Adventurer's Stats

Adventurer's Stats is a progression-based RPG character stats system for Minecraft 1.20.1 Fabric, designed to give players meaningful character progression throughout their journey.

Gain Attribute XP through combat, earn Attribute Points as you progress, and invest them into your character's attributes. Each attribute can affect multiple vanilla and modded attributes, allowing different builds and playstyles.

The mod also includes a detailed attribute breakdown system that shows exactly how each attribute is calculated and where its modifiers come from.

Features

• RPG Attributes — Includes STR, INT, VIT, AGI, DEX, CRT, and LUCK.
• Attribute Progression — Gain Attribute XP, level up, and earn Attribute Points.
• Persistent Progression — XP, levels, earned points, and allocated attributes are saved with the player.
• Configurable Attributes — Configure attribute effects, limits, values, operations, and supported attribute IDs.
• Combat XP — Defeating eligible vanilla and modded entities can grant Attribute XP.
• Attribute Breakdown — View how attributes are calculated from their base value, modifiers, and final result.
• Modifier Source Detection — Identify where compatible attribute modifiers come from.
• Skill Tree Support — Detect attribute modifiers granted by supported skill systems and associate them with their corresponding skills.
• Adventurer Profile — View your character progression, attributes, available points, and other RPG information.
• 3D Character Display — View your character directly inside the RPG profile.
• Stat Reset Orb — Reset allocated Attribute Points while keeping your progression.
• Zero-Value Filtering — Modifiers with a value of 0 are ignored by the attribute breakdown.
• Optional Integrations — Supports additional RPG, skill, magic, and attribute systems without making them required dependencies.
• Standalone Design — The core progression system works independently.

RPG Attributes

STR — Strength

Focused on physical combat.

By default, STR can affect:

• Attack Damage
• Melee Damage
• Armor Piercing

INT — Intelligence

Focused on magic and magical defense.

By default, INT can affect:

• Magic Damage
• Magic Resistance
• Spell Power
• Spell Resistance

VIT — Vitality

Focused on survivability.

By default, VIT can affect:

• Max Health
• Armor
• Melee Resistance

AGI — Agility

Focused on movement and combat speed.

By default, AGI can affect:

• Attack Speed
• Movement Speed
• Sprinting Speed

DEX — Dexterity

Focused on ranged combat.

By default, DEX can affect:

• Projectile Damage
• Ranged Damage
• Ranged Weapon Damage
• Bow Projectile Speed
• Crossbow Projectile Speed

CRT — Critical

Focused on critical attacks.

By default, CRT can affect:

• TieredZ Critical Chance
• Spell Power Critical Chance
• Spell Power Critical Damage

LUCK — Luck

Focused on luck-based systems.

By default, LUCK can affect:

• Minecraft Luck
• Fortune
• Compatible luck-based systems

All attribute effects can be customized through the configuration.

Attribute Details

The original Attribute Breakdown system is now integrated directly into Adventurer's Stats.

The detailed attribute interface shows the complete calculation of an attribute, including:

• Base Value
• Additions
• Base Multipliers
• Total Multipliers
• Final Value
• Active Modifiers
• Modifier Sources

Compatible modifiers can be identified and displayed using their actual source instead of appearing only as an unknown synchronized modifier.

Modifiers with a value of 0 are ignored because they do not contribute to the calculation.

Progression

Players gain Attribute XP through combat and other configured progression sources.

As players progress, they earn Attribute Points that can be invested into their RPG attributes.

The progression system can be configured to control:

• Maximum level
• Attribute Points
• XP requirements
• XP rewards
• Attribute limits
• Progression rewards
• Combat XP settings

Adventurer Profile

Press K or use the S button beside the inventory to open the Adventurer's Stats profile.

The profile allows players to view their progression and manage their attributes through a dedicated RPG interface.

Stat Reset Orb

Adventurer's Stats adds a Stat Reset Orb that can be used to reset allocated Attribute Points.

Resetting your attributes returns the spent points without removing your overall progression or earned XP.

Optional Integrations

Adventurer's Stats can integrate with the following optional mods:

• Adventurer's Titles
• Skill Tree (RPG Series)
• More RPG Classes - Skill Tree
• Pufferfish's Skills
• Pufferfish's Attributes
• Spell Power
• TieredZ
• Trinkets

These integrations are optional and are only used when the corresponding mods are installed.

Configuration

Adventurer's Stats creates its configuration inside:

config/adventurers_stats.json

Client-side settings are stored separately in:

config/adventurers_stats_client.json

The configuration allows you to customize progression, XP, Attribute Points, attribute limits, attribute effects, attribute IDs, modifier operations, and combat rewards.

Supported modifier operations include:

• ADDITION
• MULTIPLY_BASE
• MULTIPLY_TOTAL

Commands

Administrative commands require permission level 2.

Main command:

/adventurersstats

Alias:

/astats

Available commands include:

• /astats points add <amount>
• /astats points remove <amount>
• /astats xp add <amount>
• /astats reset
• /astats reset <player>
• /astats resetall confirm
• /astats reload

Persistent Progression

Player progression is stored persistently.

The following information is preserved:

• Adventurer's Stats XP
• Character level
• Available Attribute Points
• Total points earned
• STR
• INT
• VIT
• AGI
• DEX
• CRT
• LUCK

This progression is separate from Minecraft's normal XP system.

Vanilla Compatibility

Adventurer's Stats uses Minecraft's existing attribute system to apply RPG stat effects.

Vanilla and modded attributes can be used through their registered attribute IDs, allowing the system to work alongside different RPG, combat, magic, and equipment mods.

Missing optional attributes are simply skipped without preventing the rest of the system from working.

Installation

Install Adventurer's Stats on both the client and server.

Requirements

• Minecraft 1.20.1
• Fabric
• Fabric API
• Java 17+

Optional integrations are not required for the core system.

Compatibility

Minecraft 1.20.1

Fabric

Java 17+

Client & Server

Credits

Created by zClashTM.

License

Adventurer's Stats is licensed under the MIT License.