BedWars Level Head

BedWars Level Head is a lightweight, simplified fork of the classic Levelhead mod, rebuilt specifically to display a player's BedWars Star above their nametag on Hypixel.

All extra features from the original mod have been removed to keep this version lightweight.

Features

• Automatic Display: Shows BedWars stars above player heads in lobbies and pre-game waiting areas.
• Smart Caching: Caches player stats to prevent spamming the API and reduce rate limits.
• Proxy Backend: Uses a custom proxy backend to handle requests, meaning you do not need your own Hypixel API key to get started.
• Nick Detection: Identifies if a player is "nicked" via the proxy service.
• Customization: Change header text, colors (including Chroma/✨), and display offsets.

Note: By default, this mod connects to a proxy server (beeny.hackclub.app) to fetch stats. You do not need to request a Hypixel API key unless you choose to disable the proxy.

Commands

General

• /levelhead Shows the current configuration status (Enabled/Disabled, Offset, Header).
• /levelhead gui Opens a simple GUI button to toggle the mod on or off.
• /levelhead toggle Quickly enables or disables the level display.
• /levelhead whois <player> Manually look up the BedWars stats, star, and nick status of a specific player or UUID.
• /levelhead status Displays technical diagnostics, such as cache size, rate limit status, and proxy connection health.

Customization

• /levelhead display header text <text> Change the text label above the star (Default: "BedWars Star").
• /levelhead display header color <color> Change the color of the header text (supports hex codes, RGB, or Minecraft color names).
• /levelhead display header chroma <on|off> Toggles the ✨ (chroma) effect for the header text.
• /levelhead display offset <value> Adjusts how high the text floats above the player's head.
• /levelhead display showself <on|off> Toggle whether you see your own stats above your head.

API & Proxy Management

• /levelhead apikey <key> Manually set your own Hypixel API key. Only required if you disable the proxy.
• /levelhead apikey clear Removes your stored personal API key.
• /levelhead proxy <on|off> Enables or disables the usage of the backend proxy. If disabled, you must provide your own API key.

Configuration

For advanced users, configuration files are located in your .minecraft/config/ folder:

1. bedwars-level-head.cfg: Contains general settings like your API key, proxy URL, and cache TTL.
2. levelhead.json: Stores display-specific settings (colors, offsets, headers).

Note: It is highly recommended to use the in-game /levelhead display commands to modify visuals rather than editing the JSON manually.

Credits & License

This project is a fork of the original Levelhead mod created by Sk1er LLC and is licensed under the GNU General Public License v3. This mod would not exist without their foundational work.

• Original Author: Sk1er LLC
• Backend & Fork: beenycool
• Data: Powered by the public Hypixel API.

---