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 |
PLUXIE - Your Server's Starter for NEW PLAYERS!
🎯 Overview
Pluxie is a lightweight, server-side-only welcome system for Paper/Spigot Minecraft servers. Designed for admins who want a professional join experience without editing raw YAML files. Configure everything — join messages, vanilla message hiding, and a new-player starter kit — from a beautiful, plain-English web panel opened via an in-game link.
No YAML editing. No external dependencies. No bloat.
✨ Features
🖥️ Web-Based Setup Panel (/px setup)
Secure, one-time token (128-bit, SecureRandom) tied to the admin who ran the command
Embedded HTTP server (com.sun.net.httpserver.HttpServer) — starts only when needed, stops after save or timeout
Rate-limited & body-size limited for security
Always loads current config.yml — panel is never blank or reset; shows saved values on every open
Live preview of messages with & color codes and {player} placeholder
Saves with automatic config.yml.bak backup, then reloads in-game instantly
💬 Join Messages
New player: Custom message for first-time joiners
Returning player: Separate "welcome back" message
Both support {player} placeholder and & color codes
Toggle to hide the vanilla join message (no double messages)
🎁 New-Player Kit System
✅ YES / ❌ NO radio buttons — mutually exclusive, plain English
When enabled: searchable dropdown of 100+ items with plain-English names (stored as material IDs)
Add/remove rows, set amount per item (1–64)
Armor auto-equips into empty matching slots (helmet, chestplate, leggings, boots)
Overflow items drop at player's feet
Given only once per player — tracked in data.yml by UUID
⚙️ Commands (/px alias)
Command Description Console?
- /px setup Opens the web panel (player-only) ❌
- /px reload Reloads config.yml from disk ✅
- /px help Lists commands ✅
Full tab autocompletion for subcommands
Single permission: pluxie.admin (default: OP)
🔒 Security & Reliability
All input validated & sanitized server-side (types, lengths, material IDs)
No code execution, no eval, no trust of browser data
Token expires after configurable minutes (default 10)
New /px setup invalidates previous links
Runs on the correct server thread — Folia-safe where possible
📥 Installation
Download the jar for your server version:
Pluxie-1.21.x.jar — Paper/Spigot 1.21.x (Java 21)
Pluxie-26.x.jar — Paper 26.1+ (Java 25+)
Place in plugins/
Start server → generates plugins/Pluxie/config.yml & data.yml
In-game as OP: run /px setup → click the link → configure → Save
🌐 Networking (Web Panel)
The panel binds to 0.0.0.0:8192 by default. Configure in config.yml:
web:
port: 8192
bind-address: "0.0.0.0"
public-url: "" # Set if behind proxy/custom domain (e.g. ")
token-timeout-minutes: 10
⚠️ Note: Links are plain HTTP unless you set public-url to an HTTPS endpoint. The setup message warns admins about this.
📁 Configuration (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
Edit via /px setup, not by hand. Invalid values fall back to defaults with a logged warning.
🛠️ Technical Details
Aspect Detail
API Paper 1.21.x / 26.x (Spigot compatible)
Java 21 (1.21.x jar), 25+ (26.x jar at runtime)
Dependencies Zero external — shades only the shared core module
Thread Safety Folia-safe: no global scheduler misuse, no main-thread assumptions
Data Storage config.yml (settings), data.yml (UUID → seen/kit flags)
Build ./gradlew build → v1_21/build/libs/Pluxie-1.21.x.jar, v26/build/libs/Pluxie-26.x.jar
评论 0
登录后参与评分
还没有评论,来抢沙发吧