? Kits
为玩家的模组提供最简单的发放方式。 将物品放入你的背包,输入一条命令即可完成。
提供简洁的 GUI、冷却时间、一次性模组、预览功能以及新手的初始模组。无需繁琐的设置,无依赖项。
✨ 特性
- ? 秒级创建模组 –
/createkit <name> [cooldown] 保存你当前的整个背包内容,包括盔甲和副手
- ?️ 精美 GUI –
/kit 打开一个菜单,显示所有模组及其状态:
- ? 可用
- ? 可用时间:2小时15分
- ⛔ 已领取 / 无权限
- ? 模组预览 – 右键点击任意模组,可在领取前查看其具体内容
- ⏱️ 灵活的冷却时间 –
30m、1h、1d12h、7d… 或设置 0 表示无冷却
- ?️ 一次性模组 – 将冷却时间设为
-1,该模组仅可领取一次
- ?️ 自动装备盔甲 – 盔甲会自动穿戴到空的盔甲槽位中,盾牌进入副手
- ? 物品不会丢失 – 无法容纳的物品会掉落在玩家脚边
- ? 初始模组 – 新玩家首次加入服务器时自动获得一个模组
- ? 向其他玩家发放模组 – 在聊天栏或控制台使用
/kit <name> <player>(非常适合投票、宝箱、活动等场景)
- ? 可选的单个模组权限 –
kits.kit.<name>
- ? 持久化存储 – 冷却时间在重启和重载后依然保留
- ? 所有消息均可配置 – 完整支持
& 颜色代码
- ⚡ 轻量级且兼容 Folia – 无依赖项,无重复任务,后台无任何运行进程
- ? 支持 1.20 → 26.x – 一个 jar 文件即可兼容 Paper、Purpur 和 Folia,覆盖从 1.20 到最新版本的范围
? 命令
| 命令 |
描述 |
权限 |
/kit |
打开模组菜单 |
– |
/kit <name> |
领取一个模组 |
– (或 kits.kit.<name>) |
/kit <name> <player> |
给某玩家发放模组(无冷却) |
kits.admin |
/createkit <name> [cooldown] |
根据当前背包创建模组 |
kits.admin |
/delkit <name> |
删除一个模组 |
kits.admin |
/kit reload |
重载配置和模组数据 |
kits.admin |
提示: 执行 /createkit 时主手中持有的物品将成为该模组在菜单中的图标。
? 权限
| 权限 |
描述 |
默认值 |
kits.admin |
创建、删除、发放模组,重载配置 |
OP |
kits.bypass.cooldown |
忽略所有冷却时间 |
OP |
kits.kit.<name> |
访问某个模组(仅在 require-permission: true 时生效) |
– |
kits.kit.* |
访问所有模组 |
OP |
⚙️ 配置
# 是否需要 kits.kit.<name> 权限才能领取模组
require-permission: false
# 玩家首次加入时获得的模组("" = 禁用)
first-join-kit: "start"
# 菜单标题
menu-title: "&8Kits"
消息默认使用英文。
所有消息和菜单文本均可在 config.yml 中进行修改。
? 快速开始
- 将
Kits.jar 放入服务器的 plugins 文件夹并重启服务器
- 在背包中准备好初始装备
- 运行
/createkit start 1d
- 完成 – 新玩家首次加入时将自动获得该模组,其他玩家每天可通过
/kit 领取
? 质量保障
Kits 包含 18 个自动化测试,涵盖:领取、冷却时间、一次性模组、权限控制、满背包处理、GUI 点击、重载机制以及无效输入处理。
同时也在真实服务器环境中进行了测试:Paper 1.20.1、1.20.6、1.21.11、26.3 以及 Folia 1.20.1、26.3。
? 要求
- Paper、Purpur 或 Folia 1.20 – 26.x(一个 jar 文件适配所有版本)
- Java 17+(与你服务器版本所需版本一致即可)
? 发现 bug 或有想法?欢迎留言反馈 – 我们始终欢迎你的意见!
? Kits
The simplest way to give your players kits. Put items in your inventory, type one command, done.
Clean GUI, cooldowns, one-time kits, previews and a starter kit for new players. No setup headaches, no dependencies.
✨ Features
- ? Create kits in seconds –
/createkit <name> [cooldown] saves your whole inventory, armor and offhand included
- ?️ Beautiful GUI –
/kit opens a menu showing every kit and its status:
- ? Available
- ? Available in: 2h 15m
- ⛔ Already claimed / No access
- ? Kit preview – right-click any kit to see exactly what's inside before claiming
- ⏱️ Flexible cooldowns –
30m, 1h, 1d12h, 7d… or 0 for none
- ?️ One-time kits – use
-1 as the cooldown and the kit can be claimed only once, ever
- ?️ Auto-equip armor – armor goes straight onto empty armor slots, shields into the offhand
- ? Nothing gets lost – items that don't fit are dropped at the player's feet
- ? Starter kit – new players automatically get a kit on their first join
- ? Give kits to others –
/kit <name> <player> from chat or console (great for votes, crates, events)
- ? Optional per-kit permissions –
kits.kit.<name>
- ? Persistent – cooldowns survive restarts and reloads
- ? Every message is configurable – full
& color code support
- ⚡ Lightweight & Folia ready – no dependencies, no repeating tasks, nothing running in the background
- ? 1.20 → 26.x – one jar works on Paper, Purpur and Folia from 1.20 up to the latest version
? Commands
| Command |
Description |
Permission |
/kit |
Open the kits menu |
– |
/kit <name> |
Claim a kit |
– (or kits.kit.<name>) |
/kit <name> <player> |
Give a kit to a player (no cooldown) |
kits.admin |
/createkit <name> [cooldown] |
Create a kit from your inventory |
kits.admin |
/delkit <name> |
Delete a kit |
kits.admin |
/kit reload |
Reload config and kits |
kits.admin |
Tip: the item you hold in your main hand while running /createkit becomes the kit's icon in the menu.
? Permissions
| Permission |
Description |
Default |
kits.admin |
Create, delete, give kits, reload |
OP |
kits.bypass.cooldown |
Ignore all cooldowns |
OP |
kits.kit.<name> |
Access to a kit (only when require-permission: true) |
– |
kits.kit.* |
Access to all kits |
OP |
⚙️ Configuration
# Require kits.kit.<name> to claim a kit
require-permission: false
# Kit given on a player's first join ("" = disabled)
first-join-kit: "start"
# Menu title
menu-title: "&8Kits"
Messages are in English by default.
All messages and menu texts can be changed in config.yml.
? Quick start
- Drop
Kits.jar into your plugins folder and restart the server
- Fill your inventory with starter gear
- Run
/createkit start 1d
- Done – new players get it on first join, everyone else can claim it daily with
/kit
? Quality
Kits is covered by 18 automated tests: claiming, cooldowns, one-time kits, permissions, full inventories, GUI clicks, reloads and invalid input.
It is also tested on real servers: Paper 1.20.1, 1.20.6, 1.21.11, 26.3 and Folia 1.20.1, 26.3.
? Requirements
- Paper, Purpur or Folia 1.20 – 26.x (one jar for all versions)
- Java 17+ (whatever your server version needs)
? Found a bug or have an idea? Leave a comment – feedback is always welcome!
评论 0
登录后参与评分
还没有评论,来抢沙发吧