Kits 礼包插件

轻量级礼包领取插件：GUI 界面领取、三种冷却模式、首次加成、完整物品序列化（附魔/名字/Lore/耐久全保留）。零依赖，开箱即用。

功能特性

• GUI 礼包中心：/礼包 打开菜单，图标 Lore 实时显示领取状态（可领取 / 冷却剩余时间 / 已领完 / 今日已领）
• 三种冷却模式（每个礼包独立配置）：
  • once — 一次性领取（新手包）
  • cooldown — 固定间隔冷却（如每 24 小时）
  • daily — 每日 0 点刷新（签到式）
• 首次加成：开启 first-extra 后首次领取额外获得一份
• 完整物品序列化：手持什么存什么——附魔、自定义名、Lore、耐久全部保留
• 预览模式：Shift+左键 或 /礼包 预览 <id> 只读查看内容，不可拿取
• 动态管理：游戏内创建/删除/添加物品/设置图标，实时写回配置文件
• 背包保护：背包满默认拒绝领取防丢物（可配置改为掉落）
• 中文命令：全套 /礼包 中文子命令，符合国内服习惯

命令

命令	说明	权限
/礼包	打开礼包中心 GUI	kits.use
/礼包 领取 <id>	直接领取指定礼包	kits.use
/礼包 预览 <id>	预览礼包内容	kits.use
/礼包 列表	列出全部礼包	所有人
/礼包 创建 <id> [冷却秒] [模式]	创建礼包	kits.admin
/礼包 删除 <id>	删除礼包	kits.admin
/礼包 添加 <id>	将手持物品加入礼包	kits.admin
/礼包 移除 <id> <序号>	移除指定物品	kits.admin
/礼包 图标 <id>	手持物品设为图标	kits.admin
/礼包 信息 <id>	查看礼包详情	kits.admin
/礼包 重载	重载配置	kits.admin

安装

1. 下载 kits-1.1.0.jar 放入服务器 plugins/ 目录
2. 重启服务器
3. 编辑 plugins/Kits/kits.yml 自定义礼包（内置新手包/每日包示例）

配置示例

kits:
  新手包:
    icon: "CHEST"
    name: "&b新手礼包"
    description:
      - "&7初来乍到，收下这份见面礼！"
    permission: ""
    cooldown-mode: "once"
    cooldown-seconds: 0
    first-extra: false
    items:
      - type: STONE_PICKAXE
        amount: 1
      - type: BREAD
        amount: 16

物品支持 Bukkit 原生序列化格式，附魔等元数据自动保留；也可用 /礼包 添加 手持录入。

兼容性

• 支持核心：Spigot / Paper / Purpur / Leaves
• API 版本：1.16+（spigot-api 1.16.5 编译）
• Java：17+
• 前置依赖：无

开源协议

MIT License

---

Kits (English)

Lightweight kit plugin: GUI-based claiming, three cooldown modes, first-claim bonus, and full ItemStack serialization (enchantments/custom names/lore/durability preserved). Zero dependencies.

Features

• GUI Kit Center: /礼包 opens the menu; icon lore shows real-time claim status (available / cooldown remaining / claimed / daily-wait)
• Three cooldown modes (per-kit):
  • once — one-time claim (starter kit)
  • cooldown — fixed interval (e.g. every 24h)
  • daily — resets at midnight (sign-in style)
• First-claim bonus: enable first-extra to double the first claim
• Full ItemStack serialization: whatever you hold is what gets stored — enchantments, custom names, lore, durability all preserved
• Preview mode: Shift+Click or /礼包 预览 <id> for read-only viewing
• Live management: create/delete/add-items/set-icon in-game, written back to config instantly
• Inventory protection: denies claiming when inventory is full by default (configurable to drop instead)
• Chinese commands: all subcommands in Chinese

Compatibility

• Server: Spigot / Paper / Purpur / Leaves
• API version: 1.16+
• Java 17+
• No dependencies

License

MIT License

Author

TinyAII