📥 安装与目录

环境要求

安装步骤

1. 放入 AdventureSkills-2.4.1.jar
2. 启动服务器自动生成配置（旧数据库自动迁移）
3. 编辑 config.yml 中 enabled_normal / enabled_elite
4. /skillsadmin reload

目录结构

plugins/AdventureSkills/
├── config.yml          # 核心配置
├── messages.yml        # 消息文本
├── talent-gui.yml      # 天赋树 GUI (图标/CMD)
├── menu/
│   ├── main.yml        # 主界面 (27格)
│   ├── skill_select.yml
│   ├── leaderboard.yml
│   └── xp_sources.yml
└── data.db             # SQLite 数据库

⚔️ 11 大技能

技能激活

• 最多同时激活 2 个技能（max_active_skills）
• 仅激活的技能获得经验；首次选满标记「已初始化」
• 可通过 GUI 切换激活/取消

技能解锁卷轴 v2.2

替代旧重置系统，Lore 匹配检测单槽解锁。

1. 持有「解锁技能锁定卷」→ 点击解锁按钮或 /ss reset
2. 选择要释放的技能，消耗 1 卷轴（可选扣金币）
3. 槽位释放后可重新选择，等级/天赋不受影响

skill_unlock_scroll:
  material: PAPER
  name: "§c§l解锁技能锁定卷"
  lore:
    - "§7持有该卷轴可在职业技能中"
    - "§7解锁技能的锁定并重新选择新的技能"
  require_gold: false
  gold_cost: 0

📊 经验与来源

升级公式

所需经验 = base_required + (level × per_level_increment)
默认: 100 + (level × 50)
实际经验 = baseAmount × xpRate × defaultMultiplier × anticheatMultiplier × permissionMultiplier

天赋点获取

• 每升 5 级 获 8 NTP（normal_points_per_milestone）
• 等级 10/20/35/50 时各获 1 ETP（elite_point_milestones）
• 权限倍率：skillsystem.xp.multiplier.<N>（如 2.0 = 双倍）

经验来源

🌳 天赋树概述

天赋树由 6 行组成，每行 5 普通 + 1 精英天赋。

双点数系统 v2.4

核心规则

• 普通/精英天赋均最高 5 级，每级消耗 1 对应点数
• 普通解锁：上一行至少 1 个普通天赋满级 (Lv.5)；第 1 行默认
• 精英解锁：上一行精英已选且 ≥ Lv.1；第 1 行默认
• 每行需先选择一个精英天赋（从候选池），再加点
• 切换精英惩罚：默认 1 NTP + 1 ETP
• 操作：左键加点 / 右键减点 / Shift+右键打开切换 GUI

6 大天赋行

🛡️ 天赋池: 行 1-3

第 1 行 · 生存核心 (9 普通 + 3 精英)

第 2 行 · 战斗防御 (8 普通 + 3 精英)

第 3 行 · 近战攻击 (8 普通 + 3 精英)

🏹 天赋池: 行 4-6

第 4 行 · 远程与魔法 (8 普通 + 3 精英)

第 5 行 · PVE 专项 (9 普通 + 3 精英)

第 6 行 · 冒险探索 (8 普通 + 5 精英)

⚙️ 天赋机制

启用天赋配置

每行恰好 5 普通 + 1 精英：

talent:
  enabled_normal:
    survival: [health_boost, slow_hunger, water_resist, natural_regen, fire_resist]
    combat_defense: [armor_boost, explosion_resist, ranged_block, thorns_reflect, counter_storm]
    # ...
  enabled_elite:
    survival: life_link
    combat_defense: shield_master
    # ...

精英天赋选择 v2.4

• 首次选择：免费，从候选池选一个激活
• 切换：扣 1 NTP + 1 ETP，原天赋清零退还 ETP，新天赋从 Lv.0
• 触发级联清除下游精英链

级联回收与休眠 v2.4.1

• 普通级联：行内无满级天赋 → 清空更高行普通天赋，退还 NTP
• 精英休眠：上层精英降至 0 级 → 下游精英进入休眠（保留选择和等级，效果失效）
• GUI 显示 §8§l[休眠]，递归检查整条链路
• 恢复上层等级后下游自动恢复

