WkKit icon

WkKit -----

Gift Pack|Automatic refresh Kit plugin based on Cron expression! - Support 1.21.5✅Folia✅




Fix some known problems.
----------, Jun 29, 2025

  • Fix the issue where low-version email or menu cannot claim the gift package.
  • Fix the version number error of the lower version。
----------, Jun 27, 2025

- The new version updates the automatic download plugin
- Fix some language file errors
----------, Jun 16, 2025

  • Repair some problem on use kit which has command.
----------, Jun 12, 2025

  • Compatible with Folia core and versions 1.2 and Bukkit 1.21.5.
  • Fix some problems.
----------, Jun 12, 2025

Delete the missing "LOG_SAVED" language prompt on the plugin save log and Fix the issues caused by the update of the new version of NBTItem syntax:
  • Mailbox item collection
  • GUI Editing
----------, Jun 10, 2025

  • Fix the problem of the SQL statement
(No new features will be added after this version update. The update of WkKitPlus is currently being planned)
----------, May 31, 2025

  • Full compatibility with Minecraft 1.12 and below, as well as 1.20.5 and above. All NBT, GUI, and kit features now work stably across versions.
  • Enhanced MySQL configuration: added useSSL and tablePrefix options. All SQL operations now support table prefix placeholders, improving database compatibility and security.
  • Comprehensive NBT-API upgrade: all legacy NBTItem usages have been replaced with the new API (ReadWriteNBT, NBT.itemStackToNBT, NBT.itemStackFromNBT, etc.), strictly following official best practices.
  • The writing and reading of the wkkit tag for kit items are now fully adapted to both old and new NBT structures, with automatic version detection to ensure correct kit name retrieval on 1.20.5+.
  • Added utility methods ItemEditer.hasWkKitTag and ItemEditer.getWkKitTagValue to standardize wkkit tag checking and retrieval; all related code has been globally refactored.
  • All GUI kit group, kit editing, item saving, and listener logic involving the wkkit tag have been refactored with the new API and utility methods, with null checks to prevent NPEs.
  • Item utility classes such as PlayerHead, GlassPane, and Barrier are now fully compatible with the new NBT-API and multi-version support.
  • Server version retrieval and comparison now support precise versions (e.g., 1.21.1, 1.20.5), and all version branching logic has been upgraded.
  • The /give command now sends kits to the mailbox if the player is offline or has insufficient inventory space, improving delivery experience and fault tolerance.
  • Fixed the issue where expandable menus skipped the claim cooldown, ensuring all kit claim logic is accurate.
  • Fixed issues caused by NBT structure changes, such as kit group click failures and kit name retrieval errors.
  • Removed all direct dependencies on NBTItem, thoroughly cleaning up legacy API usage for better code consistency and maintainability.
  • Full multi-language support: now automatically loads Simplified Chinese, Traditional Chinese (Taiwan/Hong Kong), English, Japanese, and Korean language packs based on system locale or config settings.
  • Supports user-defined language files: simply add your yml file to the Language folder and set it in the config to enable automatic recognition.
  • Improved language file loading logic: if the specified language is not found, it will automatically fall back to English for better compatibility and usability.
  • Removed all deprecated Locale usages, now uses getLanguage() and getCountry() for locale detection, making the code more modern and robust.
  • All MySQL, log management, kit, menu, CDK, and other prompt texts are fully internationalized; all info/warning/severe and player messages support multi-language.
中文日志:
  • 全面适配Minecraft 1.12及以下、1.20.5及以上版本,所有NBT、GUI、礼包等功能均可跨版本稳定运行。
  • MySQL配置增强,支持useSSL和tablePrefix参数,所有SQL操作支持表前缀占位符,提升数据库兼容性和安全性。
  • NBT-API全面升级,所有旧版NBTItem相关用法全部替换为新API(ReadWriteNBT、NBT.itemStackToNBT、NBT.itemStackFromNBT等),并严格遵循官方推荐写法。
  • 礼包物品wkkit标签的写入与读取方式全部适配新旧NBT结构,自动判断版本,确保1.20.5及以上能正确识别和获取礼包名。
  • 新增ItemEditer.hasWkKitTag和ItemEditer.getWkKitTagValue等工具方法,统一处理wkkit标签的判断与获取,所有相关代码已全局替换。
  • GUI礼包组、礼包编辑、物品保存、监听器等所有涉及wkkit标签的逻辑,全部用新API和工具方法重构,并加上判空保护,防止NPE。
  • PlayerHead、GlassPane、Barrier等物品工具类全部适配新版NBT-API和多版本兼容。
  • 服务器版本号获取与比较支持精确到小数点(如1.21.1、1.20.5),所有分流逻辑均已升级。
  • Give指令调整为玩家离线、背包空间不足时自动发送至邮箱,提升发放体验和容错性。
  • 修复展开型菜单跳过领取时间的问题,确保所有礼包领取逻辑准确无误。
  • 修复了因NBT结构变更导致的礼包组点击无效、礼包名获取失败等问题。
  • 移除所有对NBTItem的直接依赖,彻底清理旧API残留,提升代码一致性与可维护性。
  • 全面适配多语言,支持简体中文、繁体中文(台湾/香港)、英文、日语、韩语等,自动根据系统语言或配置文件自动加载对应语言包。
  • 支持用户自定义添加语言文件,只需将yml文件放入Language文件夹并在配置中设置即可自动识别。
  • 移除所有已过时的Locale写法,统一采用getLanguage()和getCountry()判断,提升代码现代性。
  • MySQL、日志管理、礼包、菜单、CDK等所有提示文本全部国际化,所有info/warning/severe和玩家消息均支持多语言。
