Pommel - Held Item Models - Pommel - 手持物品模型

Pommel - 手持物品模型

Blade - 资源包

—手持物品模型资源包—

什么是 Pommel？

Pommel 是一个 Fabric 模组，它允许资源包替换物品在手持状态下的模型——就像望远镜和三叉戟那样——让你可以自定义物品在你手中的外观。想要为手中的锤子制作一个 3D 模型，一把燃烧的巨剑，或者一根古老的魔法杖，同时保留物品的原始外观？有了 Pommel，这一切都能实现！

也适用于模组物品！

如果你使用 Pommel 创建了一个资源包，欢迎与我分享你的作品！我很想看看你能做出什么！

致资源包创作者

添加了以下物品谓词：

• pommel:is_held — 当物品在第三人称或第一人称视角下被手持时

• pommel:firstthirdperson — 物品在第一人称与第三人称视角下

• 值为 0.5 时更改第一人称视角下指定的模型，值为 1.0 时更改第三人称视角下的模型。

• pommel:is_offhand — 物品在玩家的副手槽位中

• pommel:is_fixed — 当物品在物品展示框中时

• pommel:is_head — 当物品被穿戴在头盔槽位时

• pommel:is_ground — 当物品被丢弃在地面上时

• pommel:is_thrown — 可投掷物品被投掷时（鸡蛋、雪球、末影珍珠等）

• pommel:is_used — 当物品正在被使用时（即按住使用/右键键）；如果模组安装在服务器上且玩家拥有此模组，则会在多人游戏中同步

• pommel:item_use — 物品被使用/消耗的持续时间，例如吃东西

• pommel:is_submerged — 物品浸没在 minecraft:water 中（不适用于其他液体）

• 当一个物品实体被扔进水中，但随后不再在水中（例如你移除了水），该物品仍会保持其“浸没”状态

• pommel:is_enchanted — 如果物品被附魔

• pommel:ismiscentity_holding — 由村民、女巫、熊猫和狐狸持有的物品。

• 请注意，这三种实体仍将采用该模型的“地面”显示设置。如有需要，你可以更改“地面”显示的旋转、平移、缩放，以使物品在这些实体手中看起来更好。

• isusing 和 issubmerged 也会改变物品在 GUI 中的模型

例如，通过修改模型文件 ironpickaxe.json，你可以告诉模组当物品被手持时（使用 pommel:isheld）应该显示哪个模型。

提供的持握模型及其纹理可以放在任何位置，只要在物品模型 JSON 文件中指定即可。

JSON 示例：

{
  "parent": "item/handheld",
  "textures": {
    "layer0": "minecraft:item/2d_model_texture"
  },
  "overrides": [
    { "predicate": { "pommel:is_held": 1.0 }, "model": "minecraft:item/my_held_item" },
    { "predicate": { "pommel:is_fixed": 1.0 }, "model": "minecraft:item/my_framed_item" },
    { "predicate": { "pommel:is_head": 1.0 }, "model": "minecraft:item/my_worn_item" },
    { "predicate": { "pommel:is_ground": 1.0 }, "model": "minecraft:item/my_ground_item" },
  ]
}

吃苹果示例：

{
  "parent": "minecraft:item/generated",
  "textures": {
    "layer0": "minecraft:item/apple"
  },
  "overrides": [
    { "predicate": { "pommel:is_held": 1 }, "model": "minecraft:item/held_items/apple_3d" },
    { "predicate": { "pommel:item_use": 0.25 }, "model": "minecraft:item/apple_eat_0" },
    { "predicate": { "pommel:is_held": 1, "pommel:item_use": 0.25 }, "model": "minecraft:item/held_items/apple_eat_0_3d" },
    { "predicate": { "pommel:item_use": 0.50 }, "model": "minecraft:item/apple_eat_1" },
    { "predicate": { "pommel:is_held": 1, "pommel:item_use": 0.50 }, "model": "minecraft:item/apple_eat_1_3d" },
    { "predicate": { "pommel:item_use": 0.75 }, "model": "minecraft:item/apple_eat_2" },
    { "predicate": { "pommel:is_held": 1, "pommel:item_use": 0.75 }, "model": "minecraft:item/apple_eat_2_3d" }
  ]
}

在这个例子中，苹果物品在你吃它时会从 appleeat0 变为 appleeat2。当苹果被握在手中时，它也会变为该物品的 3D 版本，并且在被吃时，手中也会有独特的模型。

你也可以为持握模型指定文件目录以便组织，或者将父模型更改为其他模型。

其他示例

• 额外提示： 如果你使用模组 Arsenal (仅限 1.20.1)，该模组的背部/挂载槽位使用物品展示框的渲染类型。你可以随意使用 pommel:isfixed 来替换背部物品（如下所示），以便显示一个模型而不是物品本身。请注意，物品展示框中的物品也会使用这个相同的模型。 用绿宝石替换了戴在头上的雕刻南瓜。就像模拟人生一样。通过使用 Arsenal (1.20.1) 和 pommel:isfixed 谓词，实现了背上的剑。

常见问题

问：这个模组与 CIT [自定义物品纹理] 兼容吗？

答：CIT Resewn 和 Optifine 都可以工作，只要你使用 CIT 将物品替换为一个物品模型（而不是替换纹理）。CIT 允许你替换物品的模型，所以 Pommel 仍然可以让你拥有自定义的持握模型。

问：这个模组与原版 Minecraft 的物品谓词（如自定义模型数据或弓的拉弦）兼容吗？

答：是的，但请确保你也为 custommodeldata 模型指定了 pommel:is_held。

以下是使用原版物品谓词和持握物品模型的示例：

{
  "parent": "item/handheld",
  "textures": {
    "layer0": "item/base_item"
  },
  "overrides": [
  { "predicate": { "pommel:is_held": 1.0 }, "model": "minecraft:item/base_item_held" },
	{ "predicate": { "custom_model_data": 1 }, "model": "minecraft:item/custom_item" },
	{ "predicate": { "custom_model_data": 1, "pommel:is_held": 1.0 }, "model": "minecraft:item/custom_item_held" }
  ]
}

问：这个模组与 Eating Animation 模组兼容吗？

答：是的，Eating Animation 可以让你在使用 Pommel 时，在吃物品时替换为你选择的模型。

该模组有两个谓词，eating 和 eat（前面没有模组ID），所以你可以将它们与 Pommel 的谓词结合使用。代码将类似于上面的 custommodeldata 示例，但使用 Eating Animation 的谓词。Eating Animation 的页面（以及模组页面上的链接）还有一个视频指南，也会向你展示如何设置！请查看该模组！

答：第二个答案，你也可以使用 pommel:itemuse 达到完全相同的效果，而无需使用 Eating Animation 模组。我并不是想“取代” Eating Animation。相反，创建 itemuse 谓词是因为 Eating Animation 模组与 CIT 存在一些兼容性问题，因此这可以作为一种替代方案。使用 Eating Animation 时，物品模型可能无法正确更改/渲染 CIT 模型，而 Pommel 没有这个问题。

问：如何替换模组物品的持握模型？

答：与 JSON 示例 中的 JSON 层次结构相同，但将前面的 ID minecraft 替换为 。

问：我在让持握模型正常工作时遇到了问题。我该去哪里寻求故障排除帮助？

答：首先检查你的 JSON 代码是否有错误，因为 JSON 代码很容易不小心出错。大多数 IDE 都会检查错误，但也有一些其他网站可以检查。如果你仍然遇到问题，说实话，获得支持的最佳方式是到 Discord 上联系我（用户名是 timmychips），或者在 Github 上提交 Issue 请求！