papermc-skill 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -5,6 +5,47 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2026-10-01
+
+### Added
+- **Plugin Security & Anti-Exploit Scanner CLI (`npx papermc-skill audit [path]`)**:
+  - Scans Java sources for known Bukkit/Paper vulnerabilities including legacy ChatColor usage, section sign formatting bugs, static collection memory leaks (`Set<Player>`), synchronous chunk freezes (`world.getChunkAt`), insecure SQL string concatenation, and unbounded float/double parsing.
+- **Masterclass Guide 11: Security & Exploit Prevention (`docs/11-security-and-exploit-prevention.md`)**:
+  - Deep-dive architectural guide covering item dupe glitch elimination, inventory race conditions, PDC cryptographic tamper-proofing, numeric/economy validation (anti-NaN/overflow), asynchronous chunk loading teleportation, HikariCP connection leak prevention, and memory leak elimination.
+- **Massively Enriched AI Agent Skill (`skills/paper-plugin-dev/SKILL.md`)**:
+  - Added dedicated Security & Exploit-Proofing protocol.
+  - Added production recipes for Secure Brigadier Commands with numeric bounds, Safe GUI Menu Controllers with 200ms click debounce and drag cancellation, Anti-Tamper PDC Item Utilities, Universal Folia/Paper Schedulers, and Async HikariCP Database Managers.
+  - Added 20-point Pre-Release Security Audit Checklist.
+
+### Changed
+- **SchedulerAdapter Precision Hardening**:
+  - Fixed tick conversion in `SchedulerAdapter.java` to use exact millisecond calculation `timeUnit.toMillis(delay) / 50L`.
+- **Documentation & Distribution**:
+  - Added `assets/` to package distribution files for local and offline tooling.
+  - Updated README documentation with Guide 11 and audit quickstart command.
+
+## [1.0.1] - 2026-09-15
+
+### Added
+- **PaperMC Fill v3 API Dynamic Version Tracker**:
+  - New CLI command `npx papermc-skill check-update [--apply]` to query `https://fill.papermc.io/v3/projects/paper` for the newest Minecraft & PaperMC versions, builds, and minimum Java requirements.
+  - Automated GitHub Actions workflow (`.github/workflows/paper-updater.yml`) running weekly or on-demand to test and bump Paper versions automatically via Pull Requests.
+  - Dependabot configuration (`.github/dependabot.yml`) for automated dependency monitoring across Gradle, GitHub Actions, and npm.
+  - Dynamic Version Discovery protocol in AI Agent skill (`skills/paper-plugin-dev/SKILL.md`).
+- **Gaming & Hype Aesthetic Overhaul**:
+  - Retro ASCII Art header banner, badges, and high-energy developer quotes in `README.md` and GitHub Release notes.
+
+### Changed
+- **Dependency Upgrades**:
+  - Bumped `io.papermc.paper:paper-api` from `1.21.4` to latest Minecraft 1.21 LTS release `1.21.11-R0.1-SNAPSHOT`.
+  - Bumped Gradle Wrapper from `9.4.1` to `9.7.1`.
+  - Bumped `xyz.jpenilla.run-paper` from `3.0.2` to `3.1.0`.
+  - Bumped `org.jspecify` from `1.0.0` to `1.0.1`.
+  - Upgraded GitHub Actions to latest major versions (`actions/checkout@v7`, `actions/setup-java@v6`, `actions/setup-node@v7`, `softprops/action-gh-release@v3`, `peter-evans/create-pull-request@v8`).
+- **Build Stabilization**:
+  - Added `pluginManagement` with `mavenCentral()` to `settings.gradle.kts` for reliable Gradle plugin dependency resolution.
+  - Configured Dependabot ignore rules to keep `paper-api` on Java 21 LTS compatibility.
+
 ## [1.0.0] - 2026-09-05
 
 ### Added

package/README.md

@@ -1,169 +1,149 @@
 <div align="center">
 
