Skip to content

README.md

Latest commit

 

History

History
23 lines (20 loc) · 1.1 KB

README.md

File metadata and controls

23 lines (20 loc) · 1.1 KB

KStats

A Modern and Lightweight Player Stat Management Plugin for Minecraft Servers

📊 Features

  • Core Player Stats: Health, Defense, Strength, Speed, Crit Chance, Crit Damage, Base Damage, Damage Multiplier, Mending
  • ⚠️ Wisdom stat interaction is currently in development

🧮 Stat Calculation Architecture

Player attributes are computed using a centralized Total Aggregator system:

  1. Extensible API: Provides interfaces/abstract classes for plugins to implement custom Sub-Aggregators
  2. Attribute Compilation:
    • Total Aggregator collects data from all registered Sub-Aggregators
    • Sums values from all contributors
    • Updates cached player attributes
  3. Event-Driven Updates:
    • Triggers AttributeUpdateEvent containing:
      • Player instance
      • Full attribute bundle
    • Allows attribute listeners to dynamically update player state (movement speed, health, etc.)
  4. Dynamic Synchronization: Enables custom listeners to react to real-time stat changes

The example of data contributor can be found here.