Pluxie

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?

1. /px setup Opens the web panel (player-only) ❌
2. /px reload Reloads config.yml from disk ✅
3. /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. "panel.myserver.com";)
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