Alpha-systemDocs v2.0.1
Alpha-systemReferenceCommands

Commands

Every command Alpha-system registers, grouped the same way as /as help.

On this page
Commands whose permission is a remappable config key (most staff commands) can be repointed to a different node in config.yml's permissions: section without touching plugin.yml — see Permissions → Remapping.

General /as, /alphasystem

CommandUsagePermissionDescription
/asPlugin info — version, author, server.
/as help [page]Paginated in-game command list, grouped the same way as this page.
/as reloadalphasystem.adminReloads config.yml, lang/messages.yml, lang/deathmessages.yml, punishments.yml, economy.yml, announcements.yml. Does not reload compiled code.
/as diagnosticsalphasystem.adminHealth check — see FAQ → What does /as diagnostics check?

Utility

CommandUsagePermissionDescription
/flyspeed /fs<1-10>alphasystem.flyspeedSet your own fly speed.
/gm<0-3> [player]alphasystem.gm / .gm.othersChange gamemode by number (0=survival, 1=creative, 2=adventure, 3=spectator).
/gmc /gms /gmsp /gmad[player]alphasystem.gmShortcut gamemode switches.
/heal[player|all]alphasystem.heal / .heal.othersFull health + extinguishes fire.
/feed[player|all]alphasystem.feed / .feed.othersFull hunger + saturation.
/godmode /god[player]alphasystem.god / .god.othersToggle invulnerability.
/ungodmode /ungod[player]alphasystem.godExplicitly turn god mode off.
/fly[player]alphasystem.fly / .fly.othersToggle flight.
/kill[player]alphasystem.kill / .kill.othersInstant kill.
/ping[player]alphasystem.ping / .ping.othersShow latency in ms.
/vanish /valphasystem.vanishToggle invisibility to other players. Self-reminder shown via bossbar or actionbar (vanish.notify-style in config.yml).
/skull /head<player>alphasystem.skullGet a player's head item.
/hatalphasystem.hatWear the item in your hand as a helmet.
/tpsbaralphasystem.tpsbarToggle a bossbar showing live 1m/5m/15m TPS, with a smooth green→yellow→orange→red color gradient.
/nvalphasystem.nvPermanent night vision — survives death and totem-of-undying saves.
/backalphasystem.backTeleport to your last death location, with a movement-cancellable warmup. Bypass: .back.bypasswarmup.
/freeze<player>alphasystem.freezeFreeze a player in place — they can still look around, just can't move.
/craftingalphasystem.craftingPortable crafting table.
/anvilalphasystem.anvilPortable anvil.
/enderchest /echestalphasystem.echestOpen your own ender chest from anywhere.
/fixhandalphasystem.fixhandRepair the item in your hand. Optional cost — fixitem.fixhand.cost-type (none/money/xp) + .cost-amount.
/fixall[player]alphasystem.fixallRepair 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

CommandUsagePermissionDescription
/invsee<player>alphasystem.invseeView a player's inventory — read-only, live-refreshing every second.
/invedit /inv<player>alphasystem.inveditFreely edit a player's inventory, armor, and offhand. Syncs live as you edit.
/enderchestsee /ecsee<player>alphasystem.enderchestseeView a player's ender chest — read-only.
/enderchestedit /ecedit<player>alphasystem.enderchesteditFreely 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

CommandUsagePermissionDescription
/tp<player> [target]alphasystem.tp / .tp.othersTeleport to a player, or one player to another.
/tphere /tph<player>alphasystem.tpherePull a player to you.
/tpall[target]alphasystem.tpallPull every online player to you (or a target).
/otp<player>alphasystem.otpTeleport to a player's last known location, even offline — reads their saved position on quit.
/spawnalphasystem.spawnTeleport to the server spawn point, with a warmup. Bypass: .spawn.bypasswarmup.
/setspawnalphasystem.setspawnSet the server spawn to your current position.
/spawnpointalphasystem.spawnpointInstantly teleport to the first-join spawn point (admin-only, no warmup — useful for checking what new players see).
/spawnpointsetalphasystem.spawnpointsetSet where brand-new players spawn on their very first join. Independent of /setspawn.
/setrespawnalphasystem.setrespawnSet the custom respawn location used by the CUSTOM entry of the respawn priority list. See Server systems → Respawn.
Every teleport command above lands on the nearest safe floor and is blocked while a player is combat-tagged. See Safe teleports and Combat tag.

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.

CommandUsagePermissionDescription
/settingsalphasystem.settingsOpens the settings menu: private messages, public chat, incoming payments, payment confirmation, and the ignore list.
/ignore<player> [on|off] | listalphasystem.ignoreIgnore or unignore a player, or show your list. Works on online players and on players the server has cached.
/msgtoggle /tmsg[on|off]alphasystem.msgtoggleStop 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.chattoggleHide public chat for yourself only. You can still type in it. Command feedback, system messages and staff channels stay visible.
/paytoggle[on|off]alphasystem.paytoggleAllow 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.payconfirmAsk for confirmation before sending large payments, when the server does not already force it. See Payments.

