原创 开源 世界管理 简单的垃圾桶 0.1.0

# ============================================================================
#                         WKTrash 主配置文件
# ============================================================================
# 修改配置后，请在服务端控制台执行：trash reload
# 游戏内拥有 wktrash.admin 权限的管理员可执行：/trash reload
#
# YAML 配置注意事项：
# 1. 只能使用空格缩进，不能使用 Tab。
# 2. 建议保留英文半角引号，不要使用中文引号“”。
# 3. 带颜色代码、冒号、# 号的文本建议始终放在双引号中。
# 4. 材质名称必须使用 Minecraft 英文 ID，例如 DIAMOND、STONE。
# 5. 配置错误时插件会在控制台指出问题，并拒绝应用错误配置。
# ============================================================================

gui:
  # 垃圾桶界面顶部显示的标题。
  # 支持传统 & 颜色代码，例如：
  # &0 黑色  &7 灰色  &8 深灰色  &a 绿色  &c 红色  &e 黄色
  title: "&8垃圾桶"

  # GUI 总格数。
  # 只能填写：9、18、27、36、45、54。
  # 每 9 格代表一行；54 格就是 6 行的大箱子界面。
  # 修改大小后，下面两个按钮的 slot 也必须在有效范围内。
  size: 54

  # “确认清空”按钮设置。
  confirm-button:
    # 按钮槽位，槽位从 0 开始计数，而不是从 1 开始。
    # 54 格 GUI 的有效槽位是 0～53；49 大致位于最后一行中间。
    slot: 49

    # 按钮使用的物品材质。必须是当前服务端存在且能作为物品的材质。
    # 材质列表可参考：https://jd.papermc.io/paper/1.20/org/bukkit/Material.html
    material: LIME_CONCRETE

    # 按钮名称，支持 & 颜色代码。
    name: "&a确认清空"

    # 鼠标移到按钮上时显示的说明文字，可以增加或删除行。
    lore:
      - "&7永久删除垃圾桶中的全部物品"
      - "&c此操作无法撤销！"

  # “取消”按钮设置。
  cancel-button:
    # 54 格 GUI 的最后一个槽位是 53。
    # 不能与 confirm-button.slot 使用相同数字。
    slot: 53
    material: RED_CONCRETE
    name: "&c取消"
    lore:
      - "&7关闭垃圾桶并返还全部物品"

# ============================================================================
# 地面掉落物自动清理
# ============================================================================
cleanup:
  # 是否启用定时自动清理。
  # true = 启用；false = 关闭。
  # 关闭后仍可以使用 /trash clean 手动清理。
  enabled: true

  # 自动清理间隔，单位为秒。
  # 600 秒 = 10 分钟；300 秒 = 5 分钟。
  # 必须大于 0。设置过小会频繁扫描实体，不建议低于 30 秒。
  interval-seconds: 600

  # 清理前在这些剩余秒数向在线玩家发送提醒。
  # 例如 60 表示清理前 60 秒提醒一次。
  # 每个数字必须大于 0，并且小于 interval-seconds。
  # 如果不需要任何倒计时提醒，可填写：warnings: []
  warnings: [ 60, 30, 10, 5, 4, 3, 2, 1 ]

  # 参与掉落物清理的世界名称。
  # 空列表 [] 表示清理服务器中的所有世界。
  #
  # 只清理指定世界的写法示例：
  # worlds:
  #   - world
  #   - world_nether
  #   - world_the_end
  #
  # 世界名称必须与服务端目录及多世界插件中的实际名称一致。
  worlds: []

  # 永远不会被自动清理的物品材质白名单。
  # 空列表 [] 表示没有任何材质受到保护。
  # 材质必须使用大写英文 ID，不能填写中文物品名。
  #
  # 保护钻石和下界合金锭的写法示例：
  # material-whitelist:
  #   - DIAMOND
  #   - NETHERITE_INGOT
  material-whitelist: []

  # 物品掉落到地面后，至少存活多少秒才允许被清理。
  # 默认 60 秒，可以避免玩家刚扔出物品就被下一轮任务立即删除。
  # 设为 0 表示不保护刚掉落的物品。
  minimum-age-seconds: 60

  # --------------------------------------------------------------------------
  # 性能保护设置
  # --------------------------------------------------------------------------
  # WKTrash 不会在一个 Tick 内扫描并删除全服所有掉落物，而是拆分到多个 Tick 完成，
  # 避免物品很多时造成明显卡顿。一般服主保持默认值即可。
  performance:
    # 每个 Tick 最多扫描多少个已加载区块。
    # 数值越大，清理完成越快，但单 Tick 压力也越高。
    # 小型服务器建议 8～16；大型群组服子服建议 4～8。
    chunks-per-tick: 8

    # 每个 Tick 最多删除多少个“掉落物实体”。
    # 注意：一组 64 个圆石通常是 1 个实体，而不是 64 个实体。
    # 默认 100 已经足够快，同时可以防止数千个实体在同一 Tick 被集中移除。
    max-removals-per-tick: 100