Player Doll

Player Doll

创建自定义玩家娃娃,支持动态皮肤加载、多种姿势和动画动作系统。

装饰

Player Doll

一个功能丰富的玩家玩偶模组,支持创建和放置自定义玩家玩偶实体。模组提供默认的 Steve 和 Alex 玩偶,并支持从游戏目录动态加载自定义皮肤材质玩偶。此外,模组还拥有强大的姿态与动作系统,允许你为玩偶设置各种静态姿势和动态动画。

✨ 功能特性

核心功能

  • 默认玩偶:提供 Steve(粗手臂)和 Alex(细手臂)默认玩偶
  • 动态加载:自动从游戏目录扫描并注册自定义皮肤材质玩偶
  • 右键放置:使用玩偶物品右键点击方块,放置对应的玩偶实体
  • 姿态系统:支持自定义静态姿势配置(站立、坐下、躺下等)
  • 动作系统:支持创建动态动画序列(挥手、跳舞等),支持循环播放和关键帧插值
  • 模型类型:同时支持粗手臂(Steve)和细手臂(Alex)两种模型类型

📋 环境要求

  • Minecraft 版本:1.21.1
  • NeoForge 版本:21.1.217 或更高
  • Java 版本:21 或更高

安装步骤

  1. 确保已安装 NeoForge 21.1.217 或更高版本
  2. 将模组文件(.jar)放入 mods 文件夹
  3. 启动游戏,模组会自动创建必要的配置目录

🎮 玩家指南

基础用法

  1. 进入创造模式并打开物品栏
  2. 在“玩家玩偶”标签页中找到玩偶物品
  3. 手持玩偶物品右键点击方块,即可在旁边放置对应的玩偶实体

添加自定义皮肤玩偶

模组支持从游戏目录自动加载自定义皮肤材质,让你无需修改代码即可添加新的玩偶。

📁 目录位置

自定义皮肤文件应放置在以下目录:

游戏根目录/
└── 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 单个下划线变为空格

🔄 使用流程

  1. 将皮肤材质 PNG 文件放入 player_doll/png/ 目录
  2. 启动游戏或按 F3+T 重载资源包
  3. 模组会自动扫描该目录并注册所有符合规则的 PNG 文件
  4. 在创造模式物品栏的“玩家玩偶”标签页中找到新注册的玩偶物品
  5. 使用玩偶物品放置对应的玩偶实体

⚠️ 注意事项

  • 文件名的第一个字符必须是 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:请检查:

  1. 文件名是否以 S 或 A 开头
  2. 文件是否为有效的 PNG 格式
  3. 文件是否放在 player_doll/png/ 目录中
  4. 是否按 F3+T 重载了资源包
  5. 查看日志文件中的错误信息

Q:如何修改玩偶姿态?

A:编辑 player_doll/poses/ 目录中的 JSON 文件,或创建新的姿态文件。详细说明请参阅 player_doll/README.md。

Q:如何创建自定义动作?

A:在 player_doll/actions/ 目录中创建 JSON 文件并定义关键帧序列。详细说明请参阅 player_doll/README.md。

Q:模组崩溃了怎么办?

A:

  1. 检查 Minecraft、NeoForge 和 Java 版本是否匹配
  2. 查看 logs/ 目录中的错误日志
  3. 启用测试模式(testMode = true)查看详细日志
  4. 检查配置文件格式是否正确

📄 许可证

本项目采用 MIT License 许可证。

MIT License 是一种宽松的开源许可证,允许:

  • ✅ 商业使用
  • ✅ 修改
  • ✅ 分发
  • ✅ 私人使用

唯一的要求是保留版权声明和许可证文本。

完整的许可证文本请参阅 LICENSE 文件。


👤 作者

作者:蓝也(lan_ye)


🇨🇳 中文说明

简介

Player Doll 是一个功能丰富的玩家玩偶模组,支持创建和放置自定义玩家玩偶实体。模组提供了 Steve 和 Alex 的默认玩偶,并支持从游戏目录动态加载自定义皮肤材质玩偶。此外,模组还提供了强大的姿态(Poses)和动作(Actions)系统,让您可以为玩偶设置各种静态姿势和动态动画。

核心功能

  • 默认玩偶:提供 Steve(粗手臂)和 Alex(细手臂)的默认玩偶
  • 动态加载:从游戏目录自动扫描并注册自定义皮肤材质玩偶
  • 右键放置:使用玩偶物品右键方块可以在指定位置放置玩偶实体
  • 姿态系统:支持自定义静态姿势配置(如站立、坐下、趴下等)
  • 动作系统:支持创建动态动画序列(如挥手、跳舞等),支持循环播放和关键帧插值
  • 模型类型:支持粗手臂(Steve)和细手臂(Alex)两种模型类型

快速使用

  1. 安装要求:Minecraft 1.21.1,NeoForge 21.1.217+,Java 21+
  2. 基础使用:创造模式 → 物品栏"玩家玩偶"标签 → 右键方块放置
  3. 自定义皮肤:将 PNG 文件放入 player_doll/png/ 目录,文件名以 S(粗手臂)或 A(细手臂)开头,按 F3+T 重载
  4. 配置姿态和动作:在 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