----------, May 25, 2025

  • Version 1.21.4 is adopted
  • Fixed logical issues with Get fetch
----------, Jan 9, 2025

2024-12-10 (1.3.1)
- Fixed DoCron refresh logic, the data record value is the next collection time (after updating this version, some kit containing Cron expressions will be refreshed directly).
----------, Dec 10, 2024

更新内容:
  • 取消物品预览堆叠
  • 优化检查更新代码
  • 取消礼包领取物品自动堆叠,解决物品超64个后继续领取导致只有一个的bug
  • 修复1.20.6版本API官方更新后修改InventoryView为接口导致低版本Found class org.bukkit.inventory.InventoryView, but interface was expected的报错。
✨Updated content:
  • Cancel item preview stacking
  • Optimize check update code
  • Cancel the automatic stacking of items for collection of gift packages, and solve the bug that only one item was caused by continued collection after more than 64 items.
  • Fixed the error that the lower version Found class org.bukkit. inventoryView was changed to an interface after the official API update in version 1.20.6 resulted in the error that the lower version Found class org.bukkit.inventoryView, but the interface was expected.
----------, Aug 14, 2024

更新内容:
  • 修复玩家登录报错问题。
  • 修复插件加载时长过长问题。
  • 更新插件各相关依赖。
Update Content:
  • Fixed the issue with player login errors.
  • Resolved the problem of long plugin loading times.
  • Updated various dependencies related to the plugin.
----------, Aug 2, 2024

:coffee: Repair:
  • Fixed the problem that versions below 1.12 cannot be loaded.
:coffee: Update:
  • Update 1.21 support.
----------, Jul 11, 2024

  • Fix the problem that you can still get the kit after you get it.
----------, May 13, 2024

  • Add 1.20.5 & 1.20.6 support
  • JDK17 and above support is required
----------, May 7, 2024

:coffee: Repair::
  • Fixed some known issues.

:coffee:A djustment:
  • Adjusted and optimized the package self-refresh logic for players to open the menu once, greatly reducing the server calculation pressure at the same time, to solve the unnecessary package refresh when there are too many server players.
  • The plugin check update logic has been adjusted, and spigot resource updates have been synchronized.
----------, Feb 11, 2024

:coffee: Repair:
  • fixed load error problem in version 1.20.4.
:coffee: Update:
  • Update 1.20.4 support.
  • With the latest NBTAPI built in, there is no need to download the pre-plugin now.
----------, Feb 2, 2024

:coffee: Repair:
  • Fixed incomplete instruction read for multiple delimiters
  • Fix get permission issue to require specific permissions instead

:coffee: adjustment:
  • After the package is deleted, the user will right click to receive the package, which will prompt that the package cannot be received
  • Configuration Item Add Get Simulation Command Enable Item
----------, Sep 3, 2023

:coffee: Repair
  • Fix the problem that the low version mailbox cannot be opened
  • Fix the failure of the CUSTOMDATA icon
----------, Aug 21, 2023

:coffee: Fixed:
- Fix the problem that CustomModelData cannot be used.
:coffee: Added:
- The edit command edits the specified package.
- Mailbox GUI custom CustomModelData.
:coffee: Adjustments:
- Optimize database statements.
- Removed residual output statement code.
----------, Aug 12, 2023

:coffee: Repair: Emergency repair refreshes bugs when using the database.
:coffee: Adjustment: parameters can be used for database connection, such as wkkituseSSL=false (which can solve SSL-related problems).
----------, Aug 2, 2023

:coffee: Repair: fix the error when Sending kit to a single user.
:coffee: Adjustment: Optimize database connection.
----------, Jul 22, 2023

:coffee: Repair:
  • Fix 'get' command unlimited access
  • Fix the problem that the mailbox cannot turn pages.
:coffee:Adjustment:
  • Optimize the one-click mailbox retrieval logic.
----------, Jul 21, 2023

