BedWars Level Head

# 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/Rainbow), 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 ` 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 ` Change the text label above the star (Default: "BedWars Star"). * `/levelhead display header color ` Change the color of the header text (supports hex codes, RGB, or Minecraft color names). * `/levelhead display header chroma ` Toggles the rainbow (chroma) effect for the header text. * `/levelhead display offset ` Adjusts how high the text floats above the player's head. * `/levelhead display showself ` Toggle whether you see your own stats above your head. ### API & Proxy Management * `/levelhead apikey ` 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 ` 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. ---