= 创作分享 =
MOD技术讨论
原版及Mod/插件的Bug汇报教程以及注意事项 ...

原版及Mod/插件的Bug汇报教程以及注意事项

Meow J 于 2016-2-28 02:59 ( 1年前 ) [教程] 分类。  [复制链接] [显示全部楼层] [打印]
本帖最后由 Meow J 于 2016-2-28 03:11 编辑

原版游戏中的Bug

概述:
首先,如果你想要报告原版游戏中的Bug的话,请记住一个网站: https://bugs.mojang.com/,这是Mojang的Bug Tracker,一切关于原版(不管是PC、PE或者是启动器)的Bug请都在这里提交。在mcbbs、贴吧、mcmod论坛报告Bug都是没有作用的!当然除非有好心人帮你报告到Mojang。
报告Bug需要一定的英文基础,大概初二左右的水平就足够了。如果遇到不会的词可以去查各种字典或者对照中文英文Minecraft wiki来学习。
报告前注意事项:
  • 请确定你是在每个版本号的最新版本上运行发现Bug的,或者说能在最新版本上重现这个Bug。这里说的每个版本号的最新版本是指快照的最新版本和目前的1.8.9,1.8.9之前的版本Bug请在1.8.9测试能够重现之后再报告,Mojang可能在新版本中已经修复你发现的Bug了
  • 请确定你使用的是官方的启动器启动的游戏,某些第三方启动器本身会有一些问题,可能会导致游戏体验有一些问题(比如很多人提到的窗口问题)
  • 请确定你是在原版的情况下发现这个Bug的,或者说能在原版里重现这个Bug。比如说这样一个问题,Minecraft 1.8引入了GlStateManager,而有些mod作者并没有使用原版的这一特性仍然使用LWJGL自带的那些渲染方法,这就有可能导致原版渲染的崩坏
  • 游戏崩溃(Crash)应该是不用怎么报告,如果游戏崩溃了启动器会上传到Hopper,Mojang应该会有人去看吧,如果想报告记得把如何重现崩溃讲清楚
  • 请确定你的Bug没有被提交过,你可以在上面提到的Bug Tracker上搜索你问题的关键词,这不仅省了你的时间也省了Mojang员工的时间。如果发现问题已经报告过了那就在底下的评论区留言confirmed来支持就行了,等待解决吧
  • 请在报告前看版本的更新日志,千万不要把新特性当做Bug给提交了

报告流程:
首先,请先进入https://bugs.mojang.com/,如果你没有注册过账号,请点击Login下方的那个Sign up来注册,注册过程非常简单,我就不赘述了。

注册完登录之后切换到Dashboard,在那里请点击你想要提交Bug使用的版本
QQ图片20160228022835.png
从上到下分别是PC版,PE版,主机板。注意,Windows 10版本的Minecraft属于Pocket Edition,请直接点击第二个。在这里我选择第一个PC版作为例子进行下面的教程,其它版本类似。

进入专区之后,请点击中上方的Create issue按钮,如下所示
QQ图片20160228022926.png

点击之后会出来这样一个界面
QQ图片20160228022937.png
如果你的界面不一样可以点击右上角的Configure Fields点击里面的All把所有项目都选中。

