用户:MashKJo/1.12.2模组开发教程/11.高级物品和方块 - 前置概念 - 版本历史

MashKJo：// Edit via Wikiplus

2025-01-03T12:33:02Z

// Edit via Wikiplus

←上一版本		2025年1月3日 (五) 20:33的版本
第2行：		第2行：

	很简单，如果我们排除掉使用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是修复材料。

	~~对于高级方块，Block类下有如下常用方法值得覆写：~~
	* isPassable：决定实体是否可以从该方块中穿过，参考原版的门方块，就不难理解了。
	* isReplacable：决定该方块是否可以在其他方块被放置时取代——如果不能，则方块会被放置在该方块的侧面。如原版的液体方块和空气方块在这里返回true。
	* neighborChanged：覆写该方法，即可自定义该种方块的周围发生方块更新时执行的游戏逻辑。一般有两个用途：1.激发红石信号，如观察者方块；2.触发对该方块的状态的合法性检验（这里的“状态”不仅仅包括BlockState，是一种抽象的概念），如悬空的沙子在周围有方块更新时会立刻下坠。
	* breakBlock：在方块被破坏后触发，注意不限于被玩家破坏（如果想要限定被玩家破坏才执行逻辑，可以考虑覆写onBlockDestroyedByPlayer），但使用<code>World#setBlockState</code>替换该方块时，不会触发这个方法。
	* onBlockActivated：玩家右键点击该方块后触发，注意两只手都会触发一次，所以最好先判定传入的EnumHand。原版的工作台和熔炉，在这里，就是让玩家打开相应的GUI界面。
	* getStateForPlacement：上一节已经提到过，不再赘述。
	* onBlockClicked：这个方法从MCP得到的名字可能会很有迷惑性，读者可能会以为它在左键、右键被按下时都会触发，实际上不对，只有左键点击它会触发该方法。
	* onBlockPlacedBy：在某个生物实体放置该方块时被触发，注意不限于玩家，像末影人这种非玩家生物也可以。
	* isFlammable、getFlammability等一系列方法：用于决定该方块是否可燃、燃烧能力等一系列和火方块相关的参数。按照Minecraft原版的设计，这些东西本来应该通过<code>BlockFire#setFireInfo</code>这个公开方法指定，不过经过Forge的patch后，我们便可以在Block类中覆写方法指定了。
	* getDrops：得到该方块所有可能的掉落物（以一个NonNullList<ItemStack>的形式呈现），由于每破坏一次该种方块，该方法就会调用一次，所以在这里可以利用利用随机数。
	* getExpDrop：得到该方块被采集时，掉落的经验量。
	* isReplacableOreGen：决定：在区块生成的过程中，已经被生成的该种方块是否可以被矿石取代。

	想必读者也看到了，覆写这些方法通常涉及到一些很重要也比较复杂的类，这些类比较琐碎，应用也非常广泛，如果真的按照“讲到了对应的专题再详细讲”这个原则安排内容，会导致一系列问题——例如，World类是一个非常重要的类，用到的地方超级多，但是读者想必也不希望掌握如何创建一个新维度后，再回来写高级的物品/方块吧？因此这一节就专门讲这些琐碎的类以及它们涉及到的一些重要概念。		想必读者也看到了，覆写这些方法通常涉及到一些很重要也比较复杂的类，这些类比较琐碎，应用也非常广泛，如果真的按照“讲到了对应的专题再详细讲”这个原则安排内容，会导致一系列问题——例如，World类是一个非常重要的类，用到的地方超级多，但是读者想必也不希望掌握如何创建一个新维度后，再回来写高级的物品/方块吧？因此这一节就专门讲这些琐碎的类以及它们涉及到的一些重要概念。

MashKJo：/* 在世界中放置方块 */ // Edit via Wikiplus

2024-12-29T14:52:56Z

在世界中放置方块： // Edit via Wikiplus

←上一版本		2024年12月29日 (日) 22:52的版本
第103行：		第103行：
	显然，这很让人摸不着头脑。不过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：/* ActionResult */ // Edit via Wikiplus

