TACZ：高级皮肤系统（NEOFORGE）

TACZ：高级皮肤系统（MCPSkins）

TACZ 的武器库。 解锁皮肤并将其应用到任何枪械上。

功能简介

MCPSkins 在 TACZ-1.21.1 之上添加了一个皮肤层。皮肤会改变武器的渲染方式——纹理、物品栏图标、HUD 图标、远距离模型或整个 3D 模型——而不会改变武器本身。没有重复物品，不会丢失配件，不使用 NBT 技巧。适用于任何已注册的 GunId，无论是官方还是第三方枪械包。

• 重新绘制纹理，或在复用基础武器动画的同时更换整个几何模型
• 可选的自定义物品栏图标、HUD 图标（包括空弹匣变体）和低细节 LOD 模型
• 可选的稀有度、收藏集、描述和新品徽章，用于浏览和筛选

皮肤包

将文件夹或 .zip 文件放入运行世界的任意端的 mcpskins/ 目录中，然后执行 /reload。无需 pack.mcmeta，无需资源包，无需数据包，可在已进行中的世界中直接使用。

玩家无需安装任何内容。美术资源会在渲染的瞬间从服务器流式传输到每个客户端。

两种浏览方式

皮肤军械库 — 全屏目录，支持搜索、已拥有/未解锁和拥有 3D 模型筛选、排序，以及可拖拽旋转的预览台，展示真实武器。按 K 键（可重新绑定）或使用 /mcpskins armory 命令打开，空手即可使用。

改装轮播 — 嵌入 TACZ 自带改装界面中的紧凑皮肤条，用于更换手中的武器。支持拖拽放置定位。

在两种界面中，未解锁的皮肤都会在真实模型上实时预览，且完全在客户端进行。

所有权

已解锁的皮肤存储在服务器端：死亡后保留，登录和重生时同步，且无法被伪造。可通过命令授予，或发放实体解锁物品——可交易、可丢弃，工具提示会显示其中的具体内容。对一叠重复物品按住 Shift 右键点击，可将它们合成升阶，优先选择玩家未拥有的皮肤。

稀有度等级、合成路线、掉落权重和花费全部定义在皮肤包中，因此皮肤包自带成长体系，无需匹配服务器配置。开箱即用支持从普通到传说的等级；可自由添加、重命名或重新调整路线。

---

添加皮肤

my_skinpack/data/<namespace>/skins/m4a1.json

{
  "base_gun": "tacz:m4a1",
  "skins": [
    {
      "id": "m4a1_cobra",
      "name": "眼镜蛇",
      "label_color": "0xFF5533",
      "rarity": "rare",
      "collection": "蛇之套装",
      "description": "迅捷出击，悄然制胜。",
      "is_new": true
    }
  ]
}

my_skinpack/assets/mcpskins/textures/skins/tacz/m4a1/m4a1_cobra.png

name 和 label_color 以下的所有字段均为可选。皮肤 ID 是全局的，因此请命名为 <武器>_<皮肤>。

完整文档与 Wiki — 包含皮肤包布局、完整模式、3D 模型和 LOD 美术、所有命令和配置选项以及故障排除。

命令

/mcpskins give skin <玩家> <皮肤ID>    解锁一个皮肤
/mcpskins give item <玩家> <皮肤ID>    给予一个实体解锁物品
/mcpskins give all  <玩家>             解锁所有皮肤
/mcpskins take skin <玩家> <皮肤ID>    移除一个皮肤
/mcpskins take skins <玩家>            清除所有皮肤
/mcpskins armory [皮肤ID]              打开军械库（无需权限）

give/take 需要管理员权限（等级可配置）。皮肤 ID 支持 Tab 补全，并会针对实时注册表进行验证。

环境要求

Minecraft	1.21.1
加载器	NeoForge 21.1.233+
必需	TACZ（MUKSC 分支），neoforge/1.21.1 分支，客户端和服务器
另需	至少一个 TACZ 枪械包——MCPSkins 本身不添加任何枪械

注意事项

• 专门为 MUKSC NeoForge 移植版构建。完整的 3D 模型替换功能挂钩到该分支的模型加载器中；在其他构建版本上，这些功能会自动停用而非崩溃。
• 替换模型必须与基础武器的骨骼名称保持一致。若不匹配则回退到基础几何体；若 LOD 损坏则回退到完整细节模型。
• 服务器端的美术托管使皮肤无需包含在整合包下载中。这不是 DRM——只要是客户端能渲染的内容，决心足够强的客户端就能提取出来。
• 失败时会在日志中输出一行可读信息，前缀为 [MCPSkins]。请在错误报告中包含该信息，以及你的 TACZ 和枪械包版本。

采用 MIT 许可证——可在任何公开或私人的整合包中使用。