跳到主要内容

rpgmakerFileStructure

RPG Maker MV / MZ 项目的文件结构（尤其是数据层）主要由以下几个部分组成，这里我为你详细拆解每个文件或目录的作用、用途和与 traits 等数据的关系：

📁 项目根目录结构总览​

YourProject/
├── audio/               # 游戏中用到的音效、音乐、语音等
├── data/                # 所有核心数据库数据（JSON格式）
├── fonts/               # 字体文件
├── img/                 # 图片资源（角色、地图、UI等）
├── js/                  # 引擎运行的主脚本（核心代码）
├── movies/              # 视频资源
├── plugins/             # 插件脚本
├── save/                # 存档文件（.rmmzsave）
├── index.html           # 网页启动入口（部署用）
├── package.json         # Electron 包信息（桌面端）
├── game.rmmzproject     # 项目信息（用 RPG Maker 打开用）
└── ...

📁 data/ 目录详解（最关键）​

此目录下的 .json 文件存储了游戏中各类数据库内容，对应 RPG Maker 编辑器中的各个标签页：

文件名对应数据库页签内容描述
Actors.json【角色】所有可控角色的配置：名称、等级、初始装备、特性（traits）、战斗图等
Classes.json【职业】各职业的成长、技能学习表、可装备类型、特性等
Skills.json【技能】所有技能，包含消耗、动画、公式、特性应用等
Items.json【物品】道具和消耗品（非战斗技能）配置
Weapons.json【武器】武器属性、伤害、特性、动画等
Armors.json【护甲】护甲属性、特性等
Enemies.json【敌人】单个敌人的基本属性、攻击、特性等
Troops.json【敌群】多个敌人的组合以及战斗事件
States.json【状态】所有状态（中毒、眩晕等），以及相关图标、效果、持续时间等
Animations.json【动画】战斗动画帧信息（效果动画）
Tilesets.json【图块】地图图块集合
CommonEvents.json【公共事件】可在游戏任何地方调用的通用事件
System.json【系统】包含全局配置（元素表、装备类型、技能类型、初始队伍、开关、变量等）
MapInfos.json地图索引地图ID与名称的索引，用于编辑器显示地图名
MapXXX.json【地图数据】各地图的实际数据（地形、事件等）

📁 img/ 图像资源文件夹（战斗图、头像等）​

路径用途
img/characters/行走图（角色地图移动用）
img/faces/头像图（菜单等显示）
img/sv_actors/战斗图（Sideview 模式使用）
img/sv_enemies/敌人战斗图
img/pictures/事件中显示的图片资源
img/system/UI 图标（IconSet.png）、菜单背景等

📁 js/ 和插件结构​

路径用途
js/plugins.js插件加载表
js/plugins/插件目录：每个 .js 是一个插件
js/rpg_core.js引擎基础类
js/rpg_objects.js数据对象逻辑（如角色、敌人、物品等）
js/rpg_scenes.js场景控制（菜单、战斗等）
js/rpg_windows.js窗口显示控制（菜单栏、状态栏）

🧬 traits 特性使用的 ID 位置说明：​

codedataId 来源说明
11（元素抗性）System.json 中的 elements 数组索引（从 1 开始）
12/21/22/23（参数）固定数字（参考引擎常量）
13/14/32（状态相关）States.json 的状态 ID
31（攻击元素）同上，System.json 中 elements
41/42（技能类型）System.json 中的 skillTypes 数组
43/44（技能）Skills.json 的技能 ID
51/52（装备类型）System.json 中的 weaponTypes / armorTypes
64（队伍能力）System.json 中的 partyAbilities 数组

📘 示例：你有这样一个特性​

{ "code": 64, "dataId": 5, "value": 1 }

你可以在 data/System.json 中找到：

"partyAbilities": [
  "Encounter Half",  // dataId: 0
  "Encounter None",  // 1
  "Cancel Surprise", // 2
  ...
  "Some Ability",    // 5 ← 就是你这个 dataId
]

🛠 想快速查看所有 ID 对应的名称？​

我可以为你写个小工具（Node.js / Python）来解析 System.json、States.json 等并输出 ID 对应的名称表。告诉我你用什么语言方便，我这边就可以生成一个清晰的映射文档给你 ✅

需要生成吗？还是你自己看 .json 文件也 OK？