Перейти к содержимому
Mineforgian

BedWars Level Head

A simplified fork of the classic Levelhead mod, rebuilt to focus exclusively on displaying a player's BedWars star above their head on the Hypixel network.

Загрузки
2K
Подписчики
1
Обновлён
9 ноября 2025 г.
Лицензия
GPL-3.0-or-later

Опубликован 15 октября 2025 г.

Исходный кодСообщить об ошибке

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:

  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.

Ченджлог

8.4.0Релиз1.8.9 · 9 ноября 2025 г.

Major Updates

Backend & Proxy:

  • Removed proxy authentication requirement - mod now uses public API routes
  • Added Docker Compose support for easy self-hosting
  • Improved observability with better logging and metrics
  • Hardened admin endpoints with proper API key authentication
  • IP-based rate limiting with separate public/private limits

Mod Improvements:

  • First-run welcome message for new users
  • Enhanced command feedback with current state display
  • Proxy enabled by default with pre-configured URL
  • Better error messages with usage examples

Technical Details

  • Backend: Removed install ID binding, added public routes, improved cache migrations
  • Mod: Proxy auth token now optional, better command parsing, improved user guidance
  • Documentation: Comprehensive backend README with Docker quick start guide
8.3.0Релиз1.8.9 · 30 октября 2025 г.

In-game /levelhead has become a full control center: the default handler now reports mod status, header text, offset, self-visibility, and proxy configuration so players know their setup at a glance.

New subcommands let you tune everything without leaving chat—set header text/color/chroma, adjust vertical offset, toggle showing your own tag, manage proxy credentials, purge backend cache entries, and run rich status/debug snapshots to inspect rate limits, cache health, and proxy connectivity.

/levelhead whois now understands usernames and UUIDs, fetching stats from either the configured proxy or Hypixel directly with helpful feedback, ✪-styled star readouts, and graceful error handling.

Display management gained new helpers so updating the primary tag immediately rewrites cached headers/colors/chroma and avoids unnecessary refetches, keeping overlays consistent when you tweak settings.

Prestige styling has been refreshed with an expanded palette, ensuring the ✪ footer color matches Hypixel’s latest tiers while keeping chroma effects where appropriate.

The mod now ships as version 8.3.0, aligning with the backend upgrade and making release tracking easier for Modrinth users.

Proxy & Backend Improvements Player lookups feed a new history service that records identifier, nick status, data source, install ID, and computed BedWars stars; the /stats route renders the latest queries in an HTML table with proper escaping for safe sharing.

A shared BedWars math helper now derives stars from raw experience so the proxy and mod stay perfectly in sync on level calculations.

Cache diagnostics were overhauled: hits/misses log detailed reasons, purge jobs report how many rows were cleared, and stored responses capture ETag/Last-Modified metadata for smarter revalidation.

Configuration now enforces a 1–24 hour TTL window (default 24h) for cache entries, reflecting documented limits and preventing accidental misconfiguration.

Server startup emits structured request timing logs, exposes the new /stats dashboard, and keeps health/metrics endpoints for observability during deployments

1.2Релиз1.8.9 · 20 октября 2025 г.

addded update notifications added backend url added caching fixed most of the star colour being wrong fixed bedwars detection added nick deteciton lot more cba lol

1Релиз1.8.9 · 15 октября 2025 г.

remove levelhead to make it smaller

Комментарии

Загружаем…