✦ SXCMC — SXCore MC ✦

Everything your Minecraft server needs, in one plugin

Built by SX Team and XserGod

An all-in-one server essentials plugin, 180 commands, a built-in economy, a full moderation toolkit, homes/warps/kits, and dozens of extra utilities, all packed into one lightweight, optimized jar.

Java 17 · Spigot API 1.13 → latest · Zero external dependencies · 180 commands

---

📖 Table of Contents

• What is SXCMC?
• Key Features
• Installation
• Version Compatibility
• All 180 Commands, Organized by Category
• Permission System — Everything About Access Control
• Configuration (config.yml)
• Data Storage
• Technical Notes for Server Admins
• Frequently Asked Questions
• Credits

---

🎯 What is SXCMC?

SXCMC (short for SXCore MC) is an all-in-one plugin for Spigot/Paper servers, built to replace a whole stack of separate plugins. Instead of running one plugin for homes, another for economy, another for moderation, another for kits — and then dealing with the conflicts and overhead of having a dozen plugins fighting over the same territory — you get everything in a single, coherent package.

The philosophy behind it is simple: everything EssentialsX gives you, plus a lot of things even EssentialsX doesn't have — all wrapped up in a lean, cleanly-written plugin with 180 genuinely functional commands, each one doing exactly what it says.

✨ Key Features

