Katacr
输入至少两个字符

等级配置:levels.yml

文档版本: v1.1.0

levels.yml 文件定义了公会的等级系统，包括升级所需经验、成员上限、金库容量、可用的 Buff 等内容。

文件位置#

plugins/KaGuilds/levels.yml

配置结构#

# KaGuilds Levels 配置文件
# 公会等级设置 - 此文件包含所有公会等级的配置信息

levels:
  1:
    need-exp: 0
    max-members: 10
    max-money: 50000
    tp-money: 200
    vaults: 1
    bank-interest: 0.5
    use-buff:
      - NightVision
      - Speed

  2:
    need-exp: 5000
    max-members: 20
    max-money: 100000
    tp-money: 150
    vaults: 2
    bank-interest: 0.6
    use-buff:
      - NightVision
      - Speed
      - Haste
      - Jump

  3:
    need-exp: 10000
    max-members: 30
    max-money: 200000
    tp-money: 100
    vaults: 3
    bank-interest: 0.7
    use-buff:
      - NightVision
      - Speed
      - Haste
      - Jump
      - WaterBreathing
      - Luck

  4:
    need-exp: 20000
    max-members: 40
    max-money: 400000
    tp-money: 60
    vaults: 4
    bank-interest: 0.8
    use-buff:
      - NightVision
      - Speed
      - Haste
      - Jump
      - WaterBreathing
      - Luck
      - Strength
      - Resistance

  5:
    need-exp: 50000
    max-members: 50
    max-money: 600000
    tp-money: 30
    vaults: 5
    bank-interest: 1.0
    use-buff:
      - NightVision
      - Speed
      - Haste
      - Jump
      - WaterBreathing
      - Luck
      - Strength
      - Resistance
      - FireResist
      - Regeneration
      - Absorption

配置选项详解#

need-exp#

升级到该等级所需的经验值。

need-exp: 0

  • 类型: 整数

  • 说明:

    • 公会达到此等级需要的总经验
    • 1 级通常设置为 0（默认等级）
    • 后续等级递增，如 5000, 10000, 20000...

  • 示例:

    levels:
  1:
    need-exp: 0      # 1 级无需经验
    #...
  2:
    need-exp: 5000   # 从 1 级升到 2 级需要 5000 经验
    #...
  3:
    need-exp: 10000  # 从 2 级升到 3 级需要 10000 经验
    #...

max-members#

该等级下的公会最大成员数量。

max-members: 10
  • 类型: 整数
  • 说明:
    • 公会达到此等级后，最多可以拥有的成员数
    • 超过此限制，新成员无法加入
    • 通常随等级提升而增加

max-money#

该等级下的公会金库最大金币容量。

max-money: 50000
  • 类型: 整数
  • 说明:
    • 公会金库可以存储的最大金额
    • 超过此限制，无法继续存入金币
    • 通常随等级提升而增加

tp-money#

使用公会传送所需的金币（从公会金库扣除）。

tp-money: 200
  • 类型: 整数
  • 说明:
    • 成员使用 /kg tp 传送到公会地点时扣除的费用
    • 等级越高，费用越低（优惠）
    • 从公会金库中扣除，不是个人钱包

vaults#

该等级下可使用的公会仓库数量。

vaults: 1
  • 类型: 整数
  • 说明:
    • 公会可以使用的仓库数量
    • 最大支持 9 个仓库
    • 通常随等级提升而增加

bank-interest#

公会金库每日利息百分比。

bank-interest: 0.5
  • 类型: 浮点数
  • 说明:
    • 每日自动为公会金库增加利息
    • 基于当前金库余额计算
    • 0.5 表示每天增加 0.5%
    • 通常随等级提升而增加

计算示例:

金库余额: 10000 金币
等级: 1 (利息 0.5%)
每日增加: 10000 × 0.005 = 50 金币
新余额: 10050 金币

use-buff#

该等级下可使用的 Buff 列表。

use-buff:
  - NightVision
  - Speed
  - Haste
  • 类型: 列表
  • 说明:
    • 公会成员可以购买的 Buff 类型
    • 必须在 buffs.yml 中定义过的 Buff
    • 通常随等级提升解锁更多 Buff