MetaStats

# MetaStats v1.0.0 - Release Notes

**Release Date:** October 17, 2025

## What's New

Initial release of MetaStats - Professional item statistics tracking system.

## Core Features

### Statistics Tracking
- Tools: blocks mined tracking
- Weapons: damage, kills, critical hits tracking
- Armor: damage absorbed, hits taken tracking
- Elytra: flight time, distance tracking

### Rarity System
- 5 rarity levels: Common, Uncommon, Rare, Epic, Legendary
- Automatic progression based on usage
- Legendary items display particle effects

### Multi-Language Support
- English, Portuguese (BR), Spanish, Italian, Russian, Chinese
- Fully customizable language files

### Quality of Life
- Auto-save system (configurable interval)
- Achievement notifications
- NBT-based persistence (no database)
- Lightweight and optimized

## Compatibility

- Minecraft: 1.17 - 1.21
- Server: Spigot, Paper, Purpur
- Java: 8+

## Installation

1. Download MetaStats.jar
2. Place in plugins/ folder
3. Restart server

## Configuration

Default config generated on first run in `plugins/MetaStats/config.yml`

## Commands

- `/metastats reload` - Reload plugin configuration

## Permissions

- `metastats.admin` - Access to reload command

## Known Issues

None at release.

## Future Plans

- PlaceholderAPI integration
- Leaderboards system
- Additional statistics
- MySQL support

## Download

Available on SpigotMC and GitHub.

---

**Full Changelog:** Initial Release