# Overview Frame draws the tablist, nametags, sidebar, boss bars and action bar — and it draws them **separately for every player**. That last part is the whole point. Two players standing next to each other can see different names, different sorting, different sidebars, at the same moment, from the same server. Most tablist plugins compute one answer and show it to everyone; Frame computes one answer per person looking. Out of the box it reads your ranks from LuckPerms and works from `config.yml` alone. The API is there for when config isn't enough. --- ## Install Drop `Frame-Loader.jar` into `plugins/` and restart. That jar is a small shim — it fetches the real plugin from lode.gg, verifies its signature, and runs it. Updates arrive on the next restart without you downloading anything. On Velocity, drop `Frame-Velocity.jar` into the proxy's `plugins/`. The two halves are independent: run either alone, or both. Requires Paper 1.21.4 or newer. PlaceholderAPI and LuckPerms are optional but recommended. --- ## What it draws | Surface | What you get | |---|---| | **Tablist** | Header, footer, per-player names, sorting, ping, and who is visible at all | | **Nametags** | Prefix, suffix, name colour, visibility and collision above players' heads | | **Sidebar** | Up to 15 lines with a title | | **Boss bars** | Several at once, updating smoothly | | **Action bar** | A line that stays put instead of fading after a few seconds | | **Belowname** | A number under every player's nametag | | **Playerlist objective** | A number beside each tablist entry, as digits or hearts | Each is a **channel** you can switch off in `channels:`. Turning one off hands it back to vanilla and to other plugins entirely — Frame stops sending for it rather than blanking it. --- ## Ranks If you run LuckPerms, Frame reads your prefixes, suffixes and group weights straight from it. Nothing to copy across, nothing to keep in sync — your ranks show up in the tablist and above players' heads immediately, and sorting follows the group weights you already set with `/lp`. Leave `name-format` and the nametag `prefix`/`suffix` blank in config to use LuckPerms. Fill them in to override it. --- ## Sharing the scoreboard Nametags, the sidebar and both objectives all live on a player's scoreboard, and Minecraft gives each player exactly one. If another plugin assigns one, Frame **steps aside for that player** and leaves them alone. When the other plugin lets go, Frame's setup comes back on its own. Everyone else is unaffected. That is the default because two plugins both claiming the scoreboard every tick is a visible fight, not a compromise. If you know nothing else touches scoreboards, set `scoreboard.yield-to-other-plugins: false` and Frame will hold on to it. To keep Frame off scoreboards entirely, set `scoreboard.manage: false` — nametags, sidebar and objectives switch off, the tablist keeps working. --- ## Upgrading `config.yml` carries a `config-version`. When an update adds settings, Frame writes them into your existing file with their explanations, and leaves everything you have already set — including comments you wrote yourself — exactly as it was. Your old file is copied to `config.yml.v<old>.bak` first. New settings are added at the end of their section rather than the file being regenerated, so it stays yours. --- ## Related - [[Frame/Server Owners/Configuration]] — every setting, explained - [[Frame/Server Owners/Commands]] — commands and permissions - [[Frame/Developers/API Reference]] — for plugin authors