Pokémon Essentials 开源项目使用教程

1. 项目概述

Pokémon Essentials 是一个基于 RPG Maker XP 的修改项目，旨在使游戏玩法类似于 Pokémon 游戏。该项目并非完整的游戏项目本身，而是需要添加到现有的 RMXP 游戏项目中才能使用。项目基于 Essentials v21.1 版本构建，采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议。

2. 项目目录结构及介绍

Pokémon Essentials 项目包含以下主要目录和文件：

核心目录结构

pokemon-essentials/
├── Data/ (游戏核心数据文件)
├── Fonts/ (游戏字体文件)
│   ├── power clear bold.ttf
│   ├── power clear.ttf
│   ├── power green narrow.ttf
│   ├── power green small.ttf
│   ├── power green.ttf
│   ├── power red and blue intl.ttf
│   ├── power red and blue.ttf
│   └── power red and green.ttf
├── PBS/ (游戏配置数据文件)
│   ├── Gen 5-8 backup/ (各世代备份数据)
│   ├── Shadow Pokémon backup/ (暗影宝可梦数据)
│   ├── abilities.txt (特性数据)
│   ├── items.txt (道具数据)
│   ├── moves.txt (招式数据)
│   ├── pokemon.txt (宝可梦数据)
│   └── trainers.txt (训练家数据)
├── Text_english_core/ (英文文本文件)
│   ├── ABILITY_DESCRIPTIONS.txt (特性描述)
│   ├── ITEM_DESCRIPTIONS.txt (道具描述)
│   ├── MOVE_DESCRIPTIONS.txt (招式描述)
│   └── SPECIES_NAMES.txt (宝可梦名称)
├── Game.exe (游戏可执行文件)
├── mkxp.json (MKXP 配置文件)
├── scripts_combine.rb (脚本合并工具)
├── scripts_extract.rb (脚本提取工具)
├── animmaker.exe (动画制作工具)
└── soundfont.sf2 (声音字体文件)

主要配置文件说明

PBS 目录包含游戏的配置文件：

• abilities.txt：定义宝可梦特性及其效果
• items.txt：定义游戏中的道具和物品
• moves.txt：定义宝可梦招式和技能
• pokemon.txt：定义宝可梦的基础属性和进化信息
• trainers.txt：定义训练家数据和队伍配置

Text_english_core 目录包含游戏的文本文件：

• 支持多语言文本定义
• 包含宝可梦名称、描述、对话等内容
• 便于本地化和翻译项目

3. 项目安装和使用

环境要求

• RPG Maker XP 基础项目
• Ruby 运行环境（用于脚本处理）

安装步骤

1. 获取 Essentials v21.1 从官方渠道获取 Pokémon Essentials v21.1 基础版本

2. 克隆仓库

   git clone https://gitcode.com/gh_mirrors/po/pokemon-essentials
   

3. 替换文件 将克隆的仓库文件复制到 Essentials v21.1 文件夹中，替换现有文件

4. 脚本处理 项目使用分离的脚本文件系统，位于 Data/Scripts/ 目录

脚本管理工具

项目提供两个 Ruby 脚本用于脚本管理：

scripts_extract.rb - 从 Scripts.rxdata 提取脚本到单独文件

• 将脚本备份到 ScriptsBackup.rxdata
• 创建仅加载脚本的 Scripts.rxdata 版本

scripts_combine.rb - 将单独脚本文件重新整合到 Scripts.rxdata

• 保持脚本文件结构不变
• 生成完整的脚本数据文件

使用方法：

ruby scripts_extract.rb   # 提取脚本
ruby scripts_combine.rb   # 合并脚本

4. 开发功能说明

脚本系统

脚本不再存储在 Scripts.rxdata 文件中，而是提取到 Data/Scripts/ 目录的单独文件中，便于版本控制和协作开发。脚本按字母数字顺序加载，支持文件夹层级结构。

多世代支持

项目包含第5代到第8代宝可梦数据的备份文件，支持多世代宝可梦游戏开发。

工具集

• animmaker.exe：动画制作工具，用于创建游戏动画
• extendtext.exe：文本扩展工具，用于处理游戏文本
• townmapgen.html：城镇地图生成工具

5. 开发注意事项

1. 许可证遵守：项目采用 CC BY-NC-SA 4.0 许可证，禁止商业使用
2. 文件排除：Audio、Graphics、Plugins 等目录不被包含在版本控制中
3. 脚本管理：建议使用提供的脚本工具进行脚本提取和合并操作
4. 多语言支持：通过 Text_english_core 目录可实现多语言本地化

脚本提取工具界面 字体文件示例 游戏使用的特殊字体

通过这个项目结构，开发者可以基于 Pokémon Essentials 构建自己的同人游戏或修改项目，同时能够方便地获取项目更新和改进。