Commands
Every command Alpha-system registers, grouped the same way as /as help.
On this page
permissions: section without touching plugin.yml — see Permissions → Remapping.General /as, /alphasystem
| Command | Usage | Permission | Description |
|---|---|---|---|
/as | Plugin info — version, author, server. | ||
/as help [page] | Paginated in-game command list, grouped the same way as this page. | ||
/as reload | alphasystem.admin | Reloads config.yml, lang/messages.yml, lang/deathmessages.yml, punishments.yml, economy.yml, announcements.yml. Does not reload compiled code. | |
/as diagnostics | alphasystem.admin | Health check — see FAQ → What does /as diagnostics check? |
Utility
| Command | Usage | Permission | Description |
|---|---|---|---|
/flyspeed /fs | <1-10> | alphasystem.flyspeed | Set your own fly speed. |
/gm | <0-3> [player] | alphasystem.gm / .gm.others | Change gamemode by number (0=survival, 1=creative, 2=adventure, 3=spectator). |
/gmc /gms /gmsp /gmad | [player] | alphasystem.gm | Shortcut gamemode switches. |
/heal | [player|all] | alphasystem.heal / .heal.others | Full health + extinguishes fire. |
/feed | [player|all] | alphasystem.feed / .feed.others | Full hunger + saturation. |
/godmode /god | [player] | alphasystem.god / .god.others | Toggle invulnerability. |
/ungodmode /ungod | [player] | alphasystem.god | Explicitly turn god mode off. |
/fly | [player] | alphasystem.fly / .fly.others | Toggle flight. |
/kill | [player] | alphasystem.kill / .kill.others | Instant kill. |
/ping | [player] | alphasystem.ping / .ping.others | Show latency in ms. |
/vanish /v | alphasystem.vanish | Toggle invisibility to other players. Self-reminder shown via bossbar or actionbar (vanish.notify-style in config.yml). | |
/skull /head | <player> | alphasystem.skull | Get a player's head item. |
/hat | alphasystem.hat | Wear the item in your hand as a helmet. | |
/tpsbar | alphasystem.tpsbar | Toggle a bossbar showing live 1m/5m/15m TPS, with a smooth green→yellow→orange→red color gradient. | |
/nv | alphasystem.nv | Permanent night vision — survives death and totem-of-undying saves. | |
/back | alphasystem.back | Teleport to your last death location, with a movement-cancellable warmup. Bypass: .back.bypasswarmup. | |
/freeze | <player> | alphasystem.freeze | Freeze a player in place — they can still look around, just can't move. |
/crafting | alphasystem.crafting | Portable crafting table. | |
/anvil | alphasystem.anvil | Portable anvil. | |
/enderchest /echest | alphasystem.echest | Open your own ender chest from anywhere. | |
/fixhand | alphasystem.fixhand | Repair the item in your hand. Optional cost — fixitem.fixhand.cost-type (none/money/xp) + .cost-amount. | |
/fixall | [player] | alphasystem.fixall | Repair every damaged item in your inventory (armor, hotbar, offhand). Console and staff can name a player to repair theirs instead. Same optional-cost pattern as /fixhand. |
Admin Inventory
| Command | Usage | Permission | Description |
|---|---|---|---|
/invsee | <player> | alphasystem.invsee | View a player's inventory — read-only, live-refreshing every second. |
/invedit /inv | <player> | alphasystem.invedit | Freely edit a player's inventory, armor, and offhand. Syncs live as you edit. |
/enderchestsee /ecsee | <player> | alphasystem.enderchestsee | View a player's ender chest — read-only. |
/enderchestedit /ecedit | <player> | alphasystem.enderchestedit | Freely edit a player's ender chest. |
Both edit GUIs have a "clear everything" button gated behind its own permission (alphasystem.invedit.clear / alphasystem.enderchestedit.clear) with a confirm-before-you-wipe screen — clearing can't be triggered by a misclick.
Teleport
| Command | Usage | Permission | Description |
|---|---|---|---|
/tp | <player> [target] | alphasystem.tp / .tp.others | Teleport to a player, or one player to another. |
/tphere /tph | <player> | alphasystem.tphere | Pull a player to you. |
/tpall | [target] | alphasystem.tpall | Pull every online player to you (or a target). |
/otp | <player> | alphasystem.otp | Teleport to a player's last known location, even offline — reads their saved position on quit. |
/spawn | alphasystem.spawn | Teleport to the server spawn point, with a warmup. Bypass: .spawn.bypasswarmup. | |
/setspawn | alphasystem.setspawn | Set the server spawn to your current position. | |
/spawnpoint | alphasystem.spawnpoint | Instantly teleport to the first-join spawn point (admin-only, no warmup — useful for checking what new players see). | |
/spawnpointset | alphasystem.spawnpointset | Set where brand-new players spawn on their very first join. Independent of /setspawn. | |
/setrespawn | alphasystem.setrespawn | Set the custom respawn location used by the CUSTOM entry of the respawn priority list. See Server systems → Respawn. |
Player preferences /settings
Every player can use these with no permission setup. Preferences are saved per player and survive restarts. The full guide, including what each toggle does and how to customise the menus, is on Player settings.
| Command | Usage | Permission | Description |
|---|---|---|---|
/settings | alphasystem.settings | Opens the settings menu: private messages, public chat, incoming payments, payment confirmation, and the ignore list. | |
/ignore | <player> [on|off] | list | alphasystem.ignore | Ignore or unignore a player, or show your list. Works on online players and on players the server has cached. |
/msgtoggle /tmsg | [on|off] | alphasystem.msgtoggle | Stop or resume receiving private messages from Alpha-system commands, including /msg and /r. With no argument it flips the current state. |
/chattoggle /togglechat | [on|off] | alphasystem.chattoggle | Hide public chat for yourself only. You can still type in it. Command feedback, system messages and staff channels stay visible. |
/paytoggle | [on|off] | alphasystem.paytoggle | Allow or refuse incoming /pay transfers, including to you while offline. Rewards from other plugins, admin balance changes and Vault are not affected. |
/payconfirm | [on|off] | alphasystem.payconfirm | Ask for confirmation before sending large payments, when the server does not already force it. See Payments. |
Chat
| Command | Usage | Permission | Description |
|---|---|---|---|
/sc | [message] | alphasystem.chat.admin | Admin chat channel — with no args, toggles it as your default typing channel. |
/mc | [message] | alphasystem.chat.manager | Manager chat channel — same toggle behavior as /sc. |
/msg /tell /w /whisper /m | <player> <message> | alphasystem.msg | Private message. |
/r /reply | <message> | alphasystem.msg | Reply to your last conversation partner. |
/alphadeletemsg | <id> | alphasystem.chat.delete | Internal. The [x] button next to a message runs it. You do not type it yourself. |
/socialspy | alphasystem.staff.socialspy | Toggle seeing every /msg on the server. On by default for anyone with the permission — an explicit toggle is remembered per-player across restarts. |
[x] delete button appears before each message for staff with alphasystem.chat.delete; how deletion actually works (signed vs. unsigned messages) is covered in Integrations → Chat deletion.Punishments features.punish
| Command | Usage | Permission | Description |
|---|---|---|---|
/ban | <player> <reason> | alphasystem.ban | Permanent ban. If <reason> exactly matches a configured preset key, uses that preset's reason and duration instead. |
/tempban | <player> <duration> <reason> | alphasystem.ban | Timed ban — see duration format below. |
/banip /ban-ip | <player> <reason> | alphasystem.ban | Permanent ban + IP block. Any other account connecting from that same IP is blocked too, with a kick screen naming the originally banned account. Overrides vanilla's own /ban-ip entirely. |
/unban | <player|id> | alphasystem.unban | Lifts a ban — and its IP block too, if it was a /banip. |
/banhistory /banhist | <player> | alphasystem.punish.history | Full ban history for a player. |
/checkban | <id|player> | alphasystem.punish.info | Look up a specific ban's details. |
/mute | <player> <reason> | alphasystem.mute | Permanent mute — blocks chat entirely. Presets supported like /ban. |
/tempmute | <player> <duration> <reason> | alphasystem.mute | Timed mute. |
/unmute | <player|id> | alphasystem.unmute | Lifts a mute. |
/mutehistory /mutehist | <player> | alphasystem.punish.history | Full mute history. |
/checkmute | <id|player> | alphasystem.punish.info | Look up a mute's details. |
/warn | <player> <reason> | alphasystem.warn | Issue a warning — expires automatically after warn.duration-days. Can trigger auto-escalation, see below. |
/unwarn | <player|id> | alphasystem.unwarn | Removes a player's most recent warn, or a specific one by id. |
/warnhistory /warnhist | <player> | alphasystem.punish.history | Full warn history. |
/checkwarn | <id|player> | alphasystem.punish.info | Look up a warn's details. |
/jail | <player> <duration> <reason> | alphasystem.jail | Teleports to the jail point and locks down block break/place, item/entity interaction, elytra, hunger loss, and commands. |
/unjail | <player|id> | alphasystem.unjail | Releases and returns the player to where they were jailed from. |
/jailhistory /jailhist | <player> | alphasystem.punish.history | Full jail history. |
/setjail | alphasystem.setjail | Sets the jail teleport point to your current position. |
Warn escalation
Config-driven, under warn.escalation.rules in config.yml. Each named rule independently watches for warns whose reason contains any of its keywords, counts only ones issued within its own window-days, and once a player crosses threshold, automatically applies punishment (mute/jail/ban) for duration. Add as many rules as you want — they don't interact with each other.
warn:
duration-days: 15
escalation:
enabled: true
rules:
spam:
keywords: ["spam"]
threshold: 5
window-days: 5
punishment: mute
duration: 24h
reason: "Reached {threshold} spam warnings within {window} days"
griefing:
keywords: ["grief", "destruction"]
threshold: 5
window-days: 4
punishment: jail
duration: 24h
reason: "Reached {threshold} griefing warnings within {window} days"
toxicity:
keywords: ["toxic", "racism", "racist"]
threshold: 4
window-days: 3
punishment: ban
duration: 1d
reason: "Reached {threshold} warnings for toxicity/racism within {window} days"
Presets
Under punishment-presets.<ban|mute|jail|warn>.<key> in config.yml — each preset has its own reason and duration. Run /ban <player> <preset-key> instead of typing a reason to use one; tab-completion suggests configured preset keys as the second argument automatically.
punishment-presets:
ban:
hacking:
reason: "Using hacked client / unfair advantage"
duration: permanent
advertising:
reason: "Advertising another server"
duration: 7d
Broadcast
| Command | Usage | Permission |
|---|---|---|
/bossbarmsg | <player|all> (-sec:N)(-n:name)(-permanent)(-c:color)(-s:1,6,10,12,20)(-p:max/current)(-cmd:"a;b")(-pcmd:"a;b") <message> cancel <name|last|all> | alphasystem.broadcastmsg |
/titlemsg | <player|all> <title>\n<subtitle> (-in:ticks)(-out:ticks)(-keep:ticks)(-n:name)(-permanent) cancel <name|last|all> | alphasystem.broadcastmsg |
/actionbarmsg | <player|all> (-s:seconds)(-n:name)(-permanent) <message> cancel <name|last|all> | alphasystem.broadcastmsg |
/restart | [seconds|cancel] | alphasystem.restart |
The three broadcast commands use CMI-style flag syntax (-flag:value) mixed directly into the message text — flags are parsed out before the rest is sent as the message. -cmd/-pcmd run console/player commands when the bossbar's timer completes; -cancel:name still works as an older way to cancel.
Named visuals and cancel
- Give a visual a name with
-n:nameon any of the three commands. Names are not case-sensitive. - Cancel it with
cancel <name>,cancel lastfor the most recent one, orcancel all. - Reusing a name replaces the earlier visual and clears it from every player who was seeing it.
-permanentkeeps it across restarts and shows it to players who join later. It needsannouncements.permanent.enabledinconfig.yml.- Defaults for duration, colour and fade timings come from the
bossbarmsg,titlemsgandactionbarmsgsections ofconfig.yml, and a flag on the command always wins.
/bossbarmsg all -n:restart -sec:30 -c:RED Server restarts in {time}
/bossbarmsg cancel restart
/restart in detail
Actually relaunches the server process (same java binary, JVM flags, jar/args) before shutting down — so it restarts instead of just stopping, no wrapper script needed. Disable with restart.relaunch-process: false if your host already handles restarts (or would kill the child process anyway, breaking this).
While counting down, an atmospheric storm effect runs by default: rain, fog particles drifting around each player, and lightning flashes far away and high in the sky — purely visual/audio, nothing can ever hurt anyone or set fires. See Configuration → Restart to tune or disable it.
Warps
| Command | Usage | Permission | Description |
|---|---|---|---|
/setwarp | <name> <public|private> | alphasystem.warpset | Create or update a warp at your position. |
/delwarp /removewarp | <name> | alphasystem.warpset | Delete a warp. |
/warp | [name] | open to all | Teleports straight to a named warp, or opens the warp GUI with none given. |
/warps | open to all | Opens the warp GUI directly. |
Private warps additionally require as.warp.<name> (or as.warp.* for every private warp), granted per-warp through your permissions plugin — not registered in plugin.yml since the set of warps is dynamic. Teleports have a movement-cancellable warmup (warps.countdown-seconds); alphasystem.warp.bypasswarmup skips it. The GUI itself is fully config-driven — see Configuration → Warps GUI.
Economy Vault provider
| Command | Usage | Permission | Description |
|---|---|---|---|
/money /balance /bal | [give|set|take|clear <player> [amount] | player] | see below | Check your own balance, someone else's, or manage balances. |
/pay | <player> <amount> | confirm | cancel | alphasystem.pay | Transfer from your own balance. Large amounts can ask for confirmation first: /pay confirm sends it once, /pay cancel drops it. See Payments. |
/baltop | alphasystem.baltop | Richest-players leaderboard, fully config-driven layout. | |
/moneyhistory /balhistory | <player> [page] | alphasystem.money.history | A player's transaction history: /pay, staff changes, Vault deposits and withdrawals, built-in charges. Each entry has an id. |
/moneyrollback | <transaction-id> | alphasystem.money.rollback | Reverse one transaction by id. It fails if the transaction is unknown, was already reversed, or the receiver no longer has enough money. |
Alpha-system registers itself as the Vault Economy provider — no separate economy plugin needed. Balances are fully cached in memory (instant responses for Vault's synchronous API) and persisted to the database on every change. Amounts accept shorthand suffixes: 1k, 2.5m, 1b, 1t.
Money sub-permissions
alphasystem.money— own balance (default: everyone)alphasystem.money.others— check someone else's balancealphasystem.money.give/.set/.take/.clearalphasystem.money.historyand.rollback— the audit commands above
economy.yml controls
starting-balancecurrency.symbol,.name-singular,.name-pluralcurrency.short-format(1000 → "1k") or fixed decimal placesbaltop-format,top-players-counttransaction-historyandtransaction-safety, see Configuration → Economy
Time & Weather
| Command | Usage | Permission | Description |
|---|---|---|---|
/time | <value|preset> [world|all] [duration|permanent] | alphasystem.time | Set a world's time to a raw tick (0-24000) or a preset name. |
/day /noon /afternoon /sunset /night /midnight /sunrise | [world|all] [duration|permanent] | alphasystem.time | Shortcut presets. Calling with no arguments behaves exactly like it did before world/duration support was added — fully backward compatible. |
/weather | <sun|rain|storm|snow> [world|all] [duration|permanent] | alphasystem.weather | snow behaves like rain — vanilla itself renders snow client-side in cold biomes. No server-side biome forcing (an earlier version of this did, and caused problems — removed). |
Both commands override vanilla's own built-in /time and /weather — force-claimed on server load, so Alpha-system always wins regardless of plugin load order.
Time presets (ticks)
day= 1000noon= 6000afternoon= 9000sunset= 12000night= 13000midnight= 18000sunrise= 23000
Extra lightning during storms
While any world is in storm, periodic extra lightning strikes near random online players for a more intense feel. Configurable under weather.extra-lightning — interval, chance, max distance, and real-vs-visual-only.
Staff Tools
| Command | Usage | Permission | Description |
|---|---|---|---|
/alts | <player> | alphasystem.staff.alts | Known alt accounts by shared IP, split into banned/online/offline. Auto-alerts staff on join if a new alt is detected. |
/whois | <player> | alphasystem.staff.whois | UUID, online status, world, gamemode, ping, first join, last seen, total playtime, latest known IP, and live ban/mute/jail status — all in one card. |
/report | <player> <reason> | alphasystem.report | Player-facing: report someone to staff. Per-player cooldown (default 60s). Stored in the database and optionally forwarded to a webhook — see Integrations → Reports webhook. |
/maintenance | <on|off> | add|remove <player> | server <name> <on|off> | network <on|off> | alphasystem.staff.maintenance | Maintenance mode with a bypass whitelist — see below. |
/maintenance in detail
on/off— kicks every online player without bypass, and gates new joins with a configurable message. Bypass = whitelisted (add/remove) or server op.- The server-list MOTD automatically swaps to a maintenance message while active.
server <name> on|offandnetwork on|offbroadcast the toggle to every server sharing the same MySQL database — requiredatabase.type: mysql. Plainon/off(no target) always stays local only, network or not.- On/off state and the whitelist persist in their own
maintenance-state.yml(not config.yml), so they survive config reloads/edits. Message templates and the MOTD text live in config.yml'smaintenancesection — see Configuration → Maintenance.
Durations & World Targeting
Shared syntax across every command that takes a duration or targets a world.
Duration format
30s,5m,2h,1d— seconds/minutes/hours/daysperm,permanent,forever, or-1— permanent
Used by /tempban, /tempmute, /jail, and the [duration|permanent] argument on /time//weather/day-night presets.
[world|all] [duration|permanent]
Optional trailing arguments on /time, every day/night preset, and /weather:
- No world given → the sender's current world only
all→ every loaded world, including VoidGen-generated ones- No duration → matches vanilla's own persistent behavior (daylight/weather cycle gamerule untouched)
- A duration → freezes the cycle, then reverts automatically when it elapses
permanent→ freezes the cycle indefinitely, no auto-revert
