Room Players

Added in v2.0.1.

Description

Checks the players in a room. In count mode it compares the room's player count against a threshold. If player is given instead, it switches to occupancy mode and passes only when that specific player (an exact online name or a UUID) is in the room. If room is set it names the room; otherwise the target's current room is used.

Procedural only. Note this condition defaults count to 1, so a bare roomplayers passes when the room holds one or more players.

Attributes

Attribute Aliases Description Default
room roomid, id, r Room name. When empty, the target's current room is used. (empty)
player p Optional exact online player name or UUID. When set, switches to occupancy mode. (empty)
count c, amount, a, value, v Threshold to compare the player count against (count mode). 1
op operator Comparison operator. See Comparison operators. >=

Examples

RoomHasTwo:
  Conditions:
  - roomplayers{room=lobby;count=2;op=>=}

Passes when at least two players are inside the lobby room.

Aliases

  • playersinroom
Updated Aug 19, 2026