{"id":109172,"date":"2026-06-06T13:06:18","date_gmt":"2026-06-06T10:06:18","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/ncode\/"},"modified":"2026-06-06T13:06:18","modified_gmt":"2026-06-06T10:06:18","slug":"ncode","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/ncode\/","title":{"rendered":"NCode"},"content":{"rendered":"

# \ud83d\ude80 NCode \u2014 The Ultimate Player Referral System<\/p>\n

**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.<\/p>\n

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.<\/p>\n

—<\/p>\n

## \u2728 Key Features<\/p>\n

### \ud83d\udcf1 Advanced Reward System (RNG)
\n– **True probabilities:** Configure prizes with exact drop chances (e.g., 5.5% for a Mythic Sword, 100% for an economy boost).
\n– **Native NBT support:** Deliver physical items with enchantments, custom names, lore, and *CustomModelData* preserved exactly as created in-game.
\n– **Command execution:** Run multiple console commands automatically when a referred player meets your configured playtime requirement.<\/p>\n

### \ud83d\udda5\ufe0f Immersive Visual Editor
\n– **In-game GUI:** Forget complex YAML edits\u2014manage rewards and drop chances in-game with `\/ncode editor`.
\n– **Live adjustments:** Fine-tune probabilities with intuitive controls (Left-click: +1%, Shift+Left: +0.1%, Right-click: -1%, Q: delete).
\n– **Top 10 leaderboard:** A visual menu showing the heads of the players with the most referrals to encourage competition.<\/p>\n

### \u26a1 High Performance & Folia-Ready
\n– **Smart caching:** Uses Caffeine Cache to keep active player data in RAM and automatically purge it after 15 minutes of inactivity.
\n– **Engine detection:** Automatically detects **Folia** and uses `GlobalRegionScheduler` \/ `EntityScheduler` to avoid thread-related crashes.
\n– **Dual storage:** Use local YAML for smaller servers or MySQL\/MariaDB (via HikariCP) for large networks.<\/p>\n

—<\/p>\n

## \ud83d\udee0\ufe0f Commands & Permissions<\/p>\n

| Command | Permission | Description |
\n|—|:—:|—:|
\n| `\/ncode` | `ncode.use` | Open the main referral GUI. |
\n| `\/ncode reference ` | `ncode.use` | Use the referral code of the player who invited you. |
\n| `\/ncode create ` | `ncode.create` | Create a custom 6-character referral code. |
\n| `\/ncode top` | `ncode.top` | Open the visual Top 10 referrers leaderboard. |
\n| `\/ncode renamecode ` | `ncode.rename` | Change your existing referral code. |
\n| `\/ncode editor` | `ncode.admin` | Open the Visual Reward Editor GUI. |
\n| `\/ncode additem ` | `ncode.admin` | Add the item in your hand to the reward pool. |
\n| `\/ncode addcmd ` | `ncode.admin` | Add a console command to the reward pool. |
\n| `\/ncode check ` | `ncode.check` | Check playtime since a player used a code. |
\n| `\/ncode info ` | `ncode.admin` | View a user\u2019s referral status and points. |
\n| `\/ncode setcode ` | `ncode.admin` | Force-assign a specific code to a player. |
\n| `\/ncode deletecode ` | `ncode.delete` | Delete a specific code from storage. |
\n| `\/ncode reset ` | `ncode.admin` | Wipe a player\u2019s referral history and points. |
\n| `\/ncode reload` | `ncode.reload` | Reload configuration and language files. |<\/p>\n

**Global permission:** `ncode.*` \u2014 Grants access to all NCode commands and features (recommended only for server administrators).<\/p>\n

### \ud83d\udccb Detailed Permissions<\/p>\n

- `ncode.use` \u2014 Basic player commands (`\/ncode`, `\/ncode reference`). Assigned to all players by default.
\n- `ncode.create` \u2014 Allows `\/ncode create`. Assigned to operators by default.
\n- `ncode.top` \u2014 Allows `\/ncode top`. Assigned to all players by default.
\n- `ncode.rename` \u2014 Allows `\/ncode renamecode` (ideal for VIP ranks).
\n- `ncode.check` \u2014 Allows checking referral playtime. Assigned to operators.
\n- `ncode.delete` \u2014 Allows deleting codes. Assigned to operators.
\n- `ncode.reload` \u2014 Allows reloading the plugin. Assigned to operators.
\n- `ncode.admin` \u2014 Admin tools (`\/ncode editor`, `\/ncode info`, `\/ncode reset`, `\/ncode setcode`, `\/ncode additem`, `\/ncode addcmd`). Assigned to operators.<\/p>\n

---<\/p>\n

## \ud83d\udcf8 Gallery<\/p>\n

![NCode Main Menu](https:\/\/cdn.modrinth.com\/data\/cached_images\/c63d349aaf63c3f63ce85026e0f82ad47087e620.png)<\/p>\n

![NCode Create Code](https:\/\/cdn.modrinth.com\/data\/cached_images\/9af95e2337cfa20dbf3ea6638eeacf7782a3d45c.png)<\/p>\n

![NCode Information](https:\/\/cdn.modrinth.com\/data\/cached_images\/7fe13644a9b87ecf0845c92d91e7a8fd56a517cf.png)<\/p>\n

---<\/p>\n

## \u2699\ufe0f Configuration<\/p>\n

NCode generates clean, easy-to-use configuration files. Below you can see example defaults.<\/p>\n

### \ud83d\udcc2 config.yml<\/p>\n

```yaml
\n#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
\n# NCode by NovaPixel
\n# Main Configuration File (v1.1.0)
\n#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#<\/p>\n

language: \"en\"<\/p>\n

prefix: \"color:#8652ffNCODE<\/b><\/color> \u00bb<\/dark_gray> \"<\/p>\n

storage:
\n type: \"YAML\"
\n database:
\n host: \"localhost\"
\n port: 3306
\n database: \"ncode_data\"
\n username: \"user\"
\n password: \"password\"
\n pool_settings:
\n maximumPoolSize: 10
\n connectionTimeout: 30000
\n idleTimeout: 600000
\n maxLifetime: 1800000
\n properties:
\n useSSL: true
\n verifyServerCertificate: false<\/p>\n

menu:
\n items:
\n create:
\n material: BIRCH_SIGN
\n view:
\n material: PLAYER_HEAD
\n texture: \"eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMWMxZjljZTAwMjgyZDViZjZiYjA1ZDJkOTBiN2ZiMTI2ZmNhNTRiZGRjNTRjODc4MjIxNGNkYmFmNDA1MWI3ZSJ9fX0=\"<\/p>\n

check-interval: 60<\/p>\n

rewards:
\n points-per-referral: 1
\n playtime_requirement:
\n amount: 5
\n unit: minutes<\/p>\n

referrer_rewards:
\n basic_money:
\n chance: 100.0
\n type: COMMAND
\n command: \"eco give {player} 1000\"<\/p>\n

extra_diamonds:
\n chance: 50.0
\n type: ITEM
\n item:
\n material: DIAMOND
\n amount: 3
\n name: \"Reward Diamonds<\/bold><\/aqua>\"
\n lore:
\n - \"Granted for inviting an active friend.\"<\/p>\n

referred_rewards:
\n starter_kit:
\n chance: 100.0
\n type: COMMAND
\n command: \"give {player} iron_ingot 10\"
\n```<\/p>\n

### \ud83d\udcac messages_en.yml<\/p>\n

```yaml
\n# GUI Menu Texts
\nmenu_text:
\n title: \"gradient:#8A2BE2:#4169E1Referral Menu<\/gradient><\/bold>\"<\/p>\n

create:
\n name: \"gradient:#50C878:#98FB98Create My Code<\/gradient><\/bold>\"
\n lore:
\n - \"\"
\n - \"\u25aa Generate your unique 6-digit code.\"
\n - \"\u25aa Share it with your friends to earn\"
\n - \" rewards when they play.\"
\n - \"\"
\n - \"color:#DDFF00\u25ba Click to Generate!<\/color>\"<\/p>\n

view:
\n name: \"My Information<\/aqua><\/bold>\"
\n lore:
\n - \"\"
\n - \"\u25aa Your Code: {code}\"
\n - \"\u25aa Referred by: color:#E643FF{referrer}<\/color>\"
\n - \"\"
\n - \"\u25aa Use \/ncode reference <\/yellow>\"
\n - \" to be referred by someone.\"<\/p>\n

top_title: \"Top 10 Referrers<\/bold><\/gold>\"
\ntop_item:
\n lore:
\n - \"\"
\n - \"Players invited:\"
\n - \"\u2b50 {points} friends<\/green>\"
\n - \"\"<\/p>\n

editor_title: \"Reward Editor<\/bold><\/dark_red>\"<\/p>\n

# Chat Messages
\nmessages:
\n welcome: \"click:run_command:\/ncodeClick here to get your code!'>gradient:#00ff00:#00ff72CLICK HERE TO CREATE YOUR REFERRAL CODE! [\u2728]<\/gradient><\/hover><\/click>\"
\n your-code: \"Your current referral code is: Click to copy'>click:copy_to_clipboard:{code}{code}<\/click><\/hover><\/gold><\/gray>\"
\n no-code: \"You haven't generated a code yet. Use color:#A781FF\/ncode<\/color> to create one.<\/yellow>\"
\n notify-referrer: \"Congratulations! {player}<\/aqua> has used your referral code.<\/green>\"
\n notify-reward-processed: \"Reward Unlocked! {invited_player}<\/aqua> completed the playtime requirement. You earned {points}<\/gold> point(s).<\/green>\"
\n notify-reward-received: \"Congratulations! You have played enough time after using a referral code. You received your reward!<\/green>\"<\/p>\n

code-created: \"Success! Your code Click to copy'>click:copy_to_clipboard:{code}{code}<\/click><\/hover><\/gold> has been created.<\/green>\"
\n code-used: \"Code applied! You were referred by {player}<\/aqua>.<\/green>\"
\n reload-success: \"NCode configuration and language have been reloaded!<\/green>\"
\n code-deleted: \"The code {code}<\/yellow> has been deleted from storage.<\/green>\"
\n check-time: \"Player {player}<\/aqua> has been using a code for {minutes}<\/yellow> minutes.<\/green>\"
\n setcode-success: \"{player}<\/yellow>'s code has been forced to: {code}<\/aqua><\/green>\"
\n reset-success: \"{player}<\/yellow>'s history and codes have been reset.<\/red>\"
\n rename-success: \"You have successfully renamed your code to {code}<\/yellow>!<\/green>\"
\n reward-deleted: \"Reward deleted successfully.<\/green>\"<\/p>\n

already-created: \"You already have an assigned referral code!<\/red>\"
\n already-used: \"You have already used a referral code before!<\/red>\"
\n code-in-use: \"That code is already registered or in use by another player!<\/red>\"
\n invalid-code: \"The entered code is invalid or does not exist.<\/red>\"
\n no-self-reference: \"You cannot use your own referral code!<\/red>\"
\n no-permission: \"You don't have permission to perform this action.<\/red>\"<\/p>\n

misc:
\n no-code-value: \"None<\/white>\"
\n no-referrer-value: \"Nobody<\/white>\"
\n unknown-player: \"Unknown<\/white>\"
\n group-referrer: \"Referrer<\/gold>\"
\n group-referred: \"Referred<\/aqua>\"
\n editor-group: \"Group\"
\n editor-chance: \"Chance\"
\n editor-controls:
\n - \"L-Click: +1%<\/white> | Shift+L: +0.1%<\/white>\"
\n - \"R-Click: -1%<\/white> | Q Key: Delete<\/red>\"
\n```<\/p>\n

---<\/p>\n

## \ud83d\udce5 Installation<\/p>\n

- Download `NCode.jar`.
\n- Drop it into your server\u2019s `plugins\/` folder.
\n- Restart the server.
\n- (Optional) Install PlaceholderAPI to use NCode placeholders (e.g., `%ncode_my_code%`, `%ncode_invite_players%`) in chat\/scoreboards.<\/p>\n","protected":false},"excerpt":{"rendered":"

Configurable referral code system that rewards players for inviting friends.<\/p>\n","protected":false},"featured_media":109173,"template":"","meta":{"_minecraft_slug":"ncode","_minecraft_project_id":"LnQLGvuz","_minecraft_author":"Tommasino","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":8,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ncode.zip","_minecraft_size_bytes":2557747,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:19:23.521122Z","_minecraft_date_created":"2026-03-04T21:23:13.551246Z","_minecraft_date_modified":"2026-02-27T20:31:03.571295Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ncode","_minecraft_icon_attachment_id":109173,"_minecraft_imported_at":"2026-06-06T10:06:19+00:00","_minecraft_import_hash":"cc24dac62721e915ead4a067b0c23cae","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,127,129],"mod_loader":[131,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-109172","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-paper","mod_category-spigot","mod_loader-folia","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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":"\nNCode - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/ncode\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"NCode - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Configurable referral code system that rewards players for inviting friends.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/ncode\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ncode\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ncode\\\/\",\"name\":\"NCode - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ncode\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ncode\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/ncode-icon-ff86fbd5040663e39357280ce353509651700c43_96.webp\",\"datePublished\":\"2026-06-06T10:06:18+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ncode\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ncode\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ncode\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/ncode-icon-ff86fbd5040663e39357280ce353509651700c43_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/ncode-icon-ff86fbd5040663e39357280ce353509651700c43_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ncode\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"NCode\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"NCode - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/ncode\/","og_locale":"en_US","og_type":"article","og_title":"NCode - Minecraft","og_description":"Configurable referral code system that rewards players for inviting friends.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/ncode\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/ncode\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/ncode\/","name":"NCode - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/ncode\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/ncode\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/ncode-icon-ff86fbd5040663e39357280ce353509651700c43_96.webp","datePublished":"2026-06-06T10:06:18+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/ncode\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/ncode\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/ncode\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/ncode-icon-ff86fbd5040663e39357280ce353509651700c43_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/ncode-icon-ff86fbd5040663e39357280ce353509651700c43_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/ncode\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"NCode"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/109172","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/109173"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=109172"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=109172"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=109172"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=109172"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}