? NCode — 终极玩家推荐系统
NCode 是一款轻量级、专业且功能丰富的玩家推荐系统,专为现代 Minecraft 服务器打造。无论你运行的是单个 Paper 服务器,还是基于 Folia 的大型多线程网络,NCode 都能为你的社区提供无缝、无卡顿的体验。
停止使用过时且仅支持文本的推荐插件。升级到 NCode,享受交互式视觉奖励编辑器、原生 NBT 物品支持以及高性能数据缓存。
✨ 主要特性
? 高级奖励系统(RNG)
- 真实概率: 配置奖品及其确切的掉落几率(例如:传说之剑 5.5%,经济加成 100%)。
- 原生 NBT 支持: 交付带有附魔、自定义名称、描述和 CustomModelData 的物理物品,完全保留在游戏内创建时的状态。
- 命令执行: 当被推荐玩家满足你配置的在线时长要求时,自动执行多条控制台命令。
?️ 沉浸式视觉编辑器
- 游戏内 GUI: 无需进行复杂的 YAML 编辑——通过
/ncode editor 在游戏中管理奖励和掉落几率。
- 实时调整: 使用直观的控制微调概率(左键点击:+1%,Shift+左键:+0.1%,右键点击:-1%,Q 键:删除)。
- 前十排行榜: 一个可视化菜单,展示推荐人数最多的玩家头像,以鼓励竞争。
⚡ 高性能与 Folia 兼容
- 智能缓存: 使用 Caffeine Cache 将活跃玩家数据保留在内存中,并在 15 分钟不活动后自动清除。
- 引擎检测: 自动检测 Folia 并使用
GlobalRegionScheduler / EntityScheduler 以避免线程相关的崩溃。
- 双存储支持: 小型服务器可使用本地 YAML,大型网络则可通过 HikariCP 使用 MySQL/MariaDB。
?️ 命令与权限
| 命令 |
权限 |
描述 |
/ncode |
ncode.use |
打开主推荐 GUI。 |
/ncode reference <code> |
ncode.use |
使用邀请你的玩家的推荐码。 |
/ncode create <code> |
ncode.create |
创建一个自定义的 6 位推荐码。 |
/ncode top |
ncode.top |
打开可视化的前十推荐者排行榜。 |
/ncode renamecode <code> |
ncode.rename |
更改你现有的推荐码。 |
/ncode editor |
ncode.admin |
打开视觉奖励编辑器 GUI。 |
/ncode additem <chance> <group> |
ncode.admin |
将你手中的物品添加到奖励池中。 |
/ncode addcmd <chance> <group> <command> |
ncode.admin |
将一条控制台命令添加到奖励池中。 |
/ncode check <player> |
ncode.check |
检查玩家使用代码后的在线时长。 |
/ncode info <player> |
ncode.admin |
查看用户的推荐状态和积分。 |
/ncode setcode <player> <code> |
ncode.admin |
强制为玩家分配特定代码。 |
/ncode deletecode <code> |
ncode.delete |
从存储中删除特定代码。 |
/ncode reset <player> |
ncode.admin |
清除玩家的推荐历史和积分。 |
/ncode reload |
ncode.reload |
重新加载配置文件和语言文件。 |
全局权限: ncode.* — 授予所有 NCode 命令和功能的使用权限(建议仅授予服务器管理员)。
? 详细权限说明
ncode.use — 基本玩家命令(/ncode, /ncode reference)。默认分配给所有玩家。
ncode.create — 允许使用 /ncode create。默认分配给操作员(OP)。
ncode.top — 允许使用 /ncode top。默认分配给所有玩家。
ncode.rename — 允许使用 /ncode renamecode(非常适合 VIP 等级)。
ncode.check — 允许检查推荐在线时长。分配给操作员。
ncode.delete — 允许删除代码。分配给操作员。
ncode.reload — 允许重新加载插件。分配给操作员。
ncode.admin — 管理工具(/ncode editor, /ncode info, /ncode reset, /ncode setcode, /ncode additem, /ncode addcmd)。分配给操作员。
? 截图



