BlazeStudios

BlazeBans/Help

Command reference

Every command on one page. `P` means Paper and Folia, `V` means Velocity.

On Velocity, punishment and lookup commands live under the root command rather than as top-level commands: /blazebansvelocity ban <player> rather than /ban <player>. The root command is blazebansvelocity, aliased to bbansvelocity and bbv.

Command names and aliases are configurable in settings.yml under commands.names and commands.aliases. Changing them needs a restart.

Punishing

CommandAliasesPermissionPlatform
/ban <player> [duration] [reason] [flags]/tempbanblazebans.command.banP V
/mute <player> [duration] [reason] [flags]/tempmuteblazebans.command.muteP V
/warn <player> [duration] [reason] [flags]noneblazebans.command.warnP V
/kick <player> [reason] [flags]noneblazebans.command.kickP V
/ipban <player> [duration] [reason] [flags]/tempipbanblazebans.command.ipbanP V
/ipmute <player> [duration] [reason] [flags]/tempipmuteblazebans.command.ipmuteP V
/punish <player> <ladder> [flags]noneblazebans.command.punishP V
/punishgui <player> [type] [template]noneblazebans.command.punishguiP

/punishgui also needs blazebans.command.punish.

Revoking and editing

CommandAliasesPermissionPlatform
/unban <player> [reason]noneblazebans.command.unbanP V
/pardon <player> [reason]noneblazebans.command.unbanP V
/unmute <player> [reason]noneblazebans.command.unmuteP V
/unwarn <player> [reason]noneblazebans.command.unwarnP V
/editpunishment <id> <details>noneblazebans.command.editpunishmentP V
/staffrollback <staff> <duration>noneblazebans.command.staffrollbackP V

/pardon is /unban under a second name.

Reading records

CommandPermissionPlatform
/history <player>blazebans.command.historyP V
/lookup <player>blazebans.command.lookupP V
/timeline <player>blazebans.command.timelineP
/namehistory <player>blazebans.command.historyP V
/staffhistory <staff>blazebans.command.staffhistoryP V
/alts <player>blazebans.command.altsP V
/checkban <player>blazebans.command.historyP V
/checkmute <player>blazebans.command.historyP V
/checkwarn <player>blazebans.command.historyP V
/warnings <player>blazebans.command.historyP V

Lists

CommandShowsPermissionPlatform
/banlistActive bans and IP bansblazebans.command.historyP V
/mutelistActive mutes and IP mutesblazebans.command.historyP V
/warnlistActive warningsblazebans.command.historyP V
/kicklistKick historyblazebans.command.historyP V
/punishlistAll active punishmentsblazebans.command.historyP V

Run by a player on Paper, these open a paginated, filterable menu. From console they print as text.

Proof

CommandPermissionPlatform
/proof view <player>blazebans.command.proof.viewP
/proof add <player> <url>blazebans.command.proof.addP
/proof remove <player> <proof_id>blazebans.command.proof.removeP

Administration

Root command /blazebans, aliased to /bbans and /bb.

CommandPermissionPlatform
/blazebansblazebans.command.helpP V
/blazebans helpblazebans.command.helpP V
/blazebans versionnoneP V
/blazebans permissionsblazebans.adminP V
/blazebans reload [file]blazebans.command.reloadP V
/blazebans settingsblazebans.command.settingsP
/blazebans addonsblazebans.command.addonsP
/blazebans dumpblazebans.command.dumpP V
/blazebans profile <player>blazebans.command.profileP
/blazebans staffprofile <staff>blazebans.command.staffprofileP
/blazebans editorblazebans.command.editorP
/blazebans trust <code>blazebans.command.editorP
/blazebans lockdown <enable|disable|status>blazebans.command.lockdownP V
/blazebans chatlockdown <enable|disable|status>blazebans.command.chatlockdownP V

Enabling lockdown asks for confirmation. From console, append confirm.

/blazebans reload accepts a filename. Message files use a colon: messages:en_us.yml.

Importing

CommandPermissionPlatform
/blazebans import vanilla [confirm]blazebans.command.importP
/blazebans import advancedban [confirm]blazebans.command.importP
/blazebans import litebans [confirm]blazebans.command.importP

Without confirm, each shows what it will do and offers a button.

Addon commands

Voice chat:

CommandAliasesPermission
/voicemute <player> [duration] <reason>/vmute, /gagblazebans.addon.voicechat.voicemute
/voiceunmute <player> [reason]/vunmute, /unvoicemute, /ungagblazebans.addon.voicechat.voiceunmute
/checkvoicemute <player>noneblazebans.addon.voicechat.voicemute
/blazebansvoicechat reload/bbvoicechat, /bbvcblazebans.addon.voicechat.reload

Ban effects:

CommandAliasesPermission
/blazebaneffects reload/bbbaneffects, /bbfxblazebans.addon.baneffects.reload
/blazebaneffects preview [effect|all]sameblazebans.addon.baneffects.preview

Flags

Appended to any punishment command.

FlagEffectPermission
--silent, -sNo broadcast, no Discord postblazebans.silent
--proof <url>Attaches evidencenone
--previewShows the result without storing itnone
--ipAlso matches the stored IPblazebans.ip
--scope <value>Sets which servers enforce itsee below
--punisher <name>Records a different issuerconsole only

--scope accepts server:global, server:this, or server:<id>. Global needs blazebans.scope.global; a named server needs blazebans.scope.server.<id> unless it is the local one.

--silent and -s also work on /unban, /unmute, and /unwarn.

Durations

UnitForms
Secondss, sec, second, seconds
Minutesm, min, minute, minutes
Hoursh, hr, hour, hours
Daysd, day, days
Weeksw, week, weeks
Monthsmo, month, months (30 days)
Yearsy, yr, year, years (365 days)

Chain them without spaces: 1d12h, 2w3d. Decimals are accepted and rounded to the second.

Permanent: permanent, perm, forever, or omitting the duration entirely.

Examples

minecraft
/ban Steve 30d Cheating --proof https://imgur.com/a/example
/ban Steve General-Cheating
/ban Steve permanent Ban evasion --silent --scope server:global
/mute Steve 1h Spam
/kick Steve Refusing staff instruction
/punish Steve Cheating
/punishgui Steve ban
/unban Steve Appeal-Accepted
/editpunishment ABC123 7d Griefing spawn
/staffrollback BadMod 2h
/history Steve
/alts Steve
/blazebans profile Steve
/blazebans reload messages:en_us.yml
/blazebans lockdown enable