
Player Doll
创建自定义玩家娃娃,支持动态皮肤加载、多种姿势和动画动作系统。
Player Doll
一个功能丰富的玩家玩偶模组,支持创建和放置自定义玩家玩偶实体。模组提供默认的 Steve 和 Alex 玩偶,并支持从游戏目录动态加载自定义皮肤材质玩偶。此外,模组还拥有强大的姿态与动作系统,允许你为玩偶设置各种静态姿势和动态动画。
✨ 功能特性
核心功能
- 默认玩偶:提供 Steve(粗手臂)和 Alex(细手臂)默认玩偶
- 动态加载:自动从游戏目录扫描并注册自定义皮肤材质玩偶
- 右键放置:使用玩偶物品右键点击方块,放置对应的玩偶实体
- 姿态系统:支持自定义静态姿势配置(站立、坐下、躺下等)
- 动作系统:支持创建动态动画序列(挥手、跳舞等),支持循环播放和关键帧插值
- 模型类型:同时支持粗手臂(Steve)和细手臂(Alex)两种模型类型
📋 环境要求
- Minecraft 版本:1.21.1
- NeoForge 版本:21.1.217 或更高
- Java 版本:21 或更高
安装步骤
- 确保已安装 NeoForge 21.1.217 或更高版本
- 将模组文件(
.jar)放入mods文件夹 - 启动游戏,模组会自动创建必要的配置目录
🎮 玩家指南
基础用法
- 进入创造模式并打开物品栏
- 在“玩家玩偶”标签页中找到玩偶物品
- 手持玩偶物品右键点击方块,即可在旁边放置对应的玩偶实体
添加自定义皮肤玩偶
模组支持从游戏目录自动加载自定义皮肤材质,让你无需修改代码即可添加新的玩偶。
📁 目录位置
自定义皮肤文件应放置在以下目录:
游戏根目录/
└── player_doll/
└── png/ # 自定义皮肤材质目录(首次启动时自动创建)
├── SMy_Character.png
└── A123_ABC__qwe.png
📝 文件命名规则
- 文件名必须以
S或A开头,表示模型类型:S= 粗手臂模型(Steve 模型)A= 细手臂模型(Alex 模型)
- 第一个字符之后的部分将作为玩偶的显示名称
- 名称处理规则:
- 单个下划线
_将被替换为空格 - 双下划线
__将被替换为单个下划线_
- 单个下划线
📊 命名示例
| 文件名 | 模型类型 | 显示名称 | 说明 |
|---|---|---|---|
SMy_Character.png |
粗手臂 | My Character |
单个下划线变为空格 |
A123_ABC__qwe.png |
细手臂 | 123 ABC_qwe |
单个下划线变为空格,双下划线变为单个 |
SHero_Doll.png |
粗手臂 | Hero Doll |
单个下划线变为空格 |
AVillager_Guard.png |
细手臂 | Villager Guard |
单个下划线变为空格 |
🔄 使用流程
- 将皮肤材质 PNG 文件放入
player_doll/png/目录 - 启动游戏或按
F3+T重载资源包 - 模组会自动扫描该目录并注册所有符合规则的 PNG 文件
- 在创造模式物品栏的“玩家玩偶”标签页中找到新注册的玩偶物品
- 使用玩偶物品放置对应的玩偶实体
⚠️ 注意事项
- 文件名的第一个字符必须是
S或A,否则该文件将被忽略 - 文件名长度至少为 2 个字符(首字符 + 至少 1 个字符)
- 仅支持 PNG 格式的图片文件
- 皮肤材质文件应遵循 Minecraft 标准皮肤格式(64x64 或 64x32 像素)
- 不符合规则的文件将被跳过,并记录一条警告日志
- 模组启动时会自动扫描该目录
配置玩偶姿态与动作
模组支持通过 JSON 配置文件自定义玩偶姿态和动作。配置文件位于 player_doll/ 目录下。
📂 配置文件目录结构
游戏根目录/
└── player_doll/
├── png/ # 自定义皮肤材质目录
├── poses/ # 姿态配置文件目录
│ ├── standing.json
│ ├── sitting.json
│ └── ...
├── actions/ # 动作配置文件目录
│ ├── wave.json
│ ├── dance.json
│ └── ...
└── README.md # 详细配置文档
详细的配置说明请参阅 player_doll/README.md 文件,其中包含:
- 姿态文件格式与字段说明
- 动作文件格式与关键帧配置
- 角度参考值与常用姿态示例
- 完整的使用教程与示例
🔄 重载配置
修改配置文件后,按 F3+T 重载资源包即可应用更改,无需重启游戏。
配置选项
模组配置文件位于 config/player_doll_addon-common.toml:
- testMode(测试模式):
- 类型:布尔值
- 默认值:
true - 描述:启用后,输出详细的调试日志,帮助分析皮肤加载和模型识别问题
🐛 常见问题
Q:自定义皮肤不显示?
A:请检查:
- 文件名是否以
S或A开头 - 文件是否为有效的 PNG 格式
- 文件是否放在
player_doll/png/目录中 - 是否按
F3+T重载了资源包 - 查看日志文件中的错误信息
Q:如何修改玩偶姿态?
A:编辑 player_doll/poses/ 目录中的 JSON 文件,或创建新的姿态文件。详细说明请参阅 player_doll/README.md。
Q:如何创建自定义动作?
A:在 player_doll/actions/ 目录中创建 JSON 文件并定义关键帧序列。详细说明请参阅 player_doll/README.md。
Q:模组崩溃了怎么办?
A:
- 检查 Minecraft、NeoForge 和 Java 版本是否匹配
- 查看
logs/目录中的错误日志 - 启用测试模式(
testMode = true)查看详细日志 - 检查配置文件格式是否正确
📄 许可证
本项目采用 MIT License 许可证。
MIT License 是一种宽松的开源许可证,允许:
- ✅ 商业使用
- ✅ 修改
- ✅ 分发
- ✅ 私人使用
唯一的要求是保留版权声明和许可证文本。
完整的许可证文本请参阅 LICENSE 文件。
👤 作者
作者:蓝也(lan_ye)
🇨🇳 中文说明
简介
Player Doll 是一个功能丰富的玩家玩偶模组,支持创建和放置自定义玩家玩偶实体。模组提供了 Steve 和 Alex 的默认玩偶,并支持从游戏目录动态加载自定义皮肤材质玩偶。此外,模组还提供了强大的姿态(Poses)和动作(Actions)系统,让您可以为玩偶设置各种静态姿势和动态动画。
核心功能
- 默认玩偶:提供 Steve(粗手臂)和 Alex(细手臂)的默认玩偶
- 动态加载:从游戏目录自动扫描并注册自定义皮肤材质玩偶
- 右键放置:使用玩偶物品右键方块可以在指定位置放置玩偶实体
- 姿态系统:支持自定义静态姿势配置(如站立、坐下、趴下等)
- 动作系统:支持创建动态动画序列(如挥手、跳舞等),支持循环播放和关键帧插值
- 模型类型:支持粗手臂(Steve)和细手臂(Alex)两种模型类型
快速使用
- 安装要求:Minecraft 1.21.1,NeoForge 21.1.217+,Java 21+
- 基础使用:创造模式 → 物品栏"玩家玩偶"标签 → 右键方块放置
- 自定义皮肤:将 PNG 文件放入
player_doll/png/目录,文件名以S(粗手臂)或A(细手臂)开头,按F3+T重载 - 配置姿态和动作:在
player_doll/poses/和player_doll/actions/目录下创建 JSON 配置文件,详细说明请查看player_doll/README.md
常见问题
- 皮肤不显示:检查文件名是否以 S/A 开头、格式是否正确、是否重载资源包
- 修改姿势:编辑
player_doll/poses/目录下的 JSON 文件 - 创建动作:在
player_doll/actions/目录下创建 JSON 文件定义关键帧 - 模组崩溃:检查版本匹配、查看错误日志、启用测试模式
许可证
本项目采用 MIT License 开源许可证,允许商业使用、修改、分发和私人使用。
最后更新:2025-01-XX
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。