Alpha-systemv1.0.0

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).

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.
/fixallalphasystem.fixallRepair every damaged item in your inventory (armor, hotbar, offhand). 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.

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.
/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)(-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

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>alphasystem.payTransfer from your own balance.
/baltopalphasystem.baltopRichest-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 balance
  • alphasystem.money.give / .set / .take / .clear

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

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