Craftmark

模组

· 作者 jaquavionbennet

无需编程或复杂配置,即可为物品和方块实体创建数据驱动的纹理变体的实用工具。

0 本站下载 0 关注 更新于 3 个月前

最新 1.5.1 · 1.21.1 · NeoForge

一键开服(送7天)

logo

Craftmark 允许整合包作者根据合成方式为方块赋予不同的外观——用黄铜合成的机器看起来是黄铜材质,用钢合成的看起来是钢材质,正常合成的则保持默认外观。基于实例而非基于方块:两个桶可以并排摆放,却拥有不同的外观。

为什么整合包需要这个功能

你已经在模组间集成了配方——例如由 Create 模组的黄铜制成的存储控制器,或由 Thermal 模组的锭制成的熔炉。配方讲述了这一故事,但方块本身却无法体现这一点。资源包也无能为力:它会重新着色每一个副本,无论其获取方式如何。Craftmark 让外观跟随单个合成的物品:

  • ? 在背包中 — 包括快捷栏、鼠标光标和配方书
  • ✋ 在手握时 — 第一人称和第三人称视角
  • ? 放置在世界中时 — 即时生效,无需重新登录
  • ⛏️ 被破坏并拾起后 — 外观会永久保留
  • ?️ 地面掉落物、物品展示框,甚至破碎粒子都会匹配

如引擎般构建

  • 作者无需编写代码。一个变体 = 一行配方(KubeJS)+ 资源包中与原始纹理路径镜像的 PNG 文件。无需映射文件,无需注册方块。
  • 适用于所有方块实体方块 — 桶、箱子、熔炉,以及实际上所有模组机器,均可自动工作。
  • 无 Mixin。完全基于官方 NeoForge 钩子构建 — 包括 Sodium 系列渲染器所遵循的 model-data 路径。截至 1.2.0 版本,如果你同时运行 Create 模组,则会包含用于动能渲染的 mixin。如果你未安装 Create 模组,1.2.0 版本不会注入任何 mixin。26.x 构建版完全不包含任何 mixin。
  • 附带可用示例 (craftmark:brass 桶) — 一个配方脚本,两分钟内即可看到效果。
  • 与原版物品无法堆叠的变体物品,以及诊断日志,精确显示你的整合包中有多少纹理已匹配成功。

依赖项:NeoForge,客户端和服务端均需安装 — 支持 1.21.1 或 26.1.2–26.2。数据可通过 KubeJs 或 CraftTweaker 等配方编辑器应用,作为任务奖励发放,或直接通过命令给予。

? 我应该下载哪个文件?

  • craftmark-1.5.0.jar — 适用于 Minecraft 1.21.1。完整功能集,包括对 Create 和 Create Aeronautics 的支持。
  • craftmark-1.5.0+26.x.jar — 适用于 Minecraft 26.1.2 和 26.2(一个文件涵盖两者)。+26.x 名副其实:相同的 1.5.0 版本,仅为新版本重新构建 — 无需学习新功能。1.5.0 的所有功能均在此版本中,除了 Create 和 Create Aeronautics 的支持,待这些模组更新后会恢复支持。

将现有的 1.21.1 世界迁移到 26.x?你的方块没问题,但已放置在方块上的外观会被重置 — 请重新放置它们,或重新运行施加它们的命令或配方。

可选依赖项:

  • Create (1.2.0) — 目前仅限 1.21.1
  • Jade (1.4.0)
  • Just Enough Items (1.4.0)
  • Sable & Create Aeronautics (1.5.0) — 目前仅限 1.21.1

可选依赖项会添加新功能,但该模组在没有它们的情况下也能完美运行。

权限:

  • 你可以将此整合包加入你的整合包中,无需许可。
  • 你可以制作插件模组,只要将其列为依赖项即可,无需许可。
  • 你绝对不可以将此模组的文件上传到其他网站。

? 作者文档

变体工作原理

首次启动时,Craftmark 会在你的 Minecraft 实例目录(位于 mods/、config/、saves/ 旁边)创建一个 craftmark_variants/ 文件夹,并预置一个可编辑的 brass 示例:

craftmark_variants/
└── brass/                                   ← 一个文件夹 = 一个变体 (ID: craftmark:brass)
    └── assets/minecraft/textures/block/
        ├── barrel_side.png
        ├── barrel_top.png
        ├── barrel_bottom.png
        └── barrel_top_open.png

在变体文件夹内,你使用与原始纹理完全相同的资源包布局。brass/assets/minecraft/textures/block/barrel_side.png 替换了原版精灵 minecraft:block/barrel_side。规则很简单:在你的变体文件夹下,将 PNG 文件放在原始文件所在的位置。

快速开始(2 分钟 — 无需 KubeJS,无需制作纹理)

brass 文件夹已经存在。开启作弊模式后,运行:

/give @p minecraft:barrel[craftmark:variant="craftmark:brass"]

