二次开发 贴图界面 [1.19–26.3] Slimefun 粘液科技材质 v5 | PC/FCL + Geyser | ItemsAdder 与盔甲修复 5.0.0

粘液科技 Slimefun 材质适配包 v5

面向 Slimefun 服务器的 Java PC、FCL 手机 Java 与 Geyser 基岩材质适配整合包。v5 重新整理了资源结构，重点修复 ItemsAdder 混用时的紫黑块/绿色长条、Java 资源列表版本不兼容，以及新版盔甲只有图标却没有穿戴外观的问题。

版本：v5.0.0 / 2026-10-04

Java 客户端材质覆盖 1.19–26.3，按 18 个资源格式区间分包；已联测后台为 Paper 1.21.11 / 26.2。客户端材质支持范围与服务端插件支持范围请分别确认。

下载内容

下载方式：点击本资源页上方的“下载”按钮，获取 v5 完整包。

下载文件：Slimefun-v5-公开完整版.zip。外层 ZIP 解压后，按“安装说明.md”选择和安装所需组件。

• Java/：PC 18 个、FCL 18 个分版 ZIP，共 36 个。选择客户端版本对应的一个包。
• 服务端插件/SlimefunTextureBridge-5.0.0.jar：Slimefun 物品与新版盔甲外观桥接。
• Geyser-Spigot/extensions/SlimefunGeyserMappings-5.0.0.jar：限定编号范围的基岩映射扩展。
• Geyser-Spigot/packs/Slimefun-v5.mcpack：基岩资源包。
• item-models.yml、映射目录、ItemsAdder 合并工具、Slimefun 配置合并工具、开发源码及校验清单。

公开附件不包含测试服务器、ItemsAdder 商业插件、授权配置或世界存档；服务器插件和对应依赖请自行准备。

v5 修复与变化

• 修复 ItemsAdder 资源冲突：合并物品分支和原版回退，保留字体、shader、私有命名空间与弓弩状态；遇到无法安全处理的冲突会停止并生成说明。
• 修复版本标识与资源结构：按实际客户端格式拆分，新版采用对应的物品定义与装备资源目录。
• 修复 PNG CRC、贴图边缘及模型引用；PC 保留三维物品，FCL 简化可转换的复杂模型。
• 增加 146 件盔甲装备定义，通过桥接关联原版模型与装备资源，保留原有物品属性及装备组件其他字段。
• Geyser 不再部署旧阈值 JSON，改由扩展限制 CMD 匹配范围，避免吞掉其他插件的高编号物品。
• Geyser 现有 2369 个材质/编号组合，CMD 与独立模型共 4738 条注册；146 件盔甲对应 292 个 attachable，77 张去重装备纹理。
• 普通头颅和地毯不误继承装备组件，避免可堆叠物品被当作装备注册时报错。

Java PC / FCL 安装

按客户端版本从 Java/ 选择 PC 或 FCL ZIP，放入 .minecraft/resourcepacks 并启用；不要解压该内层 ZIP，也不要同时启用旧版粘液包。

FCL 是手机 Java 包，不能导入基岩版；部分复杂物品的持握外观会简化为平面图标。

服务端先备份并同步 plugins/Slimefun/item-models.yml。新服可用随附配置，已有私人附属编号的服使用合并脚本保留自己的条目和注释。将 SlimefunTextureBridge-5.0.0.jar 放入 plugins，移出旧桥接 JAR 后重启。使用 /sftexture status 检查，管理员可用 /sftexture repair 检查当前背包。

新版自定义盔甲穿戴需要桥接补齐资源关联；单独启用材质包不会自动给物品添加关联。旧客户端穿戴仍需要对应版本支持 type=armor 的 CIT 实现，仅支持图标的 CIT 模组不保证支持盔甲。

ItemsAdder 整合

安装 Node.js 后，使用自己服务器最新 iazip 输出，在本包解压目录运行：


手机 Java 将 Edition 改为 FCL。核对输出报告后，把合并结果设为服务器实际下发包，更新 URL/文件及 SHA1。每次 iazip 后都需重新合并，不能只叠放两个冲突 ZIP。

