Skip to content

Commands

gniftygnome edited this page Sep 13, 2023 · 6 revisions

Skylark Commands

Overview

Skylark adds new Minecraft commands for managing player teams and teleporting players to their team spawn. Like all Minecraft commands, a user must have Cheats enabled in order to use the Skylark commands. Additionally, most commands require operator (level 4) permissions in order for a player to execute the command.

Commands

Help

Skylark provides a rudimentary help system. Users can request an overview via the /skylark help command, and more detailed usage information for the commands via /skylark help teams and /skylark help teleport.

Team

Skylark's team commands allow inspection of Skylark's view of player team membership (including both scoreboard teams and Skylark's automatic teams for non-scoreboard-team players). It is also possible for the administrator to modify a team's default spawn point.

  • /skylark team list [names] - List the teams, their default spawn point (operators only), and their currently-logged-in membership.
  • /skylark team list keys - The same listing as above, but teams and players are shown by the keys needed for configuration instead of by their display name.
  • /skylark team spawn <teamkey> <BlockPosition> - Change the spawn point of the team to a new position. The value of should be present in the output of /skylark team list keys.

Teleport

Skylark offers a convenience teleportation command for the server operator. Any subset of currently logged-in users that can be selected using an entity selector can be simultaneously teleported to their team's configured spawn point. Spawn features will be generated as required.

  • /skylark teleport spawn <PlayerSelector> - Immediately teleport all matched players to their team's default spawn point.

Minecraft Scoreboard Teams

Instead of implementing its own general-purpose team system, Skylark uses Minecraft's scoreboard teams to group players. The following commands are examples of common scoreboard team administration.

  • /team add <teamname> "<Team Display Name>" - Creates a new scoreboard team. Skylark commands will refer to this team as minecraft.team.<teamname> (the "team key") or <Team Display Name> (the "team name").
  • /team join <teamname> - Join yourself to the <teamname> team.
  • /team join <teamname> <PlayerName> - Join <PlayerName> to the <teamname> team (entity selectors can also be used).
  • /team list - List the current scoreboard teams.
  • /team modify <teamname> ... - Modify various scoreboard team options (not strictly relevant for Skylark).

Examples

For the most part, use of commands is only necessary when the server operator is using custom scoreboard teams. In the default single-team mode and when using the separateTeams configuration option without any custom teams, commands are not required.

Configuration of custom teams

A four-person game where two players are placed in each team might be configured as follows. The separateTeams configuration option should be left at its default (false), and in most cases the operator will want to set the spawnRingRadius configuration option to some positive value giving the teams sufficient separation. Once the game is running and all players have logged in, the following sequence of commands would separate the players and relocate all players to their spawn points.

/team add red "Red Team"
/team add blue "Blue Team"
/team join red Bob
/team join red Joe
/team join blue Bruce
/team join blue Jerry

/skylark team list keys
/skylark teleport spawn @a
Clone this wiki locally