Matija Stars

Stars - Lightweight Currency & Reward System

A simple yet powerful currency plugin that rewards players for active playtime. Perfect for servers looking to add an extra layer of progression without complexity.

---

Features

- Lightweight - Players earn Stars automatically for active play (AFK detection included) - Lightweight - Beautiful hex color gradients in all messages - Lightweight - Works as an economy provider for other plugins - Lightweight - Display Stars anywhere (TAB, scoreboard, holograms) - Lightweight - Every message, color, and value can be changed - Lightweight - No lag, no bloat, just works

---

Commands

/stars [player]

Check your Stars balance or view another player's balance. Displays with customizable gradient colors.

---

/starstop [page]

View the server leaderboard. Shows top players with pagination and displays your current position at the bottom.

Aliases: `/starslb`, `/topstars`, `/starsleaderboard`

---

/starsadmin

Admin commands to manage player Stars.

| Command | Description | |---------|-------------| | `/starsadmin give <player> <amount>` | Give Stars to a player | | `/starsadmin take <player> <amount>` | Remove Stars from a player | | `/starsadmin set <player> <amount>` | Set exact Stars amount | | `/starsadmin reset <player>` | Reset player to 0 Stars | | `/starsadmin reload` | Reload configuration |

---

Permissions

| Permission | Description | Default | |------------|-------------|---------| | `stars.use` | Use /stars command | Everyone | | `stars.top` | View leaderboard | Everyone | | `stars.earn` | Earn Stars from playtime | Everyone | | `stars.admin` | Full admin access | OP | | `stars.admin.give` | Give Stars to players | OP | | `stars.admin.take` | Take Stars from players | OP | | `stars.admin.set` | Set player Stars | OP | | `stars.admin.reset` | Reset player Stars | OP | | `stars.admin.reload` | Reload configuration | OP |

---

PlaceholderAPI

| Placeholder | Output | |-------------|--------| | `%stars_balance%` | Raw number (1000) | | `%stars_formatted%` | Formatted (1,000) | | `%stars_display%` | With symbol (* 1,000) | | `%stars_gradient%` | Gradient colored |

---

Configuration

All values are fully configurable:

- Number format - Minutes required to earn Stars (default: 10) - Number format - Min/max Stars earned per interval (default: 2-3) - Number format - Require player movement to prevent AFK farming - Number format - Custom hex colors for start/end gradient - Number format - Every message can be customized with hex color support - Number format - Customize thousands separator

---

Data Storage

- Player data stored in `data.yml` - Automatic saving (configurable interval) - Stores UUID, player name, and Stars balance - Offline player lookup support for leaderboard

---

Soft Dependencies

| Plugin | Purpose | |--------|---------| | Vault | Register as economy provider | | PlaceholderAPI | Enable placeholders | | LuckPerms | Permission management (any perm plugin works) |

---

Requirements

- Spigot / Paper 1.16.5 - 1.21+ - Java 11+

---

Support

Having issues or questions? Leave a message or open a ticket. Response within 24 hours.

---

Version: 1.0.0