!Banner

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.

!Stars Command

---

/starstop [page]

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

Aliases: /starslb, /topstars, /starsleaderboard

!Leaderboard

---

/starsadmin

Admin commands to manage player Stars.

!Admin Command

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