2024-12-29T14:48:37Z

ActionResult<T>： // Edit via Wikiplus

←上一版本		2024年12月29日 (日) 22:48的版本
第57行：		第57行：

	== 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 ==

MashKJo：// Edit via Wikiplus

2024-12-29T14:46:20Z

// Edit via Wikiplus

@@ 第17行： / 第17行： @@
 * getItemBurnTime：如果你想添加熔炉燃料，那么覆写这个方法即可。返回一个正整数，则默认它是一个熔炉燃料，且单位为tick；若返回0，则代表它不可燃；返回-1，则代表它的可燃状态交给原版Minecraft去决定。
 * getIsRepairable：用于决定该ItemStack可被什么ItemStack修复。两个参数中，toRepair是被修复的，repair是修复材料。
 想必读者也看到了，覆写这些方法通常涉及到一些很重要也比较复杂的类，这些类比较琐碎，应用也非常广泛，如果真的按照“讲到了对应的专题再详细讲”这个原则安排内容，会导致一系列问题——例如，World类是一个非常重要的类，用到的地方超级多，但是读者想必也不希望掌握如何创建一个新维度后，再回来写高级的物品/方块吧？因此这一节就专门讲这些琐碎的类以及它们涉及到的一些重要概念。
 == 一些枚举类 ==

MashKJo：// Edit via Wikiplus

2024-12-29T13:51:41Z

// Edit via Wikiplus

