Pluxie

插件

· 作者 avy_gxming

一个帮助管理员/OP每次有新玩家加入或老玩家回归时自动欢迎/问候他们的插件,并为新玩家自动发放套装和物品。

2 本站下载 0 关注 更新于 6 天前

最新 1.1 · 26.3 · Paper

一键开服(送7天)

PLUXIE - 新手玩家的服务端入门套件!

🎯 概述

Pluxie 是一个轻量级、仅服务端的欢迎系统,适用于 Paper/Spigot Minecraft 服务器。专为希望在不编辑原始 YAML 文件的情况下提供专业加入体验的管理员而设计。通过游戏内链接打开的精美英文 Web 面板,即可配置所有内容——包括加入消息、原版消息隐藏以及新手玩家起始装备包。

无需编辑 YAML。无外部依赖。零臃肿。

✨ 功能特性

🖥️ 基于 Web 的设置面板 (/px setup)

  • 安全的一次性令牌(128位,SecureRandom),与执行命令的管理员绑定
  • 嵌入式 HTTP 服务器 (com.sun.net.httpserver.HttpServer) —— 仅在需要时启动,保存或超时后停止
  • 限流及请求体大小限制以保障安全
  • 始终加载最新的 config.yml —— 面板永远不会空白或重置;每次打开时显示已保存的值
  • 支持使用 & 颜色代码和 {player} 占位符的消息实时预览
  • 保存时自动生成 config.yml.bak 备份,随后在游戏内即时重载

💬 加入消息

  • 新玩家: 首次加入玩家的自定义消息
  • 回归玩家: 单独的“欢迎回来”消息
  • 两者均支持 {player} 占位符和 & 颜色代码
  • 可切换隐藏原版加入消息(避免重复发送)

🎁 新手玩家起始装备包系统

  • ✅ YES / ❌ NO 单选按钮 —— 互斥选项,使用通俗易懂的英文
  • 启用时:可从 100+ 种物品中进行搜索的下拉菜单,使用通俗易懂的名称存储为材料 ID
  • 添加/删除行,设置每种物品的数量(1–64)
  • 盔甲自动穿戴至对应的空槽位(头盔、胸甲、护腿、靴子)
  • 溢出物品掉落至玩家脚下
  • 每位玩家仅发放一次 —— 通过 UUID 在 data.yml 中跟踪记录

⚙️ 命令 (/px 别名)

命令 描述 控制台可用?
1. /px setup 打开 Web 面板(仅限玩家) ❌
2. /px reload 从磁盘重载 config.yml ✅
3. /px help 列出所有命令 ✅
  • 子命令完整 Tab 补全
  • 单一权限节点:pluxie.admin(默认:OP)

🔒 安全性与可靠性

  • 所有输入在服务端进行验证和清理(类型、长度、材料 ID)
  • 无代码执行,无 eval,不信任浏览器数据
  • 令牌在配置的时间(默认 10 分钟)后过期
  • 新的 /px setup 会使之前的链接失效
  • 在正确的服务器线程上运行 —— 尽可能兼容 Folia

📥 安装方法

下载适合您服务器版本的 jar 包:

  • Pluxie-1.21.x.jar — Paper/Spigot 1.21.x (Java 21)
  • Pluxie-26.x.jar — Paper 26.1+ (Java 25+)

将其放入 plugins/ 文件夹。 启动服务器 → 生成 plugins/Pluxie/config.yml 及 data.yml 在游戏中以 OP 身份运行 /px setup → 点击链接 → 配置 → 保存

🌐 网络配置 (Web 面板)

面板默认绑定到 0.0.0.0:8192。请在 config.yml 中配置:

web:
  port: 8192
  bind-address: "0.0.0.0"
  public-url: ""      # 如果位于代理或自定义域名后方,请设置此项 (例如 "https://panel.myserver.com")
  token-timeout-minutes: 10

⚠️ 注意: 除非您将 public-url 设置为 HTTPS 端点,否则链接均为纯 HTTP。设置消息会提醒管理员注意此情况。

📁 配置文件 (config.yml)

web:
  port: 8192
  bind-address: "0.0.0.0"
  public-url: ""
  token-timeout-minutes: 10

messages:
  new-player: "&aWelcome, {player}! &7Enjoy your stay on the server."
  returning-player: "&aWelcome back, {player}! &7Glad to see you again."
  hide-vanilla-join-message: false

kit:
  enabled: false
  items:
    - material: "DIAMOND_SWORD"
      amount: 1

通过 /px setup 进行编辑,不要手动修改。无效值将回退到默认值并记录警告日志。

🛠️ 技术细节

方面 详情
API Paper 1.21.x / 26.x (兼容 Spigot)
Java 21 (1.21.x jar), 25+ (运行时 26.x jar)
依赖 零外部依赖 —— 仅打包共享 core 模块
线程安全 Folia 安全:未滥用全局调度器,未假设主线程
数据存储 config.yml (设置), data.yml (UUID → 是否见过/起始装备包状态)
构建 ./gradlew build → v1_21/build/libs/Pluxie-1.21.x.jar, v26/build/libs/Pluxie-26.x.jar

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源