下面将详细说明每一项的作用,红色字体项目表示必填:
  • Project(工程):这一项表示Bug出现的工程(即PC版、PE版、主机版等),如果你之前点了PC版本这里默认的就是PC版本的工程,你也可以点击下拉菜单选择其他的工程。
  • Issue Type(问题类型):这一项不用管,只能够填Bug类型
  • Summary(概括问题):重申一遍,请一定先在创建新的Issue之前搜索,这里的概括就是用几个简短的词来概括Bug的内容,一般不超过15个词。比如你想报告最新那个中键点击生物会给你一个无效的刷怪蛋,那么就可以写“Middle clicking mobs gives an invalid spawn egg”。注意,这里的概括一定要讲清楚问题,不要仅仅说“It's broken”或者是“Help me!!!”。
  • Security Level(安全等级):如果你报告的Bug可能会危害服务器安全或者是一些刷物品的Bug,请将安全等级设置为“Minecraft - Private”,这样子就只有管理员能看到你发出的Bug了。
  • Affects Versions(影响的版本):这里选择你发现Bug的版本,可以是多个版本。注意请不要选择Unreleased versions里面的内容,你不能获得未发布的版本。
  • Environment(系统环境):这里填写你的系统和Java版本。比如说你可以在这里填写“Windows 10 Pro x64, Java 8u20 x64”
  • Description(问题描述):这个虽然不是必填但是还是很重要的,你需要描述Bug是什么,并且还要告诉别人如何重现(Reproduce)这个Bug,这个问题描述用的是一种特殊的Markup语言进行排版,如果想要了解语法可以到这里学习。具体的注意事项太多我会在下面列出来
  • Attachment(附件):这里你可以把Bug出现时候的截图(游戏内F2键)上传到附件里,或者你也可以录一段视频,但是注意大小不能超过10MB。这里你可以上传多个附件
  • Device(设备,PE版):这个项目只有PE版才会出现,请选择你的手机/平板的型号,注意一下如果是Windows 10版本的MC请选择最下面的几个带有Windows 10字样的设备
  • Operating System Version(操作系统版本,PE版):这个项目只有PE版才会出现,填写你手机/平板的操作系统,比如iOS 7.1.2和Android 5.1
  • Affected Platforms(影响的平台,主机版):这个项目只有主机版才会出现,请勾选你使用的平台


最后点击Create按钮就能创建你的新Issue了

Bug描述注意事项:
  • 请对你的描述进行排版,良好的排版能帮助别人更有效的理解你的问题,如果你不会使用那个编辑器请点击这里学习,另外编辑器左下角有个蓝色的按钮可以预览,再按一下返回编辑
  • Mojang提供了一份描述的样板,你可以往里套:本应发生什么现象?实际发生什么现象?怎样重现这个Bug?
  • 请附上合适的截图或其它能够描述问题的证据
  • 推荐EnderIO mod的一篇排版非常好而且非常详细的Bug报告,虽然不是原版的报告但你也能从中获取很多有用的参考: https://github.com/SleepyTrousers/EnderIO/issues/2673 (作者有点话唠/w\,不过能从中获得灵感就好,如果我发现Mojang的Bug Tracker上有排版非常好的我也会放上来)


Mod和插件中的Bug

概述:
在这里我会讲解如何提交Mod和Bukkit插件中的Bug,一般常用的Issue Tracker有两种,一种JIRA(也就是Mojang使用的那个),还有一种就是用GitHub的Issues功能。JIRA的提交流程和上面提交原版Bug的流程差不多,你可以直接去看上面那篇教程。这里主要讲解GitHub的Issues功能的使用方法。如果你想提交的mod或插件作者是中国的那肯定没英语水平需求。如果是外国的还是一样的初二水平就够了,不会的词查字典。

寻找反馈地点:
首先,你需要查找反馈的地点,通常我们只要在Google(或者Yahoo和Bing,只要不是百度就行)搜索"mod/插件原名 + github"来找作者有没有GitHub工程,注意是原名而不是创世神这类的译名。一般来说都是能找到的,即使有些mod/插件不开源,也通常会有一个工程专门反馈Bug。如果真的没找到,在搜索引擎中搜索”minecraft + mod/插件原名“来找插件/mod的发布帖,仔细阅读原帖看看有没有Issue Tracker的字样,如果有就进入那个网址;如果还是没有,那么就直接在原帖或者是论坛(比如IC2就有自己的论坛)回复报告你发现的问题。我在这里只介绍GitHub的Issues的使用方法,在原帖回复很简单就不介绍了。

