StartKit —— 新玩家初始物资管理插件

📌 简介

StartKit 是一款轻量级的 Paper/Spigot 插件，专为 **11thMay 五月十一服务端** 打造。新玩家首次加入服务器时，自动获得预先配置好的初始物资，让开荒体验更友好。

无需任何前置插件，开箱即用。

✨ 特性

🎁 **自动发放** — 玩家首次加入时自动获得物资，老玩家不受影响
🌐 **多语言** — 内置简体中文 / English，改一个字段即可切换
⚙️ **完全可配置** — 物资种类、数量、自定义名称、描述，全部通过 config.yml 控制
🔄 **热重载** — /startkit reload 即时生效，无需重启服务器
🛡️ **容错稳健** — 配置写错不会崩服，自动回退到内置默认值
📦 **背包满保护** — 物品栏满时自动掉落地面，不会丢失
🎨 **精美控制台输出** — 蓝色方块组成的启动横幅

📦 默认物资

物品	数量
铁胸甲	1
盾牌	1
铁剑	1
熟牛肉	10
火把	5

以上所有物品均可在配置文件中修改。

📋 命令 & 权限

命令	说明	权限
`/startkit`	查看帮助	`startkit.use`(默认所有人)
`/startkit reload`	重载配置文件	`startkit.reload`(仅 OP)
`/sk`	`/startkit`的别名	同上

⚙️ 配置

插件首次运行后，配置文件位于 plugins/StartKit/config.yml，完整内容如下：

# 语言: zh_cn | en_us
language: zh_cn

# 初始物资
kit:
  items:
    - material: IRON_CHESTPLATE
      amount: 1
      name: ""
      lore: []
    - material: SHIELD
      amount: 1
    - material: IRON_SWORD
      amount: 1
    - material: COOKED_BEEF
      amount: 10
    - material: TORCH
      amount: 5

messages:
  zh_cn:
    prefix: "&9[&bStartKit&9]&r "
    kit_received: "&a欢迎！你已获得初始物资！"
    # ...
  en_us:
    prefix: "&9[&bStartKit&9]&r "
    kit_received: "&aWelcome! You have received the starter kit!"
    # ...

配置说明

material — 物品类型，全大写英文（如 DIAMOND_SWORD），完整列表见 Paper API
amount — 数量，范围 1-64
name — 自定义名称，支持 & 颜色码，留空 = 使用默认名称
lore — 物品描述文字，支持 & 颜色码，[] 表示无描述

添加自定义物品示例

- material: DIAMOND_SWORD
  amount: 1
  name: "&b新手光剑"
  lore:
    - "&7一把闪闪发光的剑"
    - "&e来自 LGDfort 的礼物"

修改后游戏内执行 /startkit reload 即可生效。

📥 安装

下载 StartKit-1.0-SNAPSHOT.jar
放入服务器的 plugins/ 文件夹
重启服务器或执行 /reload confirm
插件自动生成 plugins/StartKit/config.yml
按需修改配置 → /startkit reload

要求：Paper/Spigot 1.21+，Java 21+

🌐 语言切换

编辑 config.yml 第一行：

language: en_us

然后 /startkit reload，所有消息切换为英文。

🖥️ 控制台效果

启动时控制台会显示蓝色方块组成的艺术字：

╔══════════════════════════════════════════╗
║                                          ║
║          L G D f o r t                  ║
║          S t a r t K i t                ║
║                                          ║
╠══════════════════════════════════════════╣
║  ✓ 插件已成功运行！                      ║
╚══════════════════════════════════════════╝