←上一版本		2024年12月29日 (日) 21:51的版本
第3行：		第3行：
	很简单，如果我们排除掉使用TileEntity的方块，那么剩下的那些高级的物品/方块，几乎都是通过覆写Item类或Block类下的若干方法实现的，这些方法有的是Minecraft原生支持的，还有一些是Forge塞进去的。你可能会看到Minecraft有些原生支持的方法被@Deprecated了，那可能是因为Forge觉得这个方法提供的形参不够多，对于对应功能的控制还不够精细，因此patch了一个更为强大的同功能重载方法。另外，如果你实在找不到可以覆写的方法，那么可以考虑监听一些事件。		很简单，如果我们排除掉使用TileEntity的方块，那么剩下的那些高级的物品/方块，几乎都是通过覆写Item类或Block类下的若干方法实现的，这些方法有的是Minecraft原生支持的，还有一些是Forge塞进去的。你可能会看到Minecraft有些原生支持的方法被@Deprecated了，那可能是因为Forge觉得这个方法提供的形参不够多，对于对应功能的控制还不够精细，因此patch了一个更为强大的同功能重载方法。另外，如果你实在找不到可以覆写的方法，那么可以考虑监听一些事件。

	然而，覆写这些方法通常涉及到一些很重要也比较复杂的类，这些类比较琐碎，应用也非常广泛，如果真的按照“讲到了对应的专题再详细讲”这个原则安排内容，会导致一系列问题——例如，World类是一个非常重要的类，用到的地方超级多，但是读者想必也不希望掌握如何创建一个新维度后，再回来写高级的物品/方块吧？因此这一节就专门讲这些琐碎的类以及它们涉及到的一些重要概念。		对于高级物品，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类是一个非常重要的类，用到的地方超级多，但是读者想必也不希望掌握如何创建一个新维度后，再回来写高级的物品/方块吧？因此这一节就专门讲这些琐碎的类以及它们涉及到的一些重要概念。
	== 一些枚举类 ==		== 一些枚举类 ==
	在给我们的高级的物品/方块实现一些功能时，我们会和很多枚举类打交道，如：		在给我们的高级的物品/方块实现一些功能时，我们会和很多枚举类打交道，如：
	* EnumAction：这个枚举类专用于物品，具体地说，是表示物品被使用时，产生的动画效果的“类型”（说是动画效果，实际上就是一层薄薄的贴图转了个角度后的一堆平移、伸缩或旋转变换而已），由<code>Item#getItemUseAction</code>决定。原版有5种EnumAction，分别是：NONE、EAT、DRINK、BLOCK、BOW。很显然，后四者分别用于食物、水瓶和药水、方块的物品形式、弓。那么可能会有读者问了：如果我想自定义物品使用时的动画效果，怎么办，如何去做到？答案是通常情况下做不到，除非你用黑魔法。一般而言，新的EnumAction可以通过Forge提供的EnumHelper来通过反射生成，但是Minecraft具体处理这个EnumAction并实际产生动画的代码中，Forge实际上没有发布任何事件，所以理论上我们无法新增自定义的物品使用动画，除非你用Mixin大法，但除非你Modding水平够高，否则执意在Forge框架下开发时用Mixin实现自己的需求，还不如自己换个需求。		* EnumAction：这个枚举类专用于物品，具体地说，是表示物品被使用时，产生的动画效果的“类型”（说是动画效果，实际上就是一层薄薄的贴图转了个角度后的一堆平移、伸缩或旋转变换而已），由<code>Item#getItemUseAction</code>决定。原版有5种EnumAction，分别是：NONE、EAT、DRINK、BLOCK、BOW。很显然，后四者分别用于食物、水瓶和药水、方块的物品形式、弓。那么可能会有读者问了：如果我想自定义物品使用时的动画效果，怎么办，如何去做到？答案是通常情况下做不到，除非你用黑魔法。一般而言，新的EnumAction可以通过Forge提供的EnumHelper来通过反射生成，但是Minecraft具体处理这个EnumAction并实际产生动画的代码中，Forge实际上没有发布任何事件，所以理论上我们无法新增自定义的物品使用动画，除非你用Mixin大法，但除非你Modding水平够高，否则执意在Forge框架下开发时用Mixin实现自己的需求，还不如自己换个需求。
	* EnumActionResult：这个枚举类有3个实例：SUCCESS、PASS和FAIL，它用于描述某个交互逻辑进行后，返回的结果（或者说执行结果）。其实它的意义不是那么大，因为它也就只是一个返回值而已，你可以在写一堆你自己的自定义逻辑后返回FAIL，本质上就是一个标记而已。不过对于物品的使用而言，SUCCESS和FAIL都不会在执行完主手上的物品的相关逻辑后，继续执行副手上对应物品的相关逻辑，而PASS则会，这个特性需要小小地注意一下。		* EnumActionResult：这个枚举类有3个实例：SUCCESS、PASS和FAIL，它用于描述某个交互逻辑进行后，返回的结果（或者说执行结果）。其实它的意义不是那么大，因为它也就只是一个返回值而已，你可以在写一堆你自己的自定义逻辑后返回FAIL，本质上就是一个标记而已。3个返回值没有固定的含义，读者在使用前请先查看相关的代码。
	* EnumBlockRenderType：顾名思义，这个枚举类用于描述方块的渲染类型——INVISIBLE、LIQUID、ENTITYBLOCK_ANIMATED、MODEL。		* EnumBlockRenderType：顾名思义，这个枚举类用于描述方块的渲染类型——INVISIBLE、LIQUID、ENTITYBLOCK_ANIMATED、MODEL。
	** MODEL：默认值，就是最普通的渲染类型——从指定的模型文件中读取出一个模型（实际上是通过一个ICustomModelLoader得到了一个IModel），并经历一系列加工过程，最后渲染出来。		** MODEL：默认值，就是最普通的渲染类型——从指定的模型文件中读取出一个模型（实际上是通过一个ICustomModelLoader得到了一个IModel），并经历一系列加工过程，最后渲染出来。
