职业、奖励与排行 - LiSkills 文档

15 项技能成长与“选职赚钱”是两层功能。默认 jobs.yml -> enabled: false，玩家仍可自由提升所有技能；升级奖励示例也默认关闭，避免未经审核的经济设置直接影响生存服。

开启职业

职业菜单命令为 /lsk jobs list、/lsk jobs join mining 和 /lsk jobs leave mining。默认最多选 2 职，加入或退出后的变更冷却为 300 秒。

selection-required: true 表示只向已选职业发收入；disable-unselected-xp: false 表示未选职业仍有技能经验。后者设为 true 才限制未选职业的自然成长。

收入按“实际新增自然经验 × 该技能 money-per-xp”计算，并截断到每日剩余额度。管理员加经验、被取消经验和满级没有新增经验都不付款。默认新增的耐力、治疗、锻造与法术收入为 0，审核消耗成本与挂机风险后再调整。

Vault 本身不是经济数据库，还需安装兼容的经济实现。缺少服务时中文提示，不补造余额。每日额度按 UTC 午夜切换，时钟回拨不会重置。

rewards.yml 可以按技能、起止等级和间隔配置原版物品、金币与管理员指定的控制台命令。自定义物品或外部宠物发放使用明确审核过的控制台命令，不自动下载对应插件。

每条奖励按“规则 ID + 技能”保存已处理等级，降级再升级不能重刷；修改规则 ID 相当于建立新奖励，需谨慎。管理员经验默认不发奖。一次跨级最多处理 32 份，超出部分标记为已处理，避免一次执行大量命令。

收入和奖励先确认独立账本写入，再尝试外部发放。这能防止回滚玩家 PDC 后重复领取，但 Vault、物品与控制台命令不是共同事务：崩溃或外部失败可能出现已记录但未完整发放，需要管理员对账补偿，不会无条件自动重试。

不要通过删除 reward-ledger/ 来解除错误，否则会破坏防重复领取依据。开启大量经济奖励前应评估账本写入成本和本服负载。

/lsk top total 1
/lsk top mining 1
/lsk rank mining

排行榜后台合并本服离线档案与在线快照，查询读取缓存，不在命令线程读盘。默认 300 秒刷新、每页 10 行、每榜最多 1000 人。

技能榜先比较等级，再比较本级经验；榜单计算时先把每项技能等级限制到当前配置的最大等级，total 为这些已启用技能等级的总和，总等级相同时再比较本级经验之和。这个显示限制不改写玩家原档案。名字和 UUID 用于稳定打破并列。刚启动可能显示加载中；未进入缓存范围不代表玩家“世界排名第 0”。

它不是跨服实时榜单。换配置后会清空旧缓存并重新生成。

技能档案、reward-ledger/、世界原生玩家数据都要保留。职业选择与切换冷却、个人 HUD 开关、命名玩家加成等在世界玩家数据中；物品规则在物品本身。