Content generated with AI — it may contain mistakes.

ExyliaPracticeCore/GuidesUpdated in v1.4.0

Let players spectate matches

Let players watch running matches, and see which setting and permission decide who can be watched.

Page 15 of 354 min read

You will end with arenas that lobby players can watch from the spectator spawn, with a menu to jump between fighters. Two different things are called spectating here: external spectators (somebody from the lobby who chooses to watch) and revive spectators (a player waiting out a revive). Only the first one needs setup.

Before you start#

  • You have at least one arena that matches are played in.
  • Players hold exyliapractice.spectate, which everybody has by default.

Steps#

Set a spectator spawn on every arena you want watchable

Run /epc, click Manage arenas, then your arena, and click Spectator spawn. Left click sets it where you stand; right click teleports you to it. The button shows its state (set or not).

The teleport is the first step of spectating and fails without a destination, so an arena with no spectator spawn cannot be watched.

Let players open the list

Players run /spectate (alias /spec) to open a list of the matches running right now, or /spectate <player> to watch the match that player is in. The default lobby hotbar also has a spyglass item that runs /spectate: see Lobby.

Keep the veto setting available

Players choose whether their own matches can be watched with Spectators in /settings. It is on by default; see Who can be watched.

Check that it works#

  1. Start a match in an arena with a spectator spawn, for example with two accounts on /duel.
  2. From a third account in the lobby run /spectate. The GAMES list shows the match with its kit, players and duration. Click it.
  3. You are teleported to the spectator spawn in Minecraft's spectator game mode, stripped of items and effects, and given the match sidebar. A second later the spectator menu opens with the living players.
  4. Click a player to teleport to them. End the match: every spectator returns to the lobby.

Going further#

The spectator menu#

Opens a second after joining, and again when the spectator sneaks twice quickly or uses the vanilla spectator teleport. Inside it:

  • Player heads (one per living player, with their health): click to teleport to that player.
  • Toggle spectators: hide or show the other spectators, so a crowded match is not a wall of floating names. The two states are named by labels.spectators-hidden and labels.spectators-visible in lang/<language>/messages.yml, and drawn with spectator.toggle-hiding-material and spectator.toggle-visible-material in config.yml (GRAY_DYE and LIME_DYE by default).
  • Leave the game: back to the lobby.

Who can be watched#

A match refuses spectators if any living player in it has Spectators turned off in /settings. It is one player's veto over the whole match, not a per-player hide. The viewer is told "Spectating is not allowed in this game."

Holders of exyliapractice.spectate.bypass (staff by default) ignore that veto. Spectate lists only offer the matches the viewer can watch, and can be searched by player name.

Only matches that are ACTIVE or STARTING can be joined. A match that ends between the menu opening and the click sends the spectator straight back to the lobby. A player who is a spectator themselves cannot be targeted by /spectate <player>.

Revive spectators#

The other kind: a player who was eliminated inside a match with revive-time above zero. They are put in spectator mode where they died, wait out the revive, and are teleported back to their spawn with the kit reapplied.

They never leave the match, are never counted as external spectators, and cannot be teleported to from the spectate menu.

Between rounds of a duel, the same thing happens for the round-end delay: the round's loser watches until the arena is regenerated.

Visibility rules

Spectators are hidden from the players fighting, and can be hidden from each other with the toggle. The players in a match see only each other: the isolation is applied per match, so two clones of one arena running side by side never show each other's players.

A spectator is held in spectator game mode: world plugins that change the game mode after arrival (Multiverse, for example) are overridden until the player leaves the match. Matches against bots cannot be spectated, not even with the bypass permission.

Something missing on this page? Tell us on Discord