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 <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 rainbow (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:

bedwars-level-head.cfg: Contains general settings like your API key, proxy URL, and cache TTL.
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.

BedWars Level Head

介绍