Declare的高级职业

AdvancedJobs（Hytale）- 模组概述

一个完全原生、以 GUI 为先的 Hytale 职业系统，灵感来源于 JobsReborn，专为注重进度与经济的生存/服务器打造。

模组功能

AdvancedJobs 增加了一套完整的职业进度层级，玩家可以：

• 通过 UI 加入职业（/jobs 或 /job）
• 通过职业特定行为获得经验和金钱
• 提升职业等级并获得递增奖励
• 在实时 UI 面板中追踪进度和收益
• 使用占位符用于 HUD/计分板/Tab 列表
• 受益于可选的 MMO 技能同步和经济集成

无需玩家进行命令配置。核心玩家操作均在 GUI 中完成。

核心特性

• 职业创建及基于配置的奖励映射
• 每次行动获得经验（破坏、放置、击杀、制作）
• 包含指数经验曲线的等级系统
• 带有倍率和等级缩放的经济报酬
• 每个玩家可同时激活职业数量限制（基于权限）
• 基于权限的职业访问
• GUI 管理员管理工具
• 定时增益效果（经验/经济）
• 占位符支持（含内部回退行为）
• 基于通知的升级提醒（非聊天刷屏）
• 玩家进度持久化存储

默认职业与行为

职业	奖励来源
矿工	仅限使用镐 破坏方块；不包括泥土/土壤；矿石目标配置更高报酬
建造者	仅限放置 以下方块：Furniture_*、Cloth_*、Soil_Clay_*、Rock_*、Wood_*
猎人	击杀实体/玩家（可配置击杀映射）
工匠	严格的明确制作白名单（非通配符所有制作）
炼金术师	在炼金台制作炼金产物，包含配置的药水/炸弹产物专属路由
农夫	放置植物目标 + 配置的农耕制作目标；无破坏奖励
厨师	仅制作 Food_*

命令

/jobs
打开职业 UI。
需要权限：advancedjobs.use

/job
/jobs 的别名。
需要权限：advancedjobs.use

/jobsadmin reload
运行时从磁盘重新加载 jobs_config.json。
需要权限：advancedjobs.admin

权限

advancedjobs.use
允许使用 /jobs 和 /job。

advancedjobs.admin
完全管理员访问（管理员 UI/操作、/jobsadmin reload、无限制最大职业数）。

advancedjobs.job.<jobid>
单个职业访问权限（示例：advancedjobs.job.miner、advancedjobs.job.chef）。

advancedjobs.maxjobs.1 / .2 / .3 / .4
根据权限等级设置最大同时激活职业数量。

advancedjobs.boost.vip（默认示例）
应用配置的权限倍率（经验/经济）。

GUI 概述

• 职业标签：浏览职业、查看状态、加入/离开、打开职业信息
• 活跃标签：显示所有当前激活职业及实时进度
• 进度标签：职业指南 + 当前等级/经验/经济追踪
• 管理员标签：创建/删除职业、编辑奖励映射、应用增益、调整默认设置

占位符支持

标识符：jobs

支持的占位符：

• %jobs_current_job%
• %jobs_level_<job>%
• %jobs_xp_<job>%
• %jobs_income_<job>%

行为：

• 当 PlaceholderAPI 存在时，注册为其内部扩展
• 若 PlaceholderAPI 缺失，文本保持安全/回退（不会崩溃）

经济集成

提供者顺序：

1. EcoTale（首选，若可用）– https://www.curseforge.com/hytale/mods/ecotale
2. VaultUnlock（若 EcoTale 不可用时的回退）– https://www.curseforge.com/hytale/mods/vaultunlocked

所有职业报酬均通过当前激活的提供者存入。

MMOSkillTree 集成

可选的 MMO 同步功能包括：

• 在获得职业经验时奖励 MMOSkillTree 经验
• 可选通过 MMO 技能等级缩放经济
• 可选职业等级同步到 MMO 技能等级
• 可配置的职业到技能映射（包含默认映射）

集成链接：
MMO Skill Tree – https://www.curseforge.com/hytale/mods/mmo-skill-tree

通知

升级消息通过 NotificationUtil 传递，使用图标：

• HayHay_Klop_Head2_Plushie

替代聊天式的升级刷屏。

数据与配置文件

• jobs_config.json
  职业、奖励映射、限制、倍率、增益、集成设置

• players.json
  每个玩家的激活职业、经验/等级进度、总收益

安装说明

• 将模组放置在服务器的 mods 文件夹中
• 可选集成在运行时自动检测
• PlaceholderAPI 和 VaultUnlock 在清单中声明为可选依赖
• VaultUnlock 支持通过经济桥接的反射机制实现回退

可选依赖

• VaultUnlock – https://www.curseforge.com/hytale/mods/vaultunlocked
• MMO Skill Tree – https://www.curseforge.com/hytale/mods/mmo-skill-tree
• PlaceholderAPI – https://www.curseforge.com/hytale/mods/placeholder-api
• EcoTale – https://www.curseforge.com/hytale/mods/ecotale