📥 安装教程

环境要求

安装步骤

1. 将 AdventureSkill-版本号.jar 放入服务器 plugins/ 目录。
2. 启动服务器，插件会自动生成默认配置。
3. 按需修改 config.yml、messages.yml、talents.yml。
4. 执行 /askilladmin reload 热加载配置。
5. 使用 /askilladmin givepoint <玩家> <数量> 发放天赋点。
6. 玩家输入 /askill 打开天赋 GUI。

文件结构

plugins/AdventureSkill/
├── config.yml          # 数据库、群组服限制、GUI、反馈音效
├── messages.yml        # 消息、GUI文本、Lore文本
├── talents.yml         # 天赋树、天赋节点、效果数值
└── data.db             # SQLite 数据库

⌨️ 命令列表

玩家命令

管理命令

🔐 权限节点

🖥️ GUI 操作

图标状态

操作方式

GUI 可配置项

• GUI 标题、大小、槽位布局
• 信息按钮、重置按钮、填充物品
• 未解锁/可加点状态材质
• CustomModelData
• GUI 文本与 Lore
• 操作成功/失败音效

🌳 天赋总览

解锁规则

如果玩家撤回上层天赋点，导致下层天赋不再满足前置条件，系统会自动撤销不合法的下层加点并返还点数。

内置天赋

🧩 天赋配置

基础结构

talents:
  skilled:
    row: 1
    column: 1
    type: normal
    name: '&a熟练'
    material: EXPERIENCE_BOTTLE
    custom-model-data: 0
    max-level: 8
    cost: 1
    description: '提升原版经验获取。'
    effect-lore: '+{value}% 原版经验'
    effects:
      vanilla-exp-bonus-percent-per-level: 1.0

字段说明

效果列表

effect-settings:
  fortune-like-blocks:
    - DIAMOND_ORE
    - DEEPSLATE_DIAMOND_ORE
  vein-mine-ores:
    - DIAMOND_ORE
    - DEEPSLATE_DIAMOND_ORE
  melee-weapons:
    - DIAMOND_SWORD
    - NETHERITE_SWORD

⚔️ 效果机制

机制说明

• 点金：只对配置列表内方块触发额外掉落。
• 老矿工：只对自然生成矿石触发，玩家放置方块不会触发。
• 爆发：只对配置列表内的原版近战武器生效。
• 稳定：通过提高箭矢初速度，使箭矢飞行更远、更直。
• 洗甲：原版没有四肢命中判定，因此会分散影响目标护甲。
• 利刃：基于原版跳劈和攻击冷却判定增强暴击伤害。

⚙️ config.yml

数据库

database:
  type: sqlite
  table-prefix: askill_
  mysql:
    host: localhost
    port: 3306
    database: adventure_skill
    username: root
    password: ''
    pool-size: 10

GUI

gui:
  tree:
    size: 54
    title: '&8AdventureSkill &7| &0天赋树'
    info-slot: 48
    reset-slot: 49
    locked:
      material: GRAY_DYE
      custom-model-data: 0
    available:
      material: LIME_DYE
      custom-model-data: 0

反馈音效

feedback:
  add-point:
    enabled: true
    sound: ENTITY_EXPERIENCE_ORB_PICKUP
    volume: 0.8
    pitch: 1.4

💬 messages.yml

颜色支持

消息、GUI 文本和 Lore 支持以下颜色格式：

• & 传统颜色代码
• &#RRGGBB 十六进制颜色
• <#RRGGBB> 十六进制颜色
• <gradient:#起始色:#结束色>文本</gradient> 渐变色

常用变量

🌐 群组服限制

AdventureSkill 支持 Velocity 群组服环境下的子服与世界限制。插件不需要单独的 Velocity 端 jar，只需要在各个子服的 config.yml 中填写当前子服名称和限制规则。

network:
  server-name: lobby
  velocity:
    enabled: true
    servers:
      whitelist:
        - lobby
        - survival
      blacklist: []
    worlds:
      whitelist:
        - world
        - resource_world
      blacklist:
        - disabled_world

限制范围

• /askill GUI 打开
• GUI 加点与撤点
• 天赋效果触发
• 定时属性刷新
• PAPI 状态判断

🔗 PlaceholderAPI

前缀：%adventureskill_变量%

示例

%adventureskill_points%
%adventureskill_talent_skilled%
%adventureskill_talent_effect_skilled%

❓ 常见问题

玩家提示当前子服或世界未启用？

检查 config.yml 中的 network.server-name、servers.whitelist、worlds.whitelist 和 blacklist 配置。

修改配置后没有生效？

执行 /askilladmin reload。如果是升级后新增配置项，需要手动合并到旧配置文件。

GUI 中图标为什么是灰色染料？

灰色染料表示该天赋尚未满足前置解锁条件。满足条件后会显示绿色染料，投入点数后显示天赋自身材质。

天赋点如何获得？

AdventureSkill 本体不强制绑定经验来源。管理员可通过命令或 API 发放天赋点。

/askilladmin givepoint Steve 10

📝 更新日志

v1.3.0 LATEST

• NEW 新增 Velocity 群组服环境下的子服与世界限制。
• NEW 新增 network.server-name、服务器白名单/黑名单、世界白名单/黑名单。
• IMPROVED 限制覆盖 GUI、加点、撤点、天赋效果和属性刷新。
• NEW 新增 %adventureskill_scope_enabled% 与 %adventureskill_server%。

v1.2.1

• FIX 修复默认配置与消息文件的中文编码显示问题。
• FIX 修复 RGB、HEX、渐变颜色处理异常。
• FIX 修复增益药水延时在部分情况下可能重复处理的问题。
• IMPROVED 优化玩家进服后的天赋效果刷新时机。

v1.2.0

• IMPROVED 调整为单一天赋点池，不再拆分普通天赋点与精英天赋点。
• IMPROVED 取消额外启用操作，天赋只要加点即视为生效。
• NEW GUI 图标状态调整：未解锁、可加点、已加点三态显示。
• NEW 增加加点、撤点、失败、重置等反馈音效配置。
• IMPROVED 丰富天赋 Lore，展示当前加成、下级加成与满级加成。

v1.1.0

• NEW 增加 /askilladmin version 版本命令。
• IMPROVED 优化管理命令帮助内容和 Tab 补全。
• NEW 增加 PlaceholderAPI 支持。
• IMPROVED 完善天赋树前置解锁和撤点校验。

v1.0.0

• NEW 初始版本发布，提供基础天赋树 GUI。
• NEW 支持管理员发放、扣除、设置天赋点。
• NEW 支持玩家通过 GUI 加点、撤点与重置。
• NEW 支持 SQLite / MySQL 数据存储。
• NEW 提供基础发育、机动、生存防护、输出进攻天赋效果。