NCode

# 🚀 NCode — The Ultimate Player Referral System **NCode** is a lightweight, professional, and feature-packed player referral system built for modern Minecraft servers. Whether you run a single **Paper** server or a large multi-threaded network on **Folia**, NCode delivers a seamless, lag-free experience for your community. Stop using outdated, text-only referral plugins. Upgrade to NCode for an interactive Visual Reward Editor, native NBT item support, and high-performance data caching. --- ## ✨ Key Features ### 📱 Advanced Reward System (RNG) - **True probabilities:** Configure prizes with exact drop chances (e.g., 5.5% for a Mythic Sword, 100% for an economy boost). - **Native NBT support:** Deliver physical items with enchantments, custom names, lore, and *CustomModelData* preserved exactly as created in-game. - **Command execution:** Run multiple console commands automatically when a referred player meets your configured playtime requirement. ### 🖥️ Immersive Visual Editor - **In-game GUI:** Forget complex YAML edits—manage rewards and drop chances in-game with `/ncode editor`. - **Live adjustments:** Fine-tune probabilities with intuitive controls (Left-click: +1%, Shift+Left: +0.1%, Right-click: -1%, Q: delete). - **Top 10 leaderboard:** A visual menu showing the heads of the players with the most referrals to encourage competition. ### ⚡ High Performance & Folia-Ready - **Smart caching:** Uses Caffeine Cache to keep active player data in RAM and automatically purge it after 15 minutes of inactivity. - **Engine detection:** Automatically detects **Folia** and uses `GlobalRegionScheduler` / `EntityScheduler` to avoid thread-related crashes. - **Dual storage:** Use local YAML for smaller servers or MySQL/MariaDB (via HikariCP) for large networks. --- ## 🛠️ Commands & Permissions | Command | Permission | Description | |---|:---:|---:| | `/ncode` | `ncode.use` | Open the main referral GUI. | | `/ncode reference <code>` | `ncode.use` | Use the referral code of the player who invited you. | | `/ncode create <code>` | `ncode.create` | Create a custom 6-character referral code. | | `/ncode top` | `ncode.top` | Open the visual Top 10 referrers leaderboard. | | `/ncode renamecode <code>` | `ncode.rename` | Change your existing referral code. | | `/ncode editor` | `ncode.admin` | Open the Visual Reward Editor GUI. | | `/ncode additem <chance> <group>` | `ncode.admin` | Add the item in your hand to the reward pool. | | `/ncode addcmd <chance> <group> <command>` | `ncode.admin` | Add a console command to the reward pool. | | `/ncode check <player>` | `ncode.check` | Check playtime since a player used a code. | | `/ncode info <player>` | `ncode.admin` | View a user’s referral status and points. | | `/ncode setcode <player> <code>` | `ncode.admin` | Force-assign a specific code to a player. | | `/ncode deletecode <code>` | `ncode.delete` | Delete a specific code from storage. | | `/ncode reset <player>` | `ncode.admin` | Wipe a player’s referral history and points. | | `/ncode reload` | `ncode.reload` | Reload configuration and language files. | **Global permission:** `ncode.*` — Grants access to all NCode commands and features (recommended only for server administrators). ### 📋 Detailed Permissions - `ncode.use` — Basic player commands (`/ncode`, `/ncode reference`). Assigned to all players by default. - `ncode.create` — Allows `/ncode create`. Assigned to operators by default. - `ncode.top` — Allows `/ncode top`. Assigned to all players by default. - `ncode.rename` — Allows `/ncode renamecode` (ideal for VIP ranks). - `ncode.check` — Allows checking referral playtime. Assigned to operators. - `ncode.delete` — Allows deleting codes. Assigned to operators. - `ncode.reload` — Allows reloading the plugin. Assigned to operators. - `ncode.admin` — Admin tools (`/ncode editor`, `/ncode info`, `/ncode reset`, `/ncode setcode`, `/ncode additem`, `/ncode addcmd`). Assigned to operators. --- ## 📸 Gallery !(https://cdn.modrinth.com/data/cached_images/c63d349aaf63c3f63ce85026e0f82ad47087e620.png) !(https://cdn.modrinth.com/data/cached_images/9af95e2337cfa20dbf3ea6638eeacf7782a3d45c.png) !(https://cdn.modrinth.com/data/cached_images/7fe13644a9b87ecf0845c92d91e7a8fd56a517cf.png) --- ## ⚙️ Configuration NCode generates clean, easy-to-use configuration files. Below you can see example defaults. ### 📂 config.yml ```yaml #~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~# # NCode by NovaPixel # Main Configuration File (v1.1.0) #~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~# language: "en" prefix: "color:#8652ff<b>NCODE</b></color> <dark_gray>»</dark_gray> " storage: type: "YAML" database: host: "localhost" port: 3306 database: "ncode_data" username: "user" password: "password" pool_settings: maximumPoolSize: 10 connectionTimeout: 30000 idleTimeout: 600000 maxLi