Chat

CommandUsagePermissionDescription
/sc[message]alphasystem.chat.adminAdmin chat channel — with no args, toggles it as your default typing channel.
/mc[message]alphasystem.chat.managerManager chat channel — same toggle behavior as /sc.
/msg /tell /w /whisper /m<player> <message>alphasystem.msgPrivate message.
/r /reply<message>alphasystem.msgReply to your last conversation partner.
/alphadeletemsg<id>alphasystem.chat.deleteInternal. The [x] button next to a message runs it. You do not type it yourself.
/socialspyalphasystem.staff.socialspyToggle seeing every /msg on the server. On by default for anyone with the permission — an explicit toggle is remembered per-player across restarts.
Normal chat's format, colors, and the LuckPerms rank prefix/suffix are fully owned by the plugin — see Configuration → Chat. A small [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

CommandUsagePermissionDescription
/ban<player> <reason>alphasystem.banPermanent ban. If <reason> exactly matches a configured preset key, uses that preset's reason and duration instead.
/tempban<player> <duration> <reason>alphasystem.banTimed ban — see duration format below.
/banip /ban-ip<player> <reason>alphasystem.banPermanent 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.unbanLifts a ban — and its IP block too, if it was a /banip.
/banhistory /banhist<player>alphasystem.punish.historyFull ban history for a player.
/checkban<id|player>alphasystem.punish.infoLook up a specific ban's details.
/mute<player> <reason>alphasystem.mutePermanent mute — blocks chat entirely. Presets supported like /ban.
/tempmute<player> <duration> <reason>alphasystem.muteTimed mute.
/unmute<player|id>alphasystem.unmuteLifts a mute.
/mutehistory /mutehist<player>alphasystem.punish.historyFull mute history.
/checkmute<id|player>alphasystem.punish.infoLook up a mute's details.
/warn<player> <reason>alphasystem.warnIssue a warning — expires automatically after warn.duration-days. Can trigger auto-escalation, see below.
/unwarn<player|id>alphasystem.unwarnRemoves a player's most recent warn, or a specific one by id.
/warnhistory /warnhist<player>alphasystem.punish.historyFull warn history.
/checkwarn<id|player>alphasystem.punish.infoLook up a warn's details.
/jail<player> <duration> <reason>alphasystem.jailTeleports to the jail point and locks down block break/place, item/entity interaction, elytra, hunger loss, and commands.
/unjail<player|id>alphasystem.unjailReleases and returns the player to where they were jailed from.
/jailhistory /jailhist<player>alphasystem.punish.historyFull jail history.
/setjailalphasystem.setjailSets the jail teleport point to your current position.
No movement radius is enforced for jail. Alpha-system only stops a jailed player from leaving the jail's world entirely (e.g. via a portal). You're responsible for physically containing them — walls, a cell, or a WorldGuard region around the jail point.

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

CommandUsagePermission
/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

/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

CommandUsagePermissionDescription
/setwarp<name> <public|private>alphasystem.warpsetCreate or update a warp at your position.
/delwarp /removewarp<name>alphasystem.warpsetDelete a warp.
/warp[name]open to allTeleports straight to a named warp, or opens the warp GUI with none given.
/warpsopen to allOpens 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

CommandUsagePermissionDescription
/money /balance /bal[give|set|take|clear <player> [amount] | player]see belowCheck your own balance, someone else's, or manage balances.
/pay<player> <amount> | confirm | cancelalphasystem.payTransfer from your own balance. Large amounts can ask for confirmation first: /pay confirm sends it once, /pay cancel drops it. See Payments.
/baltopalphasystem.baltopRichest-players leaderboard, fully config-driven layout.
/moneyhistory /balhistory<player> [page]alphasystem.money.historyA player's transaction history: /pay, staff changes, Vault deposits and withdrawals, built-in charges. Each entry has an id.
/moneyrollback<transaction-id>alphasystem.money.rollbackReverse 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 balance
  • alphasystem.money.give / .set / .take / .clear
  • alphasystem.money.history and .rollback — the audit commands above

economy.yml controls

  • starting-balance
  • currency.symbol, .name-singular, .name-plural
  • currency.short-format (1000 → "1k") or fixed decimal places
  • baltop-format, top-players-count
  • transaction-history and transaction-safety, see Configuration → Economy

Time & Weather

CommandUsagePermissionDescription
/time<value|preset> [world|all] [duration|permanent]alphasystem.timeSet 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.timeShortcut 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.weathersnow 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 = 1000
  • noon = 6000
  • afternoon = 9000
  • sunset = 12000
  • night = 13000
  • midnight = 18000
  • sunrise = 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

CommandUsagePermissionDescription
/alts<player>alphasystem.staff.altsKnown 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.whoisUUID, 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.reportPlayer-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.maintenanceMaintenance mode with a bypass whitelist — see below.

/maintenance in detail

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/days
  • perm, 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