Skip to content

Commands and Permissions

RedstoneFuture edited this page May 29, 2024 · 35 revisions

Main Command

Syntax: /mw …

Aliases: /missilewars

Permission: -

This is the main command of the MissileWars plugin. Without specifying any arguments, it displays the available commands based on the user's permissions.

User Commands

Map-Vote Menu

Syntax: /mw mapmenu

Aliases: votegui

Permission: mw.mapmenu

This command can be used to open the Map-Vote Menu. This is an inventory menu that displays the available arenas there are can be voted for and allows executing the corresponding Map-Vote command through item interaction.

Note: The menu can be partially reconfigured. All details can be found here.

Screenshot

Map-Vote

Syntax: /mw vote <arena>

Aliases: -

Permission: mw.vote

This command can be used to vote for the desired arena-map in the game-phase "Lobby", if more than one map is available for the game and the map_choose_procedure is set to MAPVOTING in the arena config. If the command is used multiple times in the same game, the previous vote is overwritten.

Team-Selection Menu

Syntax: /mw teammenu

Aliases: changegui

Permission:

  • mw.teammenu - Permission to open the menu
  • mw.change.team.player - Permission to see the two "player-team" items
  • mw.change.team.spectator - Permission to see the "spectator-team" item

This command can be used to open the Team-Selection Menu. This is an inventory menu that displays the available teams (Team 1, Team 2 and Spectator) and allows executing the corresponding Team-Change command through item interaction.

Note: The menu can be partially reconfigured. All details can be found here.

Screenshot

Team-Change

Syntax: /mw change <1|2|spec>

Aliases: switch, team

Permission:

  • mw.change.use - Basic Permission to use the command
  • mw.change.team.player - Permission to switch in one of the "player-teams"
  • mw.change.team.spectator - Permission to switch in the "spectator-team"

This command can be used to change the team. This is possible in the game-phase "Lobby" and (if the arena setting teamchange_ongoing_game is enabled) in the game-phase "Ingame". The anti-spam interval (antispam_intervall.team_change_command) from the config.yml is used here so that the command cannot be used too quickly in succession. In the game-phase "Ingame", with executing the command the plugin checks whether the requested team-change is fair (in the lobby, the game simply does not start in this case). The maximum values for the game and the teams are also validated.

Game-Quit

Syntax: /mw quit

Aliases: leave

Permission: mw.quit

You can use this command to leave a game if you are in one. It doesn't matter whether you are currently in a player team or watching in a spectator team. This command teleports you to the configured fallback_spawn position.

Statistics

Warn: The stats system is outdated and will be reworked in the future.

Show Stats

Syntax: /mw stats [from] [arena]

Aliases: -

Permission: mw.stats

Shows stats.

Shows Recommendations

Syntax: /mw stats recommendations [from] [arena]

Aliases: -

Permission: mw.stats.recommendations

Shows recommendations.

Shows Player-List

Syntax: /mw stats players [from] [arena]

Aliases: -

Permission: mw.stats.players

Shows player list.

List Game-History

Syntax: /mw stats list [from] [arena]

Aliases: -

Permission: mw.stats.list

Lists history of games.

Staff Commands

Game-List

Syntax: /mw listgames

Aliases: list, games

Permission: mw.listgames

This command lists the currently running games and shows important basic information about it.

Screenshot

Game-List

Syntax: /mw paste <missile>

Aliases: -

Permission: mw.paste

This command can be used to manually paste a missile. The missiles that have been activated in the arena in the current game are available. The missiles are pasted in the direction of player-view and according to the Missiles settings (down and dist offset) in the arena configuration.

Warn: The command does not execute a normal Player-WorldEdit command and therefore cannot currently be undone with "//undo". The command should therefore be used with care.

Force-Start

Syntax: /mw start [lobby]

Aliases: -

Permission: mw.start

This command sets the Lobby Wait-Time (based on the lobby_time setting from the lobby configuration) to "0" sec., so that the map vote (if active) is evaluated and the game starts instantly. The command can of course only be used in the game-state "Lobby".

Force-Stop

Syntax: /mw stop [lobby]

Aliases: -

Permission: mw.stop

This command ends the current game with a draw.

Append Restart

Syntax: /mw appendrestart [lobby]

Aliases: -

Permission: mw.appendrestart

This command appends a server stop and restart (if possible) after the next game ends. This command works independent of the restart_after_fights setting in the config.yml.

Plugin Reload

Syntax: /mw reload

Aliases: -

Permission: mw.reload

This command reloads all configuration files.

Note: Changes are only applied to games when they are restarted. This happens at the latest after the game-end. You can also force a game-restart with the Force-Stop or Restart-All command.

Debug-Info

Syntax: /mw debug

Aliases: -

Permission: mw.debug

This debug command prints parts of the configuration into the server-log file.

Warn: This command does not output all information. This command must be revised / replaced in the future. If you have a problem, depending on the case, you should provide all the necessary information to help us identify / reproduce the error.

Restart-All

Syntax: /mw restartall

Aliases: -

Permission: mw.restartall

This command restarts all active MissileWars games.

Show Plugin-Version

Syntax: /mw version

Aliases: -

Permission: mw.version

This command shows the currently installed plug-in version.

Game-Setup

Syntax: /mw setup <main|lobby|arena> …

  • /mw setup main fallbackspawn <set|teleport>
  • /mw setup lobby <spawnpoint|aftergamespawn> <set|teleport> <lobby>
  • /mw setup lobby area <pos1|pos2> <set|teleport> <lobby>
  • /mw setup arena <team1spawn|team2spawn|spectatorspawn> <set|teleport> <lobby>
  • /mw setup arena area <pos1|pos2> <set|teleport> <lobby>

Aliases: -

Permission: mw.setup

With this command, you can customize the most important areas and positions of your MissileWars setup and teleport to them.

Note: Cubic areas are of course defined with two points ("Position 1" and "Position 2"). It doesn't matter where you set which position. (They are sorted afterwards in the config.)

Location / Area Type Description
Main Fallback-Spawn Position The player comes here after a game-quit or a game-stop; after the player is not allowed to enter the game or after rejoining the server within the "Lobby Area" / "Arena Area". The position should be located outside every "Arena Area" and ideally outside every "Lobby Area", to avoid errors caused by automatic teleports. The server spawn may be a good location for that.
Lobby Spawnpoint Position When the player enters the lobby arena and has been accepted, they will be teleported here. This should always be within the lobby arena.
Lobby After-Game-Spawn Position This is the position to which the players are teleported at the end of the game. This can also be within the lobby area. They are then automatically included in the restarted game.
Lobby Area Area This is the area to enter the game. When the player steps into this area, the plugin checks the conditions for entry and teleports the player to the "Lobby Spawnpoint".
Arena Team1 & Team2 Spawn Position This is the position to which the team member of team 1 or team 2 is teleported at the game-start / team-join or after respawn from a death. This should always be within the "Arena Area".
Arena Spectator Spawn Position This is the position to which the team member of the spectator-team is teleported at the game-start / team-join. This is typically further up outside the "Arena Area" between the two team spawns. But it is not important.
Arena Area Area This is the arena within which the players may be located during the game.

Clone this wiki locally