LevelZ+

LevelZ+ — Expanded Progression & Compatibility

LevelZ+ is a modular expansion and compatibility suite for LevelZ on Minecraft 1.20.1 Fabric.

It extends LevelZ’s progression system into additional gameplay mechanics, provides compatibility with popular mods, and introduces configurable XP improvements for both singleplayer and multiplayer.

The goal is simple: make LevelZ progression matter across more of Minecraft, without requiring a large dependency stack or forcing unwanted gameplay changes.

LevelZ is the only required gameplay mod. All external integrations are optional and activate only when their corresponding mods are installed.

Version 2.0 consolidated the former standalone Tom’s Simple Storage and combat compatibility mods into LevelZ+, adding Small Ships Dockyard support alongside the existing stat integrations.

Version 2.1.1 builds on that foundation with improved independent progression XP, reliable multiplayer combat rewards, farming compatibility, configuration improvements, and additional safeguards against duplicate XP.

Features

Expanded LevelZ Skill Integration

LevelZ+ connects existing LevelZ skills to additional gameplay mechanics.

Every stat contribution is configurable, and individual bonuses can be effectively disabled by setting their per-level values to 0.

Endurance / Stamina

• Maximum stamina scaling through Stamina Attributes.

• Stamina regeneration scaling through Stamina Attributes.

• Reduced melee stamina costs through Better Combat Extension.

• Increased food effectiveness.

• Faster passive health regeneration through Passive Regen.

• Increased positive Diet gain through Diet.

Agility

• Increased Combat Roll distance.

• Faster Combat Roll recharge.

• Additional roll charges at configurable LevelZ thresholds.

Luck

• Virtual Fortune applied to block loot.

• Increased positive progression XP gain.

• Critical-hit chance scaling through Zenith Attributes.

Archery

• Draw-speed scaling through Zenith Attributes.

Trade

• Increased Numismatic Overhaul coin rewards from supported Bountiful rewards.

Alchemy

• Maximum mana scaling through RPG Mana.

• Mana regeneration scaling through RPG Mana.

All relevant values are configurable through config/levelz_plus.properties.

Independent LevelZ Progression XP

LevelZ+ expands the way players earn progression XP without interfering with Minecraft’s vanilla experience system.

Vanilla XP and LevelZ progression XP remain separate.

This allows players to continue using ordinary Minecraft experience for enchanting, repairing, and other mechanics while progressing their LevelZ skills independently.

Optional Custom Combat XP

LevelZ+ includes a configurable combat XP system with improved damage attribution and multiplayer contribution tracking.

When enabled, it provides:

• LevelZ XP from eligible mob kills.

• Configurable combat XP multipliers.

• Optional mob maximum-health scaling.

• Contributor-based multiplayer XP distribution.

• Support for multiple players receiving progression credit from the same kill.

• Improved attribution for direct and indirect player damage.

• Fallback attribution using Minecraft’s recorded attacking player.

• Diagnostics for skipped or ineligible XP rewards.

Shared multiplayer progression

When multiple eligible players contribute to killing the same mob, LevelZ+ can award each contributor their own full calculated LevelZ XP reward.

XP is not divided between players or restricted to the player delivering the final hit.

This makes cooperative combat more rewarding and avoids the usual last-hit limitation.

Health-Based Combat XP

Combat XP can optionally scale with a mob’s maximum health.

Default settings when custom combat XP is enabled:

levelz_xp.combat.mob_xp_multiplier=1.0
levelz_xp.combat.max_health_fraction=0.10

This allows tougher enemies to provide additional progression XP, with the contribution controlled through configuration.

Safe Combat XP Defaults

Custom LevelZ+ combat XP is disabled by default in 2.1.1.

levelz_xp.combat.enabled=false

Standard LevelZ already provides mob-kill XP. Enabling both systems without adjusting their configuration may cause duplicate progression rewards.

If you want to use LevelZ+’s custom multiplayer combat XP system, enable it and disable native LevelZ mob XP by setting:

mobXPMultiplier=0.0

in LevelZ’s configuration.

LevelZ+ also includes a lightweight server-startup warning when it detects that both combat XP systems are enabled.

It never automatically changes LevelZ’s settings.

Existing LevelZ+ configurations retain their explicit combat XP settings when updating.

Farming & Harvesting XP

LevelZ+ extends progression XP support to additional farming interactions.

This includes compatibility with Actually Harvest, allowing supported right-click harvesting actions to award LevelZ farming progression XP.

The integration is designed to work alongside ordinary Minecraft farming and harvesting mechanics.

Farming XP behaviour and reward scaling remain configurable.

Optional Compatibility Modules

Each compatibility module operates independently.

Modules only activate when the relevant mod is installed, and they can be enabled or disabled through the LevelZ+ configuration.

Tom’s Simple Storage

Prevents the Crafting Terminal from bypassing LevelZ crafting requirements.

• Recipes blocked by LevelZ remain blocked inside the storage network’s Crafting Terminal.

• Players can craft those recipes once they meet the required LevelZ skill level.

• Existing LevelZ crafting restrictions are respected.

• No separate compatibility mod is required.

Better Combat

Enforces LevelZ item-use restrictions during Better Combat attacks.

• Validates attack requests against LevelZ’s hand-use restrictions.

• Prevents off-hand attacks from bypassing LevelZ progression.

• Cancels attacks when the corresponding weapon is restricted.

• Works through Better Combat’s custom attack handling.

Spell Engine

