Players

The Joined players panel shows everyone who has connected to your server, plus any players you add manually. From here you can search, sort, and bulk-assign roles (op, whitelist, ban).

The player table

Each row shows:

• Checkbox — Select the player for bulk actions
• Player — Minecraft username with a live head avatar (fetched from minotar.net)
• Last joined — Timestamp of their most recent connection, or "added manually" for players you added by username
• IP — Last known IP from session data, or "added manually"
• Tags — Role badges: Op (accent), Whitelisted (success), or Banned (danger). A muted — is shown when the player has no roles.

The tags are display-only — you change roles via the bulk action bar (see below), not by clicking the badges.

Sorting and filtering

• Search — Filter by player name or IP
• Role — Filter to All, Ops, Whitelisted, or Banned players
• Sortable columns — Click Player, Last joined, or IP to sort. Click again to reverse direction; click a third time to clear sorting. The default order puts connected players first (most recent join first), then manually added players alphabetically.

Adding a player manually

You can add a player to the table without them having connected:

1. Click Add player in the toolbar
2. Enter a Minecraft username (3-16 letters, numbers, or underscores)
3. Click Add player (or press Enter)

Cliff looks up the player via Mojang's API and adds them to the table. Manually added players are stored in your browser's local storage for that server and show "added manually" for their join time and IP. Once a manually added player actually connects, their real session data takes over.

Assigning roles (bulk actions)

Roles are applied via bulk selection — there are no per-row toggle buttons.

1. Tick the checkbox next to each player you want to update (or use the column-header checkbox to select all filtered players)
2. The bulk action bar appears with three split buttons:
   • Op selected — Expands to Op selected / Deop selected
   • Whitelist selected — Expands to Whitelist selected / Unwhitelist selected
   • Ban selected — Expands to Ban selected / Unban selected
3. Click the action you want

Cliff writes the changes to the server's access files and refreshes the table. The selection is cleared after the action completes.

Operators (OPs)

Operators have full administrative access to the server. Op-ing a player sets level 4 in ops.json, giving them access to all server commands. Use Op selected / Deop selected to add or remove op status.

Whitelist

When whitelist is enabled in server.properties, only players on the whitelist can join the server. Use Whitelist selected / Unwhitelist selected to manage the list. Whitelisted players are stored in whitelist.json.

To enable the whitelist itself, toggle it in Server Settings or run whitelist on in the console.

Bans

Banned players cannot join the server. Use Ban selected / Unban selected to manage bans. When banning, Cliff records the reason as "Banned by an operator." Banned players are stored in banned-players.json.

Where the data comes from

The player list is built from two sources:

• Sessions — Pulled from the server's log files and usercache.json. Each entry includes the player's name, last known IP, and last joined timestamp. The list updates when you reload the panel.
• Manual additions — Players you add by username, stored in your browser's local storage.

There is no separate sessions view — session data is merged directly into the player table.