第21行：		第35行：

	== 一些向量类 ==		== 一些向量类 ==
	Minecraft在<code>net.minecraft.util.math</code>包下提供了三个向量类：Vec2f、Vec3f和Vec3d。实际上读者应该能很清楚地看出来，数字代表空间维度数，第一个是平面向量，后两个是空间向量；而字母代表坐标精度，f代表float，d代表double。一般而言，我们用的都是Vec3d。		Minecraft在<code>net.minecraft.util.math</code>包下提供了三个向量类：Vec2f、Vec3i和Vec3d。实际上读者应该能很清楚地看出来，数字代表空间维度数，第一个是平面向量，后两个是空间向量；而字母代表坐标精度，i代表int，f代表float，d代表double。一般而言，我们用的都是Vec3d。

	合理运用向量类能给不少问题中的数学运算带来极大的便利，如Vec3d下就有很多简化计算过程的好用方法，读者可以去自行察看。		合理运用向量类能给不少问题中的数学运算带来极大的便利，如Vec3d下就有很多简化计算过程的好用方法，读者可以去自行察看。

MashKJo：/* 在世界中放置方块 */ // Edit via Wikiplus

2024-12-27T18:19:10Z

在世界中放置方块： // Edit via Wikiplus

←上一版本		2024年12月28日 (六) 02:19的版本
第67行：		第67行：
	没错，我们终于说到了，判断当前所处的逻辑端的方法——检查非静态字段isRemote的值——是true，则代表当前为逻辑客户端，否则为逻辑服务端。虽然也有其它一些方法来判断逻辑段，但都没有这种方法好用，因为World对象在Minecraft各处代码中均可见到。		没错，我们终于说到了，判断当前所处的逻辑端的方法——检查非静态字段isRemote的值——是true，则代表当前为逻辑客户端，否则为逻辑服务端。虽然也有其它一些方法来判断逻辑段，但都没有这种方法好用，因为World对象在Minecraft各处代码中均可见到。

	== 在世界中放置方块 ==		=== 在世界中放置方块 ===
	在一个World中获取某坐标处的方块状态很简单，getBlockState这个方法即可胜任。与之类似地，放置方块，可以用setBlockState。		在一个World中获取某坐标处的方块状态很简单，getBlockState这个方法即可胜任。与之类似地，放置方块，可以用setBlockState。

MashKJo：/* 在世界中放置方块 */ // Edit via Wikiplus

2024-12-27T18:18:14Z

在世界中放置方块： // Edit via Wikiplus

←上一版本		2024年12月28日 (六) 02:18的版本
第89行：		第89行：

	Minecraft的默认行为是采取前两项行为，因此默认的幻数值是把前两项行为对应的数进行按位或运算，即0b00011——实际上也就是上文提到的3。你可能会注意到，第三条和第四条是相冲突的，当发生冲突时，以第三条为准。		Minecraft的默认行为是采取前两项行为，因此默认的幻数值是把前两项行为对应的数进行按位或运算，即0b00011——实际上也就是上文提到的3。你可能会注意到，第三条和第四条是相冲突的，当发生冲突时，以第三条为准。

			== 注释与外部链接 ==

MashKJo：/* 在世界中放置方块 */ // Edit via Wikiplus

2024-12-27T18:17:29Z

在世界中放置方块： // Edit via Wikiplus

←上一版本		2024年12月28日 (六) 02:17的版本
第75行：		第75行：

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

	Minecraft的默认行为是采取前两项行为，因此默认的幻数值是把前两项行为对应的数进行按位或运算，即0b00011——实际上也就是上文提到的3。你可能会注意到，第三条和第四条是相冲突的，当发生冲突时，以第三条为准。		Minecraft的默认行为是采取前两项行为，因此默认的幻数值是把前两项行为对应的数进行按位或运算，即0b00011——实际上也就是上文提到的3。你可能会注意到，第三条和第四条是相冲突的，当发生冲突时，以第三条为准。

MashKJo：/* World */ // Edit via Wikiplus

2024-12-27T18:16:35Z

World： // Edit via Wikiplus