报告前注意事项:
  • 请先确定出现问题的是你要报告的Mod或者是插件,有时候可能是其它Mod或者是插件导致的问题
  • 请利用搜索引擎先搜索你的问题,再进行报告,有可能别人已经报告了或者是已经找到了解决方案
  • 请确定你使用的是最新版本的Mod/插件,注意这里的最新指的是原帖发布的最新版,甚至是用提供的源码自己编译的最新版本,而不是国内搬运贴里的最新版本,他们有时候会更新很不及时
  • 非常重要的一点,如果你报告Bug的是Mod,请确定你没有运行mod在MCPC+、Cauldron、或者是KCauldron上,这些版本的服务端对原版的代码有更改,而一些mod作者是不管这些修改版本的,甚至有些mod根本就不兼容Cauldron服务器(FastCraft)。比如如果你安装BuildCraft在Cauldron服务器上,你就会发现log里有明确的说明不兼容的环境,作者将不对Cauldron上出现的问题进行任何的修复,这样的mod还有很多,请仔细看清楚之后再汇报你的Bug。如果发现这类消息请换成原版+Forge的服务器,重现之后再报告Bug
  • 如果你在使用整合包的时候mod出现bug,请将bug报告至整合包作者。可能整合包作者对mod进行了一些改动
  • 如果你报告Bug的是Mod,请升级Forge到最新版本进行测试,重现之后再报告你的Bug。对于插件也是一样,请升级到作者说明的CraftBukkit/Spigot最新版本测试之后再进行汇报



GitHub的Issues使用方法:
首先,你如果没有GitHub账号的话需要先注册一个,点击右上角Sign up注册,注册很简单就不赘述了。

注册完之后进入你刚刚搜索到的工程,这里以BuildCraft为例,你会看到这样的界面:
QQ图片20160228024339.png

你应该能看到上方有一个Issues按钮:
QQ图片20160228024349.png

点击进入之后你就能看到类似于这样的界面:
QQ图片20160228024456.png


接下来你只需要点击右上角那个绿色的New issue就会弹出个窗口让你新建一个问题了。界面:
QQ图片20160228024532.png
GitHub的编辑器使用的是Markdown语法,如果不会的可以点击这里学习。你只需要在标题简述你的问题并在正文详细说明你的问题就行了。

Bug描述注意事项:
  • 请对你的描述进行排版,一个良好的排版能帮助作者更轻松地了解你的问题,请利用好Preview功能。如果你不熟悉Markdown语法,可以点击这里来学习
  • 如果不是崩溃(Crash)的问题,建议提供你安装所有Mod及版本的列表,当然这不是必须的。如果是关于崩溃的问题,请提供Crash-reports,里面已经包括了你安装的所有mod,如果想要贴crash-reports请务必使用Pastebin网站的网址,而不是直接粘贴到正文里,这里推荐几个:PastebinAsie的PastebinMozilla的PastebinFTB的PastebinGist。注意如果是报告Forge的Bug请不要提交crash-reports,他们只接受log
  • 如果报告的是mod,请提供你的log文件,不论是客户端还是服务端的,Mod作者可能会在出现错误的时候在log里记录出错的原因。log文件在1.3-1.6文件名是server-0.log,在1.7及之后版本名称是fml-client-latest.logfml-server-latest.log,在logs/文件夹里能找到。同样,请使用Pastebin服务,不要直接贴正文里
  • 如果报告的是插件,请提供logs/latest.log,要求同上
  • 请尽量提供截图(游戏内F2)或者视频等资料,视频可以用Gfycat上传,或者可以用YouTube
  • 在描述中请介绍如何重现(Reproduce)你发现的Bug
  • 推荐EnderIO mod的一篇排版非常好而且非常详细的Bug报告,你能从中获取很多有用的参考: https://github.com/SleepyTrousers/EnderIO/issues/2673


本教程采用Creative Commons 4.0 BY-NC协议,如果想要转载请不要有商业用途,请署名并通知我。

评分

参与人数 5RF +20 Vis +4 Mana +1 收起 理由
Zi_Min + 2 + 1 因为无意中发现楼主没有mana,考虑到当时精.
重生是希望 + 5 + 2 祖国需要你
CannonFotter + 5 祖国需要你
AstonIceDog + 5 祖国需要你
Humus + 5 喵呜机~

查看全部评分

发表于 2016-2-28 02:59:47 | 显示全部楼层 |阅读模式

回复 | 举报

该帖共收到 12 条回复!
好评ovo
话说v姐弄过一个自助issue编写教程233
http://vazkii.us/br101/
就是这个
我觉得新人也可以试试这个= =
要不加上链接?
发表于 2016-2-28 15:50:20 | 显示全部楼层

回复 | 支持 | 反对 举报

已保存,感谢楼主分享
return 0;
发表于 2016-5-20 22:04:08 | 显示全部楼层

回复 | 支持 | 反对 举报

已保存~精华竟然没人回复?
MCBBSID:a946115793
发表于 2017-3-18 22:22:07 | 显示全部楼层

回复 | 支持 | 反对 举报

能不能在论坛上专门弄个bug的提出的地方,然后由一个人收集一起上报给那个网站,这样既解了新人不会的问题,又能把重要的bug上报,怎么说也是对mc好啊。
做不到也就算了,我提个建议
神奇的强迫症,看帖不回帖难受
发表于 2017-3-18 23:12:17 | 显示全部楼层

回复 | 支持 | 反对 举报

1911226481 发表于 2017-3-18 23:12
能不能在论坛上专门弄个bug的提出的地方,然后由一个人收集一起上报给那个网站,这样既解了新人不会的问题 ...

那不是让发现bug的人自己去提交漏洞会更好。
毕竟bug关系到虚拟财产,经的手越少越好。
return 0;
发表于 2017-3-19 08:57:14 | 显示全部楼层

回复 | 支持 | 反对 举报

sxjsxj 发表于 2017-3-19 08:57
那不是让发现bug的人自己去提交漏洞会更好。
毕竟bug关系到,经的手越少越好。 ...

主要问题是麻烦,很多人不想费这个劲,而且很多可能根本就不是bug,而且如果有像我这样看到英文就头疼的也不会去反馈,还有,这个为什么涉及到虚拟财产啊
神奇的强迫症,看帖不回帖难受
发表于 2017-3-19 09:17:19 | 显示全部楼层

回复 | 支持 | 反对 举报

1911226481 发表于 2017-3-19 09:17
主要问题是麻烦,很多人不想费这个劲,而且很多可能根本就不是bug,而且如果有像我这样看到英文就头疼的 ...

这个bug是你发现的,你就拥有它的知识产权。
而且别人把漏洞报给百科,百科派人去提交,费时费力,我觉得不妥。
return 0;
发表于 2017-3-19 10:17:11 | 显示全部楼层

回复 | 支持 1 | 反对 0 举报

sxjsxj 发表于 2017-3-19 10:17
这个bug是你发现的,你就拥有它的知识产权。
而且别人把漏洞报给百科,百科派人去提交,费时费力,我觉得 ...

这么说也是,不过,提交bug有什么用呢
神奇的强迫症,看帖不回帖难受
发表于 2017-3-19 10:24:01 | 显示全部楼层

回复 | 支持 | 反对 举报

1911226481 发表于 2017-3-19 10:24
这么说也是,不过,提交bug有什么用呢

让作者修复,然后有可能被提名到贡献名单中。
毕竟大家都是无偿的。
return 0;
发表于 2017-3-19 10:25:54 | 显示全部楼层

回复 | 支持 | 反对 举报

12下一页
百科目前不允许匿名发帖哦~ 请先 [ 登陆 ][ 注册 ] 吧~

本版积分规则

发新帖
  • 回复
  • 点评
  • 评分
  • 分享
MCmod百科

[ MC百科(mcmod.cn) 除教程作者自定义规则的文章, 及未授权的站外图片/链接以外的所有可编辑内容, 均采用 BY-NC-SA 3.0 协议 ]

Minecraft百科CC协议
快速回复 返回顶部 返回列表