Piston API

模组

· 作者 jbredwards

添加可推动的方块实体,并允许玩家和模组开发者处理活塞交互!

0 本站下载 0 关注 更新于 2 年前

最新 1.0.2 · 1.12.2 · Forge

一键开服(送7天)

一个让模组和整合包处理活塞交互的小型模组!


API 功能:

为自定义方块赋予高级的活塞交互能力

活塞 API 为方块提供了一种与活塞进行位置及世界敏感交互的方式!主要涉及方块的推动性(pushability)及其粘性(stickiness)。

IPushableBehavior:

  • 此接口添加了一个方法 getPushReaction(接收方块源与活塞信息,并返回 EnumPushReaction)。如果方块具有高级的推动反应逻辑,应实现此接口。该接口覆盖了原版的 getPushReaction(IBlockState) 方法;未实现此接口的方块将回退至原版方法。对于整合包开发者: 可以通过 Groovyscript 在 postInit 阶段调用 PushReactionHanlder.overridePushReaction 来覆盖每个方块的推动反应(模组开发者请勿这样做!)
  • Groovyscript 示例:
import static git.jbredwards.piston_api.mod.asm.PushReactionHandler.overridePushReaction
import net.minecraft.block.material.EnumPushReaction

//使泥土在被推动时像草或树叶一样被破坏
overridePushReaction(block('minecraft:dirt'), EnumPushReaction.DESTROY)

//使橙色羊毛不可被推动,而其余羊毛仍可被推动
def orangeWool = blockstate('minecraft:wool', 1)
overridePushReaction(block('minecraft:wool'), {source, pistonInfo -> orangeWool == source.getBlockState() ? EnumPushReaction.BLOCK : EnumPushReaction.NORMAL})

IStickyBehavior:

  • 此接口添加了两个方法:getStickReaction(接收方块源、用于测试的邻居方块及活塞信息,并返回 EnumStickReaction),以及 hasStickySide(接收方块源与活塞信息,并返回该方块是否具有任何潜在的粘性面)。如果方块具有高级的粘性逻辑,应实现此接口。该接口覆盖了 Forge 的 isStickyBlock(IBlockState) 方法;未实现此接口的方块将回退至 Forge 的方法。对于整合包开发者: 可以通过 Groovyscript 在 postInit 阶段调用 StickReactionHanlder.overrideStickReaction 来覆盖每个方块的粘性结果(模组开发者请勿这样做!)
  • Groovyscript 示例:

import static git.jbredwards.piston_api.mod.asm.StickReactionHandler.overrideStickReaction
import git.jbredwards.piston_api.api.piston.EnumStickReaction

//使 slime blocks 不再具有粘性
overrideStickReaction(block('minecraft:slime'), EnumStickReaction.PASS)

//使工作台具有粘性
overrideStickReaction(block('minecraft:crafting_table'), EnumStickReaction.STICK)

//使书架永远不粘附任何东西
overrideStickReaction(block('minecraft:bookshelf'), EnumStickReaction.NEVER)

//使染色玻璃具有粘性,但仅针对相同颜色的玻璃
overrideStickReaction(block('minecraft:stained_glass'), {source, other, pistonInfo -> source.getBlockState() == other.getBlockState() ? EnumStickReaction.STICK : EnumStickReaction.PASS})

//一个更复杂的示例,使原木的开放部分具有粘性
import static git.jbredwards.piston_api.api.block.IStickyBehavior.getConnectingSide
import net.minecraft.block.BlockLog
overrideStickReaction([block('minecraft:log'), block('minecraft:log2')], {source, other, pistonInfo ->
    def connectingAxis = BlockLog.EnumAxis.fromFacingAxis(getConnectingSide(source, other).getAxis())
    def logAxis = source.getBlockState().getValue(BlockLog.LOG_AXIS)

    connectingAxis == logAxis ? EnumStickReaction.STICK : EnumStickReaction.PASS
})

主要功能:

  • 可配置的活塞推动限制
  • 活塞可以移动实体方块(tile entities)
  • 活塞不会破坏流体状态(当安装了 Fluidlogged API 时)
  • 兼容 Quark 模组

小功能:

  • 覆盖现有的活塞交互
  • 箱子在被推动时会相互粘附
  • 当方块被活塞破坏时播放方块破坏的声音和粒子效果

本模组不会移植

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源