⚙️ 配置
NCode 会生成清晰易用的配置文件。以下是示例默认值。
? config.yml
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
# 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
maxLifetime: 1800000
properties:
useSSL: true
verifyServerCertificate: false
menu:
items:
create:
material: BIRCH_SIGN
view:
material: PLAYER_HEAD
texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMWMxZjljZTAwMjgyZDViZjZiYjA1ZDJkOTBiN2ZiMTI2ZmNhNTRiZGRjNTRjODc4MjIxNGNkYmFmNDA1MWI3ZSJ9fX0="
check-interval: 60
rewards:
points-per-referral: 1
playtime_requirement:
amount: 5
unit: minutes
referrer_rewards:
basic_money:
chance: 100.0
type: COMMAND
command: "eco give {player} 1000"
extra_diamonds:
chance: 50.0
type: ITEM
item:
material: DIAMOND
amount: 3
name: "<aqua><bold>Reward Diamonds</bold></aqua>"
lore:
- "<gray>Granted for inviting an active friend."
referred_rewards:
starter_kit:
chance: 100.0
type: COMMAND
command: "give {player} iron_ingot 10"
? messages_en.yml
# GUI 菜单文本
menu_text:
title: "<bold>gradient:#8A2BE2:#4169E1推荐菜单</gradient></bold>"
create:
name: "<!i><bold>gradient:#50C878:#98FB98创建我的代码</gradient></bold>"
lore:
- ""
- "<!i><white>▪ <gray>生成您独一无二的6位代码。</gray>"
- "<!i><white>▪ <gray>分享给你的朋友,当他们游玩时赚取奖励。"
- "<!i><gray>"
- ""
- "<!i>color:#DDFF00► 点击生成!</color>"
view:
name: "<!i><bold><aqua>我的信息</aqua></bold>"
lore:
- ""
- "<!i><white>▪ <gray>您的代码:{code}"
- "<!i><white>▪ <gray>被谁推荐:color:#E643FF{referrer}</color>"
- ""
- "<!i><white>▪ <gray>使用 <yellow>/ncode reference <code></yellow>"
- "<!i><gray> 以通过他人进行推荐。"
top_title: "<gold><bold>前10名推荐人</bold></gold>"
top_item:
lore:
- ""
- "<!i><gray>邀请玩家数:"
- "<!i><green>⭐ {points} 位朋友</green>"
- ""
editor_title: "<dark_red><bold>奖励编辑器</bold></dark_red>"
# 聊天消息
messages:
welcome: "click:run_command:/ncode<hover:show_text:'<gray>点击此处获取您的代码!'>gradient:#00ff00:#00ff72点击此处创建您的推荐代码![✨]</gradient></hover></click>"
your-code: "<gray>您当前的推荐代码为:<gold><hover:show_text:'<gray>点击复制'>click:copy_to_clipboard:{code}{code}</click></hover></gold></gray>"
no-code: "<yellow>您尚未生成代码。请使用 color:#A781FF/ncode</color> 创建一个。</yellow>"
notify-referrer: "<green>恭喜!<aqua>{player}</aqua> 已使用了您的推荐代码。</green>"
notify-reward-processed: "<green>奖励解锁!<aqua>{invited_player}</aqua> 已完成游戏时长要求。您获得了 <gold>{points}</gold> 点奖励。</green>"
notify-reward-received: "<green>恭喜!在使用推荐代码后,您已达到足够的游戏时长。您已收到您的奖励!</green>"
code-created: "<green>成功!您的代码 <gold><hover:show_text:'<gray>点击复制'>click:copy_to_clipboard:{code}{code}</click></hover></gold> 已创建。</green>"
code-used: "<green>代码已应用!您由 <aqua>{player}</aqua> 推荐。</green>"
reload-success: "<green>NCode 配置和语言设置已重新加载!</green>"
code-deleted: "<green>代码 <yellow>{code}</yellow> 已从存储中删除。</green>"
check-time: "<green>玩家 <aqua>{player}</aqua> 使用代码的时间为 <yellow>{minutes}</yellow> 分钟。</green>"
setcode-success: "<green><yellow>{player}</yellow> 的代码已被强制设置为:<aqua>{code}</aqua></green>"
reset-success: "<red><yellow>{player}</yellow> 的历史记录和代码已重置。</red>"
rename-success: "<green>您已成功将代码重命名为 <yellow>{code}</yellow>!</green>"
reward-deleted: "<green>奖励删除成功。</green>"
already-created: "<red>您已经拥有一个分配的推荐代码!</red>"
already-used: "<red>您已经使用过推荐代码!</red>"
code-in-use: "<red>该代码已被注册或正在被其他玩家使用!</red>"
invalid-code: "<red>输入的代码无效或不存在。</red>"
no-self-reference: "<red>您不能使用自己的推荐代码!</red>"
no-permission: "<red>您没有权限执行此操作。</red>"
misc:
no-code-value: "<white>无</white>"
no-referrer-value: "<white>无人</white>"
unknown-player: "<white>未知</white>"
group-referrer: "<gold>推荐人</gold>"
group-referred: "<aqua>被推荐者</aqua>"
editor-group: "分组"
editor-chance: "概率"
editor-controls:
- "<yellow>左键点击: <white>+1%</white> | <yellow>Shift+左键点击: <white>+0.1%</white>"
- "<yellow>右键点击: <white>-1%</white> | <yellow>Q键: <red>删除</red>"
? 安装方法
- 下载
NCode.jar。
- 将其放入服务器的
plugins/ 文件夹中。
- 重启服务器。
- (可选)安装 PlaceholderAPI 以便在聊天/计分板中使用 NCode 占位符(例如
%ncode_my_code%、%ncode_invite_players%)。
? 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



