# AstralisPlaytime

**Reward your players for actually playing — not just being online.**
AstralisPlaytime is a modern playtime rewards plugin for **Paper** and **Folia**, featuring smart AFK detection, clean GUI claiming, and optional cross-server sync.

## Why AstralisPlaytime?

- **Accurate Playtime Tracking**
Advanced AFK detection prevents idle farming and keeps progression fair.

- **Modern Reward GUI**
Players can claim rewards in an intuitive menu with clear status states (locked / unlocked / claimed).

- **Paper + Folia Support**
Built for modern server performance and compatibility.

- **Single-Server or Network Mode**
Use it with **SQLite** out of the box, or scale with **MySQL/MariaDB + Redis**.

- **Admin-Friendly**
Reload config without restart, manage player playtime, debug reward states.

- **PlaceholderAPI Ready**
Integrate playtime values easily into scoreboards, chat formats, and other plugins.

## Core Features

- Configurable playtime milestones and rewards
- Granular AFK event handling (move/chat/command/combat/etc.)
- One-time reward claims with permission checks
- Fast and lightweight architecture
- Clean MiniMessage-based text formatting
- Built-in pagination for large reward sets

## Commands

- `/playtime`
- `/playtime rewards`
- `/playtime claim <id>`
- `/playtime admin reload`
- `/playtime admin set <player> <seconds>`
- `/playtime admin add <player> <seconds>`
- `/playtime admin reset <player>`
- `/playtime admin reward debug <player>`

## Permissions

- `astralis.playtime.use`
- `astralis.playtime.admin`
- `astralis.playtime.toggle.bypass`

## Quick Setup

1. Drop the jar into your `plugins` folder
2. Start server once to generate configs
3. Configure `config.yml`, `rewards.yml`, `messages.yml`
4. Use `/playtime admin reload` and you’re ready

---

Built for servers that want **clean progression**, **fair rewards**, and **modern performance**.