# NextLib<\/p>\n
<\/p>\n
\n
\n
\n
\n
\n
\n
\n
\n<\/p>\n
**NextLib** is a modular library for Paper\/Spigot plugins that covers basic development tasks: working with configs, GUIs, objects, and databases. All modules are focused on a declarative style and convenient integration into existing projects.<\/p>\n
—<\/p>\n
## Content<\/p>\n
1. [Features](#features)
\n2. [Installation](#installation)
\n3. [Quick start](#quick-start)
\n4. [Main modules](#main-modules)
\n5. [GUI API and Conditions](#gui-api-and-conditions)
\n6. [Working with configs](#work-with-configs)
\n7. [Roadmap](#roadmap)
\n8. [License](#license)<\/p>\n
—<\/p>\n
## Features<\/p>\n
* **Dynamic database** \u2014 describe entities through regular Java classes and annotations, and the library creates tables itself and provides a convenient Fluent API for CRUD operations.
\n* **Connecting to the database via HikariCP** is a ready pool of connections with configurable parameters.
\n* **Flexible GUI** \u2014 loading menus from YAML, conditions for display and built-in actions (`update`, `playsound`, `command`, `opengui`, etc.).
\n* **Command API** \u2014 a tree of commands with auto-completion.
\n* **Item API** \u2014 concise builders of items with support for PDC, titles, lore and heads.
\n* **Color API** \u2014 formatting HEX and `&` codes without extra code.
\n* **Config Manager** \u2014 declarative loading of YAML configs into Java objects.<\/p>\n
—<\/p>\n
## Installation<\/p>\n
Add the JitPack repository and dependency `1.0.5` to your build script.<\/p>\n
### Gradle (Kotlin DSL)<\/p>\n
“`kotlin
\nrepositories {
\n mavenCentral()
\n maven(“https:\/\/jitpack.io”)
\n}<\/p>\n
dependencies {
\n implementation(“com.github.chi2l3s:next-lib:1.0.5”)
\n}
\n“`<\/p>\n
### Gradle (Groovy DSL)<\/p>\n
“`gradle
\nrepositories {
\n mavenCentral()
\n maven { url ‘https:\/\/jitpack.io’ }
\n}<\/p>\n
dependencies {
\n implementation ‘com.github.chi2l3s:next-lib:1.0.5’
\n}
\n“`<\/p>\n
### Maven<\/p>\n
“`xml —<\/p>\n ## Quick start<\/p>\n 1. Download the library via JitPack and add it as a dependency. “`java @Override database.register(PlayerEntity.class);<\/p>\n guiManager = new GuiManager(this); —<\/p>\n ## Main modules<\/p>\n ### Command API<\/p>\n * Structure commands through subcommands and permissions. “`java ### Item API<\/p>\n * Fluent builders for ‘ItemStack’ with customizing the name, description, flags and `PersistentDataContainer’. “`java ### Color API<\/p>\n * A single formatting method that translates `&` and HEX (`&#RRGGBB`) into color messages.<\/p>\n “`java ### Config Manager<\/p>\n * The BaseConfig base class automatically creates and updates YAML files. —<\/p>\n ## Dynamic database<\/p>\n * Define the entity using a familiar Java class. “`java DynamicTable String trapSkinId = players.findFirst() For more information, see the separate manual [`docs\/dynamic\u2014database.md`](docs\/dynamic-database.md).<\/p>\n —<\/p>\n ## GUI API and terms<\/p>\n * The menus are described by YAML files in `plugins\/ “`yaml For a detailed guide and examples, see [`docs\/gui\u2014conditions.md`](docs\/gui-conditions.md).<\/p>\n —<\/p>\n ## Working with configs<\/p>\n * Inherit from BaseConfig to get automatic file creation and updating. “`java —<\/p>\n ## Useful links<\/p>\n * [NextLib v1.0.5 Release Notes](docs\/releases\/NextLib-v1.0.5.md) —<\/p>\n ## Roadmap<\/p>\n – [x] Command API —<\/p>\n ## License<\/p>\n MIT License \u00a9 2025 NextGenTech<\/p>\n —<\/p>\n","protected":false},"excerpt":{"rendered":" Build Minecraft Plugins The Easy Way<\/p>\n","protected":false},"featured_media":110605,"template":"","meta":{"_minecraft_slug":"nextlib","_minecraft_project_id":"K0QERWMA","_minecraft_author":"chi2l3s","_minecraft_license":"MIT","_minecraft_downloads":17,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"nextlib.zip","_minecraft_size_bytes":110217,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:45:06.822668Z","_minecraft_date_created":"2025-11-05T07:51:16.753662Z","_minecraft_date_modified":"2025-10-28T06:45:41.905881Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/nextlib","_minecraft_icon_attachment_id":110605,"_minecraft_imported_at":"2026-06-06T12:03:16+00:00","_minecraft_import_hash":"b725aa92bb67ce4b1370d0856e2cec0f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,873,126,127,128,129,91,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-110604","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-library","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n
\n
\n
\n
\n <\/repository>
\n<\/repositories><\/p>\n
\n
\n
\n
\n
\n<\/dependency>
\n“`<\/p>\n
\n2. Create an instance of `GUIManager` and load the menu from the `menus\/` folder.
\n3. Describe the database entities with Java classes, annotate the primary key `@PrimaryKey` and register them in `DynamicDatabase’.
\n4. Use the provided APIs for commands, items, and configurations \u2014 all functionality is available from the namespace `io.github.chi2l3s.nextlib.api’.<\/p>\n
\npublic final class NextTrapsPlugin extends JavaPlugin {
\n private DynamicDatabase database;
\n private GuiManager guiManager;<\/p>\n
\n public void onEnable() {
\n database = DatabaseManager.createDynamicDatabase(this, “jdbc:mysql:\/\/localhost:3306\/nexttraps”, config -> {
\n config.setUsername(“root”);
\n config.setPassword(“password”);
\n config.setMaximumPoolSize(10);
\n });<\/p>\n
\n guiManager.loadFromFolder(new File(getDataFolder(), “menus”));
\n }
\n}
\n“`<\/p>\n
\n* Support for auto-completion and aliases.
\n* Is connected in one line in `OnEnable()’.<\/p>\n
\ngetCommand(“nextlib”).setExecutor(new RootCommand());
\n“`<\/p>\n
\n* Support for head owner installation and massive meta changes.<\/p>\n
\nItemStack reward = new ItemBuilder(Material.DIAMOND)
\n.setName(“&B Reward of the day”)
\n.setLore(List.of(“&7 Press to get”))
\n .addPersistentTag(“reward”, PersistentDataType.STRING, “daily”)
\n .glow()
\n .build();
\n“`<\/p>\n
\nplayer.SendMessage(color.format(“Welcome to ඪdbNextLib”));
\n“`<\/p>\n
\n* Data is loaded into Java fields or DTOs.<\/p>\n
\n* The `@PrimaryKey` annotation marks the primary key field.
\n* `DynamicTable` provides the methods `findFirst`, `findMany’, `create`, `update` and `delete’.<\/p>\n
\n@AllArgsConstructor
\n@Getter
\npublic class PlayerEntity {
\n @PrimaryKey
\n private final UUID playerId;
\n private final String nickname;
\n private final String trapSkinId;
\n}<\/p>\n
\n .where(“playerId”, playerId)
\n .execute()
\n .map(PlayerEntity::getTrapSkinId)
\n .orElse(“fallback”);
\n“`<\/p>\n
\n* The `slot` field takes a single value, and `slots` is a list of arbitrary slots or ranges `A-B’.
\n* You can register your own conditions (`Conditions#register`) and use them to highlight objects or restrict interaction.
\n* Built`in actions: `close`, `command’, `console’, `message’, `opengui`, `update’, `playsound’.<\/p>\n
\nid: traps
\ntitle: “&8 Trap Selection”
\nsize: 54
\nitems:
\n back:
\n material: ARROW
\n slot: 53
\n name: “&7node”
\nonLeftClick:
\n – “opengui main”
\n trap:
\n material: TRIPWIRE_HOOK
\n slots:
\n – 0-8
\n – 18
\n name: “&b%trap_name%”
\n lore:
\n – “&7 Cost: &e%price%”
\nenchanted_when:
\n – “selected”
\n onLeftClick:
\n – “update”
\n – “playsound ENTITY_ENDER_DRAGON_AMBIENT 0.7 1.2”
\n“`<\/p>\n
\n* Use ‘loadValues()` to read data and associate it with objects in your domain.<\/p>\n
\npublic class TrapSkinsConfig extends BaseConfig {
\n @Override
\n protected void loadValues() {
\n ConfigurationSection skins = config.getConfigurationSection(“skins”);
\n \/\/ Convert YAML to your TrapSkin objects
\n }
\n}
\n“`<\/p>\n
\n* [Dynamic Database Guide](docs\/dynamic-database.md)
\n* [GUI Conditions and Actions Guide](docs\/gui-conditions.md)<\/p>\n
\n– [x] Item API
\n– [x] Color API
\n– [x] Config Manager
\n– [x] GUI API with conditions and slot ranges
\n– [x] Dynamic database with HikariCP
\n– [ ] Expandable GUI action registry
\n– [ ] Redis\/Message Queue integration
\n– [ ] Utilities for working with events<\/p>\n