MCBBS Wiki

用户:MashKJo/1.12.2模组开发教程/11.高级物品和方块 - 前置概念：修订间差异

用户页 讨论

用户:MashKJo/1.12.2模组开发教程/11.高级物品和方块 - 前置概念 (查看源代码)

2025年1月3日 (五) 20:33的版本

删除3,943字节 、​ 2025年1月3日 (星期五)
// Edit via Wikiplus
可视化wikitext
（// Edit via Wikiplus）
（// Edit via Wikiplus）
 
（未显示同一用户的3个中间版本）
第3行： 第3行：
很简单，如果我们排除掉使用TileEntity的方块，那么剩下的那些高级的物品/方块，几乎都是通过覆写Item类或Block类下的若干方法实现的，这些方法有的是Minecraft原生支持的，还有一些是Forge塞进去的。你可能会看到Minecraft有些原生支持的方法被@Deprecated了，那可能是因为Forge觉得这个方法提供的形参不够多，对于对应功能的控制还不够精细，因此patch了一个更为强大的同功能重载方法。另外，如果你实在找不到可以覆写的方法，那么可以考虑监听一些事件。
很简单，如果我们排除掉使用TileEntity的方块，那么剩下的那些高级的物品/方块，几乎都是通过覆写Item类或Block类下的若干方法实现的，这些方法有的是Minecraft原生支持的，还有一些是Forge塞进去的。你可能会看到Minecraft有些原生支持的方法被@Deprecated了，那可能是因为Forge觉得这个方法提供的形参不够多，对于对应功能的控制还不够精细，因此patch了一个更为强大的同功能重载方法。另外，如果你实在找不到可以覆写的方法，那么可以考虑监听一些事件。


对于高级物品，Item类有如下常用的方法值得覆写：
* onItemUseFirst、onItemUse：在物品被玩家手持，且右键非空气方块时触发，均返回一个EnumActionResult，前者先于后者被触发。对于前者而言，返回EnumActionResult.PASS，则代表会继续执行原版的相关逻辑。
* onItemUseFinish：该方法和上述2个方法有所区别——该方法限定的实体并不仅仅是玩家（EntityPlayer）了，而是所有生物（EntityLivingBase）。它返回一个ItemStack，代表某个ItemStack被使用后的结果。
* onItemRightClick：该方法会在玩家手持物品右键时触发——没错，它不要求玩家必须选中某个非空气方块，只要右键就行，实际上它也先于onItemUseFirst和onItemUse触发。Minecraft本身只提供了修改右键物品的逻辑的该方法，那么如果我们想干涉左键逻辑怎么办？考虑监听这两个事件：PlayerInteractEvent.LeftClickBlock和PlayerInteractEvent.LeftClickEmpty，具体在监听时可以判断玩家的手持物品，再写入相关逻辑，即可。
* canHarvestBlock：返回一个布尔值，注意该方法有2个重载，其中一个是原版的，还有一个是Forge塞进来的，当然推荐使用后者。用于判断某个BlockState是否可以被该Item对应的某个ItemStack挖掘并产生掉落物，原版中该方法的实现很丑陋，全是面向结果编程的味道，且鉴于Forge patch的<code>Block#setHarvestLevel</code>这一方法的存在，一般你不该动这个方法，不过如果你想做出像剪刀那样比较特殊的挖掘、掉落效果，就可以覆写这个方法。
* onUpdate：这是一个比较重要的方法，它在游戏主循环中，每一tick都会被调用一次，也就是说理想状态下每秒钟内两个逻辑端各会调用该方法20次。因此如果我们覆写了该方法，便可以赋予相应的ItemStack一秒刷新20次的能力，我们利用它可以做出一些很高级的物品，例如计时器之类的东西。从该方法中我们可以拿到持有该ItemStack的实体（没错，Entity，甚至都非EntityLivingBase），以及“该物品是否被选中”（isSelected）。
* onEntityItemUpdate：决定当前ItemStack对应的EntityItem的刷新逻辑。
* onCreated：在该物品被合成出来后触发。
* getMaxItemUseDuration：用于指定物品被右键按住使用后，持续的最长时间——如右键弓后弓会逐渐拉伸至蓄满力状态，蓄满力后一段时间内，如果不松开右键，弓会一直紧绷着。注意这个方法的返回值是一个int值，单位实际上是tick。
* onPlayerStoppedUsing：配合着getMaxItemUseDuration使用的——即玩家松开右键后执行的游戏逻辑，原版的弓在这里即会召唤出一发箭矢实体（EntityArrow）。
* addInformation：@SideOnly(Side.CLIENT)，用于给ItemStack添加tooltip，具体为向一个List<String>中添加新元素的过程，一般是搭配<code>I18n#format</code>实现，甚至我们可以通过当前ItemStack的附加NBT信息来决定添加的tooltip。
* hasEffect：@SideOnly(Side.CLIENT)，用于决定该ItemStack是否有附魔光泽——没错，ItemStack有无附魔和有无附魔光泽的对应关系并不是写死的，只是Item类对该方法的默认实现即为：有附魔才有附魔光泽，你大可给你的Item子类在这里无脑返回一个true。
* getItemBurnTime：如果你想添加熔炉燃料，那么覆写这个方法即可。返回一个正整数，则默认它是一个熔炉燃料，且单位为tick；若返回0，则代表它不可燃；返回-1，则代表它的可燃状态交给原版Minecraft去决定。
* getIsRepairable：用于决定该ItemStack可被什么ItemStack修复。两个参数中，toRepair是被修复的，repair是修复材料。
想必读者也看到了，覆写这些方法通常涉及到一些很重要也比较复杂的类，这些类比较琐碎，应用也非常广泛，如果真的按照“讲到了对应的专题再详细讲”这个原则安排内容，会导致一系列问题——例如，World类是一个非常重要的类，用到的地方超级多，但是读者想必也不希望掌握如何创建一个新维度后，再回来写高级的物品/方块吧？因此这一节就专门讲这些琐碎的类以及它们涉及到的一些重要概念。
想必读者也看到了，覆写这些方法通常涉及到一些很重要也比较复杂的类，这些类比较琐碎，应用也非常广泛，如果真的按照“讲到了对应的专题再详细讲”这个原则安排内容，会导致一系列问题——例如，World类是一个非常重要的类，用到的地方超级多，但是读者想必也不希望掌握如何创建一个新维度后，再回来写高级的物品/方块吧？因此这一节就专门讲这些琐碎的类以及它们涉及到的一些重要概念。
== 一些枚举类 ==
== 一些枚举类 ==
第42行： 第28行：


== ActionResult<T> ==
== ActionResult<T> ==
这是对EnumActionResult的一个扩展——有时候，Minecraft处理游戏逻辑时，在获取对某个对象的处理的结果时，不仅想知道处理是否成功（SUCCESS、PASS、FAIL这些结果），还想知道该对象的最终值，这个时候就需要用到这个类了，该类的构造很简单，就是<code>(EnumFacing typeIn, T value)</code>。实际上我们一般能见到的是ActionResult<ItemStack>。
这是对EnumActionResult的一个扩展——有时候，Minecraft处理游戏逻辑时，在获取对某个对象的处理的结果时，不仅想知道处理是否成功（SUCCESS、PASS、FAIL这些结果），还想知道该对象的最终值，这个时候就需要用到这个类了，该类的构造很简单，就是<code>(EnumActionResult typeIn, T value)</code>。实际上我们一般能见到的是ActionResult<ItemStack>。


== AxisAlignedBB ==
== AxisAlignedBB ==
第88行： 第74行：
显然，这很让人摸不着头脑。不过Forge在<code>Constants.BlockFlags</code>类下提供了相应的常量，并通过注释和常量名说明了flags的具体含义。简单地说，Minecraft会从传入的幻数中获取很多信息，每一种信息的具体值都由传入的幻数对应的二进制数的每一位决定：
显然，这很让人摸不着头脑。不过Forge在<code>Constants.BlockFlags</code>类下提供了相应的常量，并通过注释和常量名说明了flags的具体含义。简单地说，Minecraft会从传入的幻数中获取很多信息，每一种信息的具体值都由传入的幻数对应的二进制数的每一位决定：


{| class="wikitable" style="text-align:center;"
{| class="wikitable"
| style="font-weight:bold;" || 常量名及含义 | style="font-weight:bold;" | 数值（二进制形式） |
|-
|-
| NOTIFY_NEIGHBORS（邻近方块更新） || 0b00001 |
! 常量名及含义 !! 数值（二进制形式）
|-
|-
| SEND_TO_CLIENTS（将相关数据同步到客户端） || 0b00010 |
| NOTIFY_NEIGHBORS（邻近方块更新） || 0b00001
|-
|-
| NO_RENDERER（该方块的渲染状态不会被更新） || 0b00100 |
| SEND_TO_CLIENTS（将相关数据同步到客户端） || 0b00010
|-
|-
| RENDERER_MAIN_THREAD（让方块的渲染状态在游戏主线程中立刻被更新） || 0b01000 |
| NO_RENDERER（该方块的渲染状态不会被更新） || 0b00100
|-
| RENDERER_MAIN_THREAD（让方块的渲染状态在游戏主线程中立刻被更新） || 0b01000
|-
| NO_OBSERVERS（该行为不会被观察者方块观测到） || 0b10000
|-
|-
| NO_OBSERVERS（该行为不会被观察者方块观测到） || 0b10000 |
|}
|}


MashKJo
行政员、​优秀编辑者、​界面管理员、​监督员、​管理员、​小部件编辑者
3,430

个编辑

取自“https://mcbbs.wiki/wiki/特殊:移动版差异/55017...55026”