为什么你的 Fight Club 5e 总缺内容？FightClub5eXML 零基础完整配置指南

为什么你的 Fight Club 5e 总缺内容？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

FightClub5eXML 是一个把 D&D 5e 全部官方资料整理成 Fight Club 5e 与 Game Master 5e 应用可导入 XML 文件的开源项目。这篇文章不从功能列表讲起，而是跟着新手最常见的五个真实场景走一遍：内容太少、导入报错、合集不会选、自制内容不会加、更新跟不上。读完您就能自己动手，把一套完整的 D&D 5e 资料库免费装进手机。

装好应用却发现内容匮乏？先弄清 FightClub5eXML 能提供什么

很多人第一次打开 Fight Club 5e 都会愣住：界面很漂亮，但可用的内容只有系统自带的 SRD 基础规则。玩家手册里的职业选项、怪物手册里的图鉴、各大冒险模组的剧情物品，统统没有。买实体书不会同步到应用，应用商店里也找不到官方扩展包可下载。

这正是 FightClub5eXML 存在的意义。它把玩家手册、地下城主指南、怪物手册、Xanathar 指南、塔莎的万事坩埚，以及几十个官方冒险模组的内容，全部转换成了应用可以识别的 XML 格式。项目按"一本书 + 一种内容类型"拆分文件，例如职业文件放在Sources/PlayersHandbook/class-wizard-phb.xml，怪物放在Sources/MonsterManual/bestiary-mm.xml，想找哪个模组的内容就去对应的目录，结构一目了然。

解决导入报错：搞懂合集文件与编译步骤的关系

不少人在网上搜到别人分享的 XML 文件，直接丢进应用却发现导入失败。原因很可能是：仓库里的文件不能直接导入，必须先经过一次"编译"。

项目文档把文件分成两类，这个区分值得记住：

• Collection（合集文件）：仓库里Collections/目录存放的原始素材清单，只列出要合并哪些来源，不能直接导入。
• Compendium（资料总集）：编译后生成的文件，包含全部数据，这才是能导入 Fight Club 5e 的最终成品。

编译只依赖一个命令和两个文件，没有复杂的构建系统：

xsltproc -o Compendiums/CoreOnly.xml Utilities/merge.xslt Collections/CoreOnly.xml

逐段拆解一下：-o指定输出文件的路径；Utilities/merge.xslt是项目提供的合并样式表，负责把多个来源拼成一个总集；Collections/CoreOnly.xml是您选择的合集清单。命令执行完，Compendiums/目录下就会出现可用的资料总集文件。

之所以需要这一步，是因为合并不是简单的拼接：同名职业会被合并（子职业以autolevel形式追加），同名法术的职业列表会被拼接，这些逻辑都封装在合并样式表里。

选择合适合集文件：七种预置组合怎么挑

看到Collections/目录里一堆名字，新手很容易纠结。其实它们是一层层"叠"起来的，从少到多依次是：

新手最稳妥的路径是：先用CoreRulebooks.xml跑通整个流程，确认导入没问题，再逐步升级到CoreOnly.xml。如果手机存储紧张，就不要一上来就选Complete.xml——文件越大，应用加载越慢。各合集的详细说明见 Collections/README.md。

添加自制内容与自定义合集：DIY 专属资料库的合并技巧

玩到深处，您可能想把自己设计的怪物、装备，或者网上流行的自制职业加进去。项目把这一步做得相当开放：每个来源文件本质上是独立的 XML，格式与资料总集一致，只是范围更小。

项目自带一个自制内容模板 Sources/Homebrew.xml，里面已包含血猎人职业等经典自制内容，可以直接作为参考。更进阶的玩法是自建合集——只挑自己需要的来源文件：

<?xml version="1.0" encoding="UTF-8"?> <collection> <doc href="../Sources/PlayersHandbook/races-phb.xml" /> <doc href="../Sources/Homebrew.xml" /> </collection>

把这个文件放进Collections/目录，文件名就是最终资料总集的名称，然后照常执行编译命令即可。合并规则也足够聪明：普通内容直接追加；同名的职业会合并子职业，同名法术会合并职业列表，所以您不需要改动原始文件就能扩充内容。

动手之前，建议先用项目提供的校验工具检查语法，避免导入失败：

xmllint --noout --schema Utilities/compendium.xsd Sources/Homebrew.xml

校验规则定义在 Utilities/compendium.xsd，DIY 前先跑一遍能省下不少排查时间。

跟上内容更新节奏：查看更新日志与重编译的正确姿势

D&D 5e 的内容更新非常频繁，尤其是 Unearthed Arcana 这类试验性内容。项目本身也在持续维护，更新记录集中在 CHANGELOG.md。建议养成两个习惯：

• 更新前先看更新日志，了解这次改了什么、有没有影响您正在用的内容；
• 更新后在小合集上先验证，再重新编译完整合集，避免新版本引入的问题影响整场游戏。

项目还把"正式出版内容"和"UA 试验内容"分开管理，想要抢先体验新机制就选带 UA 的合集，追求稳定就选不带 UA 的版本，互不干扰。

完整安装步骤：从项目文件到手机导入的最小路径

把上面的思路串起来，您只需要五步就能用上完整资料库：

1. 获取项目文件：git clone https://gitcode.com/gh_mirrors/fi/FightClub5eXML，或者直接下载 ZIP 并解压到电脑的文档目录。
2. 安装编译工具：Windows 上执行choco install xsltproc；macOS 上执行brew install libxslt；Linux 用户用系统自带的包管理器安装xsltproc或libxslt即可。
3. 编译合集：在项目根目录执行上文介绍过的xsltproc命令，生成资料总集文件。
4. 传输到手机：把生成的文件通过云盘、数据线或隔空投送传到手机，注意确认设备剩余存储空间。
5. 导入应用：在 Fight Club 5e 中选择导入资料总集，导入前先备份现有游戏数据，以防意外。

走完这一遍，您的应用里就装进了从核心规则到冒险模组的完整内容库。下一步，您可以试试用自建合集只保留自己和队友需要的模块，打造真正个性化的掌上 D&D 资料库。想深入了解自制内容的规范，可以继续阅读 Sources/README.md。🎲

【免费下载链接】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