
铰接式
为地牢建造添加新的大型门,此外还为整合包作者新增锁与钥匙系统!

Hinged 为 Minecraft 添加了全新的巨型门,以及一套锁与钥匙系统,供整合包作者将门锁在特定目标之后!
快速指南
所有内容都位于 config/hinged 中。请勿编辑 generated_resources;Hinged 会为你重新构建该文件夹。
添加一扇门
复制 config/hinged/doors 中的一个文件夹,重命名它,然后编辑 door.json。id 必须唯一、全小写并使用下划线。Hinged 目前支持 3x4 的门。
使用 display_name 设置游戏内名称,texture 指定门的 PNG,icon 指定可选的物品栏 PNG。如果没有 icon,Hinged 会将门模型渲染为物品。
placement_mode 可以是 wall、floor 或 ceiling。floor 和 ceiling 模式会将 3x4 的门方块水平放置;你的 GeckoLib 模型决定门的实际外观。opening_mode 仅选择匹配的开启碰撞箱行为(swing、vertical 或 trapdoor)。它不决定哪些方块必须为空。animation_ticks 控制移动冷却,auto_close_ticks 控制自动关闭(0 表示禁用)。
碰撞箱使用像素坐标:
"from": [x, y, z], "to": [x, y, z]
closed 是关闭时的碰撞箱。open_left 和 open_right 是开启时的碰撞箱。leaf_left 和 leaf_right 是额外的移动门扇碰撞箱;当中间应保持为空时使用 []。可选的 columns 和 rows 数组可将碰撞箱限制在 3x4 门中的特定方块上。
每扇门还必须具有 opening_clearance 和 closing_clearance 数组。它们使用与碰撞箱相同的 from、to、columns 和 rows 格式,但描述的是门移动前必须包含可替换方块的空间。坐标可以延伸到门方块之外;例如 [0, 0, -16] 到 [16, 16, 0] 会检查正前方的方块。Hinged 会随门旋转该区域。当该移动不需要空余空间时使用 []。
声音可以使用 Minecraft 音效,例如 minecraft:block.wooden_door.open,或放置在 door.json 旁边的 .ogg 文件。四个设置为 open_sound、close_sound、unusable_sound 和 unlock_sound。
模型与动画
门和锁的模型/动画使用 GeckoLib 文件。他们的 Blockbench 和动画指南在此:
https://wiki.geckolib.com
门的动画为 door.closed、door.open、door.close 和 door.unusable。锁的动画为 lock.locked、lock.unlock、lock.unlocked 和 lock.relock。
粒子关键帧使用 GeckoLib 的 particle_effects。将 locator 设置为任意模型骨骼;一个空的 Blockbench 骨骼非常适合作为精确的粒子标记。Hinged 还会读取如下 pre_effect_script 选项:
count=6;spread=0.06;velocity=0,0.02,0;offset=0,0,0;speed=0.005
锁与钥匙
门锁的放置由 lock_parent_bone 和 lock_transform 控制。当锁内置于门模型中时使用 lock_model: "embedded"。否则使用钥匙的锁模型。key_lock_animation 可以为该独立锁赋予特定于门的动画。
starts_locked 需要 lock_id。具有相同 lock_id 的钥匙可以打开它。stays_unlocked 决定它是否保持解锁状态,而 unlock_delay_ticks、relock_ticks 和 relock_model_swap_ticks 控制时机。
通过复制 config/hinged/keys 中的文件夹来创建钥匙。在 key.json 中,use_mode 为 single_use、unlimited 或 durability。durability 设置使用次数,can_duplicate 允许在合成网格中复制已绑定的钥匙,indestructible 保护掉落的钥匙。icon 是物品栏纹理。如果该钥匙有自己独立的锁外观,则 lock_model、lock_texture 和 lock_animation 必须一起提供。
使用未绑定的普通钥匙对门 Shift 右键点击即可上锁。已绑定到一扇门的钥匙无法锁定另一扇门。持有匹配的钥匙即可打开上锁的门。远离门时 Shift 右键点击可在保持解锁与关闭后重新上锁之间切换。上锁的门无法被破坏,原版门也使用相同的钥匙系统。
更改定义或资源后请重启 Minecraft,以便 Hinged 重新构建并加载它们。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。