:coffee: Fixed: Fix some known bugs.
:coffee: Adjustment: further reduce the volume of JAR package.
:coffee: Added: add CustomModelData to the gift package icon, with the format:
Code (YAML):
Icon : [CUSTOMDATA ]GRASS: {DATA value }
----------, Jul 19, 2023

:coffee: Repair:Optimize some logic and solve the 'send' command error.
----------, Jul 18, 2023

:coffee: Add:
  • Increase the player's access to info.
  • Add DeBug mode (function to be improved)
:coffee: Adjustment:
  • The sql statement is optimized to solve the problems that NULL players may be stored in the mailbox.
  • Check the updated version for optimization, and display the new backward version.
  • Send a gift package using asynchronous send
  • Optimize database transmission logic and use database connection pool to connect.
:coffee: Repair:
  • Solve the problem of wkkit.tmp remaining in the home directory.
  • Fix the edit interface, delete the error BUG reported by the gift package.
  • The number is not correct when sending more than 64 gift packages in the mailbox.
----------, Jul 17, 2023

Fix: Optimized some logic and fixed that @all could not be used or reported errors
----------, Jun 24, 2023

  • Fix does not automatically prompt for new version updates.
  • Fix compatible PAPER console does not appear color loading information.
  • Fixed menu opening player no data times error
  • Update compatible with Minecraft1.20.x (NBTAPI requires 2.11.3 and above)
  • New options for players to receive the new package (receive the package directly or receive the package content)
----------, Jun 22, 2023

Repair:
  • Fixed a BUG where WK EDIT returns a kit group icon reduced to 1。
  • Fixed a bug where Vault tags were not displayed in Edit。
⚙Adjustment:
  • Optimize the delivery mode of newcomer‘s kit and add strict delivery mode.
  • Optimized menu receiving package logic.
Added:
  • Added the function that kit are not automatically refreshed when created for the first time.
----------, May 2, 2023

Repair:
  • Fixed the CDK exchange execution command error BUG
  • Fixed a BUG where a bundle refresh would make it unusable with asynchronous callbacks
----------, Mar 21, 2023

Added:
  • Automatically wear when there is armor equipment in the kit.
  • Api added listening event: PlayerKitRefreshEvent.
  • Api added listening event logging type "GET".
  • Added player kit refresh record in kit cache.
  • Added the command "get" for the player to receive the kit, which is the same as the receiving conditions in the menu.
  • Modify the logging logic and customize the logging text。
----------, Mar 5, 2023

Added:
  • A new Vault node is added to the gift pack, which is the cost required to receive the gift pack. This node is only valid in the gift pack menu.
upload_2023-2-22_19-40-7.png
upload_2023-2-22_19-41-2.png

⚙Adjusted:
  • Plugin encoding adjusted to UTF-8.
----------, Feb 22, 2023

Repaired:
  • Fixed the error bug when clicking on the glass_pane in the editor interface
upload_2023-2-15_20-21-28.png upload_2023-2-15_20-21-33.png
----------, Feb 15, 2023

Fixes:
  • Fixed the bug that the gift packs refreshed at the same time interfere with the refresh of other gift packs.
  • Fixed the problem that MySQL cannot add parameters.
⚙Adjustments:
  • Optimize the self-refresh code of gift packs to single-threaded refresh, with less pressure on the server.
  • Delete statistics for variable "%wkkit_cronkits%".
----------, Feb 10, 2023

Repair:
  • Couldn't pass event bug when player jion server.
----------, Jan 23, 2023

Repair:
  • The novice gift package is issued asynchronously to fix the bug that may not be issued
Added:
  • Gift bag collection log manual storage command: /wk savechache
  • The menu supports ItemsAdder material icons: add (all lowercase) custommodeldata: <data value> to the id that needs to be adjusted
----------, Jan 21, 2023

Repair:
  • Fix the plugin error report problem caused by slow database loading
Added:
  • Add default permissions for ordinary players
  • Add the "Player No Permission" prompt in the menu
  • Add automatic initialization local language configuration
⚙Adjustment:
  • Remove GlowAPI support
  • Java minimum version supports back to JAVA8
----------, Jan 13, 2023

Fixed no find class(GlowAPI) when player drop items of kit.
If you has that problem please update new version.
----------, Dec 15, 2022

- Solve the problem of player default permissions.
- When the player has no permission, prompt him what permission he needs.
- Build a new wiki for English user, Now you can use wkkit more easily.[Click to view]
----------, Dec 14, 2022

Repair:
  • Fix page turning BUG in Editor GUI editing.
  • Fix Can't cancel BUG when op modify kit tag "Delay" & "Times".
  • Fix NullpointerException when use "Send" command.
  • Fix plugin coding problem.
  • Fix config file generation error.
  • Fix the error when the menu has no PAPI depend.
