Matija Stars
PluginLicenseRef-All-Rights-Reserved

Matija Stars

Stars is a lightweight and fully configurable currency plugin that rewards players for active playtime. Perfect for servers that want progression, leaderboards, and economy integration without performance impact.

6
Downloads
1
Followers
2 months ago
Updated
📦
1
Versions

📖About Matija Stars

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