Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.seraph.si/llms.txt

Use this file to discover all available pages before exploring further.

The stats overlay replaces Minecraft’s vanilla tab list with a configurable grid of Hypixel statistics for the lobby or game you’re in.

​
How it works

When you press Tab in a supported Hypixel game, Seraph cancels the vanilla render and draws its own table. Players are picked up from the live tab list as well as scoreboard scans, so the overlay stays accurate as people join and leave.

​
Game modes

The overlay swaps its columns based on the Hypixel game you’re in:
  • Bedwars
  • Skywars
  • Duels
Each mode has its own enable toggle, compact-mode toggle, and column list.

​
The Overlay tab

In the settings menu, the Overlay tab is split into three sub-tabs.

​
General

  • Custom Cubelify API URLs: list of full API paths used as additional tag sources. Use the dashed entry to add a new URL; clearing one removes it. Format: https://api.seraph.si/{{id}}/cubelify/blacklist.
  • Highlight Snipers: highlight players with one or more tags.
    • When on, a Sniper Highlight Color picker appears with 16 Minecraft colors.
  • Highlight Players: highlight players based on the highlight rules you define in the Modes sub-tab. Required for those rules to do anything.
  • Background Opacity: slider from 0 to 255 controlling the overlay’s background opacity.

​
Modes

For each of Bedwars, Skywars, and Duels:
  • Enabled: turns the overlay on for that mode.
  • Compact Mode (visible when enabled): displays the overlay in compact mode.
  • Display Timers (Bedwars only, when enabled): shows Bedwars resource timers in the overlay header.
  • Compact Timers (Bedwars only, when enabled): displays the timers in compact form.
  • Highlight rules editor: define rules that color rows based on stat conditions. Rules use stat names with operators + - * / ( ) <= >= < > = && ||. Each rule has a color from a 9-color preset palette and can be enabled/disabled or reordered.

​
Columns

Pick a mode (Bedwars, Skywars, Duels) using the tabs at the top. Each tab shows its current column count.
  • If Compact Mode is on for that mode: a Compact Stat dropdown lets you pick the single statistic shown next to player names.
  • Otherwise: a column editor lets you pick which columns appear, in what order. Available columns vary per mode.

​
Available columns per mode

Bedwars: Stars, Name, HP, Finals, FKDR, Wins, WLR, Beds, BBLR, KDR, WS, Ping, Tags, Custom Tags, Client, Guild, Network Level. Skywars: Level, Name, HP, Wins, Kills, KDR, WLR, WS, Ping, Tags, Custom Tags, Client, Guild, Network Level. Duels: Name, HP, Wins, Kills, KDR, WLR, WS, Ping, Tags, Custom Tags, Client, Guild, Network Level.

​
Sorting

Players are grouped by team first, then sorted within each group:
  • Bedwars: by stars, descending.
  • Skywars: by Skywars EXP, descending.
  • Duels: no secondary sort.

​
Custom players

/seraph add <player> adds someone to the overlay manually. They render at the bottom of the table and stay until you /seraph clear or change worlds.

​
Nicked players

When someone joins under a nick, the overlay shows them as ? until Seraph can resolve them through skin lookups, your saved nick map, or a manual /seraph remap. Mappings marked permanent are saved to nicknames.json.