🌌 OmniSuite – Your all-in-one utility plugin
OmniSuite bundles the most important quality-of-life features for SMPs, community servers and events in one lightweight and modular plugin. Homes & Warps, TPA, RTP, Moderation, Economy light, Mailbox, Nick/Vanish, Kits, Backpack (preview) and even blueprints from resources – all out-of-the-box.
✨ Highlights
• 🏠 Homes: /sethome [name], /home [name], /delhome , /homes — per player, stored in player YAML.
• 📍 Warps: /setwerp , /warp , /delwarp , /warps — serverwide in config.yml.
• 🧭 Spawn & Back: /setspawn, /spawn, /back — last place via death listener, spawn persists.
• 🤝 TPA system: /tpa , /tpaccept, /tpdeny — simple, robust requests (in-memory pending-map).
• 🎲 RTP: /rtp — random teleports with radius & minimum distance from config.yml (rtp.radius, rtp.min-distance).
• 🛫Utility:
• /Fly (toggle flies),
• /Gm <0|1|2|3> [player] (game mode),
• /Feed [player],
• /Repair (sets item damage to 0),
• /Uptime (since server start, h:m:s),
• /Afk (AFK toggle via metadata),
• /Hat (held item as a helmet),
• /Sit (ArmorStand sitting; sneak to get up).
• 🧑⚖️ Moderation:
• /Broadcast ,
• /Mute & /unmute — mute via mutedUntil + chat interceptor.
• ℹ️ Info:
• /Rules (from config.yml.rules with § colour codes),
• /Playtime (rough since first-accession hours).
• 💬 Mail system: /mail send , /mail inbox, /mail clear — storage per player in player YAML.
• 💰 Economy light: /bal, /pay — very simple YAML accounts without external dependencies.
• 🎒 Backpack (Preview): /backpack — 27-slot inventory; Load from player YAML available, save when closing is still "to-do" as an event (see comment in the code).
• 🧰 Kits: /kits, /kit — In-memory-defined example kits (code shows setups with Enchants/Items).
• 👤 Nick/Vanish/PvP:
• /Nick , /unnick,
• /Vanish (completely hidden, incl. tab),
• /Pvp (per-player toggle).
• 🧱 Blueprint-Pastes: /schem <list|paste> [name]
• Resource-based .obp files (hub.obp, arena.obp, market.obp) + palette.txt
• Fast paste relative to player position; block palette of resources.
⚙️ Configuration & Storage
• Config.yml:
• Chat-format (formatting with & codes),
• Join-message, quit-message,
• Rules: (multi-line server rules, § colour codes supported),
• Rtp.radius, rtp.min-distance, rtp.cooldown-seconds (cooldown value is already prepared; not yet wired in the current command).
• Player data: plugins/OmniSuite/players/.yml
• Saves e.o. Homes, Backpack slots (if available), Economy balance, Mail inbox, Nicknames, PvP status.
🔐 Permissions (excerpt)
• Omnisuite.use – Default (default: true)
• Omnisuite.mod – Moderator commands (default: op)
• Omnisuite.admin – Admin rights (default: op)
🧩 Compatibility
• Api-version: 1.21 (POSTWORLD-Load)
• Tested for Paper / Purple / Folia / Spigot
• Java 21 Build
• No external dependencies
🧪 Known boundaries / Roadmap
• Backpack-Persistence: Shop available, Storage at inventory-Close is still open (planned as listener).
• RTP-Cooldown: Field exists in config.yml, hook in the command follows.
• Kits management: Currently in-memory; persistent kit definitions in config are planned.
• Mailbox "read": Mentioned in Command-Help, but currently not implemented (present: send, inbox, clear).
📥 Installation
Place OmniSuite.jar in /plugins.
Start server → config.yml & player folders are created.
Optionally customise chat format, rules, RTP parameters, etc.
Done.
⸻
🧾 Command overview (compact)
/Sethome, /home, /delhome, /homes, /setwarp, /warp, /delwarp, /warps , /setspawn, /spawn, /back, /tpa, /tpaccept, /tpdeny, /rtp, /fly, /gm, /feed, /repair, /uptime, /afk, /hat, /sit, /broadcast, /mute, /unmute, /rules, /playtime, /kits, /kits, /nick, /unnick, /vanish, /pvp, /backpack, /mail, /bal, /pay, /schem
⸻
