Перейти к содержимому
Mineforgian

PerPlayerKit

PerPlayerKit lets players create their own custom kits (personal kits) for practicing PvP.

Загрузки
4K
Подписчики
9
Обновлён
20 января 2026 г.
Лицензия
AGPL-3.0-only

Опубликован 22 декабря 2024 г.

Исходный кодСообщить об ошибке

PerPlayerKit

Github Repository

Support Discord

License: AGPLv3

PerPlayerKit is open source and licensed under the terms of the GNU Affero General Public License v3. 0. Read and understand the license before using this software. Frequently Asked Questions about the GNU Licenses.

Contributing to PerPlayerKit

If you would like to contribute to the project you can do so by forking the repository and submitting a pull request. We prefer that improvements and contributions be merged into the main branch, rather than spread across numerous forks.

About the plugin

PerPlayerKit is a PaperMC plugin that allows players to make their own unique kits to PvP with. Administrators create a set of items in the "Virtual Kit Room", from which players pick their items. They can then make up to 9 kits each with can be shared, modified, and inspected by moderators. It features a GUI for simple kit usage of the plugin. Additionally, commands can be used to quickly load kits and for moderator features. It also features protections against abusive items, limiting NBT data and enchantments to what is available in vanilla Minecraft and only allowing items that can be found in the "virtual kit room". Players can also use the plugin to create enderchest kits that will be loaded into their enderchest when they select the enderchest kit.

Dependencies

PerPlayerKits uses a minecraft GUI library called canvas, it can be found here. PerPlayerKits was supports version 1.19 and above.

Installation

PerPlayerKits has a minimal configuration just requiring selecting the database type. PerPlayerKit supports both MySQL/MySQL compatible (MariaDB) databases and SQLite databases. If you don't know what you are doing or don't have access to a database, use sqlite as the database type.

To use the plugin run the server with the plugin in the "plugins" folder, then stop the server and edit the config.yml file in the "plugins/PerPlayerKits" folder.

More configuration options are available, please refer to the configuration documentation.

Commands and Permissions

For detailed information on commands and permissions, please refer to the command documentation.

External API

PerPlayerKit has a simple API that allows developers to interact with the plugin. The API is NOT stable and will possibly change in the future. Please refer to the API documentation for more information.

Ченджлог

1.7.1Релиз1.21.9, 1.21.10, 1.21.11 · 20 января 2026 г.

Small updates and support for newer versions

1.7.0Релиз1.19, 1.20, 1.21 · 3 ноября 2025 г.

New Features

  • MiniMessage Formatting Support - Messages now support modern MiniMessage format with RGB colors, named colors, and text formatting (bold, italic, underline, etc.). Old & color codes are no longer used.
  • Configurable Regear Behavior - /rg and /regear commands are now more configurable

Config Changes

  • New Messages Section - Added messages config section with granular control over kit action broadcasts, plus a disable-kit-messages toggle to suppress all kit messages at once
  • MiniMessage Format - All color/text formatting in config now uses MiniMessage format with examples and documentation in CONFIG.md

Fixes & Improvements

  • Fixed item filter bug affecting shulkers, bundles, and NBT chests
  • Fixed sound and GUI bugs
  • Improved notification management
1.6.2Релиз1.21.6, 1.21.7, 1.21.8 · 26 июля 2025 г.

Bug fixes and config option to clear potion effects on heal!

1.6.0Релиз1.21.4, 1.21.5, 1.21.6 · 18 июня 2025 г.

1.6.0 Update

This update introduces a variety of new features, essential bug fixes, and quality-of-life improvements.

New Features:

  • PlaceholderAPI Integration: Added support for PlaceholderAPI in the messages section of the configuration, allowing for more dynamic and personalized messages.
  • Enhanced Kit Management: Implemented a display name option for the %player% placeholder, offering greater customization.
  • Interactive UI/UX: Incorporated new sounds for saving kitroom items and enhanced the kit GUI with more interactive sound feedback.
  • Improved Regear Shulker: Introduced new features for the regear shulker, including an option to prevent players from placing items into the regear inventory.
  • Setup Guide: A new setup guide has been added to assist with initial configuration and usage.

Bug Fixes & Improvements:

  • Connection Stability: Resolved a critical connection leak in SQLStorage.java and improved SQL resource management by implementing try-with-resources.
  • Visual Corrections: Fixed a visual bug where inventories were not updating correctly on repair and addressed an issue with fill items in view-only ender chests.
  • Command Enhancements: The /inspectkit command has been significantly improved, now allowing administrators to change player kits. The /enderchest1-9 command also received a fix.
  • Performance & Reliability: Added a CI pipeline to improve development consistency, and implemented measures to prevent public kit load spam. Configuration options for maximumPoolSize have been added for both MySQL and SQLite to enhance database connection management.
  • Configuration & Reverts: Clarified button functionality and updated the default regear item whitelist. Reverted changes related to Hikari for SQLite and sqlite maximumPoolSize setting to ensure stability.
  • Minor Adjustments: Included a DisabledCommand check to RegearCommand.java and made various minor code and configuration updates to refine functionality.
1.5.4Релиз1.21.4, 1.21.5, 1.21.6 · 16 января 2025 г.

Update default config

1.5.3Релиз1.19.4, 1.20, 1.21 · 12 января 2025 г.

bug fix

1.5.2Релиз1.19.4, 1.20, 1.21 · 12 января 2025 г.

shulker/command regear modes, old-death-drops feature, testing import feature, bug fixes

1.5.0Релиз1.19.4, 1.20, 1.21 · 6 января 2025 г.

Public kit editor, feature configs, automatically upgrade config, update checker, minor bug fixes, added build metadata, bstats

Комментарии

Загружаем…