FantasyPower is an RPG ability mod for Minecraft 1.21.1 on NeoForge.
Mining, fighting, farming, and exploring grant experience in their respective skill categories. Leveling a skill awards category-specific skill points that can be spent to unlock new abilities or improve abilities you already know. Each of the ten categories progresses independently, encouraging players to build around the activities and abilities they value most.
The mod currently includes 10 skill categories and 36 abilities, ranging from active skills and passive bonuses to loot changes and golem enhancements. The in-game ability screen shows descriptions, level requirements, and skill-point costs. Hover over the purchase button to see any unmet requirements.
Install matching versions of the following on both the client and server:
| Dependency | Version |
|---|---|
| Minecraft | 1.21.1 |
| NeoForge | 21.1.x |
| FantasyPower | 1.0.0 |
Place the mod JAR in the instance's mods/ directory. For single-player, a local installation is enough; multiplayer requires the mod on both the client and server.
Client settings are stored in config/fantasypower-client.toml. You can switch Charged Leap's charging input from its dedicated key to the jump key. The default dedicated key is V, and it can be rebound in Minecraft's Controls menu.
Server settings are stored per world at:
saves/<world>/serverconfig/fantasypower-server.toml
For dedicated servers, use <world directory>/serverconfig/fantasypower-server.toml. These settings control the global experience multiplier and whether the following data is retained after death:
- Experience and skill-point records for each category
- Learned abilities and their ranks
- Daily experience counters
- Usage state for once-per-day abilities
- World Traveler container bindings and filters
All retention options are enabled by default, matching the mod's original behavior.
FantasyPower stores its level curves, experience sources, purchase requirements, and ability values in data packs. Modpack authors can override built-in definitions by using the same IDs—for example, to change an ability's cooldown, range, probability, or cross-category level requirement.
Data-driven customization means adjusting content already supplied by FantasyPower; defining an entirely new ability in JSON does not automatically add it to the screen or runtime.
See the data format documentation, the skill and ability catalog, and the ready-to-load override example in examples/datapack/.
Java 21 is required. Clone the repository and run:
./gradlew buildOn Windows:
.\gradlew.bat buildThe generated JAR is written to build/libs/.
After changing data files, validate the bundled examples with Node.js 18 or later:
node tools/validate-examples.mjsServer administrators can also run /fantasypower validate in game to validate the definitions loaded by the server.
/fantasypower progress <skill>— Show your level, experience, and skill points in a category./fantasypower add_xp <targets> <skill> <amount>— Grant category experience to players./fantasypower purchase <ability>— Unlock or upgrade an ability./fantasypower rank <ability>— Show an ability's purchased rank and currently active rank./fantasypower validate— Validate built-in definitions, references, and prerequisites.
Administrative commands require permission level 2. See the presentation-layer documentation for visual-effect development details.
If the game crashes or an ability or interface does not behave correctly, open an issue and include the versions of FantasyPower and NeoForge. Please attach latest.log or the crash report when available.
Code and build tooling are licensed under MPL-2.0. Schemas and override examples are licensed under MIT. Original textures, models, animations, and other artwork remain All Rights Reserved, but may be distributed inside modpacks as part of an unmodified official FantasyPower JAR. See LICENSES.md for details.
FantasyPower 是一个运行在 Minecraft 1.21.1 / NeoForge 上的 RPG 能力模组。
挖矿、战斗、种田或探索都会带来对应分类的经验。升级后得到的技能点可以拿来学习新能力，也可以继续强化已经掌握的能力。十个分类各有自己的成长路线，技能点互不通用，所以不必把所有玩法都塞进同一套等级里。
模组目前提供 10 个技能分类和 36 项能力，包括主动技能、被动加成、战利品变化和傀儡强化。能力界面可以直接查看说明、等级要求和技能点消耗；如果还有条件没满足，把鼠标停在购买按钮上就能看到完整列表。
客户端和服务端需要安装相同版本的以下内容：
| 依赖 | 版本 |
|---|---|
| Minecraft | 1.21.1 |
| NeoForge | 21.1.x |
| FantasyPower | 1.0.0 |
把模组 JAR 放进游戏实例的 mods/ 文件夹即可。单人游戏只需要安装在本地；进入服务器时，客户端和服务端都要安装。
客户端配置在 config/fantasypower-client.toml。其中可以把“跃斩”的蓄力方式从独立按键改为空格键；默认按键是 V，也可以在游戏的按键设置中重新绑定。
服务端配置按存档保存，文件位于：
saves/<存档>/serverconfig/fantasypower-server.toml
专用服务器对应 <世界目录>/serverconfig/fantasypower-server.toml。这里可以调整全局经验倍率，以及玩家死亡后是否保留：
- 各分类的经验和技能点记录
- 已学习能力及其阶级
- 每日经验获取计数
- 每日一次能力的使用状态
- “环球旅行者”的容器绑定和过滤列表
这些选项默认都是保留，与模组原本的行为一致。
FantasyPower 的等级曲线、经验来源、购买条件和能力数值放在数据包中。整合包可以用相同 ID 覆盖内置定义，例如修改某项能力的冷却、范围、概率或跨分类等级要求。
这里的数据驱动指的是“调整 FantasyPower 已有内容”，不是用 JSON 编写全新的能力。额外创建的能力定义不会进入能力界面和运行时。
格式说明见 数据结构，内置 ID 可查阅 技能与能力目录。examples/datapack/ 中还有一份可直接加载的覆盖示例。
需要 Java 21。克隆仓库后运行：
./gradlew buildWindows 可以使用：
.\gradlew.bat build生成的 JAR 位于 build/libs/。
修改数据后，可以用 Node.js 18+ 运行仓库自带的检查：
node tools/validate-examples.mjs进入游戏后，管理员还可以执行 /fantasypower validate 检查服务器实际加载的内置数据。
/fantasypower progress <skill>：查看自己的分类等级、经验和技能点。/fantasypower add_xp <targets> <skill> <amount>：给玩家增加指定分类的经验。/fantasypower purchase <ability>：购买或升级能力。/fantasypower rank <ability>：查看能力的购买阶级与当前生效状态。/fantasypower validate：检查内置定义、引用和前置依赖。
管理类命令需要权限等级 2。完整的视觉表现开发说明放在 表现层文档。
遇到崩溃、能力没有生效或界面异常时，请在 Issues 中提交反馈，并附上 FantasyPower 和 NeoForge 的版本。若游戏生成了 latest.log 或崩溃报告，也请一并上传。
代码和构建工具使用 MPL-2.0。Schema 与覆盖示例使用 MIT；原创贴图、模型、动画等美术资源保留所有权利，但可以随未经修改的官方 FantasyPower JAR 一同放入整合包。细则见 LICENSES.md。