Added:
  • Add kit remind when player join server.
  • Add "Kit Recived Log" function.
  • Add "AIR" item to the Menu.
  • NBT can be used for display icons and menu icons of Kit.
⚙Modify:
  • And add adjustment kit edit button.
  • Modify the event package name to listeners.
----------, Nov 25, 2022

Fixed null pointer error BUG after restart of some cores
----------, Aug 30, 2022

  • Add 1.19.2 support.
  • Add plug-ins to automatically adapt to updated new configurations.
  • Players receive prompts after adding send to send gift packages.
  • Add the record function of self-refreshing gift bag caused by anti-collapse clothes.
  • Repair menu full backpack to get BUG.
  • Fixed the problem of sending error in the background of give instruction.
  • Repair right-click air error report.
  • Fixed the segment BUG in edit and changed the segment logic to English comma
----------, Aug 19, 2022

  • Repaired menu full backpack to get BUG.
  • Fixed menu Lore display exception.
  • Fixed BlockPlace error report.
  • Fixed Give instruction error.
  • Added menu to get custom icon and Lore (support PAPI).
  • Added a single gift package to display in the menu.
  • Update PlaceHolderAPI-2.11.2 version
----------, Jul 4, 2022

  • Repaired menu full backpack to get BUG.
  • Fixed menu Lore display exception.
  • Fixed BlockPlace error report.
  • Fixed Give instruction error.
  • Added menu to get custom icon and Lore (support PAPI).
  • Added a single gift package to display in the menu.
  • Update PlaceHolderAPI-2.11.2 version
----------, Jul 4, 2022

-Added Support to Spigot 1.19
----------, Jun 9, 2022

- Added: Add version support to 1.19
----------, Jun 9, 2022

  • Fixed BUG that Send could not send to the specified player.
  • The selection of sending mode for new Give.
  • Fix the problem of interactive processing within Edit.
  • Modify the interaction between the server and the player.
  • Optimize gift package refresh logic
----------, Jun 6, 2022

Fixed missing Help help page / wk mail directive.
Fixed Reload missing Drop data in GUI editor, others to be tested.
Fixed error report when using / wk open to open the specified menu and enter the wrong menu name.
Cannot be used when repairing create gift package & color code.
Fixed Flag in GUI editor could not be deleted.
Fixed the annoying hint of popping up after receiving the gift bag.
Add / wk open menu completion
----------, May 29, 2022

  1. Plug-in remake update change version number official release.
  2. Gift bag CDK exchange.
  3. Add custom menu files and gift package files so that the data is no longer stacked.
  4. Added gift package group matching function to support gift package group distribution.
  5. New GUI editing gift package function.
  6. Newly added newcomers automatically distribute gift bags when they enter the clothes.
  7. Optimize and add language files to support traditional Chinese and English.
  8. And so on.
  9. Optimize gift package creation, TAB completion, no more tedious operations.
  10. Super custom regular refresh gift package based on Cron.
  11. The gift bag warehouse is changed to a gift bag mailbox, which supports synchronizing the database and issuing offline gift packages.
  12. Modularization of function inspection and objectification of gift package menu.
  13. Solve the problem that you can't pick it up immediately after setting up a self-refreshing gift bag.
  14. Resolve the abnormal self-refresh time of the gift package after the server is shut down.
  15. Solve the BUG after the gift package is cancelled and automatically refreshed.
  16. Solve the problem of using gift package to report error BUG for 1.8 items.
  17. Adapt to the file path under compatible Linux.
  18. Cancel the gift bag center function
----------, May 19, 2022

Come to use it,New version which is I post today。
New version content:
- Support database to store your Player Kits. ( RECOMMENDED)
- ServerKits is able to set safty, Only use Enabe command.
- New page for receive Player Kit added.
- Code rewrite 80%
- Database data transfer added.
- Optimize the distribution method of Player Kit for newcomers.
- Add Auto-Refresh package
----------, Feb 14, 2022

  • 添加礼包预览
  • 优化PAPI变量逻辑、新增4个PAPI变量
  • 优化send指令判断逻辑
  • remove指令更改为delete
  • 简化部分指令,新增指令set、reset、delete
  • 指令别名(wk)
  • 添加玩家礼包仓库,除实体礼包外发送礼包都是直接发送到仓库
  • 增加礼包领取权限
  • 将玩家礼包和服务器礼包分开
  • 玩家礼包不再支持领取次数和冷却时间
----------, Jan 3, 2022

- Now you can use command in Kit
- We can also send DropKit and CooltimeKit
- Optimize kit sending judgment
- Add OP login prompt plug-in update
----------, Dec 21, 2021

Resource Information
Author:
----------
Total Downloads: 11,896
First Release: Dec 16, 2021
Last Update: Jun 29, 2025
Category: ---------------
All-Time Rating:
12 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings