🛡️ Player Stats

A lightweight and highly configurable progression system for Minecraft players. Gain upgrade points by defeating mobs — then choose which attributes you want to improve. Fully supports modded mobs and attributes through a powerful configuration system.

📦 Overview

Player Stats is a Forge mod that introduces a customizable RPG-like system where players earn upgrade points by killing mobs. Unlike other mods of the same style, attributes are loaded dynamically — meaning that attributes from mods like Iron’s Spells ‘n Spellbooks and Epic Fight can also be upgraded. Built with compatibility, performance, and configurability in mind.

🎯 Features

✅ Gain upgrade points from killing mobs

🛠️ Manually allocate points to any supported attribute

⚙️ Configure which mobs give points and their drop chances

🧠 Smart caching of config values for better performance

🧪 Debug mode to help identify entity and attribute names

🔁 Supports custom attributes (modded or vanilla)

🧟 Customizable chance for bosses like the Wither, Ender Dragon, Warden, and more

🚫 Ignore specific attributes from appearing in the UI (enable debug mode to see the ID's hovering the attributes on the main screen)

🔧 Easy configuration via playerstats-common.toml

🎮 How It Works

Kill a mob (configured mob or boss) → chance to earn 1 upgrade point

Points are saved per player

Press your configured key (default: R) to open the upgrade screen

Choose the attribute you want to improve — spending points and XP

🔧 Example Config

[geral]
debugMode = true
highHealthAmount = 50
customMobChances = ["entity.minecraft.chicken=0.15", "entity.mymod.bossmob=0.75"]
customAttributeIncrement = ["attribute.name.generic.max_health=2.0"]
ignoredAttributes = ["attribute.name.generic.armor"]

⚔️ Supported Entities

Fully supports both vanilla and modded mobs

Add your own mobs using customMobChances in the config

Enable debugMode = true to print killed mob IDs logs on the console

🧩 Modded Compatibility

✅ Works with:

Custom mobs (using standard EntityType)

Custom attributes from other mods (e.g., Epic Fight, Iron’s Spells ‘n Spellbooks)

All standard Forge-based server/client environments

✨ What's New 1.7.0

🌀 Upgrade Rune – a special item that gives attribute points.

📜 Attribute Boost Scroll – grants temporary attribute bonuses, allowing flexible combat builds.

💎 Ability Crystal – a rare crystal that unlocks unique abilities for the player.

⚔️ Extra Feature: you can now modify attributes and add abilities directly to mobs — expanding customization and making encounters even more challenging.

🛡️ Abilities Update 1.8.0

🔹 Follow Owner

Available for mount-type mobs and Iron Golems.

The mob will follow the player who bound it as an owner, similar to pets.

🔹 Teleport to Owner (requires Follow Owner)

Available for mount-type mobs and Iron Golems. If the mob gets too far from the owner, it will automatically teleport close to them.

Helps in situations where the mob gets lost or stuck.

🛡️ Taunt

Available for Iron Golems and Wolves. Provokes nearby enemies, forcing them to target the mob instead of the owner.

Range of 16 blocks.
Emits anger particles when activated.
Attracts enemies for 30 seconds.
After activation, enters a 60-second cooldown before it can be used again.

🛡️ Defend Owner

Available for Iron Golems. Automatically attacks any hostile entity that tries to attack the owner.

Works passively.
If the player is attacked, the golem immediately acts to defend them.

⚔️ Ability Combination

Taunt + Defend Owner form a dual defense:

Taunt draws enemies to the golem, diverting attention from the player.
Defend Owner ensures that even if an enemy ignores Taunt and attacks the player, the golem reacts instantly.
Together, these abilities turn the golem into a true personal guardian, capable of actively and strategically protecting the owner.

🛡️ Patrol

Available for Iron Golems and Wolves. When activated, this ability makes the mob act as a sentinel at its location.

Begins patrolling automatically within a 16-block radius, monitoring the area.
Any hostile entity invading the territory is immediately attacked.
Unlike Follow Owner and Defend Owner, which are player-focused, Patrol keeps the mob stationed, ensuring security of a specific point. (Cannot work together with Follow Owner and Teleport to Owner)

👁️ Patrol Vision

Available for Parrots. While the mob is in Patrol mode, it activates enhanced environmental vision.

This ability allows it to detect enemies at a distance within a 16-block radius, even through obstacles.
Enemies detected by Patrol Vision can be highlighted with a Glowing effect, making identification easier.

💚 Life Regeneration

Available for all living entities except the player. Applies permanent Level 1 regeneration, increasing survival and reducing the need for player intervention.

When combined with defensive abilities like Taunt or Defend Owner, the mob can hold off more enemies for longer, as it can heal while fighting.

❄️ Frost Walker

Available for mount-type mobs. The mob freezes water beneath its feet while moving, creating temporary solid ice blocks that allow crossing rivers, lakes, and oceans easily, just like the Frost Walker enchantment.

🐺 Howl Buff

Available for wolves.

When entering combat, the wolf emits a powerful howl that inspires nearby allies, temporarily strengthening them.
Upon detecting an enemy, the wolf emits a howl that grants attribute bonuses (such as strength, speed, or resistance) to itself and allies within range.
Duration: The effect lasts for 30 seconds, followed by a 5-minute cooldown before it can be used again.

❤️ Rebirth

Works with mobs and players (for players, only in Hardcore mode).

When an entity with the Rebirth ability dies, it drops a Soul Fragment. To perform the Rebirth Ritual, a player must place a Soul Fragment and a Soul Stone on a charged Respawn Anchor, along with an equivalent entity as a sacrifice (for players, use a Villager).
The ritual causes minor damage in the surrounding area and leaves both the executor and the revived entity on the brink of death, with extreme hunger and temporary weakness effects, requiring care and strategy to survive.

💎 Soul Stone – Can be found in End Cities, Ancient Cities, and Bastions. Used to revive entities.

🔹 Soul Fragment – Mobs with the Rebirth ability drop a Soul Fragment so they can be revived.

🧑‍💻 For Modpacks & Developers

Mod ID: playerstats

No mixins or coremod hacks

Lightweight and runtime-friendly

Easy to configure and extend

📜 License This mod is licensed under the MIT License. You're free to use it in modpacks, forks, and redistribution — just credit the original project.