DDDModelLoader 是一套开箱即用的 3D 角色替换原版游戏2D角色(隐藏方式)的MOD。下载文件自带咕咕嘎嘎一只。有问题加QQ群636479168。
已适配
- ✔️模型自动缩放至角色边框(可自定义模型大小)
- ✔️同步原版角色动画(默认自带基础模型动画,MOD可自定义动画)
- ✔️可播放对应动画声音(需模型MOD支持)
未适配
模型必须是Godot场景(.tscn)且Node3D命名为Armature,模型打包后的文件必须是.pck。可采取两种加载方式:
方式1:pck文件放入mods/DDDModelLoader文件夹下
pck中必须有以下路径文件res://ddd_model_template.json(即ddd_model_loader_template.json放入mod根目录后打包)。


方式2:pck文件放入mods文件夹下
需将ddd_model_template.json放入mods/DDDModelLoader下并重命名(命名尽可能独一无二)。

动画配置(可选)
- 可自定义播放动画,不配置动画默认使用加载器自带动画(自带动画骨骼名使用的是MMD格式通过Blender cats插件转换后的名称)。
- 自定义动画需放在与模型场景下并重命名为AnimationPlayer。
- 需创建如下图的动画(可选添加):


音频配置(可选)
- 在根节点下添加 AudioStreamPlayer(不可使用带有 2D/3D 后缀的节点)并重命名AudioStreamPlayer
- Stream 属性新建 AudioStreamInteractive。
- 音量会自动调整到游戏音效音量。
- 按动画名称添加对应的音频片段(可选添加):


ddd_model__loader_template.json 配置文件
- CameraX / CameraY:相机的俯视和侧视角度(CameraY 填 90 就是看侧脸)。
- ModelOffsetX / Y:如果觉得角色站偏了,用这两个值在画面上微调(单位:像素)。
- MinModelWidth / Height:如果你的模型特别大,把这两个值填大,框架会自动给你分配超大画布防裁切。
{
"model_node_path": "res://模型节点路径.tscn",
"description": "描述",
"author": "作者名",
"model_name": "模型名",
"icon_path": "模型图标(可选)",
"params": {
"camera_x": 5.0,
"camera_y": -80.0,
"model_scale": 1.0,
"model_min_width": null,
"model_min_height": null,
"model_offset_x": 0,
"model_offset_y": 0
}
}