Feature	What it means for you
🏠 Complete Homes & Warps system	Unlimited homes (limit configurable via permissions), server-wide warps, teleports with a configurable warmup and cooldown
🤝 Social teleportation (TPA)	Two-way teleport requests, with the ability to cancel, deny, and opt out of receiving requests entirely
🎒 Kits with per-kit cooldowns	Every kit has its own independent cooldown; staff can turn their current inventory into a brand new kit in one command
💰 Built-in economy, no Vault required	Player balances, peer-to-peer payments, a live leaderboard, and full admin control over every account
🛡️ Professional-grade moderation	Ban / tempban / IP-ban (running on Minecraft's own native ban system, not a custom file), timed mutes, warnings, freezing, and multiple simultaneous jails
👻 Vanish, Freeze, God Mode, Fly	The standard toolkit every staff member needs for hands-on, real-time server management
📬 Built-in offline mail system	Leave a message for a player even while they're offline — they'll see it the next time they check their mail
🔍 SocialSpy & CommandSpy	Quietly monitor private messages and commands run by players — staff-only, of course
⚠️ Reports & Warnings system	Players can formally report bad behavior; staff can log warnings with reasons and review the full history later
🌦️ Full world control	Global and personal time/weather, difficulty, gamerules, mob spawning, explosions, lightning strikes
🎆 Visual effects on tap	Particles, sounds, titles/subtitles/action bar messages, fireworks
📊 Server monitoring without needing Paper	TPS is measured with our own lightweight algorithm — no dependency on Paper-only APIs, works fine on vanilla Spigot too
🔐 182 dedicated permission nodes	Every single one of the 180 commands has its own permission node, fully compatible with LuckPerms or any other permissions plugin
⚡ Optimized from the ground up	Smart, dirty-flag-based saving (only data that actually changed gets written to disk), zero bundled external libraries

---

📦 Installation

1. Grab the built jar (SXCMC-1.0.0.jar) from the target/ folder after building the project.
2. Drop it into your server's plugins/ folder.
3. Restart the server (a full restart, not just a /reload, for the very first install).
4. SXCMC will automatically generate the following inside plugins/SXCMC/:
   • config.yml — the main configuration file
   • warps.yml, jails.yml, kits.yml, mail.yml, warnings.yml, reports.yml, spawn.yml
   • playerdata/ — one file per player

If you're running a permissions plugin (we recommend LuckPerms), make sure to read the Permission System section below so you know exactly which nodes to hand out to which rank.

🧩 Version Compatibility

SXCMC is deliberately compiled against Spigot API version 1.13.2 — the oldest version in the range we're targeting. Why? Because Bukkit/Spigot almost never removes old methods, so code compiled against the 1.13 API keeps working perfectly fine on every newer server version (1.16.5, 1.20, 1.21, and beyond).

Wherever a feature only exists on newer Minecraft versions (like SMITHING, GRINDSTONE, or STONECUTTER, all introduced in 1.14), the plugin resolves that constant dynamically at runtime (Enum.valueOf(...)) instead of referencing it directly at compile time. In practice that means:

• On 1.14+ servers → everything works exactly as expected.
• On 1.13.x servers → you get a clean, friendly error message ("this feature isn't supported on this server version") instead of the plugin crashing outright.

If you only ever plan to run this on 1.16.5 or newer (your primary version), you don't need to change anything — it just works. This design exists purely to guarantee compatibility with the older end of the version range.

---

📜 All 180 Commands, Organized by Category

Every command below gets its own table row: a plain-English explanation of what it actually does, the exact syntax, its dedicated permission node, and whether it's open to everyone by default or locked to operators.

💡 [name] means the parameter is optional. <name> means it's required.

🗺️ Teleportation, Homes & Warps (29 commands)

Command	What it does	Usage	Permission	Default access
/home	Teleports you straight to one of your saved homes. Run it with no name to jump to your default home.	/home [name]	sxcmc.home	🟢 Everyone
/sethome	Saves your current spot as a home you can warp back to any time. Name it, or leave it blank for your default home.	/sethome [name]	sxcmc.sethome	🟢 Everyone
/delhome	Deletes a home you no longer need, freeing up a slot if you're near your limit.	/delhome <name>	sxcmc.delhome	🟢 Everyone
/homes	Lists every home you currently have saved, by name.	/homes	sxcmc.homes	🟢 Everyone
/homelimit	Shows how many homes you're allowed and how many you've already used.	/homelimit	sxcmc.homelimit	🟢 Everyone
/sethomelimit	Lets staff explain/adjust how many homes a player can set (actual limits are permission-driven, see the Permissions section).	/sethomelimit <player> <amount>	sxcmc.sethomelimit	🔴 Op only
/spawn	Sends you back to the server's spawn point, wherever you are.	/spawn	sxcmc.spawn	🟢 Everyone
/setspawn	Moves the server's spawn point to your current location. One command, and that's where every new player and every /spawn lands.	/setspawn	sxcmc.setspawn	🔴 Op only
/back	Returns you to the last spot you were standing before your most recent teleport — a lifesaver after a bad /tp or dying somewhere weird.	/back	sxcmc.back	🟢 Everyone
/top	Shoots you straight up to the highest block at your current X/Z, handy for escaping caves or ravines.	/top	sxcmc.top	🟢 Everyone
/tpa	Sends another player a request to teleport to them. They have to accept it first.	/tpa <player>	sxcmc.tpa	🟢 Everyone
/tpahere	Sends another player a request asking them to teleport to you.	/tpahere <player>	sxcmc.tpahere	🟢 Everyone
/tpaccept	Accepts whichever teleport request is currently pending for you.	/tpaccept	sxcmc.tpaccept	🟢 Everyone
/tpdeny	Declines the pending teleport request you received.	/tpdeny	sxcmc.tpdeny	🟢 Everyone
/tpcancel	Cancels the teleport request you sent out, before the other player responds.	/tpcancel	sxcmc.tpcancel	🟢 Everyone
/tptoggle	Flips whether you're open to receiving teleport requests at all — turn it off if you want to be left alone.	/tptoggle	sxcmc.tptoggle	🟢 Everyone
/tp	Staff command: instantly teleports one player to another (or to you).	/tp <player> [target]	sxcmc.tp	🔴 Op only
/tphere	Staff command: pulls a player straight to wherever you're standing.	/tphere <player>	sxcmc.tphere	🔴 Op only
/tppos	Teleports you to exact X, Y, Z coordinates in your current world.	/tppos <x> <y> <z>	sxcmc.tppos	🔴 Op only
/tpall	Staff command: gathers every online player and teleports them all to your location at once.	/tpall	sxcmc.tpall	🔴 Op only
/tpallhere	Points you toward /tpall for gathering everyone in one place — a quick usage reminder.	/tpallhere	sxcmc.tpallhere	🔴 Op only
/rtp	Randomly teleports you somewhere safe in the world — great for finding fresh, unexplored terrain.	/rtp	sxcmc.rtp	🟢 Everyone
/warp	Teleports you to a named warp point set up by the server.	/warp <name>	sxcmc.warp	🟢 Everyone
/setwarp	Creates a new warp at your current location for everyone to use.	/setwarp <name>	sxcmc.setwarp	🔴 Op only
/delwarp	Removes a warp that's no longer needed.	/delwarp <name>	sxcmc.delwarp	🔴 Op only
/warps	Lists every warp currently available on the server.	/warps	sxcmc.warps	🟢 Everyone
/warpinfo	Shows the exact world and coordinates of a specific warp.	/warpinfo <name>	sxcmc.warpinfo	🟢 Everyone
/world	Teleports you to the spawn point of a different world/dimension on the server.	/world <name>	sxcmc.world	🔴 Op only
/unstuck	An emergency escape command — teleports you to the nearest safe spot if you're stuck inside blocks.	/unstuck	sxcmc.unstuck	🟢 Everyone

🎒 Items, Kits & Inventory (31 commands)

Command	What it does	Usage	Permission	Default access
/kit	Hands you all the items in a named kit, respecting that kit's cooldown so it can't be spammed.	/kit <name>	sxcmc.kit	🟢 Everyone
/kits	Lists every kit currently available to claim.	/kits	sxcmc.kits	🟢 Everyone
/setkit	Staff command: saves your current inventory as a brand new kit, with an optional cooldown in seconds.	/setkit <name> [cooldownSeconds]	sxcmc.setkit	🔴 Op only
/delkit	Removes a kit entirely.	/delkit <name>	sxcmc.delkit	🔴 Op only
/kitreset	Clears a player's cooldown on a specific kit, letting them claim it again immediately.	/kitreset <player> <kit>	sxcmc.kitreset	🔴 Op only
/item	Gives yourself a stack of any item by name — quick way to grab building blocks or tools.	/item <material> [amount]	sxcmc.item	🔴 Op only
/give	Staff command: gives a specific item and amount directly to another player's inventory.	/give <player> <material> [amount]	sxcmc.give	🔴 Op only
/take	Staff command: removes a specific item and amount from a player's inventory.	/take <player> <material> [amount]	sxcmc.take	🔴 Op only
/more	Tops off the item stack in your hand up to its maximum size.	/more	sxcmc.more	🔴 Op only
/stack	Cleans up your inventory by merging partial stacks of the same item together.	/stack	sxcmc.stack	🟢 Everyone
/unstack	Splits the stack in your hand roughly in half, handy for sharing or organizing.	/unstack	sxcmc.unstack	🟢 Everyone
/repair	Fully repairs the durability of whatever tool, weapon, or armor piece is in your hand.	/repair	sxcmc.repair	🔴 Op only
/repairall	Repairs every repairable item in your entire inventory in one go.	/repairall	sxcmc.repairall	🔴 Op only
/hat	Swaps whatever's in your hand onto your head as a helmet — pure fun/cosmetic.	/hat	sxcmc.hat	🟢 Everyone
/trash	Opens a disposable inventory window — anything you drop in there is gone for good.	/trash	sxcmc.trash	🟢 Everyone
/disposal	Same idea as /trash: a quick way to permanently get rid of junk items.	/disposal	sxcmc.disposal	🟢 Everyone
/skull	Gives you a player head item, either your own or someone else's.	/skull [player]	sxcmc.skull	🟢 Everyone
/enchant	Staff command: adds an enchantment (and level) directly to the item in your hand, bypassing normal restrictions.	/enchant <enchantment> <level>	sxcmc.enchant	🔴 Op only
/unenchant	Strips every enchantment off the item currently in your hand.	/unenchant	sxcmc.unenchant	🔴 Op only
/itemname	Renames the item in your hand to whatever custom text you want, with color code support.	/itemname <name>	sxcmc.itemname	🟢 Everyone
/itemlore	Adds a line of lore (flavor text) to the item in your hand.	/itemlore <text>	sxcmc.itemlore	🟢 Everyone
/workbench	Opens a crafting table interface without needing to place a physical one.	/workbench	sxcmc.workbench	🟢 Everyone
/anvil	Opens an anvil interface for renaming or combining items, without needing a physical one nearby.	/anvil	sxcmc.anvil	🟢 Everyone
/cartography	Opens a cartography table for map-related crafting, no physical table required.	/cartography	sxcmc.cartography	🟢 Everyone
/grindstone	Opens a grindstone for removing enchantments and repairing, no physical block needed.	/grindstone	sxcmc.grindstone	🟢 Everyone
/loom	Opens a loom for banner patterns, no physical block needed.	/loom	sxcmc.loom	🟢 Everyone
/smithing	Opens a smithing table for netherite upgrades, no physical block needed.	/smithing	sxcmc.smithing	🟢 Everyone
/stonecutter	Opens a stonecutter for quick stone-shape crafting, no physical block needed.	/stonecutter	sxcmc.stonecutter	🟢 Everyone
/enderchest	Opens your own ender chest, or (with permission) another player's.	/enderchest [player]	sxcmc.enderchest	🟢 Everyone
/invsee	Staff command: opens and lets you view/edit another player's live inventory — great for investigating reports.	/invsee <player>	sxcmc.invsee	🔴 Op only
/clearinventory	Wipes out your entire inventory, or (with permission) another player's.	/clearinventory [player]	sxcmc.clearinventory	🟢 Everyone

🧍 Player State & Info (28 commands)

Command	What it does	Usage	Permission	Default access
/fly	Toggles flight mode on or off for yourself, or for another player if you have permission.	/fly [player]	sxcmc.fly	🔴 Op only
/flyspeed	Adjusts how fast you move while flying, on a scale of 1 to 10.	/flyspeed <1-10>	sxcmc.flyspeed	🔴 Op only
/walkspeed	Adjusts how fast you move while walking, on a scale of 1 to 10.	/walkspeed <1-10>	sxcmc.walkspeed	🔴 Op only
/speed	One command to set either your walk or fly speed, on a scale of 1 to 10.	`/speed <1-10> [walk	fly]`	sxcmc.speed
/god	Toggles invincibility — while it's on, nothing can hurt you.	/god [player]	sxcmc.god	🔴 Op only
/heal	Instantly restores full health and hunger, to yourself or another player.	/heal [player]	sxcmc.heal	🔴 Op only
/healall	Staff command: fully heals every player currently online, all at once.	/healall	sxcmc.healall	🔴 Op only
/feed	Instantly fills the hunger bar back up to full.	/feed [player]	sxcmc.feed	🔴 Op only
/feedall	Staff command: fills every online player's hunger bar at once.	/feedall	sxcmc.feedall	🔴 Op only
/gmc	Quick-switches your gamemode straight to Creative.	/gmc [player]	sxcmc.gmc	🔴 Op only
/gms	Quick-switches your gamemode straight to Survival.	/gms [player]	sxcmc.gms	🔴 Op only
/gma	Quick-switches your gamemode straight to Adventure.	/gma [player]	sxcmc.gma	🔴 Op only
/gmsp	Quick-switches your gamemode straight to Spectator.	/gmsp [player]	sxcmc.gmsp	🔴 Op only
/gamemode	Sets your gamemode to whichever one you specify by name.	/gamemode <mode> [player]	sxcmc.gamemode	🔴 Op only
/vanish	Makes you invisible to other players on the server without actually leaving — perfect for quiet moderation.	/vanish [player]	sxcmc.vanish	🔴 Op only
/nick	Sets a custom display name that shows up in chat and the tab list instead of your real username.	/nick [name]	sxcmc.nick	🟢 Everyone
/realname	Looks up the real account name behind a nickname, so staff always know who's who.	/realname <nick>	sxcmc.realname	🟢 Everyone
/afk	Marks you as Away From Keyboard and announces it, so others know you're not actively playing.	/afk	sxcmc.afk	🟢 Everyone
/afklist	Lists everyone currently marked as AFK.	/afklist	sxcmc.afklist	🟢 Everyone
/suicide	Instantly ends your own life in-game — useful for resetting position or getting unstuck from a bad spot.	/suicide	sxcmc.suicide	🟢 Everyone
/jump	Teleports you to the exact spot you're currently looking at, up to 200 blocks away.	/jump	sxcmc.jump	🟢 Everyone
/uuid	Shows the permanent UUID behind any player's username.	/uuid <player>	sxcmc.uuid	🟢 Everyone
/whois	Pulls up a full profile on a player: health, food, gamemode, world, balance, and vanish status.	/whois <player>	sxcmc.whois	🔴 Op only
/seen	Tells you whether a player is online right now, and if not, exactly when they were last seen.	/seen <player>	sxcmc.seen	🟢 Everyone
/playtime	Shows the total time a player has spent on the server, all-time.	/playtime [player]	sxcmc.playtime	🟢 Everyone
/playtimetop	Shows a leaderboard of playtime among currently online players.	/playtimetop	sxcmc.playtimetop	🟢 Everyone
/uptime	Shows how long the server itself has been running since the last restart.	/uptime	sxcmc.uptime	🟢 Everyone
/lastlogin	Same as /seen — shows a player's most recent time online.	/lastlogin <player>	sxcmc.lastlogin	🟢 Everyone

💰 Economy (6 commands)

Command	What it does	Usage	Permission	Default access
/balance Aliases: /bal, /money	Shows how much money you (or another player) currently has.	/balance [player]	sxcmc.balance	🟢 Everyone
/pay	Transfers money directly from your balance to another player's.	/pay <player> <amount>	sxcmc.pay	🟢 Everyone
/eco	Staff command: gives, takes, or sets any player's balance directly.	`/eco <give	take	set> `
/baltop	Shows a leaderboard of the richest players currently online.	/baltop	sxcmc.baltop	🟢 Everyone
/economy	Same as /eco — full administrative control over player balances.	`/economy <give	take	set
/ecoreset	Resets a player's balance back to the server's configured starting amount.	/ecoreset <player>	sxcmc.ecoreset	🔴 Op only

💬 Chat & Communication (17 commands)

Command	What it does	Usage	Permission	Default access
/msg Aliases: /tell, /w, /whisper	Sends a private message to another player that only they can see.	/msg <player> <message>	sxcmc.msg	🟢 Everyone
/reply Aliases: /r	Quickly replies to whoever last messaged you, without needing to type their name again.	/reply <message>	sxcmc.reply	🟢 Everyone
/ignore	Blocks private messages from a specific player.	/ignore <player>	sxcmc.ignore	🟢 Everyone
/unignore	Removes a player from your ignore list, letting their messages through again.	/unignore <player>	sxcmc.unignore	🟢 Everyone
/ignorelist	Shows everyone you currently have ignored.	/ignorelist	sxcmc.ignorelist	🟢 Everyone
/socialspy	Staff-only: lets you silently see every private message sent between other players.	/socialspy	sxcmc.socialspy	🔴 Op only
/commandspy	Staff-only: lets you silently see every command other players run.	/commandspy	sxcmc.commandspy	🔴 Op only
/broadcast Aliases: /bc	Sends a formatted announcement to every player on the server at once.	/broadcast <message>	sxcmc.broadcast	🔴 Op only
/alert	Sends an eye-catching, bold warning message to the entire server.	/alert <message>	sxcmc.alert	🔴 Op only
/motd	Displays the server's message of the day.	/motd	sxcmc.motd	🟢 Everyone
/rules	Displays the server's rule list.	/rules	sxcmc.rules	🟢 Everyone
/helpop	Sends a message straight to every online staff member — for when you need help right now.	/helpop <message>	sxcmc.helpop	🟢 Everyone
/staffchat Aliases: /sc	Sends a message into a private channel visible only to staff.	/staffchat <message>	sxcmc.staffchat	🔴 Op only
/adminchat Aliases: /ac	Same as /staffchat — a private channel for staff-only conversation.	/adminchat <message>	sxcmc.adminchat	🔴 Op only
/mail	Leaves a message for an offline player that they'll see the next time they read their mail.	/mail send <player> <message>	sxcmc.mail	🟢 Everyone
/mailread	Reads through all the mail waiting for you.	/mailread	sxcmc.mailread	🟢 Everyone
/mailclear	Clears out your entire mailbox.	/mailclear	sxcmc.mailclear	🟢 Everyone

🛡️ Moderation (28 commands)

Command	What it does	Usage	Permission	Default access
/kick	Removes a player from the server immediately, with an optional reason shown to them.	/kick <player> [reason]	sxcmc.kick	🔴 Op only
/kickall	Staff command: kicks every currently online player at once — handy before a restart.	/kickall [reason]	sxcmc.kickall	🔴 Op only
/ban	Permanently bans a player from the server.	/ban <player> [reason]	sxcmc.ban	🔴 Op only
/tempban	Bans a player for a set amount of time, then automatically lifts it once that time is up.	/tempban <player> <duration> [reason]	sxcmc.tempban	🔴 Op only
/unban	Lifts an existing ban, letting the player back in.	/unban <player>	sxcmc.unban	🔴 Op only
/banlist	Shows every player currently banned from the server.	/banlist	sxcmc.banlist	🔴 Op only
/banip	Bans an IP address outright, blocking every account connecting from it.	`/banip <ip	player>`	sxcmc.banip
/unbanip	Lifts an IP ban.	/unbanip <ip>	sxcmc.unbanip	🔴 Op only
/mute	Silences a player in chat, permanently or for a set duration.	/mute <player> [duration] [reason]	sxcmc.mute	🔴 Op only
/unmute	Lifts a mute, letting the player talk again.	/unmute <player>	sxcmc.unmute	🔴 Op only
/mutelist	Shows every currently online player who's muted.	/mutelist	sxcmc.mutelist	🔴 Op only
/warn	Logs a formal warning against a player, with a reason attached for the record.	/warn <player> [reason]	sxcmc.warn	🔴 Op only
/warnings	Pulls up the full warning history for a specific player.	/warnings <player>	sxcmc.warnings	🔴 Op only
/delwarn	Deletes one specific warning from a player's history by its index number.	/delwarn <player> <index>	sxcmc.delwarn	🔴 Op only
/clearwarnings	Wipes a player's entire warning history clean.	/clearwarnings <player>	sxcmc.clearwarnings	🔴 Op only
/freeze	Locks a player completely in place — they can't move an inch until unfrozen.	/freeze <player>	sxcmc.freeze	🔴 Op only
/unfreeze	Releases a player from being frozen.	/unfreeze <player>	sxcmc.unfreeze	🔴 Op only
/jail	Sends a player to a named jail location, optionally for a set amount of time.	/jail <player> <jailname> [duration]	sxcmc.jail	🔴 Op only
/unjail	Releases a player from jail early.	/unjail <player>	sxcmc.unjail	🔴 Op only
/jails	Lists every jail location that's been set up.	/jails	sxcmc.jails	🟢 Everyone
/setjail	Creates a new jail location at your current spot.	/setjail <name>	sxcmc.setjail	🔴 Op only
/deljail	Removes a jail location.	/deljail <name>	sxcmc.deljail	🔴 Op only
/report	Lets any player formally report another player's bad behavior straight to staff.	/report <player> <reason>	sxcmc.report	🟢 Everyone
/reports	Staff command: shows every report players have submitted.	/reports	sxcmc.reports	🔴 Op only
/clearreports	Wipes the entire report log.	/clearreports	sxcmc.clearreports	🔴 Op only
/clearchat Aliases: /cc	Floods everyone's chat with blank lines, effectively clearing the screen.	/clearchat	sxcmc.clearchat	🔴 Op only
/vanishlist	Shows which staff members are currently vanished.	/vanishlist	sxcmc.vanishlist	🔴 Op only
/freezelist	Shows which players are currently frozen.	/freezelist	sxcmc.freezelist	🔴 Op only

🌍 World & Environment (21 commands)

Command	What it does	Usage	Permission	Default access
/time	Sets or adjusts the current in-game time of the world (day, night, or a specific tick value).	`/time <set	add> `	sxcmc.time
/ptime	Sets your own personal time of day, without affecting anyone else's view of the world.	`/ptime <day	night	reset>`
/weather	Sets the world's weather to sunny, rainy, or a full storm.	`/weather <sun	rain	storm>`
/pweather	Sets your own personal weather, without changing what anyone else sees.	`/pweather <sun	rain	reset>`
/lightning	Strikes lightning at a player's location, or your own — mostly for dramatic effect (and it does deal damage).	/lightning [player]	sxcmc.lightning	🔴 Op only
/explosion	Triggers a controlled explosion right where you're standing, with adjustable power.	/explosion [power]	sxcmc.explosion	🔴 Op only
/burn	Sets a player on fire for a set number of seconds.	/burn <player> <seconds>	sxcmc.burn	🔴 Op only
/extinguish	Puts out fire on yourself or another player instantly.	/extinguish [player]	sxcmc.extinguish	🟢 Everyone
/particle	Spawns a burst of a chosen particle effect around you — purely cosmetic fun.	/particle <type>	sxcmc.particle	🟢 Everyone
/sound	Plays a chosen sound effect just for you.	/sound <type>	sxcmc.sound	🟢 Everyone
/playsound	Plays a chosen sound effect for another specific player.	/playsound <player> <type>	sxcmc.playsound	🔴 Op only
/title	Flashes a large title message across a player's screen.	/title <player> <text>	sxcmc.title	🔴 Op only
/subtitle	Displays a smaller subtitle line beneath a title on a player's screen.	/subtitle <player> <text>	sxcmc.subtitle	🔴 Op only
/actionbar	Sends a short message that appears just above a player's hotbar.	/actionbar <player> <text>	sxcmc.actionbar	🔴 Op only
/firework	Launches a firework with a colorful effect at your location.	/firework	sxcmc.firework	🟢 Everyone
/difficulty	Changes the world's difficulty level (peaceful, easy, normal, or hard).	/difficulty <mode>	sxcmc.difficulty	🔴 Op only
/kill	Clears out hostile/living entities within a set radius around you — leaves players untouched.	/kill [radius]	sxcmc.kill	🔴 Op only
/killall	Wipes out every non-player entity in the entire world in one sweep.	/killall	sxcmc.killall	🔴 Op only
/gamerule	Changes any vanilla Minecraft gamerule for the world directly from chat.	/gamerule <rule> <value>	sxcmc.gamerule	🔴 Op only
/spawnmob	Spawns a chosen mob (or several) right at your location.	/spawnmob <type> [amount]	sxcmc.spawnmob	🔴 Op only
/worldinfo	Shows a quick summary of the current world: environment, difficulty, time, player count, and loaded chunks.	/worldinfo	sxcmc.worldinfo	🟢 Everyone

🛠️ Admin & Server Info (20 commands)

Command	What it does	Usage	Permission	Default access
/sxcmc	The plugin's main admin command — reload the config, force-save data, or check the version.	`/sxcmc <reload	save	version
/help	Shows a quick overview of what SXCMC can do.	/help	sxcmc.help	🟢 Everyone
/version	Shows exactly which version of SXCMC is currently running.	/version	sxcmc.version	🟢 Everyone
/list Aliases: /online	Lists every player currently online (vanished staff stay hidden from non-staff).	/list	sxcmc.list	🟢 Everyone
/ping	Shows your current connection latency in milliseconds, or another player's.	/ping [player]	sxcmc.ping	🟢 Everyone
/tps	Shows the server's current Ticks Per Second — the best quick indicator of server health.	/tps	sxcmc.tps	🟢 Everyone
/near	Lists every player within a chosen radius of you.	/near [radius]	sxcmc.near	🟢 Everyone
/compass	Tells you which cardinal direction you're currently facing.	/compass	sxcmc.compass	🟢 Everyone
/whoami	Shows a quick summary of your own account: name, UUID, world, and gamemode.	/whoami	sxcmc.whoami	🟢 Everyone
/entitycount	Breaks down exactly how many of each entity type exist in the current world.	/entitycount	sxcmc.entitycount	🔴 Op only
/chunkinfo	Shows details about the chunk you're standing in right now.	/chunkinfo	sxcmc.chunkinfo	🔴 Op only
/gc	Shows the server's current memory (RAM) usage.	/gc	sxcmc.gc	🔴 Op only
/colorcodes	Displays every chat color code so you can copy the one you need.	/colorcodes	sxcmc.colorcodes	🟢 Everyone
/itemdb	Shows technical details about the item currently in your hand.	/itemdb	sxcmc.itemdb	🟢 Everyone
/convertname	Converts a player's username into their UUID, or the other way around.	`/convertname <name	uuid>`	sxcmc.convertname
/serverinfo	Shows an overview of the server itself: version, player count, worlds, and uptime.	/serverinfo	sxcmc.serverinfo	🟢 Everyone
/seed	Shows the world seed of the world you're currently in.	/seed	sxcmc.seed	🔴 Op only
/plugins	Lists every plugin currently loaded on the server, and whether it's enabled.	/plugins	sxcmc.plugins	🔴 Op only
/debug	Toggles a personal debug flag for troubleshooting SXCMC.	/debug	sxcmc.debug	🔴 Op only
/memory	Same as /gc — shows current server memory usage.	/memory	sxcmc.memory	🔴 Op only

---

🔐 Permission System — Everything About Access Control

Every one of the 180 commands listed above has its own dedicated permission node, following the pattern sxcmc.<command-name> — for example, /home requires sxcmc.home, and /ban requires sxcmc.ban. That means with any permissions plugin (LuckPerms, PermissionsEx, etc.) you can control, command by command, exactly what each rank or group is allowed to do.

On top of those 180 nodes, there are two global ones:

Node	Purpose	Default
sxcmc.*	Grants access to every single command in the plugin, no exceptions	op
sxcmc.admin	An internal gate the plugin checks for sensitive actions — affecting other players, editing the world, managing the economy	op

Why two layers of permission?

Some commands (like /fly, /heal, /feed, /god, /gamemode) work both on yourself and on other players. The first layer (sxcmc.<command>) decides whether you're allowed to use that command at all. If you try to use it on another player (e.g. /fly PlayerX), the plugin separately checks whether you also hold sxcmc.admin. That lets you, for example, give a VIP rank the ability to fly themselves without also letting them toggle flight for anyone else.

How the defaults are split up

🟢 Open to everyone by default, no grant needed — 85 commands: These are everyday, low-risk commands: homes, warps, social teleporting (tpa), claiming kits, private messages, checking your balance, general server info, and quality-of-life tools like hat/more/stack.

🔴 Locked to operators by default, must be explicitly granted — 95 commands: These are either directly administrative (ban, kick, mute, freeze, jail), grant a real advantage (fly, god mode, high speed, free items, free repairs), or expose sensitive information (whois, SocialSpy).

Every command table below shows exactly which bucket each command falls into, in the last column.

A quick real-world example with LuckPerms

# Give VIP rank the ability to fly and use god mode
/lp group vip permission set sxcmc.fly true
/lp group vip permission set sxcmc.god true

# Give the Moderator rank full moderation access
/lp group moderator permission set sxcmc.admin true

# Give VIP more homes than the default (instead of the config value)
/lp group vip permission set sxcmc.homes.limit.10 true

A few extra nodes for homes and kits that sit outside the main 180-command list:

• sxcmc.homes.limit.<number> → sets this player's home limit to the given number (the highest one they hold wins)
• sxcmc.homes.unlimited → unlimited homes
• sxcmc.kit.nocooldown → bypasses kit cooldowns entirely
• sxcmc.teleport.nowarmup → teleports instantly, skipping the warmup delay
• sxcmc.teleport.nocooldown → skips the cooldown between teleports

---

⚙️ Configuration (config.yml)

prefix: "&8[&bSXCMC&8] &r"     # Prefix shown on every plugin message

economy:
  enabled: true                # Turn the entire economy system on or off
  starting-balance: 100.0      # Balance a new player starts with
  currency-symbol: "$"         # Currency symbol used everywhere

teleport:
  warmup-seconds: 3            # Seconds to wait before teleporting (cancelled by moving/taking damage)
  cooldown-seconds: 5          # Minimum time required between two teleports
  cancel-on-move: true         # Cancel the teleport if the player moves
  cancel-on-damage: true       # Cancel the teleport if the player takes damage

homes:
  default-limit: 3             # Default number of homes (can be raised via permissions)

afk:
  auto-afk-seconds: 300        # Automatically mark players AFK after this many seconds of inactivity

motd:
  - "&bWelcome to the server!"

rules:
  - "&71. Be respectful to other players."
  - "&72. No cheating or exploiting bugs."

After editing config.yml, there's no need to restart the server — just run:

/sxcmc reload

💾 Data Storage

Everything is stored in plain YAML files, no database required:

File	Contents
playerdata/<uuid>.yml	Homes, balance, nickname, mute status, ignore list, playtime
warps.yml	Every warp on the server
jails.yml	Every configured jail
kits.yml	Each kit's items and its cooldown
mail.yml	Mail waiting to be read
warnings.yml	Logged warnings
reports.yml	Logged reports
spawn.yml	The server's spawn coordinates

Bans (/ban, /tempban, /banip) run on Minecraft's own native ban system (banned-players.json / banned-ips.json) — fully standard, and compatible with any other management tool you might already be running on your server.

For efficiency, each player's data file is only written back to disk when something in it has actually changed (a "dirty flag"). That means the automatic save cycle (every 5 minutes) puts zero extra strain on your disk from idle players.

---

🧠 Technical Notes for Server Admins

• Zero external libraries: no Vault or any other plugin required — the economy and everything else is fully self-contained inside SXCMC.
• Our own TPS monitor: since the official TPS API only exists on Paper, we built a lightweight measurer using a rolling buffer of tick timestamps — it works correctly on both vanilla Spigot and Paper.
• Router-based architecture: instead of one class per command (which would mean 180 separate files), related commands are grouped into 8 router classes. This keeps the codebase compact, easier to maintain, and lighter on memory.
• Jail/Freeze/Vanish are session-based: these states reset after a server restart (except jail assignments themselves, which persist in jails.yml, and whether a player is currently jailed).
• /baltop and /playtimetop only rank currently online players (not everyone who's ever joined) — if you need a full leaderboard across offline players too, just ask and we'll add it.

❓ Frequently Asked Questions

Do I need Vault? No, the economy is fully self-contained. If you later want it to integrate with other shop plugins, Vault support can be added as a separate step.

Can I disable specific commands? Yes — just don't grant that command's permission to any rank (since every admin-tier command defaults to op-only anyway, this is often already the case).

I installed the plugin but a command isn't working, what do I check? First, check your server console for errors on startup. Then confirm you actually hold the permission for that command (/lp user <you> permission check sxcmc.<command>).

Can new features be added? Absolutely — this plugin was built specifically to make adding new commands and features easy. Just say what you need.

---

👥Credits

SXCMC (SXCore MC)

🛠️ Built & Developed by SX Team

---