Custom Player Model (CPM)

Custom Player Model

网站：http://cpmmod.top

简介

这个模组允许你使用 JSON 文件自定义玩家模型，同时兼容原版 Minecraft 功能和其他模组。表达式、物理效果与全新的粒子系统相结合，带来了令人难以置信的自定义能力！

安装

目前提供两个版本：1.12.2 和 1.14.4。1.12.2 版本使用 Forge 作为模组加载器，无需任何前置库。1.14.4 版本使用 Fabric 作为模组加载器，并需要 fabric-api 作为前置库。还推荐安装 Mod Menu，这样就能像 Forge 一样通过图形界面调整配置。

安装完成后，将 JSON 模型放入 ".minecraft" 文件夹下名为 "custom-models" 的文件夹中（服务器上则放在与 server.jar 相同的文件夹下）。每个模型条目可以是一个子文件夹，也可以是一个 ZIP 压缩文件。进入游戏后，使用按键绑定（默认为 Ctrl + M）打开游戏内的模型选择界面，也可以通过命令选择模型。

模型制作

每个模型条目可以是一个文件夹，也可以是一个 ZIP 压缩文件。其中必须包含一个名为 "model.json" 的主 JSON 文件。补充纹理都存放在根目录下，并且必须使用 PNG 格式。有关 JSON 架构的更多信息，请参阅维基页面；你也可以下载其他模型作为参考。

命令

/custommodel 是这个模组添加到游戏中的唯一命令。它包含以下子命令：

• reload <player>：从磁盘文件重新加载模型。修改磁盘上的模型后，可以使用此命令重新加载。
• refresh：强制模组刷新模型列表，以便识别你添加到文件夹中的新模型。
• select <model_id> <player>：为玩家选择 ID 为 xxx 的模型。
• list：列出模组已加载的所有模型。之后，你可以点击命令返回的消息来获取模型选择命令。
• clear <player>：清除玩家当前的模型。
• npc <model_id>：此命令用于兼容 Custom Npcs。使用 CPM Male 或 CPM Female 模型创建 NPC 后，运行此命令即可为最近的 NPC 选择模型。

常见问题

我想要一些新功能／发现了错误！

你可以在 GitHub 问题追踪页面提交新问题。也可以通过 QQ 或 Discord 联系我。

这个模组是客户端还是服务端模组？

我会说两者都是。你可以只在客户端安装，这样只有你自己能看到自定义模型；也可以在安装了模组的服务器上使用，让所有安装了此模组的玩家都能看到这些模型。

致谢

• 此模组的灵感来源于 Optifine 和 More Player Models。
• 部分模型来自模组 Touhou Little Maid。
• Minecraft 建模软件 Blockbench。
• squeek502提供的 ASMHelper，为 Core Mod 的开发提供协助。

模组网站: http://cpmmod.top

说明

此模组允许您使用JSON文件自定义玩家模型。不仅仅是方块，更有表达式计算、飘带系统、粒子系统以丰富模型效果，提供极高的可自定义程度。同时，一个编辑良好的模型能够保持与原版动作系统、装备渲染的完美兼容。

安装

现有1.12.2和1.14.4两个版本的模组。1.12.2版本使用Forge加载，不需要前置模组。1.14.4版本使用Fabric加载，需要fabric-api模组作为前置。此外Fabric版本建议使用Mod Menu模组，它可以让您像使用Forge一样使用图形界面调整模组配置文件。

安装完成后，请将JSON模型放在“.minecraft”下名为“custom-models”的文件夹中（如果是服务器，它与server.jar在同一文件夹下）。 一个模型可以是一个文件夹或者一个zip文件，其中包含model.json和其他贴图文件。 在游戏中使用快捷键可以打开模型选择界面（默认为Ctrl+M），或者也可以使用命令选择模型。

建模

每个模型都是一个文件夹或一个zip文件，它必须包含一个名为“model.json”的主JSON文件。贴图文件均存储于根目录，并且必须保存为PNG格式。 有关JSON模式的更多信息，请参考wiki页面，并可下载其他模型文件以供参考。

指令

/custommodel是该mod添加到游戏的唯一指令。它具有以下的子指令：

• reload <player>：从磁盘文件中重新加载模型。 当在游戏运行时修改模型文件后，可以使用此命令重新加载它们。player可省略以为自己重载模型。
• refresh：在游戏运行时添加模型或删除模型后，通知模组刷新模型列表。
• select <model_id> <player>：为玩家player选择ID为model_id的模型。player可省略以为自己选择模型。
• list：列出当前加载的所有模型。 之后通过点击聊天栏的输出内容即可获得模型选择指令。
• clear <player>: 清除玩家当前的模型。如果在配置文件中指定了默认模型，则切换到默认模型。player可省略以清除自己的模型。
• npc <model_id>: 为了兼容自定义NPC模组而提供的指令。当创建了使用CPM Male或CPM Female模型的NPC时，使用此指令可为距离玩家最近的一个NPC选择模型。

此外请注意，如果您加入了一个未安装此模组的服务器，您将无法使用这些指令。此时请使用内置的模型选择界面。

常见问题

我想要一些新功能/报告一些bug！

您可以在Github提出新问题。 或者，可以通过QQ或者Discord与我联系。

这是客户端模组还是服务器模组？

两者都是。 您可以只在客户端安装，这样只有您自己才能看到自定义模型。 或者，您也可以在服务器使用，使每个安装有此模组的每个玩家都能看到新模型。

致谢

• 模组的灵感来源于Optifine和更多玩家模型。
• 部分模型来源于模组车万女仆。
• 方块风格建模软件Blockbench。
• squeek502编写的ASMHelper辅助Core Mod开发。