放置它 — 黄铜桶。它在手中、背包、地面和物品展示框中都是黄铜材质;破坏它后,掉落物会保留其外观,且不会与普通桶堆叠。编辑 craftmark_variants/brass/ 中的 PNG 文件并按 F3+T 即可实时查看更改。

创建你自己的变体

  1. 在 craftmark_variants/ 中创建一个文件夹 — 使用小写字母、数字、_ . -:例如 ruby、steel、diamond… 其 ID 变为 craftmark:<文件夹名>。
  2. 放入纹理文件,其路径需与 assets/ 下的原始资源路径一一对应:
    craftmark_variants/ruby/assets/refinedstorage/textures/block/controller.png
    (覆盖 refinedstorage:block/controller)
  3. 按F3+T重新扫描 — 无需重启即可识别新文件夹。
  4. 使用以下 ID 标记物品:
    /give @p refinedstorage:controller[craftmark:variant="craftmark:ruby"]
  • 仅覆盖所需部分 — 跳过某个面则正常渲染。路径错误会静默保留原始纹理(绝不会显示为紫黑格)。
  • 通过解压源 mod 的 jar 包至 assets/<ns>/textures/ 目录来查找原始路径;在你的文件夹中镜像复制完整路径。
  • 方块类物品会自动复用方块纹理,平面物品贴图也采用相同方式镜像(assets/<ns>/textures/item/…)。

当整个面无法贴图时:逐块覆盖功能 (1.1.0 新增)

 大多数方块都能通过上述文件夹完美替换皮肤 — 只需镜像纹理路径即可完成。但少数方块对某一面使用了共享的通用纹理。一个典型的例子:某台机器的底部纹理是 somemod:block/bottom,而不是 somemod:block/<that-machine>/bottom。如果你按预期镜像路径,则不会生效 — 文件虽然会拼接成功,但该面实际上并未使用它,因此该面仍保持原版状态。

对于那些顽固的面,有一个可选的快捷方式 — 仅在某个面拒绝应用材质时使用。与其去查找纹理路径,不如直接指定方块和面:

craftmark_variants/<variant>/by_block/<block-namespace>/<block-path>/<face>.png

例如,要为 Refine Storage 存储监视器的顽固底面应用 brass 变体:

craftmark_variants/brass/by_block/refinedstorage/storage_monitor/bottom.png

<face> 可以是以下之一:

  • top.png — 顶面
  • bottom.png — 底面
  • front.png — 方块朝向的面(例如熔炉的燃烧面)
  • back.png — 与正面相对的面
  • left.png / right.png — 当你面向正面时,左侧/右侧的面
  • side.png — 同时应用于所有四个水平面

四个水平面是相对于方块正面的,因此贴图会跟随方块的旋转而自动调整 — front.png 始终位于正面。指定面(例如 front.png)的优先级高于 side.png。

需要了解的知识:

  • 仅作用于该单个方块。 它不会“渗漏”到其他共享相同贴图的方块上 — 甚至可以让两个共享同一张纹理的面拥有不同的皮肤。
  • 无需排查路径。 你指定的是面而非底层精灵图,因此共享/通用纹理不再是猜谜游戏。
  • top/bottom 适用于所有方块。front/back/left/right 需要具有水平朝向属性的方块 — 原版方块以及通过 facing 或自定义 direction 属性进行旋转的模组(例如 Refined Storage)均适用;对于没有朝向属性(或垂直放置)的方块,请使用 side.png。
  • 它不覆盖非立方体面(内凹、异形等)— 这些部分仍使用上方的常规文件夹。
  • F3+T 可实时重载,与常规文件夹的操作方式完全一致。

在配方中接入(KubeJS)

命令用于测试;在实际整合包中,你应该标记合成出的产出物,以便玩家获得皮肤。在 kubejs/server_scripts/ 目录下:

ServerEvents.recipes(event => {
    event.shapeless(
        Item.of('refinedstorage:controller', '[craftmark:variant="craftmark:ruby"]'),
        ['refinedstorage:controller', 'mymod:ruby']
    ).id('mypack:ruby_controller');
});

调试你的变体

每次资源(重新)加载时,会为每个找到的变体文件夹记录一行日志:

craftmark: variant craftmark:brass: 4 texture(s) stitched

如果计数低于预期,说明某个路径未匹配成功。F3+T 会重新运行扫描并读取新文件夹。

未来计划

内容更新已于 1.5.0 版本完结。Craftmark 现在也支持 26.1.2 和 26.2,此后将进入维护阶段:修复错误、进行小幅兼容性调整,并在 Create / Create Aeronautics 模组更新后,将对其的支持重新带回 26.x 版本。

如果您发现模组存在错误或有任何建议,请通过 此处的 CurseForge 评论区 或 Discord 服务器 联系我。提交错误报告时,请确保您使用的是该模组的最新版本,并提供重现该错误的步骤。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源