Prevents spell-casting interactions from bypassing LevelZ item restrictions.

• Validates the active casting item against LevelZ requirements.

• Blocks spell synchronization and release when the casting item is restricted.

• Clears the active cast after a denied action.

• Operates independently from the Better Combat module.

Small Ships — Dockyard Integration

Adds LevelZ crafting-requirement enforcement to the Small Ships 2.0 Dockyard.

When a player attempts to construct a ship, LevelZ+ resolves the selected ship type and wood variant to its actual item ID.

For example:

smallships:galleon + oak → smallships:oak_galleon

LevelZ+ then checks the item’s normal LevelZ crafting restriction.

• No restriction: construction proceeds.

• Requirement satisfied: construction proceeds.

• Requirement not satisfied: construction is denied before building begins.

Ship level requirements are not hard-coded into LevelZ+.

Modpack authors can change ship requirements through the standard LevelZ restriction data without modifying this mod.

Custom item-mapping overrides are also available for addon ships with unusual naming conventions.

Additional configuration options control Dockyard enforcement, denial messages, and unresolved ship handling.

Configuration

LevelZ+ generates its configuration at:

config/levelz_plus.properties

The configuration is a readable, annotated properties file designed for both ordinary players and modpack developers.

Version 2.1.1 retains all 34 existing configuration options.

Main Configuration Groups

general.debug

Enables detailed diagnostic logging for compatibility modules, item restrictions, and progression XP handling.

Disabled by default.

modules.*

Controls the optional Tom’s Simple Storage, Better Combat, Spell Engine, and Small Ships compatibility modules.

Modules are enabled by default but remain inactive when their target mods are absent.

stats.*

Controls the individual LevelZ skill-based stat contributions.

Existing balance defaults are preserved.

levelz_xp.*

Controls additional LevelZ progression XP behaviour, including combat rewards, farming integrations, reward multipliers, and combat health scaling.

Custom combat XP is disabled by default to avoid overlapping with native LevelZ combat XP.

small_ships.*

Controls Dockyard restriction enforcement, denial messages, unresolved ship handling, and custom ship-item mappings.

Updating Existing Installations

LevelZ+ preserves existing configuration values instead of silently resetting them when updating.

The previous JSON-to-properties configuration migration remains supported for older installations where applicable.

Configuration changes require a Minecraft or dedicated-server restart.

Multiplayer Support

LevelZ+ supports both singleplayer and dedicated multiplayer servers.

Its compatibility restrictions are designed to enforce progression on the server, including interactions that other mods implement through custom networking.

The optional combat XP system supports contributor-based rewards, so cooperating players can receive independent progression XP without competing for the final hit.

Version 2.1.1 improves contributor attribution, death reward handling, and skipped-award diagnostics.

Custom combat XP remains optional, allowing servers to retain standard LevelZ progression when shared combat rewards are not needed.

Requirements

Required

• Minecraft 1.20.1

• Fabric Loader 0.14.19+

• Java 17+

• LevelZ 1.4.13+

LevelZ is the only required gameplay mod.

Optional Integrations

The following versions are the established 2.0 compatibility targets. Optional mods are not required for LevelZ+ to load.

Mod	Compatibility
Tom’s Simple Storage 1.7.1	Crafting Terminal restrictions
Better Combat 1.8.6+1.20.1	Weapon-use enforcement
Spell Engine 0.15.12+1.20.1	Casting restrictions
Small Ships 2.0.0	Dockyard requirements
Zenith Attributes 1.0.3	Critical chance and draw speed
Stamina Attributes 1.6.0	Maximum stamina and regeneration
RPG Mana 1.1.0	Mana capacity and regeneration
Better Combat Extension 1.4.0	Melee stamina costs
Combat Roll 1.3.3+1.20.1	Agility-based roll improvements
Passive Regen 1.3.3+1.20.1-fabric	Health regeneration
Diet 3.0.2+1.20.1	Positive Diet gain
Bountiful 6.0.4+1.20.1	Trade reward scaling
Numismatic Overhaul 0.2.18+1.20	Currency rewards
Actually Harvest	Additional farming XP integration

Optional integrations are guarded so missing mods do not become hard dependencies.

Installation

1. Install Fabric for Minecraft 1.20.1.

2. Install LevelZ 1.4.13 or a compatible version.

3. Place the LevelZ+ JAR into your mods folder.

4. Install whichever supported optional mods you want to use.

5. Start Minecraft or your dedicated server to generate the configuration.

6. Adjust config/levelz_plus.properties as needed.

For servers using LevelZ+’s shared combat XP system, enable custom combat XP and disable native LevelZ mob XP to avoid duplicate rewards.

What’s New in 2.1.1?

• Fixed a combat XP issue where eligible mob kills could award no LevelZ progression XP.

• Improved damage contributor attribution and fallback handling.

• Improved shared multiplayer combat XP reliability.

• Preserved independent LevelZ progression XP and vanilla Minecraft XP.

• Added safer default configuration for optional combat XP.

• Added a server-startup warning for potentially duplicated combat XP.

• Improved configuration descriptions and removed pack-specific references.

• Preserved existing settings during updates.

• Maintained compatibility modules and existing stat balance.

Designed for Players and Modpack Developers

LevelZ+ can be used as a lightweight compatibility addition, a configurable stat expansion, or a broader progression extension for multiplayer servers.

Use the integrations you need. Disable the ones you don’t.

One mod. More meaningful progression. Fully configurable.