ItemsAdder 4.0.18 联测输出最低格式为 32，不能直接整合到 1.19–1.20.4；这些客户端需要真正支持旧格式的 ItemsAdder 输出。独立粘液旧版包仍可按对应版本使用。私有物品同材质/编号冲突需同步调整服务端配置和资源，不承诺任意私有资源都自动兼容。

Geyser 安装

1. 停服并备份 plugins/Geyser-Spigot。
2. 把本包 Geyser-Spigot/extensions 下的扩展 JAR 复制到服务器同名目录；扩展不能放到 plugins 根目录。
3. 把 Geyser-Spigot/packs/Slimefun-v5.mcpack 复制到服务器同名目录。
4. 移出旧粘液 JSON、旧粘液 mcpack 和重复扩展，保留其他插件文件。v5 不需要 Slimefun-geyser_mappings.json。
5. 在 Geyser config.yml 确认如下配置并重启：

基岩玩家重新进服下载；仍显示旧材质时清理该服务器资源包缓存。使用当前 Geyser 支持的基岩版本，Java 1.19 的支持范围不代表历史基岩 1.19 也能连接。

Java 版本对照

以下每个区间均提供 PC/FCL 两个 ZIP；按客户端版本选，具体文件名见附件“版本对照.md”。

• 1.19-1.19.2：资源格式 9.0
• 1.19.3：资源格式 12.0
• 1.19.4：资源格式 13.0
• 1.20-1.20.1：资源格式 15.0
• 1.20.2：资源格式 18.0
• 1.20.3-1.20.4：资源格式 22.0
• 1.20.5-1.20.6：资源格式 32.0
• 1.21-1.21.1：资源格式 34.0
• 1.21.2-1.21.3：资源格式 42.0
• 1.21.4：资源格式 46.0
• 1.21.5：资源格式 55.0
• 1.21.6：资源格式 63.0
• 1.21.7-1.21.8：资源格式 64.0
• 1.21.9-1.21.10：资源格式 69.0
• 1.21.11：资源格式 75.0
• 26.1-26.1.2：资源格式 84.0
• 26.2：资源格式 88.0
• 26.3：资源格式 97.1

测试范围与限制

• 36 个 Java ZIP 的资源格式、JSON、PNG CRC 和引用检查通过；两套实际后台完成 2369 项物品目录、146 件装备关联和 Geyser 边界检查。
• 两次真实 ItemsAdder 4.0.18 生成资源完成 48 次分版合并检查；协议客户端 1.19.4、1.21.11、26.1 完成登录和物品数据检查。
• 上述自动验证未包含 Java 图形画面、FCL 真机和基岩穿戴画面，也未逐个实测全部附属。遇到问题请附服务端、客户端、相关插件版本、物品 ID 和日志，便于复现。
• 联测为 Slimefun 2026.07-release、ItemsAdder 4.0.18、Geyser 2.11.3-b1247；这组插件在 26.3 后台未通过。使用匹配自己后台的插件与依赖，勿将客户端资源兼容当作插件兼容。
• 原素材缺失的物品保留原版外观；没有逐个运行全部附属。动态世界头颅受服务器皮肤数据影响，菜单图标适配不等于所有世界自定义方块已转换。
• ItemsAdder 自定义基岩内容仍需它自己的映射和资源。桥接没有全量扫描离线容器、生物或盔甲架，不声明 Folia 支持。

来源与鸣谢

基于原 Slimefun Resourcepack 素材二次修复与适配，原 Credits 保留。本项目并非 Slimefun 官方发布。

上游项目：Slimefun Resourcepack 上游项目

原素材权利归各原作者，上游标为 ARR；本包不将原素材改标为自由商用或 MIT。完整作者名单及归属见附件“素材来源与鸣谢.md”。

更新记录

v5.0.0 / 2026-10-04：重新实现版本分包、ItemsAdder 合并、新版盔甲桥接与 Geyser 扩展映射；完整变更见附件“更新说明.md”。

旧版本历史：v3.0.4-bedrock / 2026-06-10，v2026.06.10-java。升级步骤见附件“旧版升级步骤.md”。