天赋效果实现

Lore 变量 v2.4.1

⌨️ 命令列表

玩家命令 /ss

别名：/ss_skills

管理命令 /skillsadmin

📋 config.yml

核心参数

core:
  max_active_skills: 2
  max_skill_level: 50
  normal_points_per_milestone: 8
  normal_point_interval: 5
  elite_point_milestones: [10, 20, 35, 50]
  elite_switch_penalty_normal: 1
  elite_switch_penalty_elite: 1

经验倍率

xp:
  base_required: 100
  per_level_increment: 50
  default_multiplier: 0.5
  mining:
    ore_break: 3.0
    stone_break: 0.5
    deepslate_break: 0.8

BossBar / ActionBar

boss_bar:
  enabled: true
  stay_ticks: 60
  animate_progress: true
  format: "{skill_color}{skill_name} Lv.{level}  &f{current_xp}&7/&f{required_xp}  &e+{gained_xp}"
  colors:
    farming: GREEN
    mining: WHITE
    fighting: RED

action_bar:
  enabled: true
  format: "{skill_color}{skill_name} &7{current_xp}&8/&7{required_xp} &e+{gained_xp}"

性能

音效

sounds:
  level_up: { sound: ENTITY_PLAYER_LEVELUP, volume: 1.0, pitch: 1.0 }
  milestone: { sound: UI_TOAST_CHALLENGE_COMPLETE, total_levels: [10,25,50,75,100] }
  talent_allocate: { sound: BLOCK_ENCHANTMENT_TABLE_USE }
  talent_deallocate: { sound: BLOCK_GRINDSTONE_USE }
  skill_unlock: { sound: ENTITY_PLAYER_LEVELUP, pitch: 0.5 }

防作弊

anticheat:
  enabled: true
  frequency_window_seconds: 60
  max_events_per_window: 100
  throttle_multiplier: 0.1
  ban_duration_minutes: 10

agility_cap:
  max_xp_per_30min: 500.0

• 60 秒内 >100 次 → 经验降至 10%
• >300 次 (3x) → 10 分钟封禁
• 敏捷 30 分钟上限 500 基础经验
• 放置方块追踪 + 作物成熟度 + 传送距离 10 格

禁止世界

disabled_worlds:
  - "world_lobby"
  - "world_hub"

🖥️ GUI 与菜单

GUI 一览

talent-gui.yml

title: "&0&l✦ 天赋树 &8[&aNTP:{normal_points} &bETP:{elite_points}&8]"
bar: { filled: "■", empty: "□", filled_color: "&a", empty_color: "&8" }
icons:
  health_boost: { locked: 40101, unlocked: 40102, maxed: 40103 }
  # ... (36 天赋 CustomModelData)

main.yml 主界面

messages.yml

支持 § 颜色码和变量占位符。分类：技能操作 / GUI 标题 / 重置 / 经验等级 / 管理员 / 天赋树 / 防作弊。

🔑 权限与集成

权限节点

PlaceholderAPI

标识符：%skillsystem_xxx%

数据库

SQLite (data.db)，5 张表：

插件联动

📝 更新日志

v2.4.1 最新

• NEW 精英天赋休眠机制 — 上层精英降至 0 级时下游休眠而非清除
• FIX 精英解锁链递归检查整条链路
• FIX 天赋 GUI 效果值正确读取 config 覆盖值
• NEW Lore 变量占位符 ({epl}/{unit}/{max_effect}...)

v2.4.0

• NEW 双点数系统 (NTP + ETP)
• NEW 天赋树布局重构 — 每行 5 普通 + 1 精英
• NEW 精英天赋选择 GUI + 切换惩罚
• NEW 精英里程碑 (10/20/35/50)
• NEW 级联回收重构 — 普通/精英分链

v2.3.0

• Java 21；CraftEngine 软依赖；宝石鉴定师/花朵采集师；70 天赋候选池

v2.2.0

• 天赋候选池 68 个；技能解锁卷轴；禁止世界；天赋音效