本节将分析彩虹桥方块的动画效果，建筑小助手是如何触及极远的区域的，最后我们会造一个便利的建筑方块
知识速览:
- ITickable TileEntity
- BlockRayTraceResult
# 天之苍苍，其正色耶？
说起 Botania 的彩虹桥法杖，相信读者并不陌生，其美丽的特效出自浪漫的 Vazkii 之手，观察彩虹桥方块我们可以发现，其模型应该是一个不断变色的方块，并且不时会散发出有植物气息的粒子效果，彩虹桥方块会在其产生后一段时间内自动消失，不难想象应该是实现了 ITickable 接口的 TileEntity.
从彩虹桥方块中我们可以发现如下三个特性，我们一个一个来看
- 透明方块的动态材质
- 在方块周围生成指定的粒子效果
- 过一段时间后自我消失
# 透明方块的动态材质
关于动态材质相信读者都不会太陌生，因为模组的模型加载说到底还是跟随了原版的机制，所以我们固然可以想到动态资源包中常用的 mcmeta 格式以及瀑布般的长条材质，其实 Minecraft 中重复简单的方块动画都可以用 mcmeta 配合一个包含动画过程关键帧的图片格式轻松实现，其实彩虹桥方块的动画也是这样的，在 Botania 的 resources 目录中我们可以找到 bifrost.json, 这就是彩虹桥方块的模型
{ | |
"parent": "minecraft:block/cube_all", | |
"textures": { | |
"all": "botania:blocks/bifrost" | |
} | |
} | |
/* | |
Botania 开源地址: https://github.com/Vazkii/Botania | |
节选自 (1.12-final 分支): /resources/assets/botania/models/block/bifrost.json | |
*/ |
显然彩虹桥方块的模型与普通方块是相同的，换句话说我们只需要关注动画材质就可以了，根据 Model 里面声明的路径我们去找对应的贴图以及 mcmeta 文件.
这里就不多说什么了，如果我们也想要一个动态模型只需如图一样创建贴图和 mcmeta 标记文件就可以了
注: mcmeta 的文件名应为贴图名 +.mcmeta
frametime: 动画播放的帧率
interpolate: 是否开启差值补帧 (使动画渐变更流畅)
之后我们来看透明的实现，在 Bifrost 的方块声明中我们可以找到如下代码
public class BlockBifrostPerm extends BlockMod implements ILexiconable { | |
public BlockBifrostPerm(String name) { | |
super(Material.GLASS, name); | |
setLightOpacity(0); | |
setLightLevel(1F); | |
setSoundType(SoundType.GLASS); | |
} | |
@Override | |
public boolean isOpaqueCube(IBlockState state) { | |
return false; | |
} | |
@Override | |
public boolean isFullCube(IBlockState state) { | |
return false; | |
} | |
@Override | |
public boolean shouldSideBeRendered(IBlockState state, @Nonnull IBlockAccess world, @Nonnull BlockPos pos, EnumFacing side) { | |
if (world.getBlockState(pos.offset(side)).getBlock() == this) { | |
return false; | |
} | |
return super.shouldSideBeRendered(state, world, pos, side); | |
} | |
@SideOnly(Side.CLIENT) | |
@Nonnull | |
@Override | |
public BlockRenderLayer getRenderLayer() { | |
return BlockRenderLayer.TRANSLUCENT; | |
} | |
} | |
/* | |
Botania 开源地址: https://github.com/Vazkii/Botania | |
节选自 (1.12-final 分支): /common/block/BlockBifrostPerm.java | |
*/ |
显然我们的彩虹桥方块需要像玻璃一样可以透光，在 Minecraft1.15.2 中我们可以让方块直接继承自 AbstractGlassBlock 从而直接得到类似玻璃的透光能力，但在 1.12.2 我们还不能这样做，于是我们可以覆盖 isOpaqueCube isFullCube getRenderLayer 等一系列方法，使方块可以透光，为了拥有更好的显示效果，Vazkii 还覆盖了 shouldSideBeRendered 方法，重叠的面将不会渲染，这里笔者就不多说了，读者可以自行阅读上文该方法的代码
# 在方块周围生成指定的粒子效果
有心的读者如果去 Github 阅读了 BlockBifrostPerm 的源码可以发现我们列举的代码中缺少了如下部分
@Override | |
public void randomDisplayTick(IBlockState state, World world, BlockPos pos, Random rand) { | |
if(rand.nextBoolean()) | |
Botania.proxy.sparkleFX(pos.getX() + Math.random(), pos.getY() + Math.random(), pos.getZ() + Math.random(), (float) Math.random(), (float) Math.random(), (float) Math.random(), 0.45F + 0.2F * (float) Math.random(), 6); | |
} | |
/* | |
Botania 开源地址: https://github.com/Vazkii/Botania | |
节选自 (1.12-final 分支): /common/block/BlockBifrostPerm.java | |
*/ |
显然这段代码的含义便是粒子效果的渲染，randomDisplayTick 会在贴图刷新的随机游戏刻执行，可以看到 Vazkii 在代码的开头使用 if (rand.nextBoolean ()) 使下面代码执行的概率变为 50%, 防止生成太多粒子造成卡顿. Vazkii 自己实现了一套 proxy 来运行 sparkleFX () 来保持客户端渲染，并且让粒子可以运动，其中大多使用 GL 直接渲染，这里的实现略微有点复杂我们就不展开了，读者如果希望粒子效果包含运动的效果，可以自行阅读 Botania 源码，其代码大多位于 fx 包中
若要渲染普通的粒子效果，使用 world.spawnParticle (), 并且保证位于 ClientSide 执行
# 过一段时间后自我消失
在 BlockBifrost 类中，我们可以发现彩虹桥方块绑定了 TileEntity, 其类为 TileBifrost, 用于储存数据，我们来看一下 TileBifrost 类
public class TileBifrost extends TileMod implements ITickable { | |
private static final String TAG_TICKS = "ticks"; | |
public int ticks = 0; | |
@Override | |
public void update() { | |
if(!world.isRemote) { | |
if(ticks <= 0) { | |
world.setBlockToAir(pos); | |
} else ticks--; | |
} | |
} | |
@Nonnull | |
@Override | |
public NBTTagCompound writeToNBT(NBTTagCompound par1nbtTagCompound) { | |
NBTTagCompound ret = super.writeToNBT(par1nbtTagCompound); | |
ret.setInteger(TAG_TICKS, ticks); | |
return ret; | |
} | |
@Override | |
public void readFromNBT(NBTTagCompound par1nbtTagCompound) { | |
super.readFromNBT(par1nbtTagCompound); | |
ticks = par1nbtTagCompound.getInteger(TAG_TICKS); | |
} | |
} | |
/* | |
Botania 开源地址: https://github.com/Vazkii/Botania | |
节选自 (1.12-final 分支): /common/block/tile/TileBifrost.java | |
*/ |
显然 TileBifrost 实现了 ITickable, 这意味着这个方块具备了刷新数据的能力，阅读 update 方法我们发现，其实质就是自减内部储存的 tick 值，如果减没了，那么就使方块消失，writeToNBT 和 readFromNBT 的用途不言而喻，常写 TileEntity 的读者一定对其有所了解，Minecraft 会在合适的时候 (一般是保存世界和读取世界的时候) 调用这两个方法，以便于在进入和退出存档之前读写方块里面的数据
善于思考的读者此时可能发问了，这个 TileEntity 的 tick 初始值应该是什么呢，在上述对彩虹桥方块的分析过程中我们并没有看到对于 tick 初始值的声明.... 不妨再来想想彩虹桥方块是怎么被放置在世界中的呢.... 对了，就是通过彩虹桥法杖，所以不难想象设置 tick 的初始值的代码应该写在法杖中，读者可自行验证猜想，代码位于 /common/item/rod/ItemRainbowRod.java 的 onItemRightClick 方法中
# 其远而无所至极邪？
建筑小助手是 direwolf20 作为模组开发者的处女作，其中各种小助手可以隔数十格远放置方块，手中握着小助手就可以追踪到目光所及之处的方块，通过查阅建筑小助手 GadgetBuilding 类的代码，我们可以找到如下方法
private void build(ServerPlayerEntity player, ItemStack stack) { | |
······ | |
BlockRayTraceResult lookingAt = VectorHelper.getLookingAt(player, stack); | |
if (world.isAirBlock(lookingAt.getPos())) //If we aren't looking at anything, exit | |
return; | |
Direction sideHit = lookingAt.getFace(); | |
······ | |
placeBlock(world, player, index, builder, coordinate, blockData); | |
······ | |
} | |
/* | |
BuildingGadgets 开源地址: https://github.com/Direwolf20-MC/BuildingGadgets | |
节选自 (master 分支): /common/items/gadgets/GadgetBuilding.java | |
*/ |
可以猜想，在 GadgetBuilding 类的 build 方法中，实现了建筑小助手追踪视线并放置方块的特性，细心的读者可能发现，build 方法里面还具有针对 Collection 和 Undo 操作功能实现，的这里由于篇幅所限，不能为读者介绍到更为详细的部分，感兴趣的读者可以自行阅读查看
根据节选的代码片段，相信读者可以发现，追踪方块的实现依赖与 VectorHelper.getLookingAt () 这个方法，他的返回值为一个 BlockRayTraceResult, 对这个光追结果进行 getPos (), 就可以获取到目光所及之处了，所以我们更进一步，来看看 VectorHelper 的具体实现
public class VectorHelper { | |
public static BlockRayTraceResult getLookingAt(PlayerEntity player, RayTraceContext.FluidMode rayTraceFluid) { | |
double rayTraceRange = Config.GENERAL.rayTraceRange.get(); | |
RayTraceResult result = player.pick(rayTraceRange, 0f, rayTraceFluid != RayTraceContext.FluidMode.NONE); | |
return (BlockRayTraceResult) result; | |
} | |
} | |
/* | |
BuildingGadgets 开源地址: https://github.com/Direwolf20-MC/BuildingGadgets | |
节选自 (master 分支): /common/util/helpers/VectorHelper.java | |
*/ |
VectorHelper 中包含了对于 getLookingAt () 的多个重写，显然，我们的目光重点应该放在 player.pick () 方法上，相信聪明的读者已经意识到了什么，player.pick () 就是原版为我们提供好的 RayTrace 的方法，我们只需要提供 Range (第一个参数), 和流体追踪模式 (第三个参数) 就可以了
# 海运则将徙于南冥
之后我们就要着手来将这两个点子融合，我们再来回顾一下我们的想法，既利用彩虹桥方块的发光效果，以及建筑小助手 getLookingAt () 方法来制作一个便利的建筑方块，
非常抱歉的是，下面的内容因为 MCBBS 关站而遗失了，如果你曾经无意间保存了下面内容的副本，请联系我将这部分补全.
