Commands and permissions¶
Commands depend on where you are: outside any arena (lobby), inside a game or spectating, or in arena setup mode. /bw help shows what you can use right now, and /bw setupHelp [page] [command] shows the setup commands of your current setup mode.
- Player commands
- Party commands
- Network commands
- Admin commands
- Web panel commands
- Setup commands
- Permissions
Player commands¶
| Command | Where | Description |
|---|---|---|
/bw join [arena\|group] |
lobby | Open the arena selector, join a specific arena, or join the fullest waiting arena of a group. On a network lobby server <server>:<arena> joins that server's arena |
/bw rejoin |
lobby | Rejoin the game you disconnected from |
/bw spectate <arena> |
lobby | Join a running arena as a spectator |
/bw lobby |
lobby, game | Leave the arena and return to the lobby |
/bw lang <en\|pl\|de\|es\|fr\|ru> |
lobby, game | Change your language |
/bw help [page] |
lobby, game | Show the commands you can use |
/bw stats [player] |
lobby | Show a player's stats |
/bw profile [player] |
lobby | Open a player's profile GUI (also fast-buy customization) |
/bw leaderboard [wins\|kills\|beds\|fk] |
lobby | Top 10 players by a stat |
/lobby |
anywhere | Shortcut for /bw lobby |
/lang <en\|pl\|de\|es\|fr\|ru> |
anywhere | Shortcut for /bw lang |
Party commands¶
/party (alias /p). All of them need newbedwars.party. In network mode (see network.md) the same commands are handled by the NewBedwars-Proxy plugin on Velocity.
| Command | Description |
|---|---|
/party invite <player> |
Invite a player to your party |
/party accept / /party deny |
Accept or deny a pending invite (clickable in chat) |
/party leave |
Leave your party |
/party list |
List the party members |
/party kick <player> |
Kick a member (party admin only) |
/party admin <player> |
Give the party admin role to another member (party admin only) |
Network commands¶
Only used in network mode. In network mode /party is also handled by the proxy (see Party commands).
| Command | Where | Permission | Description |
|---|---|---|---|
/nbwproxy |
Velocity proxy | newbedwars.proxy.admin |
List the game servers and arenas the proxy knows, and whether a newer proxy version exists |
/bw join <server>:<arena> |
lobby server | newbedwars.bw.join |
Join that arena on that game server |
/bw arena list |
lobby server | newbedwars.bw.arena.list |
The arenas of every game server (server, group, state, players) |
/bw arena info |
lobby server | newbedwars.bw.arena |
How to set arenas up on a network. All other /bw arena commands are refused on a lobby server; run them on the game server that has the arena |
/bw group ... |
lobby server | newbedwars.bw.group |
Arena groups for the whole network; <server>:<arena> adds only that server's arena. Game servers can only list groups |
/nbwpanel network status / secret / forget <server> |
any server with the panel | newbedwars.panel.manage |
Panel network mode, see Web panel commands |
newbedwars.network.bypass lets staff stay on a game server without a join request (setup, testing).
Admin commands¶
Available outside arenas to players with the permission shown.
| Command | Permission | Description |
|---|---|---|
/bw arena create <name> [-sche <schematic>] [-n] |
newbedwars.bw.arena.create |
Create an arena, optionally from a WorldEdit schematic (-n: do not teleport to it) |
/bw arena list |
newbedwars.bw.arena.list |
List arenas and their status (with problems of disabled arenas) |
/bw arena delete <name> |
newbedwars.bw.arena.delete |
Permanently delete an arena, its world and saved data |
/bw arena enable <name> |
newbedwars.bw.arena.enable |
Enable a fully configured arena |
/bw arena disable <name> |
newbedwars.bw.arena.disable |
Disable an arena |
/bw arena setup <name> [-l <players>] |
newbedwars.bw.arena.setup |
Enter setup mode for an arena |
/bw arena backup <name> |
newbedwars.bw.arena.backup |
Back up the arena file and map now |
/bw arena backups <name> |
newbedwars.bw.arena.backups |
List the backups of an arena |
/bw arena restore <name> [backupId] |
newbedwars.bw.arena.restore |
Restore the arena file and map from a backup |
/bw arena export <name> |
newbedwars.bw.arena.export |
Export the arena (file and map) to a zip in data/exports |
/bw arena import <file> |
newbedwars.bw.arena.import |
Import an arena from a zip in data/exports (loaded disabled) |
/bw arena copy <name> <newName> |
newbedwars.bw.arena.copy |
Copy an arena (settings and map) to a new arena with the same state; it joins the same group |
/bw arena resetmap <name> |
newbedwars.bw.arena.resetmap |
Put the arena map back to its saved state now |
/bw setlobby |
newbedwars.bw.setlobby |
Set the lobby spawn |
/bw group create <name> [item] |
newbedwars.bw.group.create |
Create an arena group (players vote between its maps); item is the vote menu icon |
/bw group delete <group> |
newbedwars.bw.group.delete |
Delete a group |
/bw group add <group> <arena> |
newbedwars.bw.group.add |
Add an arena (all arenas of a group need the same team count and team size; one group per arena). On a network lobby server: <arena> = that arena on every game server, <server>:<arena> = only that one; game servers can only list groups |
/bw group remove <group> <arena> |
newbedwars.bw.group.remove |
Remove an arena from a group |
/bw group list / info <group> |
newbedwars.bw.group.list / .info |
List groups / show a group and its problems |
/bw group setitem <group> <item> |
newbedwars.bw.group.setitem |
Change the vote menu icon |
/bw arena info |
newbedwars.bw.arena |
Lobby server of a network only: how to set arenas up on the game servers (/bw arena list shows all servers' arenas there) |
/bw npc set <action> [target] |
newbedwars.bw.npc |
Turn the Citizens NPC you selected (/npc select) into a join NPC |
/bw npc clear |
newbedwars.bw.npc |
Make the selected Citizens NPC a normal NPC again |
/bw npc info [id] |
newbedwars.bw.npc |
Show the action of the selected Citizens NPC, or of a simple NPC by id |
/bw npc list |
newbedwars.bw.npc |
List all join NPCs with their action and location |
/bw npc create <entityType> <action> [target] |
newbedwars.bw.npc |
Without Citizens: spawn a simple join NPC (e.g. a villager) where you stand |
/bw npc remove <id> |
newbedwars.bw.npc |
Remove a simple join NPC |
/bw reload |
newbedwars.bw.admin |
Save arenas, send everyone to the lobby and reload the configuration |
/bw update [check\|download] (2.7-beta) |
newbedwars.bw.update |
Look for a new NewBedwars version on Modrinth/GitHub; download saves it (checksum verified) to plugins/update/, installed on the next restart |
/bw game <start\|forcestart\|stop\|forcestop\|nextPhase> |
newbedwars.bw.managegame |
Manage the running game you are in or spectating (start, stop, skip a phase) |
/bw game broadcast <message> |
newbedwars.bw.managegame |
Send a highlighted message (& colours allowed) to everyone in your arena. Available from 2.7-beta |
/bw join <group> joins the fullest waiting arena of a group, so players gather in one lobby. When a game in a grouped arena ends, everyone still there gets a vote item (MapVote.Item in config.yml, slot 2 by default) and votes for the next map among the group's other waiting arenas with room for everyone. When AfterGameWatchTime is up, everyone joins the waiting lobby of the map with the most votes (ties and no votes pick randomly; parties stay together). If no map is free, everyone goes to the lobby. Turn voting off for one arena with the gamerule MapVote.
Note
/bw update is available from 2.7-beta. /bw update or /bw update check checks now; /bw update download downloads the new jar into plugins/update/ and the server installs it on the next restart. It only works in-game; the console gets an automatic line when a new version is found. Settings are under Updates in config.yml (see Configuration).
Join NPC actions: GROUP <group> joins the fullest free arena of a group, ARENA <arena> joins that arena, and SELECTOR [group] opens the arena selector. On a network lobby server all three send players to the game servers. A group is a /bw group name; otherwise it is an arena name pattern (solo_*) or a team size (4x1 = 4 teams of 1). Hologram lines and update speed are set under JoinNpc in config.yml.
Web panel commands¶
Note
Available from 2.7-beta, only with the NewBedwars-Panel addon installed. See panel.md.
| Command | Permission | Description |
|---|---|---|
/nbwpanel status |
newbedwars.panel.manage |
Panel address, certificate fingerprint, accounts and logged-in sessions |
/nbwpanel user create <name> <role> |
newbedwars.panel.manage |
Create a panel account; prints a one-time password |
/nbwpanel user reset <name> |
newbedwars.panel.manage |
New one-time password; the account is logged out |
/nbwpanel user delete <name> |
newbedwars.panel.manage |
Delete a panel account (not the last admin) |
/nbwpanel user list |
newbedwars.panel.manage |
List panel accounts and roles |
/nbwpanel network status |
newbedwars.panel.manage |
Network role of the panel and, on a gateway, the state of every server |
/nbwpanel network secret |
newbedwars.panel.manage |
Print a new random network secret (not saved) |
/nbwpanel network forget <server> |
newbedwars.panel.manage |
Gateway: forget the remembered certificate of a server |
Setup commands¶
Used inside the arena world after /bw arena setup <name>. Choose the mode with /bw setupMode; each mode includes the commands of the ones before it. Arguments in ( ) are optional; many position commands use your location when you give no coordinates.
All modes¶
| Command | Description |
|---|---|
/bw info [gui] |
Show the setup status of the arena |
/bw setupMode |
Open the setup mode selection GUI |
/bw setupHelp [page] [command] |
Show the setup commands of your mode, or the details of one |
/bw save |
Save the arena (also updates the map copy used for resets) |
/bw remove <team\|generator> <teamName\|index> [bed\|spawn\|shop\|upgrades\|buildprotpos1\|buildprotpos2\|pos1\|pos2] |
Remove a team, a generator, or one property of a team |
/bw leave [-all] |
Leave setup mode and go back to the lobby |
Normal setup¶
| Command | Description |
|---|---|
/bw createTeam <color> <name> |
Create a team |
/bw setTeamSpawn <team> [x y z] |
Team spawn |
/bw setTeamBed <team> [x y z] |
Team bed |
/bw setTeamShop <team> <entityType> [x y z] |
Team shop NPC |
/bw setTeamUpgrades <team> <entityType> [x y z] |
Team upgrades NPC |
/bw setGenerator <type> [team] [x y z] |
Diamond, emerald or team generator |
/bw setMinPlayers <n> |
Minimum players to start |
/bw setMaxInTeam <n> |
Players per team |
/bw setWaitingSpawn [x y z] |
Waiting lobby spawn |
/bw setWaitingPos1 / setWaitingPos2 |
Corners of the waiting region |
/bw setWaitingTime <seconds> |
Countdown before the start |
/bw setQuickVoidY [y] |
Y level where players die instantly |
/bw setTeamBasePos1 <team> / setTeamBasePos2 <team> |
Corners of the team base (traps, heal pool) |
/bw setTeamBuildProtAreaPos1 <team> / ...Pos2 <team> |
Corners of the zone where blocks cannot be placed |
Advanced setup¶
| Command | Description |
|---|---|
/bw gamerule <name> <true\|false> |
Gamerule of this arena |
/bw setGui <shop\|upgrade> <guiId> |
Shop or upgrade GUI used on this arena |
/bw setGeneratorLeveling <configId> |
Generator leveling configuration |
/bw setResourcePack <url\|clear> [sha1] |
Per-arena resource pack |
Automatic setup¶
Pick Automatic in the setup menu (or /bw arena create), build the arena, stand in the middle of it and run:
| Command | Description |
|---|---|
/bw startAutomaticSetup [radius] |
Scans the blocks around you (default AutomaticSetup.DefaultRadius, at most AutomaticSetup.MaxRadius) and sets up what it finds, then asks for the rest |
/bw startAutomaticSetup next |
Shows the current step again (after you changed something by hand) |
/bw startAutomaticSetup skip |
Skips the current step |
/bw startAutomaticSetup cancel |
Stops the scan or the step-by-step help; what was already set stays |
What the scan finds:
- Beds (the head half): every bed color becomes a team (
Red,Blue,LightBlue, ...) with its bed set. - Generator blocks: diamond and emerald blocks become arena generators (touching blocks make one). The nearest iron or gold block within
AutomaticSetup.GeneratorSearchRadiusblocks of a bed becomes that team's generator. - Marker signs place the rest. Line 1 is the type, line 2 the team color (left empty = the team of the nearest bed), line 3 an optional mob type for shops (default
VILLAGER):
| Line 1 | Sets |
|---|---|
[spawn] |
Team spawn (faces the middle of the map) |
[shop] |
Item shop |
[upgrades] |
Upgrades shop |
[gen] |
Team generator (wins over a found iron or gold block). With DIAMOND or EMERALD on line 2 it adds an arena generator instead |
Used signs are removed. The lowest block of the scanned area minus 10 becomes the quick void Y, and the base area and block protection area of every team are guessed from its points (padding in AutomaticSetup). Guessed areas follow the team's points until you set them yourself.
Steps still missing are shown in chat with clickable [Set here] and [Skip] buttons that run the normal setup commands. Things that are already set are never overwritten by a new scan. When no step is left, the plugin says whether the arena can be enabled; save with /bw save.
Permissions¶
Parent permissions grant their children. Everything not marked true defaults to op.
Admin¶
| Permission | Default | Description |
|---|---|---|
newbedwars.bw.admin |
op | All admin commands (grants arena, setlobby, managegame, npc, group, update, update.notify) |
newbedwars.bw.arena |
op | All /bw arena ... commands (grants the arena.* permissions) |
newbedwars.bw.arena.create / .delete / .enable / .disable / .setup / .list |
op | The matching /bw arena <action> |
newbedwars.bw.arena.backup / .backups / .restore / .export / .import / .copy / .resetmap |
op | The matching /bw arena <action> |
newbedwars.bw.setlobby |
op | /bw setlobby |
newbedwars.bw.managegame |
op | /bw game ... |
newbedwars.bw.npc |
op | /bw npc ... |
newbedwars.bw.update |
op | /bw update |
newbedwars.update.notify |
op | One chat line on join when a new NewBedwars version is available |
newbedwars.network.bypass |
op | Network GAME mode: stay on a game server without a join request (staff, setup) |
newbedwars.proxy.admin |
- | Velocity: /nbwproxy (list the game servers and arenas the proxy knows, and whether a newer proxy version exists) |
newbedwars.panel.manage |
op | /nbwpanel (web panel addon: status and panel accounts) |
newbedwars.bw.group |
op | All /bw group ... commands (grants group.create / .delete / .add / .remove / .list / .info / .setitem) |
newbedwars.bw.bypass |
op | Bypass setup-mode restrictions (for example entering setup worlds) |
newbedwars.chat.color |
op | Use & colour codes in arena and team chat messages (others have them stripped) |
Player¶
| Permission | Default | Description |
|---|---|---|
newbedwars.bw.player |
true | Bundle that grants all player permissions below |
newbedwars.bw.join |
true | Join arenas |
newbedwars.bw.lobby |
true | Go to the lobby |
newbedwars.bw.rejoin |
true | Rejoin after a disconnect |
newbedwars.bw.spectate |
true | Spectate arenas |
newbedwars.bw.lang |
true | Change language |
newbedwars.bw.help |
true | /bw help |
newbedwars.bw.stats |
true | /bw stats |
newbedwars.bw.profile |
true | /bw profile |
newbedwars.bw.leaderboard |
true | /bw leaderboard |
newbedwars.party |
true | All /party commands |
All player permissions default to true, so everyone can use these commands until you deny a permission with a permissions plugin. Ops always bypass the checks. /lobby and /lang need the same permissions as /bw lobby and /bw lang.