? 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%)。
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
可自定义玩家模型
tom5454
自定义你的Minecraft头像!
装饰社交
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