# 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 - **Playtime Rewards** - Players earn Stars automatically for active play (AFK detection included) - **Gradient Text Support** - Beautiful hex color gradients in all messages - **Vault Integration** - Works as an economy provider for other plugins - **PlaceholderAPI Support** - Display Stars anywhere (TAB, scoreboard, holograms) - **Fully Configurable** - 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: - **Playtime interval** - Minutes required to earn Stars (default: 10) - **Reward range** - Min/max Stars earned per interval (default: 2-3) - **Activity detection** - Require player movement to prevent AFK farming - **Gradient colors** - Custom hex colors for start/end gradient - **Messages** - 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