Overview#
PlayerEx is a robust RPG-themed modification for Minecraft that introduces a sophisticated attribute system, character leveling, and skill point allocation. Designed to transform the standard survival experience into a progression-heavy RPG, it allows players to earn experience, level up their character, and invest points into various primary and secondary attributes.
The mod is built upon the Fabric ecosystem and utilizes the Data Attributes API, making it highly compatible with other mods that introduce custom damage types or additional player stats. It provides a custom interface for managing character growth and offers server administrators extensive control over leveling formulas and attribute caps.
Attributes#
Attributes are the core of PlayerEx. They are divided into Primary Attributes (which players directly invest in) and Secondary Attributes (which are derived from primary stats or gear).
Primary Attributes
Players can increase these attributes using Skill Points earned through leveling.
| Attribute | Description | Default Bonus per Point |
|---|---|---|
| Constitution | Increases the player's survivability. | +2 Max Health (1 Heart) |
| Strength | Increases physical power. | +0.5 Melee Damage |
| Dexterity | Increases speed and agility. | +0.1 Attack Speed, +0.01 Movement Speed |
| Intelligence | Increases magical aptitude and healing. | +0.2 Magic Damage, +0.1 Heal Amplification |
| Luck | Increases general fortune. | +1.0 Luck |
Secondary Attributes
Secondary attributes are often influenced by primary attributes or external factors like enchantments and equipment.
| Attribute | Effect |
|---|---|
| Evasion | The percentage chance to completely dodge an incoming physical attack. |
| Lifesteal | A percentage of damage dealt that is returned to the player as health. |
| Critical Hit Chance | The probability that a melee attack will deal critical damage. |
| Critical Hit Damage | The multiplier applied to damage when a critical hit occurs. |
| Magic Resistance | Reduces damage taken from magical sources (potions, spells). |
| Heal Amplification | Increases the effectiveness of all incoming healing sources. |
| Armor & Toughness | Standard Minecraft armor stats, integrated into the PlayerEx UI for tracking. |
Leveling and Skill Points#
The leveling system in PlayerEx replaces or augments the traditional Minecraft XP system. Instead of using XP solely for enchanting, players use it to increase their global PlayerEx Level.
Gaining Levels
Players can access the PlayerEx GUI (default key: L) to spend their accumulated Minecraft Experience Levels to purchase a PlayerEx Level.
- Leveling Up: Each time a player levels up, they consume a specific amount of XP and receive one Skill Point.
- XP Cost: The cost of each subsequent level increases. The default formula is generally defined as
100 + (level * 50), though this is fully customizable via the configuration files.
Spending Skill Points
Skill Points are spent within the Attributes tab of the GUI. Clicking the plus icon next to a Primary Attribute (Strength, Constitution, etc.) will consume one point and permanently increase that stat.
Leveling Mechanics
- Level Cap: By default, there is no hard cap on levels, but administrators can set one in the config.
- Death Penalty: Depending on server configuration, players may lose a percentage of their attributes or levels upon death. By default, levels and spent points are preserved.
User Interface#
PlayerEx adds a custom screen that serves as the central hub for character management.
- Accessing the Menu: Press the L key (configurable in controls) to open the interface.
- Attributes Tab: Displays all current stats, including those granted by armor and weapons. This is where Skill Points are allocated.
- Visual Indicators: The UI provides a clear breakdown of "Base" stats versus "Modified" stats (stats boosted by gear appear in different colors).
Mechanics#
Combat Calculations
PlayerEx modifies how damage and defense are calculated to accommodate the new attributes:
- Evasion: If a player has 10% Evasion, every incoming melee attack has a 10% chance to be negated entirely. A "Dodge" message or sound typically indicates a successful evasion.
- Lifesteal: If a player has 5% Lifesteal and deals 10 damage, they will recover 0.5 health points. This is highly effective for fast-attacking builds (Dexterity-focused).
- Critical Hits: Unlike vanilla critical hits (which require falling), PlayerEx critical hits are chance-based. If a player has a 20% Crit Chance, one in five hits will trigger the Critical Hit Damage multiplier.
Resistance Attributes
PlayerEx includes specific resistance attributes that can be modified by gear or data packs:
- Fire Resistance: Reduces damage from fire and lava.
- Freeze Resistance: Reduces damage from powder snow and freezing effects.
- Lightning Resistance: Reduces damage from lightning strikes.
- Poison/Wither Resistance: Reduces the tick damage from these status effects.
Commands#
Administrators can use the following commands to manage player progression. Replace <player> with a username and <amount> with a number.
| Command | Description |
|---|---|
/playerex level <player> add <amount> |
Adds levels to a player without consuming XP. |
/playerex level <player> set <amount> |
Sets a player's level to a specific value. |
/playerex level <player> get |
Displays the current level of a player. |
/playerex skill_points <player> add <amount> |
Grants extra skill points to a player. |
/playerex attribute <player> <attribute> get |
Checks the value of a specific attribute. |
/playerex reset <player> |
Resets all attributes and levels for a player, returning their skill points. |
/playerex refund <player> <amount> |
Returns a specific number of skill points to the player's pool. |
Configuration#
The mod is highly configurable via the playerex-server.toml (or .json in some versions) file located in the server's config folder.
Key Config Options
- Level Formula: Uses
exp4jexpressions to determine how much XP is needed for the next level. Example:100 + (level * 10)^1.2. - Skill Points per Level: Determines how many points a player receives upon leveling up (Default: 1).
- Initial Skill Points: How many points a player starts with when first joining the world.
- Reset on Death: If set to true, players will lose all levels and spent points when they die.
- Attribute Caps: Allows admins to set a maximum value for stats like Evasion or Lifesteal to prevent players from becoming invincible.
