Skip to content

Repository files navigation

🔷 RGX | Minecraft Level-Up!

MCLU Logo

RGX Mods - RealmGX Community Project


🎯 Overview

Minecraft Level-Up! (MCLU) replaces World of Warcraft's configured default level-up sound with a Minecraft-inspired chime whenever the player gains a level. It is a small, automatic sound addon built on RGX-Framework.

RealmGX Kiwi The Kiwi Says: "Crafting complete! Bwwiiiee."


⚠️ Deprecation Notice

This addon is no longer receiving updates. Its functionality and Minecraft sound are available in BLU | Better Level Up! and BLU Classic | Better Level Up!, which combine this sound with a larger sound collection.

Existing standalone users may continue to use this repository as-is, but new installations should prefer the appropriate BLU addon.


✨ Behavior and Features

  • Plays the selected Minecraft-inspired sound on PLAYER_LEVEL_UP.
  • Provides high, medium, and low OGG variants; medium is selected by default.
  • Plays through the Master sound channel by default.
  • Requests that RGX-Framework mute the configured default level-up sound while MCLU is enabled.
  • Persists enablement and sound-variant choices in MCLUSettings.
  • Shows a welcome message on login while that saved preference remains enabled.
  • Includes a test command for checking playback immediately.

MCLU does not alter leveling, experience gains, UI frames, or game data. It only handles the sound associated with the player's level-up event.


🎮 Requirements and Compatibility

RGX-Framework is a required dependency and must be installed and enabled. The current TOCs declare these game interfaces:

WoW flavor TOC Interface
Retail MinecraftLevelUp.toc 120007
Wrath Classic MinecraftLevelUp_Wrath.toc 30403
Burning Crusade Classic MinecraftLevelUp_TBC.toc 20504
Classic Era MinecraftLevelUp_Vanilla.toc 11500

These values describe the preserved release metadata. The addon is deprecated, so they are not a promise of compatibility with later game clients.


📥 Installation

  1. Download a packaged release of MinecraftLevelUp and install RGX-Framework.
  2. Extract both addon folders into the WoW client's Interface/AddOns directory.
  3. Confirm that the folder is named MinecraftLevelUp rather than a source-archive name.
  4. Enable RGX-Framework and Minecraft Level-Up! at the character-selection AddOns screen.

For the consolidated replacement, install BLU or BLU Classic instead of the standalone addon.


⌨️ Usage and Configuration

MCLU works automatically once enabled. It has no graphical configuration panel; use /mclu commands in chat:

Command Result
/mclu or /mclu help List available commands.
/mclu test Play the selected sound variant.
/mclu enable Enable replacement playback.
/mclu disable Disable replacement playback.
/mclu high Select the high-quality file.
/mclu med or /mclu medium Select the medium-quality file.
/mclu low Select the low-quality file.

The initial defaults are enabled, medium quality, Master-channel playback, default-sound muting, and the welcome message. Settings persist between sessions in MCLUSettings.


🧩 Files and Runtime

  • data/locales.lua defines chat and welcome text.
  • data/core.lua registers the sound set, events, saved settings, and /mclu command.
  • sounds/minecraft_{high,med,low}.ogg are the active playback files.
  • media/icon.tga, media/logo.png, and media/kiwi.gif provide addon and project artwork.

At addon load, MCLU initializes its RGX-Framework sound handle. At login it displays the optional welcome message. Each later PLAYER_LEVEL_UP event plays the selected variant when the addon is enabled, and logout allows the framework handle to finalize its state.


🛠️ Troubleshooting

  • If WoW marks MCLU as missing a dependency, install or enable RGX-Framework.
  • If no custom sound plays, run /mclu test, then /mclu enable and select a variant again.
  • If the default sound also plays, verify that MCLU and RGX-Framework both loaded without Lua errors.
  • If WoW cannot find the addon, verify the exact Interface/AddOns/MinecraftLevelUp folder name.

Because the standalone project is retired, migrate to BLU or BLU Classic when you prefer the consolidated sound addon.


🔗 Project Links

This repository is retained for existing users and historical context. Issue reports and contributions should account for the deprecation notice and the migration path above.


🌟 Thank you for choosing RGX Mods! 🌟

About

MCLU - Minecraft Level Up!

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages