OmniSuite

🌌 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 <name>, /homes — per player, stored in player YAML.

• 📍 Warps: /setwerp <name>, /warp <name>, /delwarp <name>, /warps — serverwide in config.yml.

• 🧭 Spawn & Back: /setspawn, /spawn, /back — last place via death listener, spawn persists.

• 🤝 TPA system: /tpa <player>, /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 <message>,

• /Mute <player> <seconds> & /unmute <player> — mute via mutedUntil + chat interceptor.

• ℹ️ Info:

• /Rules (from config.yml.rules with § colour codes),

• /Playtime (rough since first-accession hours).

• 💬 Mail system: /mail send <player> <message>, /mail inbox, /mail clear — storage per player in player YAML.

• 💰 Economy light: /bal, /pay <player> <amount> — 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 <name> — In-memory-defined example kits (code shows setups with Enchants/Items).

• 👤 Nick/Vanish/PvP:

• /Nick <name>, /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/<uuid>.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

1. Place OmniSuite.jar in /plugins.

2. Start server → config.yml & player folders are created.

3. Optionally customise chat format, rules, RTP parameters, etc.

4. 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

⸻