A powerful, modern, and modular library for building Minecraft Paper plugins. KLibrary abstracts away the complex boilerplate of actions, conditions, commands, and inventory GUIs, allowing developers to focus on writing clean, scalable feature logic.
Key Features
- Action Engine: Define dynamic behaviors (messages, sounds, commands) in configuration files and parse them effortlessly.
- Requirement Engine: Flexible condition checking (permissions, money, items) with built-in support for complex `AND`/`OR` logical groupings.
- Inventory GUI Framework: A completely stack-based, modular GUI system utilizing `InventoryProvider`, `InventoryContext`, and interactive `Button` abstractions.
- Command API: Fluent abstractions built on top of the modern Paper Command API (Brigadier) for subcommands, permissions, and dynamic tab completions.
- Dependency Integration: Built-in, fault-tolerant service layers that handle optional dependencies like Vault and PlaceholderAPI seamlessly.
Supported Platforms
- Paper API: 26.1.2
- Java Version: Java 21+
Installation
Add KLibrary to your project via Maven or Gradle.
Maven
Gradle
Quick Start Example
KLibrary allows you to bind configuration directly to logic.
`config.yml`:
`JavaPlugin` class:
Documentation
Full documentation is available in the wiki.
Built with clean architecture in mind to make Minecraft development enjoyable.
Key Features
- Action Engine: Define dynamic behaviors (messages, sounds, commands) in configuration files and parse them effortlessly.
- Requirement Engine: Flexible condition checking (permissions, money, items) with built-in support for complex `AND`/`OR` logical groupings.
- Inventory GUI Framework: A completely stack-based, modular GUI system utilizing `InventoryProvider`, `InventoryContext`, and interactive `Button` abstractions.
- Command API: Fluent abstractions built on top of the modern Paper Command API (Brigadier) for subcommands, permissions, and dynamic tab completions.
- Dependency Integration: Built-in, fault-tolerant service layers that handle optional dependencies like Vault and PlaceholderAPI seamlessly.
Supported Platforms
- Paper API: 26.1.2
- Java Version: Java 21+
Installation
Add KLibrary to your project via Maven or Gradle.
Maven
Code (Text):
<dependency>
<groupId>io.github.kaivian</groupId>
<artifactId>klibrary</artifactId>
<version>1.0.0-SNAPSHOT</version>
<scope>compile</scope>
</dependency>
<groupId>io.github.kaivian</groupId>
<artifactId>klibrary</artifactId>
<version>1.0.0-SNAPSHOT</version>
<scope>compile</scope>
</dependency>
Code (Text):
dependencies {
implementation 'io.github.kaivian:klibrary:1.0.0-SNAPSHOT'
}
implementation 'io.github.kaivian:klibrary:1.0.0-SNAPSHOT'
}
KLibrary allows you to bind configuration directly to logic.
`config.yml`:
Code (YAML):
reward-click:
requirements:
has-perm:
type : "permission"
permission : "myplugin.vip"
deny-actions :
- "[message] <red>You need VIP to do this!"
actions :
- "[message] <green>You claimed your VIP reward!"
- "[console] give %player_name% diamond 1"
requirements:
has-perm:
type : "permission"
permission : "myplugin.vip"
deny-actions :
- "[message] <red>You need VIP to do this!"
actions :
- "[message] <green>You claimed your VIP reward!"
- "[console] give %player_name% diamond 1"
Code (Java):
// Initialize the core library managers
ActionFactory actionFactory = new ActionFactory ( this ) ;
RequirementFactory requirementFactory = new RequirementFactory ( this ) ;
// Parse logic from a config node
ConfigNode node = ConfigNode. from (getConfig ( ). getConfigurationSection ( "reward-click" ) ) ;
List <Requirement > reqs = requirementFactory. deserializeRequirements (node. getList ( "requirements" ) ) ;
List <Action > actions = actionFactory. deserializeActions (node. getList ( "actions" ) ) ;
// Evaluate requirements and execute actions
if (RequirementResult. evaluateAll (player, reqs ). isSuccess ( ) ) {
actions. forEach (action -> action. execute (player ) ) ;
}
ActionFactory actionFactory = new ActionFactory ( this ) ;
RequirementFactory requirementFactory = new RequirementFactory ( this ) ;
// Parse logic from a config node
ConfigNode node = ConfigNode. from (getConfig ( ). getConfigurationSection ( "reward-click" ) ) ;
List <Requirement > reqs = requirementFactory. deserializeRequirements (node. getList ( "requirements" ) ) ;
List <Action > actions = actionFactory. deserializeActions (node. getList ( "actions" ) ) ;
// Evaluate requirements and execute actions
if (RequirementResult. evaluateAll (player, reqs ). isSuccess ( ) ) {
actions. forEach (action -> action. execute (player ) ) ;
}
Full documentation is available in the wiki.
Built with clean architecture in mind to make Minecraft development enjoyable.
Resource Information
Author:
----------
Total Downloads: 6
First Release: May 8, 2026
Last Update: May 8, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings