OrbitUtils

Orbit Changelog

v1.0.0 — Initial Release

▎ Paper 1.21.x | Java 21

Teleportation & Navigation

• Added /home, /sethome, /delhome, /homes — multiple homes per player
• Added /warp, /setwarp, /delwarp, /warps — server-wide warp points
• Added /tpa, /tpahere, /tpaccept, /tpdeny — teleport request system with 30s auto-expiry
• Added /tptoggle — players can block incoming TPA requests
• Added /back — return to last location before teleport
• Added /spawn, /setspawn — per-world spawn management

Player State

• Added /fly — toggle flight for self or others
• Added /god — toggle invincibility for self or others
• Added /heal — restore health to full
• Added /feed — restore hunger to full
• Added /speed — set walk or fly speed (1–10) for self or others
• Added /nick — set nickname with MiniMessage color support (color formatting staff-only)
• Added /vanish — go invisible to non-staff players; join/quit messages suppressed
• Added /afk — toggle AFK status with optional message; auto-clears on movement; restores nickname on return
• Added /✨ — self-kill command

Inventory & Items

• Added /enderchest (/ec) — open ender chest anywhere, view others' with permission
• Added /workbench (/wb, /craft) — open crafting table anywhere
• Added /trash — open a disposal inventory; items deleted on close
• Added /repair — repair held item or all items at once
• Added /hat — wear held item as a helmet
• Added /item (/i) — spawn any item directly into your inventory
• Added /clearinventory (/ci) — clear your own or another player's inventory

Chat & Messaging

• Added /reply (/r) — reply to the last player who messaged you; works with vanilla /msg, /tell, /w
• Added /broadcast (/bc) — server-wide announcement with gold formatting
• Added chat formatting — prefix and suffix displayed in chat automatically

Kits

• Added /kit — list, use, create, and delete kits
• Kit creation saves your current inventory contents directly; no manual item entry
• Per-kit cooldown support in seconds
• Permissions: orbit.kit.use for players, orbit.kit.admin for create/delete

Mail

• Added /mail read — read all inbox messages, marks them as read
• Added /mail send — send mail to online or offline players
• Added /mail clear — delete all mail
• Online players notified immediately on receiving mail; offline players notified on next login

Permission System

• Added built-in group system with /group — create, delete, list, inspect groups
• Group properties: prefix, suffix, weight, permission list, inheritance chain
• Added /perm — assign groups, add/remove individual permissions, view info
• LuckPerms auto-detected on startup; routes all permission changes through LuckPerms API if present
• Default groups created on first run: default, mod, admin with sensible permission sets
• Permissions persist via groups.yml and userperms.yml

Social Features

• Added /socialspy — staff can monitor all private messages in real time
• Social spy covers /reply and vanilla /msg / /tell / /w

Info & Utility

• Added /ping — check your own or another player's latency
• Added /seen — check when a player was last online
• Added /playtime — view total playtime for self or others; session-accurate, persists across restarts
• Added /sinfo — live server info: TPS (1m/5m/15m), memory usage, version, online players

Rules

• Added /rules — display server rules
• Added /rules set and /rules del — manage rules in-game, no file editing needed

GUI Menu

• Added /orbit — opens a 54-slot inventory menu with every feature documented
• Click any button to run the command or see usage hints
• Supports /serverutils, /su, /sutils as aliases

Integrations

• PlaceholderAPI support — registers %orbit_nickname%, %orbit_afk%, %orbit_vanished%, %orbit_god%, %orbit_fly%, %orbit_ping%
• TAB plugin compatible via PlaceholderAPI
• LuckPerms soft dependency — full two-way integration for groups and permissions
• Vanish system integrates with Paper's hide/show player API

Data & Persistence

• playerdata.yml — nicknames, spawn points, last seen, playtime
• groups.yml — permission group definitions
• userperms.yml — per-player group assignments and individual permissions
• kits.yml — saved kit item data and cooldown settings
• mail.yml — inbox storage with read/unread state
• rules.yml — server rule list
• homes.yml, warps.yml — location storage