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. "https://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