Cloyir/pokeemmo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

说明文档重新汉化

Browse Source
This commit is contained in:
RoamerX 2025-06-28 22:47:17 +08:00
parent a929a69962
commit 79171b28cb
9 changed files with 622 additions and 494 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

259
.github/README.md vendored
View File

@ -1,15 +1,20 @@
# pokeemerald-expansion-Chinese # 关于pokeemerald-expansion-Chinese
pokeemerald-expansion-Chinese是基于ROM Hacking Hideout的[pokeemerald-expansion](https://github.com/rh-hideout/pokeemerald-expansion/)项目的中文汉化项目。 ‌**`pokeemerald-expansion-Chinese`**‌ 是基于ROM Hacking Hideout的[`pokeemerald-expansion`](https://github.com/rh-hideout/pokeemerald-expansion)项目的中文汉化项目。该项目的详细说明请见[关于`pokeemerald-expansion`](#关于`pokeemerald-expansion`)。
更改内容包括： **本项目主要面向使用反编译方式进行改版的开发者，并非对于原作宝可梦绿宝石的汉化，也并不是一个可以独立游玩的宝可梦游戏。**
- 汉化了项目中几乎所有的文本、含文字的图片(包括原版与expansion新增的部分)，并修改了与汉化后文字展示相关的代码。原版游戏脚本文本主要使用2011年发布的由漫游&TGB联合汉化的口袋妖怪绿宝石的文本。 汉化内容包括：
- 修正原汉化文本单行字数溢出换行及换行符数量超标导致的文字显示不全的问题。
- 统一游戏内文本的译名及标点使用，专有名词及常用功能文本参照最新官方正作简体中文版译名及神奇宝贝百科的民间译名。
- 按照绿宝石日文版还原了一部分包括标题画面、读取存档及部分细节功能的内容。
注：本项目不包含对于expansion项目的优化及新功能开发。 - 参照2011年发布的由漫游&TGB联合汉化的口袋妖怪绿宝石汉化了游戏内的所有文本及文本图片，修改了部分与汉化后文字展示相关的代码。
- 汉化了项目内绿宝石原有的及expansion新增的全部的宝可梦、道具、特性、招式、属性、性格、异常状态等资料内容，译名参照目前官方正作简体中文的译名，并对提及了以上内容的所有游戏内文本进行了统一修正。
- 重新汉化了游戏内的大量文本，包括但不限于：城镇等地点名称、重要角色及普通NPC训练家的名称及所有对话，主线剧情及功能性NPC相关对话，华丽大赛、对战开拓区、联机俱乐部等设施的说明及其他文本，开拓区徒弟NPC、电视节目以及对战寻呼文本，以及例如“训练家”、“招式”、“培育屋”等游戏系列的专有名词文本。译名绝大部分参照目前官方正作简体中文及神奇宝贝百科的译名，并对提及了以上内容的所有游戏内文本进行了统一修正。
- 优化原本汉化版中的大量文本，包括但不限于：修正原汉化文本单行字数溢出换行的问题，换行符数量超标导致的文字显示不全的问题，统一游戏内文本的译名及标点使用，规范游戏内阿拉伯数字及汉字数字的使用，并对对话文本换行位置不当影响观感的情况进行了一定优化。
- 汉化了expansion项目新增的包括对战系统更新、图鉴、宝可梦跟随、测试debug等各项新增功能的全部相关文本，其中对战系统内的文本严格参照目前官方正作简体中文的翻译。
- 对于游戏内的easychat系统进行了汉化，对词库内短语进行了汉化并进行了一定程度的替换，对对战开拓区等使用easychat系统的NPC训练家的对话采用短语重拼的方式进行了汉化。
- 重新制作了标题logo，按照绿宝石日文版还原了一部分包括标题画面、读取存档及部分细节功能的内容。
注：本项目不包含对于expansion项目的优化及新功能开发。项目内的所有汉化文本可供宝可梦正作及改版汉化参考及使用，欢迎注明出处。
汉化人员名单（不分先后）： 汉化人员名单（不分先后）：
@ -19,239 +24,63 @@ pokeemerald-expansion-Chinese是基于ROM Hacking Hideout的[pokeemerald-expansi
- 日文翻译及日版功能还原：SKT - 日文翻译及日版功能还原：SKT
- 程序支持：明雅，墟芜，卧看微尘 - 程序支持：明雅，墟芜，卧看微尘
- 测试BUG反馈：摆烂 - 测试BUG反馈：摆烂
- 标题LOGO绘制：大神丶橡皮
感谢大家的努力与贡献！ 感谢大家的努力与贡献！
也感谢之前于2011年发布的漫游&TGB联合汉化的绿宝石汉化版的参与人员： 也感谢之前于2011年发布的漫游&TGB联合汉化的绿宝石汉化版的参与人员： 飞眼，enler，胡里胡涂，ルナ，零度雨，灰米，绿叶枫，yeyezai，lazybone，雪山肥壶，信天翁，爱姿病，troy1229，夜露死苦，阿宝，lioyy，凛，酷酷的安仔，空白君，AISU，吾鱼（小黑屋）
飞眼，enler，胡里胡涂，ルナ，零度雨，灰米，绿叶枫，yeyezai，lazybone，雪山肥壶，信天翁，爱姿病，troy1229，夜露死苦，阿宝，lioyy，凛，酷酷的安仔，空白君，AISU，吾鱼（小黑屋）
# 以下是pokeemerald-expansion项目的Readme文件翻译： ------
## pokeemerald-expansion # 关于`pokeemerald-expansion`
pokeemerald-expansion是基于pret的[pokeemerald](https://github.com/pret/pokeemerald)反编译项目的一个***ROM改版蓝本***。***它不是一个可玩的ROM改版***，但它为ROM修改者提供了多种功能，以便他们可以创建自己的游戏，因此它本身不是用来单独游玩的。 ![Gif that shows debugging functionality that is unique to pokeemerald-expansion such as rerolling Trainer Id, Cheat Start, PC from Debug Menu, Debug PC Fill, Pokemon Sprite Visualizer, Debug Warp to Map, and Battle Debug Menu](https://github.com/user-attachments/assets/cf9dfbee-4c6b-4bca-8e0a-07f116ef891c) ![Gif that shows overworld functionality that is unique to pokeemerald-expansion such as indoor running, BW2 style map popups, overworld followers, DNA Splicers, Gen 1 style fishing, OW Item descriptions, Quick Run from Battle, Use Last Ball, Wild Double Battles, and Catch from EXP](https://github.com/user-attachments/assets/383af243-0904-4d41-bced-721492fbc48e) ![Gif that shows off a number of modern Pokemon battle mechanics happening in the pokeemerald-expansion engine: 2 vs 1 battles, modern Pokemon, items, moves, abilities, fully customizable opponents and partners, Trainer Slides, and generational gimmicks](https://github.com/user-attachments/assets/50c576bc-415e-4d66-a38f-ad712f3316be)
## 我应该使用它还是原版的pokeemerald作为我的改版蓝本？ ‌**`pokeemerald-expansion`**‌ 是一个GBA ROM改版蓝本，它为开发者提供了一个全面的工具包，用于创建宝可梦ROM改版。‌**`pokeemerald-expansion`**‌ 是基于[pret的`pokeemerald`](https://github.com/pret/pokeemerald)反编译项目构建的。‌**它本身并不是一个可以独立游玩的宝可梦游戏。**‌
使用原版pokeemerald作为基础的主要优势是能够与其他官方的GBA《宝可梦》游戏进行联机战斗和交换。而pokeemerald-expansion则开箱即支持与同版本游戏进行战斗和交换。如果你不介意失去与原版完全兼容的能力，我们建议使用pokeemerald-expansion。否则，请使用pret的pokeemerald。你仍然可以获得pret提供的文档改进，因为我们定期合并pret的文档更改。 # [功能](FEATURES.md)
## 使用pokeemerald-expansion ‌**`pokeemerald-expansion`**‌ 提供了来自各种[宝可梦正作游戏系列](https://bulbapedia.bulbagarden.net/wiki/Core_series)的数百种功能，以及旨在简化开发流程并提升玩家体验的热门生活质量改进。这些功能的完整列表请见[`FEATURES_ZH.md`](FEATURES_ZH.md)。
如果你在你的改版中使用了pokeemerald-expansion，请在制作人员名单中添加RHH（Rom Hacking Hideout）。可选地，你可以列出使用的版本，这样可以帮助玩家了解可以期待哪些功能。 # [致谢](CREDITS.md)
你可以这样表述： [![](https://img.shields.io/github/all-contributors/rh-hideout/pokeemerald-expansion/upcoming)](CREDITS.md)
如果您使用了‌**`pokeemerald-expansion`**‌，请注明出处为‌**RHH (Rom Hacking Hideout)**‌。可以选择额外注明版本号。
``` ```
基于RHH的pokeemerald-expansion 1.11.1 https://github.com/rh-hideout/pokeemerald-expansion/ 基于RHH的pokeemerald-expansion 1.12.0 https://github.com/rh-hideout/pokeemerald-expansion/
``` ```
请考虑[致谢](CREDITS.md)项目中的所有贡献者！
# 选择`pokeemerald` 还是 **`pokeemerald-expansion`**
***重要提示***：不要使用GitHub的“Download Zip”选项。使用这个选项将无法下载更新你的扩展版本或合并其他功能分支所需的提交历史。相反，请阅读[此指南](https://github.com/Pawkkie/Team-Aquas-Asset-Repo/wiki/The-Basics-of-GitHub)以了解如何分叉存储库并从那里本地克隆。 - ‌**`pokeemerald-expansion`**‌ 支持与其他基于 ‌**`pokeemerald-expansion`**‌ 构建的游戏进行多人游戏功能。它与官方宝可梦游戏不兼容。
- 如果重视与官方游戏的兼容性，请使用[`pokeemerald`](https://github.com/pret/pokeemerald)作为蓝本。否则，我们建议使用 ‌**`pokeemerald-expansion`**‌。
- ‌**`pokeemerald-expansion`**‌ 整合了来自`pokeemerald`的定期更新，包括错误修复和文档改进。
请按照`INSTALL.md`中的说明在你的机器上设置pokeemerald-expansion。 # [开始](INSTALL.md)
### 如果我已经有一个基于原版pokeemerald的项目，我可以使用pokeemerald-expansion吗？ ❗❗ ‌**重要提示**‌：不要使用GitHub的“Download Zip”选项，因为它不包含提交历史。如果你想更新或合并其他功能分支，这是必不可少的。
可以！请注意，我们紧跟pret对pokeemerald的文档更新，这意味着如果你的项目有点旧，你可能会遇到需要手动解决的合并冲突。 如果你是git和GitHub的新手，[Team Aqua的资源仓库](https://github.com/Pawkkie/Team-Aquas-Asset-Repo/)提供了一个[关于fork和clone仓库的指南](https://github.com/Pawkkie/Team-Aquas-Asset-Repo/wiki/The-Basics-of-GitHub)。然后，你可以按照以下指南之一进行操作：
- 如果你还没有设置远程仓库，请运行命令`git remote add RHH https://github.com/rh-hideout/pokeemerald-expansion`。 ## 📥 [安装**`pokeemerald-expansion`**](INSTALL_ZH.md)
- 一旦你设置了远程仓库，请运行命令`git pull RHH master`。 ## 🏗️ [构建**`pokeemerald-expansion`**](INSTALL_ZH.md#构建 pokeemerald-expansion)
## 🚚 [从**`pokeemerald`**迁移](INSTALL_ZH.md#从 pokeemerald 迁移)
## 🚀 [升级**`pokeemerald-expansion`**](INSTALL_ZH.md#更新 pokeemerald-expansion)
这样，你将获得pokeemerald-expansion的最新版本，以及一些尚未发布到下一个补丁版本中的bug修复。 # [文档](https://rh-hideout.github.io/pokeemerald-expansion/)
## 文档 详细说明文档，请见[pokeemerald-expansion文档页](https://rh-hideout.github.io/pokeemerald-expansion/)。
[请点击此处访问我们的文档页面。](https://rh-hideout.github.io/pokeemerald-expansion/) # [贡献](CONTRIBUTING.md)
如果您想要[报告bug](CONTRIBUTING.md#Bug-Report)，[新建拉取请求](CONTRIBUTING.md#Pull-Requests)，或者[请求新功能](CONTRIBUTING.md#Feature-Request)，我们的[`CONTRIBUTING_ZH.md`](CONTRIBUTING_ZH.md)文件中有针对每一项的指南。
## ***如何更新我的pokeemerald-expansion版本？*** # [社区](https://discord.gg/6CzjAG6GZk)
- 如果你还没有设置远程仓库，请运行命令`git remote add RHH https://github.com/rh-hideout/pokeemerald-expansion`。 [![](https://dcbadge.limes.pink/api/server/6CzjAG6GZk)](https://discord.gg/6CzjAG6GZk)
- 检查你的当前版本。
- 你可以在调试菜单的`Utilities -> Expansion Version`选项中检查。
- 如果该选项不可用，你可能拥有的是1.6.2或更早的版本。在那种情况下，请查看[更改日志](docs/CHANGELOG.md)以确定你的版本，基于你仓库中可用的功能。
- ***重要提示***：如果你落后了几个版本，我们建议你一次更新一个小版本，而不是直接跳到最新的补丁版本（例如，1.5.3 -> 1.6.2 -> 1.7.4等等。查看[在线文档网站](https://rh-hideout.github.io/pokeemerald-expansion/CHANGELOG.html)以查看每个步骤的最新版本。）
- 一旦你设置了远程仓库，请运行命令`git pull RHH expansion/X.Y.Z`，将X、Y和Z替换为你想要更新到的相应版本的数字（例如，要更新到1.11.1，请使用`git pull RHH expansion/1.11.1`）。
- 另外，你可以更新到扩展的未发布版本。
- ***master（稳定版）***：它包含将在下一个补丁版本中发布的***bug修复***。要合并，请使用`git pull RHH master`。
- ***upcoming（不稳定版，可能存在bug）***：它包含将在下一个小版本中发布的***功能***。要合并，请使用`git pull RHH upcoming`。
### 请考虑在你的项目中鸣谢整个[贡献者名单](https://github.com/rh-hideout/pokeemerald-expansion/wiki/Credits)，因为他们都为开发这个项目付出了辛勤的努力 :) 我们的社区使用[Rom Hacking Hideout (RHH) Discord服务器](https://discord.gg/6CzjAG6GZk)来进行沟通和组织活动。我们的大部分讨论都在那里进行，欢迎任何人加入我们！
## 谁在维护这个项目？
这个项目最初是由DizzyEgg与其他贡献者一起启动的。现在它由ROM Hacking Hideout社区中的一个团队“Expansion Senate”维护。ROM Hacking Hideout（简称RHH）是一个基于Discord的ROM修改社区，专门研究《宝可梦》ROM改版。关于项目开发的大部分讨论都在那里进行。
[点击此处加入RHH Discord服务器！](https://discord.gg/6CzjAG6GZk)
## 项目中有一个bug。我该如何让你们知道？
请在此[提交](https://github.com/rh-hideout/pokeemerald-expansion/issues)项目的任何问题，并确保在提交之前使用过滤器搜索，确认问题尚未被其他人报告。你也可以加入Discord服务器，以尝试从团队和其他服务器成员那里获得更深入的支持。
## 即使我不是ROM Hacking Hideout的成员，我也可以贡献吗？
可以！欢迎通过Pull Request进行贡献，它们将由维护者及时审查。
此外，请遵循Pull Request模板，并随时讨论如何处理审查。***沟通是关键！***如果我们花了一些时间来审查你的PR，请不要感到气馁，我们会处理的。
## 包含了哪些功能？
- ***重要❗❗ 阅读以下内容以了解你可以切换哪些功能***：
- [战斗配置](../include/config/battle.h)
- [宝可梦配置](../include/config/pokemon.h)
- [物品配置](../include/config/item.h)
- [大地图配置](../include/config/overworld.h)
- [调试配置](../include/config/debug.h)
- ***升级的战斗引擎***
- 第五世代及以后的伤害计算方式。
- 支持2v2野外战斗。
- 支持1v2/2v1战斗。
- 妖精属性（可配置）。
- 物理/特殊/变化招式划分（可配置）。
- 新增直至朱/紫为止的招式和特性。
- 自定义华丽大赛数据，直至剑/盾，新增招式正在开发中。[来源](https://web.archive.org/web/20240910012333/https://pokemonurpg.com/info/contests/rse-move-list/)
- 新增战斗机制支持：
- 超级进化
- 原始回归
- 极巨化
- Z招式
- 第八世代及以后的攻击招式，根据第七世代的Z招式威力计算公式进行威力推算。
- 第八世代及以后的变化招式没有额外效果，像治愈之愿那样。
- 极巨化和超极巨化
- 初始战斗参数
- 多项能力等级提升（例如霸主宝可梦的气场等类似效果）
- 设置场地。
- 回合中如果宝可梦的速度发生了变化，立即重新计算出手顺序。
- 野外战斗中快速选择精灵球
- 按住`R`使用方向键更改选择。
- 按`R`使用上次选择的精灵球。
- 逃走快捷键
- 战斗开场更快 - 消息和动画/叫声同时发生。
- HP减少加速。
- 战斗调试菜单。
- 在“战斗/背包/宝可梦/逃跑”菜单上按`Select`进入。
- 在野生宝可梦战斗中使用AI标志的选项。
- 火红叶绿/第四世代及以后的，战败时丢失的金钱计算。
- 可配置的经验设置
- 捕捉时获得经验。
- 学习装置影响全队。
- 训练家经验。
- 动态经验。
- 未进化时经验加成。
- 冻伤
- 如果不启用配置则不会替换冰冻效果，因此你可以混合搭配。
- 会心捕获。
- 移除徽章加成（可配置）。
- 每场战斗结束时重新计算能力值。
- 等级100的宝可梦可以获得努力值。
- 反转对战支持。
- 大量其他功能[在此](../include/config/battle.h)。
- ***全面的训练家自定义***
- 昵称、努力值（EVs）、个体值（IVs）、招式、特性、精灵球、亲密度、性格、性别、异色。
- 自定义双打对战支持（与NPC组队）。
- 对战途中对手训练家的出现和对话信息显示。
- 升级后的训练家AI
- 考虑了最新的招式效果。
- 新的标志（FLAG）选项，允许你自定义训练家的AI。
- 更快的计算速度。
- 可以按训练家类型指定其使用的精灵球种类。
- ***宝可梦涵盖第1至第9世代***
- 简化了添加新宝可梦的过程。
- 可以禁用不需要的宝可梦进化链。
- 更新为DS风格的宝可梦图像。
- 更新种族值、属性、特性和蛋组（可配置）。
- 参照《欧米伽红宝石/阿尔法蓝宝石》更新丰缘地区图鉴（可配置）。
- 更新全国图鉴，纳入新宝可梦。
- 宝可梦和动画可视化工具，通过在宝可梦摘要屏幕上按`Select`键访问。
- 第四世代及以后的进化方法，并做出了一些改动：
- 苔藓岩石、冰冷岩石和特殊磁场的位置参照《欧米伽红宝石/阿尔法蓝宝石》进行了改动。
- 也可以使用叶之石、冰之石和雷之石进行进化。
- 好啦鱿只需达到30级即可进化。
- 由于物理上无法同时拥有实时时钟（RTC）和陀螺仪，因此我们跳过了它原本的进化条件需求。
- 仙子伊布使用第八世代及以后的进化方法（亲密度+妖精系招式）。
- 可以像使用进化石那样，直接使用需携带的进化道具。
- 隐藏特性
- 可以通过特性膏药获得。
- 兼容Ghoul的DexNav分支。
- 保留了所有性别差异。
- 为雌性的河马兽、沙河马、皮卡丘和果然翁自定义了雌性图标。
- 传说宝可梦、幻之宝可梦和究极异兽拥有3项完美个体值。
- ***可自定义的形态变化表。完整方法列表[在此](../include/constants/form_change_types.h)***
- 持有道具（如骑拉帝纳/阿尔宙斯）
- 使用道具（如花舞鸟）
- 对于谢米，可以设定在特定时间才能使用
- 昏厥
- 战斗开始和结束（如哲尔尼亚斯）
- 对于苍响/藏玛然特，可同时进行招式的改变
- 在特定地形战斗结束时（如结草儿）
- 在战斗中换下（如海豚侠）
- HP阈值（如达摩狒狒）
- 天气（如飘浮泡泡）
- 回合结束时（如莫鲁贝可）
- 特定时间（如谢米）
- 融合（如酋雷姆）
- ***孵蛋改进***
- 需要香薰孵化的幼年宝可梦蛋现在可以直接孵化（可配置）。
- 1级蛋（可配置）。
- 精灵球遗传（可配置）。
- 蛋招式传递，包括模仿香草（可配置）。
- 使用不变石可确保100%遗传性格（可配置）。
- 第六世代及以后的特性遗传方式（可配置）。
- ***新世代道具。完整列表[在此](../include/constants/items.h)***
- 第六世代及以后的学习装置（可配置）
- 破坏因子
- 大多数第四世代及以后的战斗道具
- ***合并的功能分支（已获授权）***
- [RHH开场动画](https://github.com/Xhyzi/pokeemerald/tree/rhh-intro-credits)由@Xhyzi制作
- 展示我们所有人签名的小环节，体现了项目的集体努力 :)
- [大地图调试](https://github.com/TheXaman/pokeemerald/tree/tx_debug_system)由@TheXaman制作
- 可禁用。
- 默认情况下，在大地图中按`R + Start`键访问。
- **附加功能**：
- *清空盒子*：清空所有盒子中的宝可梦。
- *孵化蛋*：选择队伍中的一颗蛋并立即孵化。
- [HGSS风格宝可梦图鉴](https://github.com/TheXaman/pokeemerald/tree/tx_pokedexPlus_hgss)由@TheXaman制作
- 可禁用。
- **附加功能**：
- *支持新的进化方式*。
- *暗色模式*。
- [特性颜色](https://github.com/DizzyEggg/pokeemerald/tree/nature_color)摘要屏幕由@DizzyEggg制作
- [动态多选框](https://github.com/SBird1337/pokeemerald/tree/feature/dynmulti)由@SBird1337制作
- [SaveBlock清理](https://github.com/ghoulslash/pokeemerald/tree/saveblock)由@ghoulslash制作
- [宝可梦跟随&扩展ID](https://github.com/aarant/pokeemerald/tree/followers-expanded-id)由@aarant制作
- 可禁用。
- 包括《心金/魂银》中的宝可梦跟随，包括互动功能。
- **扩展了可能的物体事件ID数量，超出255个**。
- **包含了动态调色板（DOWP）的实现**。
- **附加功能**：
- *宝可梦跟随行走图更新至第八世代*。
- *与我们的宝可梦宝可梦图像可视化工具集成，允许用户浏览宝可梦跟随及战斗图像*。
- ***其他功能***
- 抓起宝可梦时按B键可以像官方新作中那样放下（可配置）。
- 室内跑步（可配置）。
- 可配置的战斗外大地图中毒伤害。
- 可配置的标志（FLAG），用于禁用野生宝可梦遭遇和训练家对战。
- 可配置的标志（FLAG），用于强制或禁用异色宝可梦。
- 可重复使用的招式学习器（TM）（可配置）。
- 《黑2/白2》及以后的驱虫喷雾系统，也支持《Let's Go!皮卡丘/伊布》中的香水。
- 第六世代及以后的努力值上限。
- 包含了pret的所有错误修复。
- 修复了地图上的下雪天气效果。

155
CONTRIBUTING_ZH.md Normal file
View File

@ -0,0 +1,155 @@
# 为 pokeemerald-expansion 做贡献
首先，感谢您帮助改进 `pokeemerald-expansion`！❤️
我们鼓励并珍视所有贡献。请务必在贡献前阅读相关章节！这将使您和维护者的工作更轻松。我们期待看到您的贡献。🎉
## 错误报告
我们使用 [GitHub Issues](https://github.com/rh-hideout/pokeemerald-expansion/issues?q=sort%3Aupdated-desc+is%3Aissue+is%3Aopen+label%3Abug) 跟踪错误。
### 提交错误报告前应做什么？
- 该错误是否在最新未修改的 [`upcoming`](https://github.com/rh-hideout/pokeemerald-expansion/tree/upcoming) 或 [`master`](https://github.com/rh-hideout/pokeemerald-expansion/tree/master) 分支上重现？如不能，请勿提交报告——问题很可能由您的游戏修改引起
- 是否已有其他人发现此问题？请搜索[错误跟踪器](https://github.com/rh-hideout/pokeemerald-expansion/issues?q=label%3Abug)确认。若已有相关 issue，可在现有 issue 中补充信息
### 如何提交错误报告？
如果在项目中遇到问题，请新建一个 [issue](https://github.com/rh-hideout/pokeemerald-expansion/issues/new)
优质错误报告应包含充足信息，避免后续反复沟通。请尽可能完成以下检查清单：
- [ ] 清晰描述问题现象
- [ ] 提供重现步骤（如："1. 打开菜单 2. 选择道具 3. 发生崩溃"）
- [ ] 说明预期行为与实际行为的差异
- [ ] 附上相关截图/视频（如有）
- [ ] 注明使用的游戏版本和分支
### 提交错误报告后会发生什么？
- 维护者将添加[标签](https://github.com/rh-hideout/pokeemerald-expansion/labels)
- 维护者将尝试按您提供的步骤复现错误
- 若无重现步骤或无法复现，将标注为 `bug:unconfirmed`（未确认错误）
- 成功复现后将标注为 `bug:confirmed`（已确认错误），等待[修复](#拉取请求)
- 严重问题将加入版本[里程碑](https://github.com/rh-hideout/pokeemerald-expansion/milestones)，该版本发布前必须修复
## 功能请求
本节指导您如何提交功能请求（包括全新功能和现有功能改进）。遵循指南将帮助维护者和社区理解您的建议。
- 我们使用 [GitHub Issues](https://github.com/rh-hideout/pokeemerald-expansion/issues?q=sort%3Aupdated-desc+is%3Aissue+is%3Aopen+label%3Afeature-request) 跟踪功能请求
### 提交功能请求前应做什么？
- 确认请求在[pokeemerald-expansion 范畴](docs/team_procedures/scope.md)内
- 若不明确是否在范畴内，请在 [RHH Discord 服务器](https://discord.gg/6CzjAG6GZk)的 [#pr-discussions](https://discord.com/channels/419213663107416084/1102784418369785948) 频道发起讨论
### 如何提交功能请求？
向项目添加功能请求时，请新建 [feature request](https://github.com/rh-hideout/pokeemerald-expansion/issues/new)
请包含以下信息：
- [ ] 功能解决的痛点
- [ ] 建议的解决方案
- [ ] 替代方案（如有）
- [ ] 附加上下文（如截图/概念设计）
### 提交功能请求后会发生什么？
- 维护者将添加[标签](https://github.com/rh-hideout/pokeemerald-expansion/labels)
- 若超出[范畴](docs/team_procedures/scope.md)，将关闭该请求
- 若在范畴内，其他贡献者可自愿[通过拉取请求实现](#拉取请求)。实现后请求将关闭
## 拉取请求
若阅读后仍有疑问，可在 Discord 的 #pr-discussions 频道发起讨论，或在 #expansion-dev 频道提问
### 提交拉取请求前应做什么？
- **Git 新手**：参考 [Team Aqua 资源库](https://github.com/Pawkkie/Team-Aquas-Asset-Repo/)的[fork与clone指南](https://github.com/Pawkkie/Team-Aquas-Asset-Repo/wiki/The-Basics-of-GitHub)，确保拥有[pokeemerald-expansion 本地副本](INSTALL.md)
- 确认贡献在[范畴](docs/team_procedures/scope.md)内（若不明确，请在 [RHH Discord](https://discord.gg/6CzjAG6GZk) 的 #pr-discussions 频道讨论）
- **选择目标分支**：
- **`master`**：修复当前 `master` 分支的错误
- **`upcoming`**：其他所有拉取请求
- 基于所选分支的最新版本创建新分支
- 若贡献涉及大量代码变更，建议先联系维护者确认审核意向（参见[维护者列表](#维护者)）
### 如何提交拉取请求？
#### 1. 获取本地工作副本
按 [INSTALL.md](INSTALL.md) 获取 `pokeemerald-expansion` 本地工作副本
#### 2. 添加 RHH 远程仓库
将主仓库设为远程源：
```bash
git remote add RHH https://github.com/rh-hideout/pokeemerald-expansion # RHH 可替换为任意名称
```
#### 3. 创建新分支
创建并切换到新分支：
```bash
git switch -c newFeature # 分支名可自定义
```
#### 4. 同步目标分支
使新分支与目标分支最新版本一致：
```bash
git reset --hard upcoming # 若目标为 master 分支则替换为 master
```
#### 5. 实现代码
所有工作应在新的干净分支上完成。若已有其他分支的工作，可通过 [cherry-pick](https://git-scm.com/docs/git-cherry-pick) 迁移提交，或直接复制文件变更
##### 社区功能分支注意事项
若基于已知社区功能分支开发，**强烈建议**提前发起讨论。某些情况下维护者会要求：
- 直接以现有功能分支为基础
- 或要求完全重写该功能
#### 6. 推送变更
首次提交需推送新分支到远程仓库：
```bash
git push --set-upstream origin newFeature
```
#### 7. 发起拉取请求
代码完成并推送后，请[从分支发起拉取请求](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork)，目标选择 `pokeemerald-expansion` 的对应分支。**请完整填写 PR 描述**
### 提交拉取请求后会发生什么？
- 维护者将分配自己为审核者，通过 PR 审查提供反馈
- 贡献者需响应反馈并更新分支
- 贡献者需确保分支始终通过[合并检查清单](https://docs/team_procedures/merge_checklist.md)
- **重要**：维护者开始审核后，请勿使用 `force-push`（普通推送不受影响）
- 满足检查清单所有条件后，分支将被合并
## 维护者
最后更新：2025年4月1日
| 姓名 | Discord | 当前活跃 | 专长领域 |
| :------------------------------------------ | :---------- | :------- | :----------------------------------------------------------- |
| [Alex](https://github.com/AlexOn1ine) | rainonline | ✅ | 战斗引擎、战斗 AI |
| [Egg](https://github.com/DizzyEggg) | egg9255 | ✅ | 战斗引擎、战斗 AI |
| [ghoulslash](https://github.com/ghoulslash) | ghoulslash | ✅ | 图鉴导航、大地图、战斗引擎 |
| [Jasper](https://github.com/Bassoonian) | bassoonian | ✅ | 树果、昼夜系统、跟随系统、功能分支 |
| [MGriffin](https://github.com/mrgriffin) | mgriffin | ✅ | 测试、训练家控制 |
| [psf](https://github.com/pkmnsnfrn) | pkmnsnfrn | ✅ | 再战系统、难度调节、训练家幻灯片、模拟实时时钟、钓鱼小游戏、英制/公制单位、大地图道具球、空战 |
| [Hedara](https://github.com/hedara90) | hedara | ✅ | 压缩算法、精灵图像 |
| [Pawkkie](https://github.com/Pawkkie) | pawkkie | ✅ | 战斗 AI |
| [SBird](https://github.com/SBird1337) | karathan | ✅ | 动态多选项、伤害计算、动画、训练家控制、测试 |
| [Agustin](https://github.com/AgustinGDLV) | agustingdlv | 未活跃 | 特殊机制、战斗引擎、测试、道具系统 |
| [tertu](https://github.com/tertu-m) | tertu | 未活跃 | 随机化系统 |
## 鸣谢
本指南基于 [contributing.md](https://contributing.md/generator) 创作！

106
FEATURES_ZH.md Normal file
View File

@ -0,0 +1,106 @@
- # 包含哪些功能？
## 目录
- [包含哪些功能？](#包含哪些功能)
- [目录](#目录)
- [配置文件](#配置文件)
- [升级的战斗引擎](#升级的战斗引擎)
- [完整的训练家自定义](#完整的训练家自定义)
- [宝可梦数据](#宝可梦数据)
- [界面改进](#界面改进)
- [引擎改进](#引擎改进)
- [大地图改进](#大地图改进)
- [开发者工具](#开发者工具)
## 配置文件
下面列出的许多功能都可以根据需要关闭。在这些文件中检查哪些功能可以配置：
- [AI 配置](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/ai.h)
- [战斗配置](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/battle.h)
- [限制配置](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/caps.h)
- [调试配置](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/debug.h)
- [宝可梦导航系统 (DexNav) 配置](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/dexnav.h)
- [通用配置](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/general.h)
- [心金魂银 (HGSS) 图鉴配置](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/pokedex_plus_hgss.h)
- [道具配置](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/item.h)
- [NPC 跟随者配置](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/follower_npc.h)
- [大地图配置](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/overworld.h)
- [宝可梦配置](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/pokemon.h)
- [存档配置](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/save.h)
- [启用的宝可梦种类](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/species_enabled.h)
- [摘要屏幕配置](https://github.com/rh-hideout-chinese/pokeemerald-expansion/blob/master/include/config/summary_screen.h)
## 升级的战斗引擎
- ***战斗特殊机制 :*** 超级进化、原始回归、究极爆发、Z招式、极巨化、超极巨化和太晶化。
- ***新世代战斗类型:*** 双打野生对战、自定义多人对战、反转对战、1v2/2v1 对战、空中对战。
- ***更新的战斗机制:*** 高级球捕获、冻伤状态支持、精灵球快捷菜单、招式描述菜单、无徽章加成、第四世代雾天、听话机制、亲密度影响、捕获后队伍交换、战斗中显示效果绝佳/一般、《火红叶绿》/第四世代起战斗失败金钱计算、第四世代风格大地图人物影子。
- ***更新的招式数据:*** 妖精/星晶属性、物理/特殊招式分类、各种招式标志。
- ***更新的计算方式:*** 伤害、经验值、回合中速度计算、战斗结束后的状态和努力值、100级努力值计算。
- ***截至第九世代的每个道具、特性和招式效果:*** 包括截至《剑盾》的华丽大赛数据 ([来源](https://pokemonurpg.com/info/contests/rse-move-list/))。
- ***初始战斗条件:*** 能力等级、战场地形、野生宝可梦 AI 标志。
- ***更快的战斗:*** 同时减少HP、快捷“逃跑”选项、更快的战斗开场、更快的HP减少动画、更快的AI计算。
- ***更简单的自定义:*** 更简洁的代码库，便于实现自定义招式和效果。
- ***改进的 AI:*** 更快，并考虑了扩展版添加的新效果。
- ***受欢迎的功能:***等级/努力值上限、睡眠条款、属性指示器。
## 完整的训练家自定义
- ***兼容 Pokémon Showdown 的队伍语法:*** 在[队伍构筑器](https://play.pokemonshowdown.com/teambuilder)中创建你的训练家队伍并粘贴结果！
- ***自定义宝可梦数据:*** 昵称、努力值、个体值、招式、特性、精灵球、亲密度、性格、性别、闪光、极巨等级、超极巨化因子 和太晶属性。
- ***“王牌宝可梦”:*** 会将特定宝可梦保留到最后出场。
- ***训练家池:*** 一个训练家可以拥有一个随机宝可梦池，而不是固定的队伍。
- ***自定义训练家切入对话*** 首回合、命中效果绝佳时、超级进化前等。
- ***新的 AI 标志选项:*** 自定义训练家的智能程度。
- ***训练家类别对应的精灵球:*** 潜水员使用潜水球、培育家使用巢穴球等。
## 宝可梦数据
- ***改进的宝可梦数据结构:*** 优化了空间占用，允许容纳更多信息，如太晶属性、12字符名称、极限特训过的能力、进化条件、保存的HP/状态异常。
- ***更新的培育机制:*** 精灵球/蛋招式/特性/性格的遗传、等级1蛋自动适用熏香宝宝规则。
- ***更新的宝可梦种类数据:*** 种族值、属性、特性、隐藏特性、蛋群、努力值产出、招式学习列表、对战设施禁用、保证完美个体值数量、《欧米伽红宝石/阿尔法蓝宝石》图鉴编号。
- ***更简单的宝可梦种类数据操作:*** 添加一个新宝可梦只需编辑约5个文件，而不是原版 pokeemerald 的20多个文件。
- ***更新的精灵图:*** DS风格的精灵图，支持绿宝石的2帧动画和性别差异。
- ***宝可梦种类开关:*** 可以禁用特定的宝可梦组别以节省空间，包括家族、跨世代进化、超级进化、地区形态等。
- ***重构的进化系统:*** 多个进化条件可以堆叠，无需额外编码即可创建复杂的进化方式。支持除亲密度和主机陀螺仪外的所有条件。
- ***形态变化系统:*** 大多数形态变化可以在不额外编码的情况下添加。这包括对以下机制的支持：持有/使用道具、达到HP阈值、战斗内外天气变化、融合等。
## 界面改进
- ***宝可梦摘要:*** 招式回忆、查看努力值/个体值、性格能力加减颜色标识 ([功能分支](https://github.com/DizzyEggg/pokeemerald/tree/nature_color) by @DizzyEggg)。
- ***队伍菜单:*** “移动道具”选项。
- ***宝可梦存储系统:*** 置顶“移动”选项、可通过盒子链接道具访问。
- ***心金魂银风格图鉴*** ([原始功能分支](https://github.com/TheXaman/pokeemerald/tree/tx_pokedexPlus_hgss) by @TheXaman): 玩家可访问的详细游戏内信息。
## 引擎改进
- ***默认实现了所有基础 pokeemerald 的错误修复:*** 所有在 `BUGFIX` 定义下的修复。
- ***改进的精灵图和调色板压缩:*** 资源比原版压缩占用更少空间。
- ***现代编译器支持:*** 更容易检测代码中的潜在错误。
- ***动态多选菜单*** ([原始分支](https://github.com/SBird1337/pokeemerald/tree/feature/dynmulti) by @SBird1337): 更简单的方式为脚本添加多选菜单。
- ***高质量随机数生成器:*** 不再有原版破碎的 RNG。
## 大地图改进
- ***现代机制:*** 清除浓雾场地技能、《黑2白2》+驱虫剂系统、室内奔跑、移除大地图中毒状态、连锁钓鱼、对战搜寻器、《火红叶绿》+战斗失败消息。
- ***大地图行走图和跟随宝可梦*** ([功能分支](https://github.com/aarant/pokeemerald/tree/followers-expanded-id) by @aarant)
- *包含动态大地图调色板 (DOWP) 和扩展大地图事件ID (支持超过255)。*
- *包含截至第九世代的宝可梦精灵图。*
- ***昼夜系统:*** ([功能分支](https://github.com/aarant/pokeemerald/tree/lighting-expanded-id) by @aarant)
- *包含对非实时时钟的支持*。
- ***NPC 跟随者:*** ([功能分支](https://github.com/ghoulslash/pokeemerald/tree/follow_me) by @ghoulslash)
- ***黑白风格地图弹出框*** ([功能分支](https://github.com/ravepossum/pokeemerald/tree/bsbob_map_popups) by @BSBob)
- ***XY 树果机制:*** 突变、湿度、杂草、害虫。
- ***获得道具时显示说明*** (功能分支 by @ghoulslash)。
## 开发者工具
- ***集成测试:*** 精确定位你的自定义机制是否破坏了游戏中的其他功能。
- ***宝可梦精灵图查看器:*** 测试每个宝可梦的精灵图和动画。
- ***大地图调试菜单*** ([原始功能分支](https://github.com/TheXaman/pokeemerald/tree/tx_debug_system) by @TheXaman): 支持菜单，包含一系列功能以方便调试，包括传送、开关标志和变量、生成宝可梦和道具等。
- ***战斗调试菜单:*** 在战斗中途即时修改数据。
- ***招式学习列表助手:*** 根据官方兼容性数据，从你的自定义TM和教学招式中自动生成招式学习列表。
- ***可配置的脚本标志:*** 禁用野生遭遇、禁用训练家对战、强制/禁用闪光。
- ***存档块清理*** ([功能分支](https://github.com/ghoulslash/pokeemerald/tree/saveblock) by @ghoulslash)

217
INSTALL_ZH.md
View File

@ -1,22 +1,24 @@
# 安装说明 # 安装说明
每个支持的操作系统的安装说明可在 `docs/install/` 目录下的对应子目录中找到。
各个系统的链接列在各自的标题下。
本文件仅包含对每个支持系统的简要介绍。
如果遇到问题，请在 Discord 上寻求帮助（见 [README_ZH.md](README_ZH.md)）。
完成对应操作系统的安装说明后，继续阅读 [构建 pokeemerald-expansion](#构建-pokeemerald-expansion)。 各支持操作系统的安装说明可在 `docs/install/` 下相应目录中找到。
各系统对应的链接见下方标题。
本文档仅包含对各支持系统的简要介绍。
如遇问题，请在 Discord 寻求帮助（参见 [README_ZH.md](README_ZH.md)）。
完成适用于您操作系统的安装说明后，请继续阅读[构建 pokeemerald-expansion](#构建-pokeemerald-expansion)。
## Windows ## Windows
**Windows 需要以下系统之一来构建项目**
**注意事项**：由于 Microsoft 已停止对 Windows 7 和 Windows 8 的官方支持，一些维护者不再维护这两个系统的安装说明。因此，这些说明可能在未来失效，并且修复速度会慢于 Windows 10/11 的相关说明。 **Windows 需要以下任一系统来构建项目**
在 Windows 上，可以使用以下系统构建项目： **注意**：由于 Windows 7 和 Windows 8 已被微软官方停止支持，部分维护者可能不会长期维护 Win7/8 的安装说明。因此这些说明未来可能失效，修复时间可能长于 Windows 10/11 的说明修复。
- WSL2，最快
- WSL1，速度是 WSL2 的七分之一 在 Windows 上，可使用以下系统构建项目：
- Msys2，速度是 WSL2 的二十分之一（**注意**：当前在 pret 上游版本中已损坏）
- Cygwin，速度是 WSL2 的三十分之一（**注意**：当前在 pret 上游版本中已损坏） - WSL2（速度最快）
- WSL1（比 WSL2 慢 7 倍）
- Msys2（比 WSL2 慢 20 倍）（**注意**：目前在 pret 上游已损坏）
- Cygwin（比 WSL2 慢 30 倍）（**注意**：目前在 pret 上游已损坏）
**注意**：仅推荐使用 WSL 系统。 **注意**：仅推荐使用 WSL 系统。
@ -24,101 +26,188 @@
[Msys2 安装说明](docs/install/windows/MSYS2_ZH.md) [Msys2 安装说明](docs/install/windows/MSYS2_ZH.md)
[Cygwin 安装说明](docs/install/windows/CYGWIN.md) [Cygwin 安装说明](docs/install/windows/CYGWIN_ZH.md)
## Linux ## Linux
该项目可在任意 Linux 发行版上构建。 该项目可在任意 Linux 发行版上构建。
已有说明的发行版： 已有说明的发行版：
- [Ubuntu](docs/install/linux/UBUNTU_ZH.md) - [Ubuntu](docs/install/linux/UBUNTU_ZH.md)
- [Debian](docs/install/linux/DEBIAN_ZH.md) - [Debian](docs/install/linux/DEBIAN_ZH.md)
- [Arch Linux](docs/install/linux/ARCH_LINUX_ZH.md) - [Arch Linux](docs/install/linux/ARCH_LINUX_ZH.md)
- [NixOS](docs/install/linux/NIXOS.md) - [NixOS](docs/install/linux/NIXOS_ZH.md)
其他发行版请参考 [通用说明](docs/install/linux/OTHERS.md)。 其他发行版请参考 [通用说明](docs/install/linux/OTHERS.md)。
## Mac ## Mac
在启用测试系统时需要额外考虑一些事项。
[Mac 安装说明](docs/install/mac/MAC_OS.md) 需要额外配置才能使测试系统正常工作。
[Mac 安装说明](docs/install/mac/MAC_OS_ZH.md)
## ChromeOS ## ChromeOS
仅在基于 x86_64 的系统上测试过。
[Chrome OS 安装说明](docs/install/chromeos/CHROME_OS.md) 仅在 x86_64 架构系统上测试过。
[Chrome OS 安装说明](docs/install/chromeos/CHROME_OS_ZH.md)
# 构建 pokeemerald-expansion # 构建 pokeemerald-expansion
按以下步骤构建 `pokeemerald-expansion` 项目。
1. 进入你想保存项目的目录，注意系统的路径限制。 按照以下步骤构建 `pokeemerald-expansion`：
1. 导航到您要存放项目的目录，注意任何系统特定的限制。
2. 使用 `git` 下载 `pokeemerald-expansion` 2. 使用 `git` 下载 `pokeemerald-expansion`
```console ```console
git clone https://github.com/rh-hideout-chinese/pokeemerald-expansion git clone https://github.com/rh-hideout/pokeemerald-expansion
``` ```
3. 进入新下载的项目目录。 3. 进入新下载的项目目录。
```console ```
cd pokeemerald-expansion cd pokeemerald-expansion
``` ```
4. 构建项目。 4. 构建项目。
```console ```
make make
``` ```
5. 如果一切顺利，你应该能看到类似下面这样的输出。
```console 5. 如果一切正常，您将看到类似以下输出：
arm-none-eabi-ld: warning: ../../pokeemerald.elf has a LOAD segment with RWX permissions
Memory region Used Size Region Size %age Used ```
EWRAM: 243354 B 256 KB 92.83% arm-none-eabi-ld: warning: ../../pokeemerald.elf has a LOAD segment with RWX permissions
IWRAM: 30492 B 32 KB 93.05% Memory region Used Size Region Size %age Used
ROM: 26072244 B 32 MB 77.70% EWRAM: 243354 B 256 KB 92.83%
cd build/modern && arm-none-eabi-ld -T ../../ld_script_modern.ld --print-memory-usage -o ../../pokeemerald.elf <objs> <libs> | cat IWRAM: 30492 B 32 KB 93.05%
tools/gbafix/gbafix pokeemerald.elf -t"POKEMON EMER" -cBPEE -m01 -r0 --silent ROM: 26072244 B 32 MB 77.70%
arm-none-eabi-objcopy -O binary pokeemerald.elf pokeemerald.gba cd build/modern && arm-none-eabi-ld -T ../../ld_script_modern.ld --print-memory-usage -o ../../pokeemerald.elf <objs> <libs> | cat
tools/gbafix/gbafix pokeemerald.gba -p --silent tools/gbafix/gbafix pokeemerald.elf -t"POKEMON EMER" -cBPEE -m01 -r0 --silent
``` arm-none-eabi-objcopy -O binary pokeemerald.elf pokeemerald.gba
构建好的 ROM 文件将保存在目录中，名为 `pokeemerald.gba`。 tools/gbafix/gbafix pokeemerald.gba -p --silent
```
构建完成的 ROM 将以 `pokeemerald.gba` 文件名位于项目目录中。
# 构建指南 # 构建指南
## 并行构建 ## 并行构建
更多信息请参见 [GNU 文档](https://www.gnu.org/software/make/manual/html_node/Parallel.html) 和 [Stack Exchange 线程](https://unix.stackexchange.com/questions/208568)。 更多信息请参阅 [GNU 文档](https://www.gnu.org/software/make/manual/html_node/Parallel.html) 和 [Stack Exchange 讨论](https://unix.stackexchange.com/questions/208568)。
为加快构建速度，先通过以下命令获取 `nproc` 的值： 要加速构建，首先通过以下命令获取 `nproc` 值：
```bash
```
nproc nproc
``` ```
然后通过以下命令进行并行构建：
```bash
make -j<由 nproc 返回的数字>
```
将 `<由 nproc 返回的数字>` 替换为实际数值。
macOS 不支持 `nproc`。可使用替代命令 `sysctl -n hw.ncpu`（参考 [Stack Overflow 线程](https://stackoverflow.com/questions/1715580)）。 然后通过以下命令加速构建：
```
make -j<nproc 输出值>
```
将 `<nproc 输出值>` 替换为 `nproc` 命令返回的数字。
macOS 上无 `nproc` 命令。替代命令是 `sysctl -n hw.ncpu`（相关 [Stack Overflow 讨论](https://stackoverflow.com/questions/1715580)）。
### 其他工具链 ### 其他工具链
若使用非 devkitARM 工具链构建，请通过环境变量 `TOOLCHAIN` 覆盖路径，该路径必须包含 `bin` 子目录。 要使用 devkitARM 以外的工具链构建，需用工具链路径覆盖 `TOOLCHAIN` 环境变量（该路径必须包含 `bin` 子目录）：
```bash
```
make TOOLCHAIN="/path/to/toolchain/here" make TOOLCHAIN="/path/to/toolchain/here"
``` ```
例如：
```bash 示例如下：
```
make TOOLCHAIN="/usr/local/arm-none-eabi" make TOOLCHAIN="/usr/local/arm-none-eabi"
``` ```
要使用此工具链构建 `modern` 目标，还需存在 `lib`、`include` 和 `arm-none-eabi` 子目录。
### 带调试信息的构建 要使用此工具链编译 `modern` 目标，还需存在 `lib`、`include` 和 `arm-none-eabi` 子目录。
使用现代工具链构建带有调试符号和优化设置的 **pokeemerald.elf**： ### 构建调试信息
```bash
要在现代工具链下构建带调试符号和调试优化级别的 **pokeemerald.elf**：
```
make debug make debug
``` ```
# 附加工具推荐 # 选择分支
* [porymap](https://github.com/huderlem/porymap)：用于查看和编辑地图 **pokeemerald-expansion** 提供不同分支供用户选择使用。
* [poryscript](https://github.com/huderlem/poryscript)：用于脚本编写（[VS Code 扩展](https://marketplace.visualstudio.com/items?itemName=karathan.poryscript)）
* [Tilemap Studio](https://github.com/Rangi42/tilemap-studio)：用于查看和编辑图块地图 ## 最新补丁版 (Latest Patch)
此选项包含所有官方发布的扩展功能和错误修复。
## `master` 分支
`master` 分支包含"最新补丁版"的所有功能，以及自该版本发布以来发现的所有错误修复。
## `upcoming` 分支
`upcoming` 分支包含"最新补丁版"的所有功能，以及自该版本发布以来添加的所有新功能。
`master` 分支的错误修复会不定期合并到 `upcoming`，但无固定时间表。
# 从 pokeemerald 迁移
1. 添加 RHH 作为 git 远程仓库
```
git remote add RHH https://github.com/rh-hideout/pokeemerald-expansion
```
1. 拉取您选择的分支
有三种可选分支：
```
git pull RHH master # 如选择 upcoming 分支，将 master 替换为 upcoming
# 如选择最新补丁版，将 master 替换为 expansion
# 如选择特定版本（如 1.11.0），将 master 替换为 expansion/1.11.0
```
如果您未使用最新版 pret/pokeemerald，可能需要解决一些合并冲突。完成后，您即可使用 **pokeemerald-expansion**。
# 更新 pokeemerald-expansion
1. 添加 RHH 作为 git 远程仓库（若未添加）
```
git remote add RHH https://github.com/rh-hideout/pokeemerald-expansion
```
2. 检查当前版本
本地 更新日志 会显示您仓库的当前版本。
3. 选择目标版本
我们建议按以下顺序逐步更新到下一版本：
若当前版本低于 1.6.2，应先更新到 1.6.2
- 1.6.2
- 1.7.4
- 1.8.3
- 1.9.4
- 1.10.3
例如，若当前版本为 1.7.0，应更新到 1.7.4。
4. 拉取目标版本
```
git pull RHH expansion/X.Y.Z # 将 X.Y.Z 替换为目标版本，如 `1.9.3`、`master` 或 `upcoming`
```
可能需要解决合并冲突。
如果您选择的目标版本不是 [标签页](https://github.com/rh-hideout/pokeemerald-expansion/tags) 上的最新版本，请重复步骤 3 和 4 直至更新到最新版。
# 实用附加工具
- [porymap](https://github.com/huderlem/porymap) - 查看和编辑地图
- [porytiles](https://github.com/gruntlucas/porytiles) - 为地图添加新元图块
- [poryscript](https://github.com/huderlem/poryscript) - 脚本编写（[VS Code 扩展](https://marketplace.visualstudio.com/items?itemName=karathan.poryscript)）
- [Tilemap Studio](https://github.com/Rangi42/tilemap-studio) - 查看和编辑图块地图

259
README_ZH.md
View File

@ -1,15 +1,20 @@
# pokeemerald-expansion-Chinese # 关于pokeemerald-expansion-Chinese
pokeemerald-expansion-Chinese是基于ROM Hacking Hideout的[pokeemerald-expansion](https://github.com/rh-hideout/pokeemerald-expansion/)项目的中文汉化项目。 &zwnj;**`pokeemerald-expansion-Chinese`**&zwnj; 是基于ROM Hacking Hideout的[`pokeemerald-expansion`](https://github.com/rh-hideout/pokeemerald-expansion)项目的中文汉化项目。该项目的详细说明请见[关于`pokeemerald-expansion`](#关于`pokeemerald-expansion`)。
更改内容包括： **本项目主要面向使用反编译方式进行改版的开发者，并非对于原作宝可梦绿宝石的汉化，也并不是一个可以独立游玩的宝可梦游戏。**
- 汉化了项目中几乎所有的文本、含文字的图片(包括原版与expansion新增的部分)，并修改了与汉化后文字展示相关的代码。原版游戏脚本文本主要使用2011年发布的由漫游&TGB联合汉化的口袋妖怪绿宝石的文本。 汉化内容包括：
- 修正原汉化文本单行字数溢出换行及换行符数量超标导致的文字显示不全的问题。
- 统一游戏内文本的译名及标点使用，专有名词及常用功能文本参照最新官方正作简体中文版译名及神奇宝贝百科的民间译名。
- 按照绿宝石日文版还原了一部分包括标题画面、读取存档及部分细节功能的内容。
注：本项目不包含对于expansion项目的优化及新功能开发。 - 参照2011年发布的由漫游&TGB联合汉化的口袋妖怪绿宝石汉化了游戏内的所有文本及文本图片，修改了部分与汉化后文字展示相关的代码。
- 汉化了项目内绿宝石原有的及expansion新增的全部的宝可梦、道具、特性、招式、属性、性格、异常状态等资料内容，译名参照目前官方正作简体中文的译名，并对提及了以上内容的所有游戏内文本进行了统一修正。
- 重新汉化了游戏内的大量文本，包括但不限于：城镇等地点名称、重要角色及普通NPC训练家的名称及所有对话，主线剧情及功能性NPC相关对话，华丽大赛、对战开拓区、联机俱乐部等设施的说明及其他文本，开拓区徒弟NPC、电视节目以及对战寻呼文本，以及例如“训练家”、“招式”、“培育屋”等游戏系列的专有名词文本。译名绝大部分参照目前官方正作简体中文及神奇宝贝百科的译名，并对提及了以上内容的所有游戏内文本进行了统一修正。
- 优化原本汉化版中的大量文本，包括但不限于：修正原汉化文本单行字数溢出换行的问题，换行符数量超标导致的文字显示不全的问题，统一游戏内文本的译名及标点使用，规范游戏内阿拉伯数字及汉字数字的使用，并对对话文本换行位置不当影响观感的情况进行了一定优化。
- 汉化了expansion项目新增的包括对战系统更新、图鉴、宝可梦跟随、测试debug等各项新增功能的全部相关文本，其中对战系统内的文本严格参照目前官方正作简体中文的翻译。
- 对于游戏内的easychat系统进行了汉化，对词库内短语进行了汉化并进行了一定程度的替换，对对战开拓区等使用easychat系统的NPC训练家的对话采用短语重拼的方式进行了汉化。
- 重新制作了标题logo，按照绿宝石日文版还原了一部分包括标题画面、读取存档及部分细节功能的内容。
注：本项目不包含对于expansion项目的优化及新功能开发。项目内的所有汉化文本可供宝可梦正作及改版汉化参考及使用，欢迎注明出处。
汉化人员名单（不分先后）： 汉化人员名单（不分先后）：
@ -19,239 +24,63 @@ pokeemerald-expansion-Chinese是基于ROM Hacking Hideout的[pokeemerald-expansi
- 日文翻译及日版功能还原：SKT - 日文翻译及日版功能还原：SKT
- 程序支持：明雅，墟芜，卧看微尘 - 程序支持：明雅，墟芜，卧看微尘
- 测试BUG反馈：摆烂 - 测试BUG反馈：摆烂
- 标题LOGO绘制：大神丶橡皮
感谢大家的努力与贡献！ 感谢大家的努力与贡献！
也感谢之前于2011年发布的漫游&TGB联合汉化的绿宝石汉化版的参与人员： 也感谢之前于2011年发布的漫游&TGB联合汉化的绿宝石汉化版的参与人员： 飞眼，enler，胡里胡涂，ルナ，零度雨，灰米，绿叶枫，yeyezai，lazybone，雪山肥壶，信天翁，爱姿病，troy1229，夜露死苦，阿宝，lioyy，凛，酷酷的安仔，空白君，AISU，吾鱼（小黑屋）
飞眼，enler，胡里胡涂，ルナ，零度雨，灰米，绿叶枫，yeyezai，lazybone，雪山肥壶，信天翁，爱姿病，troy1229，夜露死苦，阿宝，lioyy，凛，酷酷的安仔，空白君，AISU，吾鱼（小黑屋）
# 以下是pokeemerald-expansion项目的Readme文件翻译： ------
## pokeemerald-expansion # 关于`pokeemerald-expansion`
pokeemerald-expansion是基于pret的[pokeemerald](https://github.com/pret/pokeemerald)反编译项目的一个***ROM改版蓝本***。***它不是一个可玩的ROM改版***，但它为ROM修改者提供了多种功能，以便他们可以创建自己的游戏，因此它本身不是用来单独游玩的。 ![Gif that shows debugging functionality that is unique to pokeemerald-expansion such as rerolling Trainer Id, Cheat Start, PC from Debug Menu, Debug PC Fill, Pokemon Sprite Visualizer, Debug Warp to Map, and Battle Debug Menu](https://github.com/user-attachments/assets/cf9dfbee-4c6b-4bca-8e0a-07f116ef891c) ![Gif that shows overworld functionality that is unique to pokeemerald-expansion such as indoor running, BW2 style map popups, overworld followers, DNA Splicers, Gen 1 style fishing, OW Item descriptions, Quick Run from Battle, Use Last Ball, Wild Double Battles, and Catch from EXP](https://github.com/user-attachments/assets/383af243-0904-4d41-bced-721492fbc48e) ![Gif that shows off a number of modern Pokemon battle mechanics happening in the pokeemerald-expansion engine: 2 vs 1 battles, modern Pokemon, items, moves, abilities, fully customizable opponents and partners, Trainer Slides, and generational gimmicks](https://github.com/user-attachments/assets/50c576bc-415e-4d66-a38f-ad712f3316be)
## 我应该使用它还是原版的pokeemerald作为我的改版蓝本？ &zwnj;**`pokeemerald-expansion`**&zwnj; 是一个GBA ROM改版蓝本，它为开发者提供了一个全面的工具包，用于创建宝可梦ROM改版。&zwnj;**`pokeemerald-expansion`**&zwnj; 是基于[pret的`pokeemerald`](https://github.com/pret/pokeemerald)反编译项目构建的。&zwnj;**它本身并不是一个可以独立游玩的宝可梦游戏。**&zwnj;
使用原版pokeemerald作为基础的主要优势是能够与其他官方的GBA《宝可梦》游戏进行联机战斗和交换。而pokeemerald-expansion则开箱即支持与同版本游戏进行战斗和交换。如果你不介意失去与原版完全兼容的能力，我们建议使用pokeemerald-expansion。否则，请使用pret的pokeemerald。你仍然可以获得pret提供的文档改进，因为我们定期合并pret的文档更改。 # [功能](FEATURES.md)
## 使用pokeemerald-expansion &zwnj;**`pokeemerald-expansion`**&zwnj; 提供了来自各种[宝可梦正作游戏系列](https://bulbapedia.bulbagarden.net/wiki/Core_series)的数百种功能，以及旨在简化开发流程并提升玩家体验的热门生活质量改进。这些功能的完整列表请见[`FEATURES_ZH.md`](FEATURES_ZH.md)。
如果你在你的改版中使用了pokeemerald-expansion，请在制作人员名单中添加RHH（Rom Hacking Hideout）。可选地，你可以列出使用的版本，这样可以帮助玩家了解可以期待哪些功能。 # [致谢](CREDITS.md)
你可以这样表述： [![](https://img.shields.io/github/all-contributors/rh-hideout/pokeemerald-expansion/upcoming)](CREDITS.md)
如果您使用了&zwnj;**`pokeemerald-expansion`**&zwnj;，请注明出处为&zwnj;**RHH (Rom Hacking Hideout)**&zwnj;。可以选择额外注明版本号。
``` ```
基于RHH的pokeemerald-expansion 1.11.1 https://github.com/rh-hideout/pokeemerald-expansion/ 基于RHH的pokeemerald-expansion 1.12.0 https://github.com/rh-hideout/pokeemerald-expansion/
``` ```
请考虑[致谢](CREDITS.md)项目中的所有贡献者！
# 选择`pokeemerald` 还是 **`pokeemerald-expansion`**
***重要提示***：不要使用GitHub的“Download Zip”选项。使用这个选项将无法下载更新你的扩展版本或合并其他功能分支所需的提交历史。相反，请阅读[此指南](https://github.com/Pawkkie/Team-Aquas-Asset-Repo/wiki/The-Basics-of-GitHub)以了解如何分叉存储库并从那里本地克隆。 - &zwnj;**`pokeemerald-expansion`**&zwnj; 支持与其他基于 &zwnj;**`pokeemerald-expansion`**&zwnj; 构建的游戏进行多人游戏功能。它与官方宝可梦游戏不兼容。
- 如果重视与官方游戏的兼容性，请使用[`pokeemerald`](https://github.com/pret/pokeemerald)作为蓝本。否则，我们建议使用 &zwnj;**`pokeemerald-expansion`**&zwnj;。
- &zwnj;**`pokeemerald-expansion`**&zwnj; 整合了来自`pokeemerald`的定期更新，包括错误修复和文档改进。
请按照`INSTALL.md`中的说明在你的机器上设置pokeemerald-expansion。 # [开始](INSTALL.md)
### 如果我已经有一个基于原版pokeemerald的项目，我可以使用pokeemerald-expansion吗？ ❗❗ &zwnj;**重要提示**&zwnj;：不要使用GitHub的“Download Zip”选项，因为它不包含提交历史。如果你想更新或合并其他功能分支，这是必不可少的。
可以！请注意，我们紧跟pret对pokeemerald的文档更新，这意味着如果你的项目有点旧，你可能会遇到需要手动解决的合并冲突。 如果你是git和GitHub的新手，[Team Aqua的资源仓库](https://github.com/Pawkkie/Team-Aquas-Asset-Repo/)提供了一个[关于fork和clone仓库的指南](https://github.com/Pawkkie/Team-Aquas-Asset-Repo/wiki/The-Basics-of-GitHub)。然后，你可以按照以下指南之一进行操作：
- 如果你还没有设置远程仓库，请运行命令`git remote add RHH https://github.com/rh-hideout/pokeemerald-expansion`。 ## 📥 [安装**`pokeemerald-expansion`**](INSTALL_ZH.md)
- 一旦你设置了远程仓库，请运行命令`git pull RHH master`。 ## 🏗️ [构建**`pokeemerald-expansion`**](INSTALL_ZH.md#构建 pokeemerald-expansion)
## 🚚 [从**`pokeemerald`**迁移](INSTALL_ZH.md#从 pokeemerald 迁移)
## 🚀 [升级**`pokeemerald-expansion`**](INSTALL_ZH.md#更新 pokeemerald-expansion)
这样，你将获得pokeemerald-expansion的最新版本，以及一些尚未发布到下一个补丁版本中的bug修复。 # [文档](https://rh-hideout.github.io/pokeemerald-expansion/)
## 文档 详细说明文档，请见[pokeemerald-expansion文档页](https://rh-hideout.github.io/pokeemerald-expansion/)。
[请点击此处访问我们的文档页面。](https://rh-hideout.github.io/pokeemerald-expansion/) # [贡献](CONTRIBUTING.md)
如果您想要[报告bug](CONTRIBUTING.md#Bug-Report)，[新建拉取请求](CONTRIBUTING.md#Pull-Requests)，或者[请求新功能](CONTRIBUTING.md#Feature-Request)，我们的[`CONTRIBUTING_ZH.md`](CONTRIBUTING_ZH.md)文件中有针对每一项的指南。
## ***如何更新我的pokeemerald-expansion版本？*** # [社区](https://discord.gg/6CzjAG6GZk)
- 如果你还没有设置远程仓库，请运行命令`git remote add RHH https://github.com/rh-hideout/pokeemerald-expansion`。 [![](https://dcbadge.limes.pink/api/server/6CzjAG6GZk)](https://discord.gg/6CzjAG6GZk)
- 检查你的当前版本。
- 你可以在调试菜单的`Utilities -> Expansion Version`选项中检查。
- 如果该选项不可用，你可能拥有的是1.6.2或更早的版本。在那种情况下，请查看[更改日志](docs/CHANGELOG.md)以确定你的版本，基于你仓库中可用的功能。
- ***重要提示***：如果你落后了几个版本，我们建议你一次更新一个小版本，而不是直接跳到最新的补丁版本（例如，1.5.3 -> 1.6.2 -> 1.7.4等等。查看[在线文档网站](https://rh-hideout.github.io/pokeemerald-expansion/CHANGELOG.html)以查看每个步骤的最新版本。）
- 一旦你设置了远程仓库，请运行命令`git pull RHH expansion/X.Y.Z`，将X、Y和Z替换为你想要更新到的相应版本的数字（例如，要更新到1.11.1，请使用`git pull RHH expansion/1.11.1`）。
- 另外，你可以更新到扩展的未发布版本。
- ***master（稳定版）***：它包含将在下一个补丁版本中发布的***bug修复***。要合并，请使用`git pull RHH master`。
- ***upcoming（不稳定版，可能存在bug）***：它包含将在下一个小版本中发布的***功能***。要合并，请使用`git pull RHH upcoming`。
### 请考虑在你的项目中鸣谢整个[贡献者名单](https://github.com/rh-hideout/pokeemerald-expansion/wiki/Credits)，因为他们都为开发这个项目付出了辛勤的努力 :) 我们的社区使用[Rom Hacking Hideout (RHH) Discord服务器](https://discord.gg/6CzjAG6GZk)来进行沟通和组织活动。我们的大部分讨论都在那里进行，欢迎任何人加入我们！
## 谁在维护这个项目？
这个项目最初是由DizzyEgg与其他贡献者一起启动的。现在它由ROM Hacking Hideout社区中的一个团队“Expansion Senate”维护。ROM Hacking Hideout（简称RHH）是一个基于Discord的ROM修改社区，专门研究《宝可梦》ROM改版。关于项目开发的大部分讨论都在那里进行。
[点击此处加入RHH Discord服务器！](https://discord.gg/6CzjAG6GZk)
## 项目中有一个bug。我该如何让你们知道？
请在此[提交](https://github.com/rh-hideout/pokeemerald-expansion/issues)项目的任何问题，并确保在提交之前使用过滤器搜索，确认问题尚未被其他人报告。你也可以加入Discord服务器，以尝试从团队和其他服务器成员那里获得更深入的支持。
## 即使我不是ROM Hacking Hideout的成员，我也可以贡献吗？
可以！欢迎通过Pull Request进行贡献，它们将由维护者及时审查。
此外，请遵循Pull Request模板，并随时讨论如何处理审查。***沟通是关键！***如果我们花了一些时间来审查你的PR，请不要感到气馁，我们会处理的。
## 包含了哪些功能？
- ***重要❗❗ 阅读以下内容以了解你可以切换哪些功能***：
- [战斗配置](./include/config/battle.h)
- [宝可梦配置](./include/config/pokemon.h)
- [物品配置](./include/config/item.h)
- [大地图配置](./include/config/overworld.h)
- [调试配置](./include/config/debug.h)
- ***升级的战斗引擎***
- 第五世代及以后的伤害计算方式。
- 支持2v2野外战斗。
- 支持1v2/2v1战斗。
- 妖精属性（可配置）。
- 物理/特殊/变化招式划分（可配置）。
- 新增直至朱/紫为止的招式和特性。
- 自定义华丽大赛数据，直至剑/盾，新增招式正在开发中。[来源](https://web.archive.org/web/20240910012333/https://pokemonurpg.com/info/contests/rse-move-list/)
- 新增战斗机制支持：
- 超级进化
- 原始回归
- 极巨化
- Z招式
- 第八世代及以后的攻击招式，根据第七世代的Z招式威力计算公式进行威力推算。
- 第八世代及以后的变化招式没有额外效果，像治愈之愿那样。
- 极巨化和超极巨化
- 初始战斗参数
- 多项能力等级提升（例如霸主宝可梦的气场等类似效果）
- 设置场地。
- 回合中如果宝可梦的速度发生了变化，立即重新计算出手顺序。
- 野外战斗中快速选择精灵球
- 按住`R`使用方向键更改选择。
- 按`R`使用上次选择的精灵球。
- 逃走快捷键
- 战斗开场更快 - 消息和动画/叫声同时发生。
- HP减少加速。
- 战斗调试菜单。
- 在“战斗/背包/宝可梦/逃跑”菜单上按`Select`进入。
- 在野生宝可梦战斗中使用AI标志的选项。
- 火红叶绿/第四世代及以后的，战败时丢失的金钱计算。
- 可配置的经验设置
- 捕捉时获得经验。
- 学习装置影响全队。
- 训练家经验。
- 动态经验。
- 未进化时经验加成。
- 冻伤
- 如果不启用配置则不会替换冰冻效果，因此你可以混合搭配。
- 会心捕获。
- 移除徽章加成（可配置）。
- 每场战斗结束时重新计算能力值。
- 等级100的宝可梦可以获得努力值。
- 反转对战支持。
- 大量其他功能[在此](./include/config/battle.h)。
- ***全面的训练家自定义***
- 昵称、努力值（EVs）、个体值（IVs）、招式、特性、精灵球、亲密度、性格、性别、异色。
- 自定义双打对战支持（与NPC组队）。
- 对战途中对手训练家的出现和对话信息显示。
- 升级后的训练家AI
- 考虑了最新的招式效果。
- 新的标志（FLAG）选项，允许你自定义训练家的AI。
- 更快的计算速度。
- 可以按训练家类型指定其使用的精灵球种类。
- ***宝可梦涵盖第1至第9世代***
- 简化了添加新宝可梦的过程。
- 可以禁用不需要的宝可梦进化链。
- 更新为DS风格的宝可梦图像。
- 更新种族值、属性、特性和蛋组（可配置）。
- 参照《欧米伽红宝石/阿尔法蓝宝石》更新丰缘地区图鉴（可配置）。
- 更新全国图鉴，纳入新宝可梦。
- 宝可梦和动画可视化工具，通过在宝可梦摘要屏幕上按`Select`键访问。
- 第四世代及以后的进化方法，并做出了一些改动：
- 苔藓岩石、冰冷岩石和特殊磁场的位置参照《欧米伽红宝石/阿尔法蓝宝石》进行了改动。
- 也可以使用叶之石、冰之石和雷之石进行进化。
- 好啦鱿只需达到30级即可进化。
- 由于物理上无法同时拥有实时时钟（RTC）和陀螺仪，因此我们跳过了它原本的进化条件需求。
- 仙子伊布使用第八世代及以后的进化方法（亲密度+妖精系招式）。
- 可以像使用进化石那样，直接使用需携带的进化道具。
- 隐藏特性
- 可以通过特性膏药获得。
- 兼容Ghoul的DexNav分支。
- 保留了所有性别差异。
- 为雌性的河马兽、沙河马、皮卡丘和果然翁自定义了雌性图标。
- 传说宝可梦、幻之宝可梦和究极异兽拥有3项完美个体值。
- ***可自定义的形态变化表。完整方法列表[在此](./include/constants/form_change_types.h)***
- 持有道具（如骑拉帝纳/阿尔宙斯）
- 使用道具（如花舞鸟）
- 对于谢米，可以设定在特定时间才能使用
- 昏厥
- 战斗开始和结束（如哲尔尼亚斯）
- 对于苍响/藏玛然特，可同时进行招式的改变
- 在特定地形战斗结束时（如结草儿）
- 在战斗中换下（如海豚侠）
- HP阈值（如达摩狒狒）
- 天气（如飘浮泡泡）
- 回合结束时（如莫鲁贝可）
- 特定时间（如谢米）
- 融合（如酋雷姆）
- ***孵蛋改进***
- 需要香薰孵化的幼年宝可梦蛋现在可以直接孵化（可配置）。
- 1级蛋（可配置）。
- 精灵球遗传（可配置）。
- 蛋招式传递，包括模仿香草（可配置）。
- 使用不变石可确保100%遗传性格（可配置）。
- 第六世代及以后的特性遗传方式（可配置）。
- ***新世代道具。完整列表[在此](./include/constants/items.h)***
- 第六世代及以后的学习装置（可配置）
- 破坏因子
- 大多数第四世代及以后的战斗道具
- ***合并的功能分支（已获授权）***
- [RHH开场动画](https://github.com/Xhyzi/pokeemerald/tree/rhh-intro-credits)由@Xhyzi制作
- 展示我们所有人签名的小环节，体现了项目的集体努力 :)
- [大地图调试](https://github.com/TheXaman/pokeemerald/tree/tx_debug_system)由@TheXaman制作
- 可禁用。
- 默认情况下，在大地图中按`R + Start`键访问。
- **附加功能**：
- *清空盒子*：清空所有盒子中的宝可梦。
- *孵化蛋*：选择队伍中的一个蛋并立即孵化。
- [HGSS风格宝可梦图鉴](https://github.com/TheXaman/pokeemerald/tree/tx_pokedexPlus_hgss)由@TheXaman制作
- 可禁用。
- **附加功能**：
- *支持新的进化方式*。
- *暗色模式*。
- [特性颜色](https://github.com/DizzyEggg/pokeemerald/tree/nature_color)摘要屏幕由@DizzyEggg制作
- [动态多选框](https://github.com/SBird1337/pokeemerald/tree/feature/dynmulti)由@SBird1337制作
- [SaveBlock清理](https://github.com/ghoulslash/pokeemerald/tree/saveblock)由@ghoulslash制作
- [宝可梦跟随&扩展ID](https://github.com/aarant/pokeemerald/tree/followers-expanded-id)由@aarant制作
- 可禁用。
- 包括《心金/魂银》中的宝可梦跟随，包括互动功能。
- **扩展了可能的物体事件ID数量，超出255个**。
- **包含了动态调色板（DOWP）的实现**。
- **附加功能**：
- *宝可梦跟随行走图更新至第八世代*。
- *与我们的宝可梦宝可梦图像可视化工具集成，允许用户浏览宝可梦跟随及战斗图像*。
- ***其他功能***
- 抓起宝可梦时按B键可以像官方新作中那样放下（可配置）。
- 室内跑步（可配置）。
- 可配置的战斗外大地图中毒伤害。
- 可配置的标志（FLAG），用于禁用野生宝可梦遭遇和训练家对战。
- 可配置的标志（FLAG），用于强制或禁用异色宝可梦。
- 可重复使用的招式学习器（TM）（可配置）。
- 《黑2/白2》及以后的驱虫喷雾系统，也支持《Let's Go!皮卡丘/伊布》中的香水。
- 第六世代及以后的努力值上限。
- 包含了pret的所有错误修复。
- 修复了地图上的下雪天气效果。

18
docs/install/chromeos/CHROME_OS_ZH.md Normal file
View File

@ -0,0 +1,18 @@
# ChromeOS编译指南
1. 按照[此页面](https://chromeos.dev/en/productivity/terminal)上的说明启用Linux终端。请确保为Linux安装分配足够的空间。
2. Linux终端安装完成后，在终端中运行以下命令以更新和升级Linux终端：
```console
sudo apt update && apt upgrade
```
3. 然后，通过运行以下命令安装所有依赖项：
```console
sudo apt install build-essential binutils-arm-none-eabi gcc-arm-none-eabi libnewlib-arm-none-eabi git libpng-dev python3
```
‌**注意**‌：项目必须保存在Linux文件系统中的某个目录下，例如`~/Decomps/pokeemerald-expansion`下。

5
docs/install/linux/NIXOS_ZH.md Normal file
View File

@ -0,0 +1,5 @@
# NixOS编译指南
运行以下命令以启动一个包含必要包的交互式 shell：
```bash
nix-shell -p pkgsCross.arm-embedded.stdenv.cc git pkg-config libpng
```

94
docs/install/mac/MAC_OS_ZH.md Normal file
View File

@ -0,0 +1,94 @@
# macOS 编译指南
1. 如果未安装 Xcode 命令行工具，请点击[此处](https://developer.apple.com/xcode/resources/)下载工具，打开终端并运行以下命令：
```bash
xcode-select --install
```
2. - 如果 **未安装 libpng**，请跳转到 [安装 libpng (macOS)](# 安装 libpng (macOS))
- 如果 **未安装 pkg-config**，请跳转到 [安装 pkg-config (macOS)](#安装 pkg-config (macOS))
- 如果 **未安装 devkitARM**，请跳转到 [安装 devkitARM (macOS)](#安装 devkitARM (macOS))
- 如果以上都已安装，请**打开终端**并跳转到 [选择 pokeemerald-expansion 存储位置 (macOS)](#choosing-where-to-store-pokeemerald-expansion-macos)
3. **可选：运行测试**
如果未安装 Homebrew 环境，请参考[此指南](https://brew.sh)安装包管理器。打开终端运行：
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install coreutils
```
4. **可选：通过 Rosetta 运行测试**
- 通常不建议这样做（速度较慢）。多数用户可使用原生工具，但某些情况（如使用仅支持 Intel 的自定义工具链）可能需要此配置
- 需安装 Intel 兼容的 Homebrew，配置方法参考[此说明](https://github.com/Homebrew/brew/issues/9173#issuecomment-729206868)
- 使用 Intel 兼容的 Homebrew 安装 `coreutils`（步骤同第 3 步）
### 安装 libpng (macOS)
<details>
<summary><i>高级用户注意...</i></summary>
> 本指南通过 Homebrew 安装 libpng（最简单方法），高级用户可通过其他方式自行安装
1. 打开终端
2. 如未安装 Homebrew，请按官网说明安装 [Homebrew](https://brew.sh/)
3. 运行以下命令安装 libpng：
```bash
brew install libpng
```
libpng 现已安装完成
如果 **未安装 pkg-config** 请跳转至 [安装 pkg-config (macOS)](#安装 libpng (macOS))；如果 **未安装 devkitARM** 请跳转至 [安装 devkitARM (macOS)](#安装 devkitARM (macOS))
若两者均已安装，请前往 [选择 pokeemerald-expansion 存储位置 (macOS)](#choosing-where-to-store-pokeemerald-expansion-macos)
### 安装 pkg-config (macOS)
<details>
<summary><i>高级用户注意...</i></summary>
> 本指南通过 Homebrew 安装 pkg-config（最简单方法），高级用户可通过其他方式自行安装
1. 打开终端
2. 如未安装 Homebrew，请按官网说明安装 [Homebrew](https://brew.sh/)
3. 运行以下命令安装：
```bash
brew install pkg-config
```
pkg-config 现已安装完成
如果 **未安装 devkitARM** 请跳转至 [安装 devkitARM (macOS)](#安装 devkitARM (macOS))，否则前往 [选择 pokeemerald-expansion 存储位置 (macOS)](#choosing-where-to-store-pokeemerald-expansion-macos)
### 安装 devkitARM (macOS)
1. 从[此链接](https://github.com/devkitPro/pacman/releases)下载 `devkitpro-pacman-installer.pkg` 安装包
2. 打开安装包完成 devkitPro pacman 的安装
3. 在终端运行以下命令安装 devkitARM：
```bash
sudo dkp-pacman -Sy
sudo dkp-pacman -S gba-dev
sudo dkp-pacman -S devkitarm-rules
```
gba-dev 安装时会提示选择软件包，直接按 Enter 键安装全部，然后输入 Y 确认安装
4. 安装完成后，需让系统全局访问 devkitARM。运行以下命令：
```bash
export DEVKITPRO=/opt/devkitpro
echo "export DEVKITPRO=$DEVKITPRO" >> ~/.zshrc
export DEVKITARM=$DEVKITPRO/devkitARM
echo "export DEVKITARM=$DEVKITARM" >> ~/.zshrc
echo "if [ -f ~/.zshrc ]; then . ~/.zshrc; fi" >> ~/.zprofile
```
*注：从 macOS 10.15 开始默认使用 zsh 终端。若从旧版本迁移，可能仍在使用 bash，可通过终端运行 `echo $0` 确认*
<details>
<summary><i>如果终端使用 bash 而非 zsh...</i></summary>
```bash
export DEVKITPRO=/opt/devkitpro
echo "export DEVKITPRO=$DEVKITPRO" >> ~/.bashrc
export DEVKITARM=$DEVKITPRO/devkitARM
echo "export DEVKITARM=$DEVKITARM" >> ~/.bashrc
echo "if [ -f ~/.bashrc ]; then . ~/.bashrc; fi" >> ~/.bash_profile
```
### 安装 Python (macOS)
1. 从[官网](https://www.python.org/downloads/)下载最新版 Python 安装包
2. 打开安装包完成安装
Python 现已安装完成

3
docs/install/windows/CYGWIN_ZH.md Normal file
View File

@ -0,0 +1,3 @@
# cygwin
警告：千万别用，当前Expansion版本无法运行。
此问题源于上游 pret 项目中的 `pokeemerald` 代码库缺陷。