NCode

插件

· 作者 Tommasino

可配置的推荐码系统,奖励邀请好友的玩家。

0 本站下载 0 关注 更新于 8 个月前

最新 1.1.0 · 1.21.11 · Folia / Paper

一键开服(送7天)

? 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 Main Menu

NCode Create Code

NCode Information


⚙️ 配置

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%)。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源