Minecraft(我的世界)中文论坛
标题: Forge与ForgeGradle官方开发文档 - 持续更新中
作者: fyfly 时间: 2015-7-12 17:54
标题: Forge与ForgeGradle官方开发文档 - 持续更新中
本帖最后由 fyfly 于 2017-2-18 01:24 编辑
介绍:
也许有人发现了，MinecraftForge在四月底2015年4月底启动了一个Documentation的项目，作为Forge的官方文档。目前大部分内容是面向1.8+的。里面对Forge在1.8+新加的东西有很详细的介绍。如果你要升级你的mod到1.8+，请务必阅读一下这个文档。当然这个教程里面也有一些比较通用并且常用的内容，像是版本命名或者是保持代码整洁之类的东西。我花了大概一天多的时间将这个文档翻译成中文。
ForgeGradle的文档翻译完成了，由于比较忙(lan)拖了七天。里面的内容如果不熟悉Gradle的可以去看看。里面一些构建脚本还是比较常用的，比如说Shading什么的(之前我直接拷源码什么的真是太傻了/w\，另外求这个专有名词的翻译)。
Forge文档地址: http://mcforge-cn.readthedocs.org/
Forge文档英文版地址: http://mcforge.readthedocs.org/
ForgeGradle文档地址: http://forgegradle-cn.readthedocs.org/
ForgeGradle文档英文版地址: http://forgegradle.readthedocs.org/
注意:
- 这个文档并不包含Java的基本概念。如果你不了解Java，请先学习Java。
- 原文档仍然在缓慢更新中，如果新的内容加上了我会及时去补上。
- 如果遇到实在不能理解的地方，不妨到英文版去看看，如果你有改进翻译的地方可以提交给我。
- 如果你要升级你的mod到1.8+，请务必阅读网络部分，新版本对线程有改动。原来英文版的范例是不能工作的，而文档里只是提出了这个问题。如果想要知道正确的写法请看我的注释。
- 如果你要升级你的mod到1.8+，推荐阅读Blockstates部分，里面Forge新加了自己的Blockstates JSON格式会很方便。
如果有能力的话最好直接去阅读原版，毕竟翻译一定会存在信息缺失与误解。
Forge文档的Github工程: https://github.com/Meow-J/Forge-Documentation-CN
ForgeGradle文档的Github工程: https://github.com/Meow-J/ForgeGradle-Documentation-CN
如果你喜欢这两个工程，记得在Github上给工程一个Star。
作者: fyfly 时间: 2015-7-12 21:51
现在搬到一个独立的工程里去了
作者: liach 时间: 2015-7-12 22:15
Meow可惜啊，LedManos发飙了…吓死人了
作者: fyfly 时间: 2015-7-12 22:22
没事，只是不是官方认可的翻译，他们对质量还是有怀疑的，要做根据MIT协议还是能做下去的
作者: fyfly 时间: 2015-7-20 15:46
ForgeGradle文档已经翻译完成了，虽然拖了一段时间，欢迎来阅读，如果有错误给我发PR
作者: fyfly 时间: 2015-8-11 14:23
没什么人啊，自己顶一下吧orz
作者: AMN 时间: 2015-8-12 02:57
有在看的哦
作者: 181133567 时间: 2015-8-12 21:59
好东西 支持一下 希望能持续更新~
作者: fyfly 时间: 2015-8-12 22:21
如果英文版的有新增内容我会更新的
作者: 侑阳 时间: 2015-8-13 04:29
我还是先去学java吧
作者: fyfly 时间: 2015-10-29 12:34
更新Locations内容
作者: xjj2005 时间: 2015-12-20 15:09
请问有1710的forge文档吗
作者: fyfly 时间: 2015-12-20 15:31
这个文档基本讲的都是概念，大部分是通用的
作者: icreaft 时间: 2015-12-23 10:35
我是来回复的
作者: fyfly 时间: 2016-2-19 19:24
昨天肝了一晚上把最新的几篇文章给翻译了，大家可以去看下
作者: 冰の风铃草 时间: 2016-3-24 09:27
对于四级都没过的我来说简直就是不要太棒{:10_530:}
蟹蟹fyfly桑
作者: fyfly 时间: 2017-2-11 14:18
昨天晚上稍微校对了一下文本，现在应该看起来好多了，另外帖子现在也移动到翻译版来了。
作者: CNife 时间: 2017-2-26 21:20
感谢翻译，已经Star
作者: YPXxiaoK 时间: 2017-4-20 21:15
感谢Moew J的分享
作者: 拥友 时间: 2017-4-21 22:43
.................
作者: LoungerW 时间: 2017-6-19 23:10
我看Oeasy老师的视频，看到那个wiki，但是链接还是到forge Documentation的网页上。
你中文翻译给的wiki链接也是这样。是没有了吗？还是要科学上网啊
作者: fyfly 时间: 2017-6-20 00:32
地址就是这个：http://mcforge-cn.readthedocs.io/zh/latest/
作者: LoungerW 时间: 2017-6-20 21:17
谢谢大神回复。我会c++（面向对象只简单了解）。java刚看了 一丢丢。
所有的这些方法都是可以可链的(Chainable)，也就是说你可以以一个序列调用这些方法。如果想要一个例子，请看 Block#registerBlocks 方法。
看到你翻译的documentation，也看了原文的这里。应该有个例子吧，结果没有。不想msdn啊，还是因为我java不会啊。
作者: fyfly 时间: 2017-6-21 13:33
这里的例子指的就是Minecraft代码里的东西啦，你去看看Block类下的registerBlocks方法。这里还是给你截一小段吧：
- registerBlock(0, AIR_ID, (new BlockAir()).setUnlocalizedName("air"));
- registerBlock(1, "stone", (new BlockStone()).setHardness(1.5F).setResistance(10.0F).setSoundType(SoundType.STONE).setUnlocalizedName("stone"));
- registerBlock(2, "grass", (new BlockGrass()).setHardness(0.6F).setSoundType(SoundType.PLANT).setUnlocalizedName("grass"));
- registerBlock(3, "dirt", (new BlockDirt()).setHardness(0.5F).setSoundType(SoundType.GROUND).setUnlocalizedName("dirt"));
- Block block = (new Block(Material.ROCK)).setHardness(2.0F).setResistance(10.0F).setSoundType(SoundType.STONE).setUnlocalizedName("stonebrick").setCreativeTab(CreativeTabs.BUILDING_BLOCKS);
- registerBlock(4, "cobblestone", block);
- Block block1 = (new BlockPlanks()).setHardness(2.0F).setResistance(5.0F).setSoundType(SoundType.WOOD).setUnlocalizedName("wood");
- registerBlock(5, "planks", block1);
- [...]
作者: LoungerW 时间: 2017-6-21 22:07
是看源码吗，好像懂了些，看来要学的还有好多。
谢谢
作者: 343362619 时间: 2017-9-2 21:15
你这个文档实在实在太给力啦，我一直在找的就是它
作者: 大笑江湖233 时间: 2017-9-4 20:24
刨坟了......楼主大大有没有1.12模组的教程啊
作者: dogeop 时间: 2017-9-5 11:07
Srg2Source是个好东西啊，Forge出的神奇的语法分析器，能给你把bukkit给翻译成mcp。
作者: fyfly 时间: 2017-9-5 23:41
这个就是
作者: lq2007 时间: 2018-5-11 14:24
问一下 现在还在更新吗？
发现大半年没更新了。。。
但是 我神奇的发现我从github下载的文档比你这个还少啊，比如block那节，就没有着色那块
作者: Qin_An 时间: 2019-8-10 00:29
支持作者！
作者: wdhliminghao 时间: 2020-4-24 11:42
十分有用，感谢分享~
java也是刚刚学习 勉强能看懂，试着做做看