-# 🎮 Paper Minecraft Plugin Skill & Knowledge Base
+<a href="https://github.com/ardianryan/papermc-skill">
+  <img src="https://raw.githubusercontent.com/ardianryan/papermc-skill/main/assets/banner-animated.svg" alt="PaperMC Skill - The Ultimate Paper &amp; Folia Arsenal" width="100%" />
+</a>
+
+# ⚔️ PAPERMC PLUGIN SKILL & KNOWLEDGE BASE ⚔️
+
+**Stop writing legacy Spigot code like it's 2014. Build for modern Paper & Folia with pure speed, thread-safety, and zero lag.**
 
 [![PaperMC](https://img.shields.io/badge/PaperMC-1.20.6%20%7C%201.21+-0098FF?style=for-the-badge&logo=minecraft&logoColor=white)](https://papermc.io)
+[![Folia](https://img.shields.io/badge/Folia-Multi--Threaded%20Ready-5865F2?style=for-the-badge&logo=dependabot&logoColor=white)](https://github.com/PaperMC/Folia)
 [![Java](https://img.shields.io/badge/Java-21%2B%20LTS-ED8B00?style=for-the-badge&logo=openjdk&logoColor=white)](https://adoptium.net)
-[![Folia](https://img.shields.io/badge/Folia-Multi--Threaded%20Ready-5865F2?style=for-the-badge)](https://github.com/PaperMC/Folia)
+[![NPM](https://img.shields.io/npm/v/papermc-skill?style=for-the-badge&color=CB3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/papermc-skill)
+[![GitHub Release](https://img.shields.io/github/v/release/ardianryan/papermc-skill?style=for-the-badge&color=2ea44f&logo=github&logoColor=white)](https://github.com/ardianryan/papermc-skill/releases/latest)
 [![License: MIT](https://img.shields.io/badge/License-MIT-44CC11?style=for-the-badge)](LICENSE)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=for-the-badge)](CONTRIBUTING.md)
 
-**A comprehensive, production-grade knowledge base, architectural reference collection, starter template, and AI engineering skill for modern Minecraft Java Server plugin development on [PaperMC](https://papermc.io) and [Folia](https://github.com/PaperMC/Folia).**
-
-[Features](#-features) • [Quickstart](#-quickstart) • [Architecture Guide](#-documentation-suite) • [Reference Plugins](#-cloned-reference-plugins) • [AI Skill](#-ai-agent-integration) • [Contributing](#-contributing)
+[⚡ Quickstart](#-instant-quickstart-5-seconds) • [💎 Key Features](#-why-modern-paper-matters) • [📚 11 Masterclass Guides](#-11-masterclass-technical-guides) • [🔍 Battle-Tested References](#-cloned-reference-plugins) • [🤖 AI Agent Skill](#-ai-agent-integration)
 
 ---
 
 </div>
 
-## 🌟 Overview
+## 🚀 Instant Quickstart (5 Seconds!)
 
-The Minecraft server development ecosystem has undergone massive architectural shifts with Minecraft 1.20.5+ and 1.21+. Legacy Bukkit/Spigot habits—such as section sign color formatting (`§`), `plugin.yml` command registration, third-party NBT hacks, and blocking main-thread schedulers—lead to performance degradation, memory leaks, and fatal crashes on modern servers.
+You don't need to configure Gradle or clone anything manually. Scaffold a production-grade, Folia-ready Paper plugin right now with **one command**:
 
-This repository serves as an **authoritative, single-source knowledge base** and **developer skill** designed to empower both human software engineers and AI pair-programming assistants to build performant, thread-safe, and idiomatic Paper plugins.
+```bash
+npx papermc-skill create MyEpicPlugin
+```
 
----
+Or install the AI skill globally so your coding agents (**Antigravity**, **Cursor**, **Copilot**) write flawless Paper 1.21+ code:
 
-## ⚡ Key Architecture Highlights
+```bash
+npx papermc-skill install-skill --global
+```
 
-| Modern Paper Standard | Legacy Spigot / Bukkit | Why Modern Matters |
-| :--- | :--- | :--- |
-| **Kyori Adventure & MiniMessage** | `ChatColor` & `§` color codes | Type-safe, component-based, 24-bit TrueColor/Hex gradients, interactive click/hover events, and zero string-injection risks. |
-| **PersistentDataContainer (PDC)** | External NBT libraries / Lore parsing | Official native NBT storage on Items, Entities, Chunks, and Worlds. Serializes Java records seamlessly. |
-| **Paper Native Brigadier** | `plugin.yml` & `setExecutor(...)` | Client-side syntax validation, auto tab-completion, and command routing directly inside Mojang's Brigadier engine. |
-| **Regionized Threading (Folia)** | Single Main Thread `BukkitScheduler` | Scales across CPU cores via Threaded Regions. Uses `RegionScheduler`, `EntityScheduler`, and `AsyncScheduler`. |
-| **Mojang Mappings (Paperweight)** | Spigot remapped / Obfuscated NMS | Zero-remapping runtime on Paper 1.20.5+; direct, clean access to Mojang server internals with `paperweight-userdev`. |
+To browse architectural cheat sheets directly in your terminal:
+```bash
+npx papermc-skill docs
+```
 
----
+To check for the newest Minecraft & PaperMC releases from the official API:
+```bash
+npx papermc-skill check-update
+```
 
-## 📚 Documentation Suite
-
-Our documentation suite includes 10 comprehensive, in-depth architectural guides:
-
-1. **[01. Modern Paper Architecture](https://github.com/ardianryan/papermc-skill/blob/main/docs/01-modern-paper-architecture.md)**  
-   *Deep dive into `paper-plugin.yml`, `PluginBootstrap` vs `JavaPlugin`, Gradle `paperweight-userdev`, and runtime Mojang mappings.*
-2. **[02. Adventure API & MiniMessage](https://github.com/ardianryan/papermc-skill/blob/main/docs/02-adventure-and-minimessage.md)**  
-   *Hex colors, gradient tags, dynamic `TagResolver` placeholders, `ComponentLogger`, Titles, BossBars, and Sound playback.*
-3. **[03. PersistentDataContainer (PDC)](https://github.com/ardianryan/papermc-skill/blob/main/docs/03-persistent-data-container.md)**  
-   *Storing custom data on ItemStacks, Entities, and Chunks; implementing custom `PersistentDataType<T, Z>` for POJO/record serialization.*
-4. **[04. Modern Command Systems: Brigadier & Cloud](https://github.com/ardianryan/papermc-skill/blob/main/docs/04-commands-and-brigadier.md)**  
-   *Paper's native Brigadier command registration via `LifecycleEvents.COMMANDS`, argument parsing, suggestions, and Incendo Cloud.*
-5. **[05. Concurrency, Threading & Folia Compatibility](https://github.com/ardianryan/papermc-skill/blob/main/docs/05-concurrency-and-folia.md)**  
-   *Threaded regions, region schedulers, entity schedulers, async schedulers, and universal cross-platform scheduling abstractions.*
-6. **[06. Event System & Listeners](https://github.com/ardianryan/papermc-skill/blob/main/docs/06-events-and-listeners.md)**  
-   *Paper-exclusive events (`AsyncChatEvent`, `PrePlayerAttackEntityEvent`), event priority lifecycle, and custom event authoring.*
-7. **[07. Best Practices & Performance Optimization](https://github.com/ardianryan/papermc-skill/blob/main/docs/07-best-practices-and-perf.md)**  
-   *Preventing GC memory leaks (UUID vs entity references), asynchronous chunk loading (`world.getChunkAtAsync`), and anti-patterns.*
-8. **[08. Modern GUI & Inventory Menus](https://github.com/ardianryan/papermc-skill/blob/main/docs/08-gui-and-menus.md)**  
-   *Custom `InventoryHolder` verification, PDC-tagged interactive buttons, and bulletproof duplication-exploit prevention.*
-9. **[09. Custom Items, Abilities & Combat](https://github.com/ardianryan/papermc-skill/blob/main/docs/09-custom-items-and-combat.md)**  
-   *Raycasting hitscan spells (`rayTraceEntities`), particle beam effects, vanilla visual cooldowns, and Adventure sound effects.*
-10. **[10. Asynchronous Database Storage](https://github.com/ardianryan/papermc-skill/blob/main/docs/10-database-and-storage.md)**  
-    *SQLite and MySQL/PostgreSQL connection pooling via HikariCP, thread-safe asynchronous DAO pattern with `CompletableFuture`.*
+To audit any plugin codebase for exploits, memory leaks, and anti-patterns:
+```bash
+npx papermc-skill audit
+```
 
 ---
 
-## 🔍 Cloned Reference Plugins
+## 💎 Why Modern Paper Matters
 
-Nine industry-standard open-source repositories have been cloned into [`references/`](references/) as real-world architectural blueprints:
+The Minecraft server ecosystem has evolved dramatically. Legacy habits lead to server lag spikes, thread collisions, and fatal crashes on modern engines:
 
-| Repository | Source Origin | Core Concepts Demonstrated |
+| Feature | 💀 Legacy Spigot / Bukkit | ⚡ Modern Paper & Folia (1.20.6 / 1.21+) |
 | :--- | :--- | :--- |
-| **[`squaremap`](references/squaremap)** | `jpenilla/squaremap` | Developed by a PaperMC core developer. World rendering, `paperweight-userdev`, Incendo Cloud commands, and Folia multi-threading. |
-| **[`chunky`](references/chunky)** | `pop4959/Chunky` | High-throughput async chunk loading (`world.getChunkAtAsync`), mathematical optimizations, and multi-platform platform adapters. |
-| **[`luckperms`](references/luckperms)** | `LuckPerms/LuckPerms` | Enterprise-grade Java architecture: HikariCP connection pooling, custom internal event bus, caching hierarchy, and async I/O. |
-| **[`miniplaceholders`](references/miniplaceholders)** | `MiniPlaceholders/MiniPlaceholders` | Advanced Kyori Adventure API usage, custom MiniMessage tag resolvers, and modern `paper-plugin.yml` bootstrapping. |
-| **[`vault-api`](references/vault-api)** | `MilkBowl/VaultAPI` | The standard ecosystem bridge API for economy and permissions in Minecraft Java. |
-| **[`run-paper`](references/run-paper)** | `jpenilla/run-paper` | The Gradle plugin source code for running instant local Paper and Folia test environments. |
-| **[`decentholograms`](references/decentholograms)** | `DecentSoftware-eu/DecentHolograms` | Display entity manipulation, protocol packet handling, and dynamic per-player text rendering. |
-| **[`bstats`](references/bstats)** | `Bastian/bStats-Metrics` | Industry-standard telemetry and metrics integration for Minecraft server plugins. |
-| **[`paperweight-test-plugin`](references/paperweight-test-plugin)** | `PaperMC/paperweight-test-plugin` | Official PaperMC test project for `paperweight-userdev` Gradle configurations. |
+| **Color & Text** | `ChatColor.RED + "§lText"` | **Kyori Adventure & MiniMessage**: `<gradient:#ff007f:#7f00ff><bold>Text</bold></gradient>` |
+| **Persistent Data** | Third-party NBT hacks / Lore reading | **PersistentDataContainer (PDC)**: Native, type-safe NBT on Items, Entities, Chunks, and Worlds. |
+| **Command System** | `plugin.yml` + `setExecutor(...)` | **Paper Native Brigadier**: Client-side syntax validation, auto tab-completion directly in Mojang's engine. |
+| **Multi-Threading** | Single main thread (`BukkitScheduler`) | **Threaded Regions (Folia)**: Independent regional ticking via `RegionScheduler` & `EntityScheduler`. |
+| **Server Internals** | Obfuscated Spigot remapping | **Paperweight Userdev**: Direct, unmapped access to Mojang Mappings (`net.minecraft.*`) at runtime. |
 
 ---
 
-## 🚀 Quickstart
+## 📚 11 Masterclass Technical Guides
 
-### Method 1: Instant Scaffolding via NPX (Recommended)
+Written by developers for developers, covering everything from basic setup to high-throughput concurrency:
 
-You can scaffold a new Paper plugin or install the AI skill instantly anywhere using `npx`:
+| # | Masterclass Guide | Focus & Highlights |
+| :-: | :--- | :--- |
+| **01** | [Modern Paper Architecture](https://github.com/ardianryan/papermc-skill/blob/main/docs/01-modern-paper-architecture.md) | `paper-plugin.yml`, `PluginBootstrap` vs `JavaPlugin`, Gradle `paperweight-userdev`, and runtime Mojang mappings. |
+| **02** | [Adventure API & MiniMessage](https://github.com/ardianryan/papermc-skill/blob/main/docs/02-adventure-and-minimessage.md) | Hex gradients, dynamic `TagResolver` placeholders, `ComponentLogger`, Titles, BossBars, and Sound playback. |
+| **03** | [PersistentDataContainer (PDC)](https://github.com/ardianryan/papermc-skill/blob/main/docs/03-persistent-data-container.md) | Custom NBT on ItemStacks, Entities, and Chunks; implementing custom `PersistentDataType<T, Z>` for Java records. |
+| **04** | [Modern Brigadier & Cloud Commands](https://github.com/ardianryan/papermc-skill/blob/main/docs/04-commands-and-brigadier.md) | Native Mojang Brigadier trees via `LifecycleEvents.COMMANDS`, argument suggestions, and Incendo Cloud. |
+| **05** | [Concurrency & Folia Compatibility](https://github.com/ardianryan/papermc-skill/blob/main/docs/05-concurrency-and-folia.md) | Threaded regions, region schedulers, entity schedulers, async schedulers, and universal platform wrappers. |
+| **06** | [Event System & Paper Listeners](https://github.com/ardianryan/papermc-skill/blob/main/docs/06-events-and-listeners.md) | Paper-exclusive events (`AsyncChatEvent`, `PrePlayerAttackEntityEvent`), event priority, and custom events. |
+| **07** | [Best Practices & Performance Tuning](https://github.com/ardianryan/papermc-skill/blob/main/docs/07-best-practices-and-perf.md) | Eliminating GC memory leaks (UUID vs entity references), asynchronous chunk loading (`world.getChunkAtAsync`). |
+| **08** | [Modern GUI & Inventory Menus](https://github.com/ardianryan/papermc-skill/blob/main/docs/08-gui-and-menus.md) | Custom `InventoryHolder` menus, PDC interactive buttons, and bulletproof duplication-exploit prevention. |
+| **09** | [Custom Items, Abilities & Combat](https://github.com/ardianryan/papermc-skill/blob/main/docs/09-custom-items-and-combat.md) | Raycasting spells (`rayTraceEntities`), particle beam effects, vanilla visual cooldowns, and SFX. |
+| **10** | [Asynchronous Database Storage](https://github.com/ardianryan/papermc-skill/blob/main/docs/10-database-and-storage.md) | SQLite & MySQL HikariCP connection pooling, thread-safe asynchronous DAO pattern with `CompletableFuture`. |
+| **11** | [Security & Exploit Prevention](https://github.com/ardianryan/papermc-skill/blob/main/docs/11-security-and-exploit-prevention.md) | Eliminating dupe glitches, inventory race conditions, PDC tamper verification, numeric/economy validation, and packet DoS defense. |
 
-```bash
-# 1. Interactively create a new modern Paper & Folia plugin
-npx papermc-skill create MyAwesomePlugin
+---
 
-# 2. Or install the AI skill into your workspace (.agents/skills) or globally
-npx papermc-skill install-skill --global
+## 🏛️ Cloned Reference Plugins
 
-# 3. Read architectural guides right in your terminal
-npx papermc-skill docs
-```
+Nine battle-tested open-source repositories are included directly in [`references/`](references/) for reverse-engineering and architectural inspiration:
+
+- 🗺️ **[`squaremap`](references/squaremap)**: Production Paperweight, Incendo Cloud commands, and Folia multi-threading by PaperMC core dev `jpenilla`.
+- ⚡ **[`chunky`](references/chunky)**: High-throughput async chunk generation engine (`world.getChunkAtAsync`) and multi-platform abstractions.
+- 🛡️ **[`luckperms`](references/luckperms)**: Enterprise permissions, HikariCP database pool, caching hierarchy, and custom event bus.
+- 🏷️ **[`miniplaceholders`](references/miniplaceholders)**: Advanced Kyori Adventure API and custom MiniMessage tag resolvers.
+- 💰 **[`vault-api`](references/vault-api)**: The industry-standard economy and permissions bridge API.
+- 🛠️ **[`run-paper`](references/run-paper)**: The instant local Paper/Folia runner Gradle plugin.
+- 👻 **[`decentholograms`](references/decentholograms)**: Protocol display entity manipulation, floating text, and packet optimizations.
+- 📊 **[`bstats`](references/bstats)**: Global plugin telemetry and metrics integration.
+- 🧪 **[`paperweight-test-plugin`](references/paperweight-test-plugin)**: Official PaperMC Mojang mapping testbed.
 
-### Method 2: Manual Clone & Local Server Test
+---
 
-A production-ready Gradle starter template is available in [`templates/paper-modern-template/`](templates/paper-modern-template).
+## 🛠️ Runnable Starter Template
 
-#### Prerequisites
-- **Java 21 SDK** installed ([Adoptium Temurin 21](https://adoptium.net/)):
-  - macOS: `brew install openjdk@21`
-  - Linux: `sudo apt install openjdk-21-jdk`
-- Gradle is bundled inside the template via `./gradlew` (no manual Gradle install required).
+A battle-ready project is pre-configured in [`templates/paper-modern-template/`](templates/paper-modern-template):
 
-#### Running a Local Test Server in 60 Seconds
 ```bash
-# 1. Navigate to the template project
+# Navigate to the template
 cd templates/paper-modern-template
 
-# 2. Launch an automated Paper test server
+# Launch an automated Paper test server in 60s
 ./gradlew runServer
 
-# 3. Or launch a multi-threaded Folia test server
+# Or launch on multi-threaded Folia
 ./gradlew runFoliaServer
 ```
-The task will automatically download the Paper/Folia runtime, accept the Mojang EULA, compile your code, and launch the server with your plugin enabled.
 
 ---
 
 ## 🤖 AI Agent Integration
 
-This repository includes a standardized AI Assistant Skill in [`skills/paper-plugin-dev/SKILL.md`](skills/paper-plugin-dev/SKILL.md).
+This repository includes a machine-readable coding skill in [`skills/paper-plugin-dev/SKILL.md`](skills/paper-plugin-dev/SKILL.md).
 
-When working with AI coding assistants (such as Antigravity, GitHub Copilot, or Cursor):
-- Point your assistant to `skills/paper-plugin-dev/SKILL.md`.
-- The assistant will automatically adopt modern Paper 1.21+ standards, avoid deprecated Spigot methods, enforce Folia thread-safety, and use Adventure/PDC patterns out of the box.
+When pair-programming with AI coding agents:
+- Tell your agent: *"Use the `paper-plugin-dev` skill"*.
+- The agent will automatically generate Folia-safe schedulers, MiniMessage components, Brigadier command trees, and PDC data holders with zero legacy anti-patterns.
 
 ---
 
-## 📁 Repository Structure
-
-```text
-minecraft-plugin-skill/
-├── .github/                            # Issue & Pull Request templates
-│   ├── ISSUE_TEMPLATE/
-│   │   ├── bug_report.yml
-│   │   └── feature_request.yml
-│   └── pull_request_template.md
-├── docs/                               # 10 In-depth architectural guides
-├── references/                         # 9 Cloned open-source reference plugins
-├── skills/
-│   └── paper-plugin-dev/               # AI Assistant Skill definition (SKILL.md)
-├── templates/
-│   └── paper-modern-template/          # Standalone, runnable starter plugin project
-├── CODE_OF_CONDUCT.md                  # Contributor Covenant v2.1
-├── CONTRIBUTING.md                     # Comprehensive contribution guide
-├── LICENSE                             # MIT License
-├── README.md                           # Repository documentation
-└── SECURITY.md                         # Security policy & reporting guidelines
-```
+## 📦 Packages & Distribution
 
----
+| Channel | Identifier / Command | Link |
+| :--- | :--- | :--- |
+| **NPM Global** | `npx papermc-skill` | [![NPM Version](https://img.shields.io/npm/v/papermc-skill?color=CB3837)](https://www.npmjs.com/package/papermc-skill) |
+| **GitHub Packages** | `@ardianryan/papermc-skill` | [GitHub Packages Hub](https://github.com/users/ardianryan/packages?repo_name=papermc-skill) |
+| **Release Asset** | `papermc-skill-v1.1.0.zip` | [Latest GitHub Release](https://github.com/ardianryan/papermc-skill/releases/latest) |
 
-## 🤝 Contributing
+---
 
-Contributions are welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md) before submitting pull requests or opening issues.
+<div align="center">
 
----
+### 🌟 Show Your Support!
+If this toolkit helped you or your server project, give this repository a **Star ⭐** on GitHub!
 
-## 📄 License & Trademarks
+*Minecraft is a registered trademark of Mojang Synergies AB. This project is not affiliated with or endorsed by Mojang Synergies AB, Microsoft Corporation, or PaperMC.*
 
-- This project is licensed under the **[MIT License](LICENSE)**.
-- *Minecraft* is a registered trademark of Mojang Synergies AB. This project is not affiliated with or endorsed by Mojang Synergies AB, Microsoft Corporation, or PaperMC.
+</div>