FightClub5eXML 从零到精通：4 步把 D&D 5e 官方资料装进口袋
【免费下载链接】FightClub5eXMLCreating XML files of all D&D sources compatible with Fight Club 5e and Game Master 5e apps for iOS and Android.项目地址: https://gitcode.com/gh_mirrors/fi/FightClub5eXML
每次开团前，你大概都经历过这样的画面：桌上堆着玩家手册、地下城主指南、怪物手册，外加几本扩展和冒险模组，想查一个法术得翻半天索引，想确认怪物的属性要在章节间来回找。明明手机就在手边，却因为没有离线资料，只能继续和纸质书搏斗。FightClub5eXML 正是为这个烦恼而生的开源项目：它把 D&D 5e 的官方内容统一编译成 XML 数据文件，导入 Fight Club 5e 或 Game Master 5e 应用后，你的移动设备就成了一座随时可查的离线 D&D 资料库。
先弄懂仓库里的"食材"和"菜单"
打开项目会看到两个关键目录：Sources存放按资料书拆分的原始 XML 文件，Collections存放各种"合集清单"。打个比方，Sources 是超市货架上的食材，Collections 是搭配好的菜单，而最终编译出的 Compendium 才是端上桌的那道菜——也就是真正能被应用识别的文件。
仓库里直接下载的 XML 无法导入应用，必须先通过工具把合集"编译"成 compendium。好在项目已经帮你搭配好了几种常用菜单：
- CoreRulebooks：只含玩家手册、地下城主指南、怪物手册三本核心书，最轻量，适合刚入坑、想先熟悉规则的新手。
- CoreOnly：在三本核心书之上加入全部扩展与冒险模组，资料比较全，适合长期带团的主持人。
- Complete：全量版，除官方内容外还包含 Unearthed Arcana、自制内容与第三方资料，内容最丰富，但对存储空间和加载速度要求也更高。
- CorePlusHomebrew-NoUA：想要官方加自制内容、又不想混入测试性质 UA 的玩家，选这个刚刚好。
选哪种全看玩法：开荒期用核心三书足够，常跑模组就上 CoreOnly，喜欢尝鲜再考虑 Complete。
3 分钟完成首次编译
编译工具叫 xsltproc，各平台安装都不难：Windows 装好 chocolatey 后执行choco install xsltproc；macOS 用 Homebrew 执行brew install libxslt；Linux 直接用系统包管理器装 xsltproc 或 libxslt 即可。
工具就位后，先把项目拿到本地：
git clone https://gitcode.com/gh_mirrors/fi/FightClub5eXML然后在项目根目录打开终端，执行这条命令：
xsltproc -o Compendiums/CoreOnly.xml Utilities/merge.xslt Collections/CoreOnly.xml拆开看并不神秘：Utilities/merge.xslt是合并规则，Collections/CoreOnly.xml是待编译的合集，-o指定输出路径。跑完后 Compendiums 文件夹里就会出现可导入的 XML。想一次编译全部合集？项目还提供了批量构建脚本，省去逐条执行的麻烦。
把编译结果搬进手机
这一步没有技术含量，但细节值得留意。先把生成的 XML 传到手机，走 Google Drive、Dropbox 这类云盘最省事，之后在应用里选择"导入文件"即可。传之前顺手看看文件大小——Complete 这类全量合集动辄几十上百 MB，先确认设备存储够用。更重要的一点是，导入新合集前备份应用里已有的角色和自制数据，万一新文件不兼容，还能退回旧版本。
自制内容导入的完整步骤
不想只当消费者？这套方案的接入流程其实很简单：
- 参照现有源文件的结构新建一个 XML，根节点写
<compendium>，把物品、种族、法术等内容分别填到对应的注释位置下。 - 把文件放进 Sources 目录，便于统一管理。
- 在 Collections 目录新建或修改一个合集文件，用
<doc href="../Sources/你的文件.xml" />引用它。 - 重新执行编译命令，自制内容就和官方资料一起被合并进 compendium。
有个细节值得记住：当多个源文件出现同名职业或同名法术时，合并工具会把内容拼接起来。也就是说，想给某个职业加子职、或把某法术加进某个职业的法术表，都不用改动原始文件，只需在自制 XML 里写上名字和新增内容。提交前还可以用 Utilities 目录里的 schema（compendium.xsd）配合 xmllint 校验格式，提前抓出语法错误。
按需裁剪与日常维护
模块化设计是这套方案最聪明的地方。每个来源独立成文件，意味着你可以像自助点餐一样只挑需要的部分：不喜欢某个扩展的职业设计？把它从合集里去掉；新资料发布后，也只需更新对应源文件再重新编译。正是这种可裁剪性，让移动端跑团资料管理真正做到了个性化，自定义合集也不再是高手专属。
性能方面，加载变慢通常是因为合集太大。追求流畅就先从 CoreRulebooks 起步，确认没问题再逐步加料；平时多留意项目更新日志，新版本往往修复数据错误或补充新内容，及时跟进能少踩不少坑。
常见报错排查与求助方向
新手最容易遇到三类问题：命令提示找不到 xsltproc，多半是没装好，先在终端里验证安装；编译失败，检查合集里的<doc href>路径是否指向真实存在的文件；导入后内容缺失，通常是某个源文件格式有误，用 xmllint 按 schema 校验一遍基本能定位。实在解决不了，项目 README 和各目录说明都是不错的求助入口，也可以到社区提问时把报错信息原样贴出，通常很快就有老玩家给出方向。
说到底，FightClub5eXML 解决的不只是"查资料"这一个问题，而是把整套规则书变成可以随身携带、自由组合的数字资产。与其继续在纸质书和零散笔记里挣扎，不如花一个晚上走完上面四步。下一次开团时，所有法术、怪物和规则都在你的口袋里安静待命，你要做的只是翻开手机，把冒险继续下去。
【免费下载链接】FightClub5eXMLCreating XML files of all D&D sources compatible with Fight Club 5e and Game Master 5e apps for iOS and Android.项目地址: https://gitcode.com/gh_mirrors/fi/FightClub5eXML
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
