马铠架

一个马铠展示架——相当于原版盔甲架的马铠版本。放下架子，把马铠放上去，它就会展示在那里。任何游戏本身认定为马铠的物品都可以使用，包括来自其他模组的盔甲，而本模组无需知道那个模组的存在。

客户端和服务端都要安装。单人游戏可用——直接放进你的 mods 文件夹即可。

依赖项：Fabric 和 NeoForge 需要 Architectury API。Forge 不需要额外依赖。

可免费用于任何整合包——公开或私人都可以，无需授权。

功能

• 放置——右键点击一个方块面，将架子放置在该面上，站立在表面并面向你（没有空间时不放置）。
• 穿戴 / 替换——手持马铠右键将其放上；原来在上面的一切会回到你的物品栏。
• 卸下——空手右键取下马铠（可在配置中禁用）。
• 转向——潜行 + 右键旋转（默认每次点击 45°）；潜行时无论你手中拿着什么，都会转向。
• 破坏——击打一次掉落架子和它的马铠（创造模式：只掉落马铠；爆炸会摧毁架子并把马铠留在地上）。
• 固定不动——马铠随世界保存；即使架子下方的方块被挖掉，架子也不会掉落（类似物品展示框）。
• 模组马铠——接受游戏归类为马铠的任何物品（以及 1.21.11+ 上数据包制作的马铠）。使用原版马铠模型绘制，因此它在架子上的外观与在马身上一致。

限制（1.0.0）：将马替换为完全自定义 3D 模型（而非原版风格的纹理/装备资源）的马铠不会在架子上使用该自定义模型——它可能会以标准形状绘制，或者根本不绘制，但架子仍然会保存并返还该物品。如果整合包需要强制允许或阻止特定 id，请使用配置中的 extraHorseArmorItems / blockedHorseArmorItems。

合成

行	图案
上	木棍 · 皮革 · 木棍
中	（空） · 木棍 · （空）
下	木棍 · 平滑石头台阶 · 木棍

五根木棍、一块皮革、一块平滑石头台阶 → 1 个马铠展示架（原版盔甲架配方，在顶部中间换成皮革）。皮革槽位是标签 #horsearmorstand:stand_craft_materials（默认包含 minecraft:leather）。

配置

文件：config/horsearmorstand.json（首次启动时创建）。Fabric、Forge 和 NeoForge 使用相同的文件和键——所有加载器共用一个配置文件。

{
  "rotationStepDegrees": 45,
  "emptyHandRemovesArmor": true,
  "adventureModeCanInteract": false,
  "extraHorseArmorItems": [],
  "blockedHorseArmorItems": [],
  "renderScale": 1.0,
  "renderHeightOffset": 0.0,
  "debugLogging": false
}

键：

• rotationStepDegrees（45，范围 1–180）——每次潜行右键旋转的角度；也是新放置架子的对齐步长。
• emptyHandRemovesArmor（true）——空手右键卸下架子上的马铠。在展示服务器上设为 false，这样访客就无法卸下展品。
• adventureModeCanInteract（false）——冒险模式玩家是否可以穿戴、卸下、旋转或破坏架子。
• extraHorseArmorItems（[]）——额外接受的物品 id，除游戏归类为马铠的物品之外。
• blockedHorseArmorItems（[]）——拒绝的物品 id，即使游戏将其称为马铠（优先于上面的列表）。
• renderScale（1.0，范围 0.25–2.0）——展示尺寸倍数（1.0 = 真实马匹大小）。
• renderHeightOffset（0.0，范围 −1.0–1.0）——抬高或降低展示，单位为方块。
• debugLogging（false）——调试模组马铠时记录每个接受/拒绝决定。

物品 id 的写法很宽容：Iron_Horse_Armor、iron horse armor 和 minecraft:iron_horse_armor 都能匹配；缺少命名空间时默认为 minecraft。超出范围的值在加载时会被限制。未知的键保持其默认值。

强制允许某个模组的物品：

{ "extraHorseArmorItems": ["my_mod:steel_horse_armor"] }

阻止某个物品，即使游戏将其称为马铠：

{ "blockedHorseArmorItems": ["some_mod:cursed_barding"] }

面向整合包创作者

配方和合成材料标签由数据包驱动——无需重新构建 jar，也无需为此进行配置。

更改架子的合成材料

覆盖 #horsearmorstand:stand_craft_materials：

{
  "replace": true,
  "values": ["minecraft:iron_ingot", "minecraft:copper_ingot"]
}

Minecraft	路径
1.19.2、1.20.1	data/horsearmorstand/tags/items/stand_craft_materials.json
1.21.1+	data/horsearmorstand/tags/item/stand_craft_materials.json

"replace": false 表示在默认皮革的基础上添加，而非替换。

替换或禁用配方

保留配方 id horsearmorstand:horse_armor_stand，这样你的配方就会覆盖内置配方。

Minecraft	路径	材料形式	结果键
1.19.2、1.20.1	data/horsearmorstand/recipes/horse_armor_stand.json	{"item": "minecraft:stick"}	"item"
1.21.1	data/horsearmorstand/recipe/horse_armor_stand.json	{"item": "minecraft:stick"}	"id"
1.21.11、26.2、26.3	data/horsearmorstand/recipe/horse_armor_stand.json	"minecraft:stick"	"id"

要禁用合成，请用一个无法满足的配方覆盖（例如单个 minecraft:barrier）——刻意没有配置开关来控制此项（数据包覆盖在所有受支持版本上都有效）。

翻译（资源包）：assets/horsearmorstand/lang/<locale>.json

• item.horsearmorstand.horse_armor_stand
• item.horsearmorstand.horse_armor_stand.tooltip
• entity.horsearmorstand.horse_armor_stand

细节

• 服务端上的真实实体，在客户端绘制（类似原版盔甲架）。
• 创造模式标签页：功能方块（原版盔甲架旁边）。
• 音效：原版盔甲架的放置/破坏音效；马铠穿上或取下时播放原版马铠音效。没有粒子效果。
• 内置 10 种语言：英语、俄语、简体中文、西班牙语、法语、德语、日语、巴西葡萄牙语、韩语和意大利语。

反馈

请在 Discord 上报告任何 bug、错误或功能建议： https://discord.gg/HTkn94BXmA

Nikrecs 的更多模组： LeashAll · Better Caravans

我推荐的其他模组。