河豚的技能配置扩展（非官方）

河豚的技能配置扩展（非官方）

为Pufferfish的技能模组提供更多配置选项。

河豚的技能配置扩展（非官方）预览查看大图

河豚技能配置扩展（非官方）

河豚技能配置扩展（非官方）是 NeoForge 1.21.1 服务端为河豚技能（Pufferfish's Skills）添加的进度层级。它增加了个人、FTB 团队和服务端全局的 XP 池；等级上限；可配置的免费/禁用技能；管理员命令；以及可选的 FTB 任务（FTB Quests）奖励。

此非官方附加组件与河豚技能（Pufferfish's Skills）的创建者无任何关联。

依赖项

  • 需要 Pufferfish's Skills 0.18.0 或更高版本。
  • FTB Teams 为可选。团队进度和团队覆盖需要它。
  • FTB Quests 为可选。安装后，PCE 会注册 Puffish Skill Tree Reward（河豚技能树奖励）。

配置

唯一的实例级文件是 config/puffish_configuration_expanded.toml。它会在首次启动时创建。字段按以下顺序继承：

  1. 全局默认设置；
  2. 全局技能树覆盖；
  3. 团队默认设置；
  4. 团队技能树覆盖。

省略的字段会继承。存在的字段会替换继承的值，包括显式空的技能列表。

schema_version = 1
debug = false # 启用额外的诊断日志；错误始终会被记录


[global]
enabled = true
progression_scope = "personal" # personal、team 或 global
minimum_level = 0
maximum_level = 100
always_enabled = []
always_disabled = []
on_team_leave = "retain" # retain 或 restore_personal
insufficient_points_policy = "debt" # debt 或 revoke_random_edge_skills


[global.trees."example:mining"]
progression_scope = "global"
maximum_level = 50
always_enabled = ["starter"]


[teams."00000000-0000-0000-0000-000000000000"]
enabled = true
label = "Blue" # 仅用于文档；匹配使用 UUID
progression_scope = "team"


[teams."00000000-0000-0000-0000-000000000000".trees."example:mining"]
maximum_level = 30
always_enabled = [] # 替换继承的列表
always_disabled = ["overpowered_skill"]

always_disabled 优先于 always_enabled。免费技能不消耗点数。PCE 会记录免费技能之前是否已被购买，以便移除规则时可以正确地恢复或移除该技能。禁用某个前置技能时，仅当没有其他已解锁路径时才会撤销其后续技能。

配置重载是事务性的。无效的重载会使最近一次的有效配置保持生效。

命令

所有命令都需要权限等级 2。

/pce xp <add|set|remove> global <tree_id> <amount>
/pce xp <add|set|remove> team <team> <tree_id> <amount>
/pce points <add|set|remove> global <tree_id> <amount>
/pce points <add|set|remove> team <team> <tree_id> <amount>
/pce whole_levels <add|set|remove> global <tree_id> <amount>
/pce whole_levels <add|set|remove> team <team> <tree_id> <amount>
/pce reload
/pce team-id [team]

团队参数接受 UUID、精确的 FTB 短名称或唯一的显示名称。团队和技能树参数有建议提示。XP 是原始的河豚 XP；set 使用绝对累积 XP，而 remove 则不会低于配置的最低值。点数命令修改奖励点数的资格且下限为零。整级命令保留当前等级内的进度：add 和 remove 相对于当前等级移动，而 set 选择绝对等级。所有等级变更都会遵循配置的最低值和最大值。持久的团队/全局记录允许在所有受影响的玩家离线时进行更改。

FTB 任务奖励

安装 FTB Quests 后，为任务添加 Puffish Skill Tree Reward（河豚技能树奖励）并配置：

  • 河豚技能树，从可用的技能树 ID 中选择；
  • 奖励类型：Experience（经验）、Points（点数）或 Whole Levels（整级）；
  • 一个正数数值。

Experience（经验）添加指定数量的原始技能树 XP。Points（点数）直接添加可用的技能点数，而不改变 XP 或等级。Whole Levels（整级）添加技能树经验曲线升级指定数量完整等级所需的 XP 量。

整级奖励会保留当前等级内的进度。例如，一个拥有 40/100 XP 且处于 4 级的领取者获得一个整级后，将处于 5 级并拥有 40 XP 向 6 级前进。奖励目标为领取者当前生效的个人、团队或全局奖励池。