Matija StarsСкачать
ВЕРСИИ (1)
release
Matija Stars 1.0.0
1.0.024 янв. 2026 г.48Minecraft: 1.20.4bukkit, paper, purpur, spigot
Что нового

# 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