> For the complete documentation index, see [llms.txt](https://kynosdeveloping.gitbook.io/kynosdeveloping/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kynosdeveloping.gitbook.io/kynosdeveloping/kynoslib.md). # KynosLib Welcome to the official documentation for **KynosLib**, an ultra-optimized, lightweight, and modern **core framework library** engineered for high-performance Bukkit and Paper plugins. Built entirely from the ground up using **Java 21**, KynosLib provides a unified ecosystem of robust utilities, file management utilities, custom GUI engines, and crash-safe third-party integrations designed to streamline your development workflow and minimize memory overhead. *** ### ✨ **Core Highlights** * 📁 **Smart File Management** - Automated, UTF-8-enforced YAML handling via `KynosFile` to manage plugin configurations without boilerplate code. * ⚙️ **Dynamic Module Control** - An isolated lifecycle system (`ModuleManager`) to toggle separate library extensions dynamically at runtime. * 🎨 **Modern Components Integration** - Native support for Paper's Adventure API, introducing fast translations for legacy styling and modern **HEX colors** (`&#RRGGBB`). * 🛡️ **Fail-Safe Bridges** - Completely decoupled hooks for **WorldGuard** and **PlaceholderAPI** ensuring smooth server startups even if external dependencies are missing. * 🎮 **Annotation-Driven Commands** - An elegant command registration architecture featuring automatic sub-command execution, permission checks, and real-time tab completions. *** ### 🗺️ **Navigation Guide** Explore the documentation side menu to get started: 1. **📦 Getting Started:** Check out Installation to add KynosLib to your Maven `pom.xml` workspace. 2. **⚙️ Configuration:** Learn how the core Configuration & Modules mapping functions. 3. **💎 Features & Utilities:** Dive deep into the specific implementations of GUI Systems, Cooldown Managers, and Sound Fallbacks. *** 💡 *Note: Ensure your hosting environment and dependent projects are compiling under **Java 21** or higher to guarantee full architectural compatibility. For any problem or suggestion or request contact me at:* ****** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://kynosdeveloping.gitbook.io/kynosdeveloping/kynoslib.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.