←上一版本		2024年12月28日 (六) 02:16的版本
第60行：		第60行：

	== World ==		== World ==
			其实在笔者看来，World类是个设计得比较奇怪的类，从字面意思上看，它就是代表着某个维度——这么理解的确是对的。然而，World类可不仅承载了维度这一概念，甚至还包括了存档这一概念——World中相关信息的保存路径、世界生成时选择的设置（如是否有奖励箱生成），甚至“是否开启了极限模式”这种全局通用设置，你都能从一个World对象中获取。Mojang显然是把“维度”和“存档”这两个概念揉到了一个类中——即World类。

			World类的设计极为复杂，相关的方法、用途也很多，这里只做简要说明。很多其他的东西，会在将来讲到添加新维度时，一并说明的。

			=== 判断当前逻辑端 ===
			没错，我们终于说到了，判断当前所处的逻辑端的方法——检查非静态字段isRemote的值——是true，则代表当前为逻辑客户端，否则为逻辑服务端。虽然也有其它一些方法来判断逻辑段，但都没有这种方法好用，因为World对象在Minecraft各处代码中均可见到。

			== 在世界中放置方块 ==
			在一个World中获取某坐标处的方块状态很简单，getBlockState这个方法即可胜任。与之类似地，放置方块，可以用setBlockState。

			但我们注意到：后者有2个重载，形参列表的区别在于：有一个重载较另一个重载而言，多了一个：<code>int flags</code>。flags即标记，但它又是一个int类型的数——显然，它是一个幻数，具体含义到底如何，全看Mojang的底层设计如何了。如果去看看那个较为简单的方法，可以发现，它实际上是调用了另一个重载方法，并指定flags为3——为什么是3？

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

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

			Minecraft的默认行为是采取前两项行为，因此默认的幻数值是把前两项行为对应的数进行按位或运算，即0b00011——实际上也就是上文提到的3。你可能会注意到，第三条和第四条是相冲突的，当发生冲突时，以第三条为准。

MashKJo：/* RayTraceResult */ // Edit via Wikiplus

2024-12-27T17:43:24Z

RayTraceResult： // Edit via Wikiplus

←上一版本		2024年12月28日 (六) 01:43的版本
第53行：		第53行：

	== RayTraceResult ==		== RayTraceResult ==
			RayTrace，意思为“光线追踪”，如该词语的含义所言，RayTrace在Minecraft中的含义，即为“计算生物实体的视线，确定其视线选中的到底是一个实体，还是一个非空气方块，亦或者就是空气（即等价于什么都没选中）”。玩家在游戏中在准星指向的位置放置方块时，就会有RayTrace的过程。描述RayTrace结果的类型便是RayTraceResult。从一个RayTraceResult中，你可以拿到很多相关的有用信息。

			World类下有与RayTrace相关的一些方法，我们需要的时候可以直接拿来用。

			另外，实体的碰撞结果也是用RayTraceResult来描述的（最常见的例子就是实体投掷物砸中某个方块或实体）。

	== World ==		== World ==

用户:MashKJo/1.12.2模组开发教程/11.高级物品和方块 - 前置概念 - 版本历史

MashKJo：​// Edit via Wikiplus

MashKJo：​/* 在世界中放置方块 */ // Edit via Wikiplus

MashKJo：​/* ActionResult */ // Edit via Wikiplus

MashKJo：​// Edit via Wikiplus

MashKJo：​// Edit via Wikiplus

MashKJo：​/* 在世界中放置方块 */ // Edit via Wikiplus

MashKJo：​/* 在世界中放置方块 */ // Edit via Wikiplus

MashKJo：​/* 在世界中放置方块 */ // Edit via Wikiplus

MashKJo：​/* World */ // Edit via Wikiplus

MashKJo：​/* RayTraceResult */ // Edit via Wikiplus

MashKJo：// Edit via Wikiplus

MashKJo：/* 在世界中放置方块 */ // Edit via Wikiplus

MashKJo：/* ActionResult */ // Edit via Wikiplus

MashKJo：// Edit via Wikiplus

MashKJo：// Edit via Wikiplus

MashKJo：/* 在世界中放置方块 */ // Edit via Wikiplus

MashKJo：/* 在世界中放置方块 */ // Edit via Wikiplus

MashKJo：/* 在世界中放置方块 */ // Edit via Wikiplus

MashKJo：/* World */ // Edit via Wikiplus

MashKJo：/* RayTraceResult */ // Edit via Wikiplus