⚙️ Configuration
NCode generates clean, easy-to-use configuration files. Below you can see example defaults.
? config.yml
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
# 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
maxLifetime: 1800000
properties:
useSSL: true
verifyServerCertificate: false
menu:
items:
create:
material: BIRCH_SIGN
view:
material: PLAYER_HEAD
texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMWMxZjljZTAwMjgyZDViZjZiYjA1ZDJkOTBiN2ZiMTI2ZmNhNTRiZGRjNTRjODc4MjIxNGNkYmFmNDA1MWI3ZSJ9fX0="
check-interval: 60
rewards:
points-per-referral: 1
playtime_requirement:
amount: 5
unit: minutes
referrer_rewards:
basic_money:
chance: 100.0
type: COMMAND
command: "eco give {player} 1000"
extra_diamonds:
chance: 50.0
type: ITEM
item:
material: DIAMOND
amount: 3
name: "<aqua><bold>Reward Diamonds</bold></aqua>"
lore:
- "<gray>Granted for inviting an active friend."
referred_rewards:
starter_kit:
chance: 100.0
type: COMMAND
command: "give {player} iron_ingot 10"
? messages_en.yml
# GUI Menu Texts
menu_text:
title: "<bold>gradient:#8A2BE2:#4169E1Referral Menu</gradient></bold>"
create:
name: "<!i><bold>gradient:#50C878:#98FB98Create My Code</gradient></bold>"
lore:
- ""
- "<!i><white>▪ <gray>Generate your unique 6-digit code."
- "<!i><white>▪ <gray>Share it with your friends to earn"
- "<!i><gray> rewards when they play."
- ""
- "<!i>color:#DDFF00► Click to Generate!</color>"
view:
name: "<!i><bold><aqua>My Information</aqua></bold>"
lore:
- ""
- "<!i><white>▪ <gray>Your Code: {code}"
- "<!i><white>▪ <gray>Referred by: color:#E643FF{referrer}</color>"
- ""
- "<!i><white>▪ <gray>Use <yellow>/ncode reference <code></yellow>"
- "<!i><gray> to be referred by someone."
top_title: "<gold><bold>Top 10 Referrers</bold></gold>"
top_item:
lore:
- ""
- "<!i><gray>Players invited:"
- "<!i><green>⭐ {points} friends</green>"
- ""
editor_title: "<dark_red><bold>Reward Editor</bold></dark_red>"
# Chat Messages
messages:
welcome: "click:run_command:/ncode<hover:show_text:'<gray>Click here to get your code!'>gradient:#00ff00:#00ff72CLICK HERE TO CREATE YOUR REFERRAL CODE! [✨]</gradient></hover></click>"
your-code: "<gray>Your current referral code is: <gold><hover:show_text:'<gray>Click to copy'>click:copy_to_clipboard:{code}{code}</click></hover></gold></gray>"
no-code: "<yellow>You haven't generated a code yet. Use color:#A781FF/ncode</color> to create one.</yellow>"
notify-referrer: "<green>Congratulations! <aqua>{player}</aqua> has used your referral code.</green>"
notify-reward-processed: "<green>Reward Unlocked! <aqua>{invited_player}</aqua> completed the playtime requirement. You earned <gold>{points}</gold> point(s).</green>"
notify-reward-received: "<green>Congratulations! You have played enough time after using a referral code. You received your reward!</green>"
code-created: "<green>Success! Your code <gold><hover:show_text:'<gray>Click to copy'>click:copy_to_clipboard:{code}{code}</click></hover></gold> has been created.</green>"
code-used: "<green>Code applied! You were referred by <aqua>{player}</aqua>.</green>"
reload-success: "<green>NCode configuration and language have been reloaded!</green>"
code-deleted: "<green>The code <yellow>{code}</yellow> has been deleted from storage.</green>"
check-time: "<green>Player <aqua>{player}</aqua> has been using a code for <yellow>{minutes}</yellow> minutes.</green>"
setcode-success: "<green><yellow>{player}</yellow>'s code has been forced to: <aqua>{code}</aqua></green>"
reset-success: "<red><yellow>{player}</yellow>'s history and codes have been reset.</red>"
rename-success: "<green>You have successfully renamed your code to <yellow>{code}</yellow>!</green>"
reward-deleted: "<green>Reward deleted successfully.</green>"
already-created: "<red>You already have an assigned referral code!</red>"
already-used: "<red>You have already used a referral code before!</red>"
code-in-use: "<red>That code is already registered or in use by another player!</red>"
invalid-code: "<red>The entered code is invalid or does not exist.</red>"
no-self-reference: "<red>You cannot use your own referral code!</red>"
no-permission: "<red>You don't have permission to perform this action.</red>"
misc:
no-code-value: "<white>None</white>"
no-referrer-value: "<white>Nobody</white>"
unknown-player: "<white>Unknown</white>"
group-referrer: "<gold>Referrer</gold>"
group-referred: "<aqua>Referred</aqua>"
editor-group: "Group"
editor-chance: "Chance"
editor-controls:
- "<yellow>L-Click: <white>+1%</white> | <yellow>Shift+L: <white>+0.1%</white>"
- "<yellow>R-Click: <white>-1%</white> | <yellow>Q Key: <red>Delete</red>"
? Installation
- Download
NCode.jar.
- Drop it into your server’s
plugins/ folder.
- Restart the server.
- (Optional) Install PlaceholderAPI to use NCode placeholders (e.g.,
%ncode_my_code%, %ncode_invite_players%) in chat/scoreboards.
评论 0
登录后参与评分
还没有评论,来抢沙发吧