Commands
Every command Alpha-system registers, grouped exactly like /as help shows them in-game. Aliases are listed next to the primary name. Permission nodes marked — mean the command has no dedicated node (open to everyone, or gated only by sub-actions).
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 | alphasystem.fixall | Repair every damaged item in your inventory (armor, hotbar, offhand). 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. |
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. |
/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)(-c:color)(-s:1,6,10,12,20)(-p:max/current)(-cmd:"a;b")(-pcmd:"a;b") <message> (-cancel:name) | alphasystem.broadcastmsg |
/titlemsg | <player|all> <title>\n<subtitle> (-in:ticks)(-out:ticks)(-keep:ticks) | alphasystem.broadcastmsg |
/actionbarmsg | <player|all> (-s:seconds) <message> | 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 cancels a previously-started named bossbar early.
/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> | alphasystem.pay | Transfer from your own balance. |
/baltop | alphasystem.baltop | Richest-players leaderboard, fully config-driven layout. |
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/.clear
economy.yml controls
starting-balancecurrency.symbol,.name-singular,.name-pluralcurrency.short-format(1000 → "1k") or fixed decimal placesbaltop-format,top-players-count
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
