Weapon Leveling x Better Combat Compat
If you have ever dual-wielded weapons in Minecraft while using the Weapon Leveling mod, you have likely noticed a frustrating gap: your offhand weapon simply does not earn experience points. This is not a bug, but a limitation of the base integration. The Weapon Leveling x Better Combat Compat add-on exists to close that gap, ensuring every swing counts toward your progression, regardless of which hand is holding the blade.
Developed by GekidoLukas, the same creator behind Weapon Leveling, this official add-on is a focused solution for players who want the full experience of leveling both primary and secondary weapons. It is not a standalone mod; it requires both Weapon Leveling and Better Combat to function. The add-on is designed for players using Weapon Leveling version 3.0.0 or higher, as older versions already had this functionality built in.
Why You Need This Compatibility Add-On
The core benefit is simple: dual-wielding weapons now applies XP to the correct weapon used by the player. In vanilla Weapon Leveling, only the main-hand weapon tracks experience. When you attack with your offhand, that damage is dealt, but no progress is recorded. This add-on intercepts those attacks and routes the XP to the offhand weapon, making your secondary arm just as viable for long-term progression.
For players who enjoy aggressive, fast-paced combat styles, this changes everything. You can now level a sword in your main hand and a dagger or axe in your offhand simultaneously, effectively doubling your combat efficiency. The add-on also ensures that weapon-specific perks and bonuses apply correctly to both hands, so you are not losing out on passive benefits.
How the Add-On Works Mechanically
When you strike an enemy with your offhand weapon, the add-on checks the weapon type and applies the appropriate experience gain. This is done seamlessly in the background, with no configuration required. The mod respects all existing Weapon Leveling settings, including XP multipliers, level caps, and skill trees. If you have already leveled a main-hand weapon, the offhand will start from zero, giving you a fresh progression path.
One important note: if you are using Weapon Leveling below version 3.0.0, this add-on is not needed. The feature was originally part of the main mod, and the split into a separate add-on was made to streamline future updates. This modular approach allows GekidoLukas to push fixes and improvements faster without breaking the core mod.
Compatibility and Requirements
This add-on is built for Minecraft versions that support both Weapon Leveling and Better Combat. Currently, the add-on works with Minecraft 1.20.1 and 1.21.x, though you should always check the specific file for your loader. It is available for both Forge and NeoForge, with Fabric support depending on the version. Always match the add-on version to your installed Weapon Leveling version to avoid crashes.
Before installing, ensure you have the latest versions of Weapon Leveling and Better Combat. The add-on will not work without them. You should also back up your world save before adding any mod, especially if you have existing weapon levels, to prevent data corruption.
How to Install the Add-On
To get started, you need to download Weapon Leveling x Better Combat Compat from a trusted mod repository. Place the downloaded JAR file into your mods folder, which is located in your Minecraft directory. Make sure you have the required dependencies in the same folder. After launching the game, the add-on will automatically integrate with your existing Weapon Leveling setup.
If you are using a modpack, you can also add it through your launcher's mod management system. Many players find it easier to use a dedicated launcher that handles dependencies automatically. For example, the foxygame.net launcher offers a one-click install for this add-on, pulling the correct version based on your Minecraft and loader settings. Its built-in add-on catalog lets you search for Weapon Leveling x Better Combat Compat for Minecraft and install it without manually tracking files. The launcher also handles auto-updates, so you will always have the latest compatibility fixes without checking forums.
After installation, launch the game and verify that the add-on appears in your mod list. You can test it by equipping a weapon in your offhand and attacking a mob. You should see experience gain notifications for both hands. If you do not see any change, double-check that you are using Weapon Leveling 3.0.0 or newer.
Troubleshooting Common Issues
If the add-on does not apply XP to your offhand, first confirm that Better Combat is active and that you are using its dual-wielding mechanics. Vanilla Minecraft does not allow attacking with the offhand in the same way, so the add-on relies on Better Combat's combat system. Also, ensure that your offhand weapon is a registered weapon type in Weapon Leveling's config; some tools like hoes may not be supported by default.
Another common issue is version mismatch. If you see a crash on startup, the add-on version likely does not match your Weapon Leveling version. Check the mod's page for the exact compatibility matrix. If you are using a launcher like foxygame.net, its version compatibility checker will flag mismatches before you even launch the game, saving you from a frustrating crash loop.
Final Thoughts on the Add-On
The Weapon Leveling x Better Combat Compat add-on is a small but essential piece for any player who takes dual-wielding seriously. It removes the artificial limitation on offhand progression and makes your combat style truly versatile. Whether you are a PvP enthusiast or a PvE grinder, having both weapons level up in tandem is a game-changer.
Since this is an official add-on, you can expect regular updates and direct support from the Weapon Leveling developer. All issues should be reported on the add-on's dedicated issue page, and feature requests for other compatibility add-ons can be submitted via Weapon Leveling's main page. This ensures the mod remains stable and forward-compatible with future Minecraft updates.
In conclusion, if you already use Weapon Leveling and Better Combat, this add-on is a no-brainer. It is lightweight, does not alter core gameplay, and delivers exactly what it promises: level up and fight better, with both hands. Download Weapon Leveling x Better Combat Compat today and start building a truly balanced dual-wield build.