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

原版游戏中的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使用的版本

从上到下分别是PC版，PE版，主机板。注意，Windows 10版本的Minecraft属于Pocket Edition，请直接点击第二个。在这里我选择第一个PC版作为例子进行下面的教程，其它版本类似。

进入专区之后，请点击中上方的Create issue按钮，如下所示


点击之后会出来这样一个界面

如果你的界面不一样可以点击右上角的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为例，你会看到这样的界面：


你应该能看到上方有一个Issues按钮：


点击进入之后你就能看到类似于这样的界面：



接下来你只需要点击右上角那个绿色的New issue就会弹出个窗口让你新建一个问题了。界面:

GitHub的编辑器使用的是Markdown语法，如果不会的可以点击这里学习。你只需要在标题简述你的问题并在正文详细说明你的问题就行了。

Bug描述注意事项：

• 请对你的描述进行排版，一个良好的排版能帮助作者更轻松地了解你的问题，请利用好Preview功能。如果你不熟悉Markdown语法，可以点击这里来学习
• 如果不是崩溃(Crash)的问题，建议提供你安装所有Mod及版本的列表，当然这不是必须的。如果是关于崩溃的问题，请提供Crash-reports，里面已经包括了你安装的所有mod，如果想要贴crash-reports请务必使用Pastebin网站的网址，而不是直接粘贴到正文里，这里推荐几个：Pastebin，Asie的Pastebin，Mozilla的Pastebin，FTB的Pastebin，Gist。注意如果是报告Forge的Bug请不要提交crash-reports，他们只接受log
• 如果报告的是mod，请提供你的log文件，不论是客户端还是服务端的，Mod作者可能会在出现错误的时候在log里记录出错的原因。log文件在1.3-1.6文件名是server-0.log，在1.7及之后版本名称是fml-client-latest.log和fml-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协议，如果想要转载请不要有商业用途，请署名并通知我。

sxjsxj 发表于 2017-3-19 10:29
行，一般作者在github有反馈区。

好吧，但是我还是没看懂怎么反馈

1911226481 发表于 2017-3-19 10:27
如果是无偿的话就没什么意义了，我有个问题，不是正版行吗

行，一般作者在github有反馈区。

sxjsxj 发表于 2017-3-19 10:25
让作者修复，然后有可能被提名到贡献名单中。
毕竟大家都是无偿的。

如果是无偿的话就没什么意义了，我有个问题，不是正版行吗

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

让作者修复，然后有可能被提名到贡献名单中。
毕竟大家都是无偿的。

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

这么说也是，不过，提交bug有什么用呢

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

这个bug是你发现的，你就拥有它的知识产权。
而且别人把漏洞报给百科，百科派人去提交，费时费力，我觉得不妥。

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

主要问题是麻烦，很多人不想费这个劲，而且很多可能根本就不是bug，而且如果有像我这样看到英文就头疼的也不会去反馈，还有，这个为什么涉及到虚拟财产啊

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

那不是让发现bug的人自己去提交漏洞会更好。
毕竟bug关系到虚拟财产，经的手越少越好。

能不能在论坛上专门弄个bug的提出的地方，然后由一个人收集一起上报给那个网站，这样既解了新人不会的问题，又能把重要的bug上报，怎么说也是对mc好啊。
做不到也就算了，我提个建议