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
