wi‐ki

📖 EasySpin Wiki

Welcome to the official EasySpin wiki! This page covers everything you need to install, configure, and use the plugin on your server.

📦 Installation

Download the latest EasySpin-x.x.x.jar from the Versions tab
Place it in your server's /plugins/ folder
Install Vault and a compatible economy plugin (e.g. EssentialsX)
Start or restart your server
EasySpin will generate config.yml and messages.yml inside /plugins/EasySpin/

✅ Requirements

Requirement	Version
Paper / Spigot	1.26.2+
Java	21+
Vault	Any
Economy plugin	EssentialsX, CMI, etc.

⚠️ Vault is required. Without it, economy rewards will not work. EasySpin will warn you in the console if Vault is missing.

🎮 How It Works

A player runs /espin
The EasySpin GUI opens — click the emerald to spin
An animated action bar shows spinning numbers for a few seconds
A reward is drawn from one of 4 rarity tiers (Common → Legendary)
The reward is deposited into the player's Vault balance
The player must wait 24 hours (configurable) before spinning again

📋 Commands

Command	Description	Permission
`/espin`	Open the spin GUI	`easyspin.use`
`/spinstats`	View your spin history and earnings	`easyspin.stats`
`/spinadmin reload`	Reload config without restarting	`easyspin.admin`
`/spinadmin reset <player>`	Reset a player's stats and cooldown	`easyspin.admin`

Aliases: /espin can also be run as /spin

🔐 Permissions

Permission	Default	Description
`easyspin.use`	Everyone	Allows using `/espin`
`easyspin.stats`	Everyone	Allows using `/spinstats`
`easyspin.admin`	OP only	Allows using `/spinadmin`

⚙️ Configuration

Located at /plugins/EasySpin/config.yml

# How many hours a player must wait between spins
cooldown-hours: 24

reward:
  common:
    min: 10       # Minimum reward amount
    max: 50       # Maximum reward amount
    chance: 50    # % chance of getting this tier

  rare:
    min: 51
    max: 150
    chance: 30

  epic:
    min: 151
    max: 300
    chance: 15

  legendary:
    min: 301
    max: 500
    chance: 5

💡 Tip: All four chance values must add up to 100 or the lowest tier will fill the remainder automatically.

After editing, run /spinadmin reload to apply changes without restarting.

🏆 Reward Tiers

Tier	Default Range	Default Chance
🟢 Common	₹10 – ₹50	50%
🔵 Rare	₹51 – ₹150	30%
🟣 Epic	₹151 – ₹300	15%
🟡 Legendary	₹301 – ₹500	5%

💾 Data Storage

EasySpin uses a SQLite database stored at /plugins/EasySpin/easyspin.db.

The following data is saved per player:

Total number of spins
Total amount earned
Timestamp of last spin (used for cooldown — survives server restarts)

No external database setup is required.

❓ FAQ

Q: Can players spin more than once a day? No. The cooldown is enforced per UUID and persists across server restarts via the database.

Q: What happens if Vault is not installed? EasySpin will load but economy rewards will be disabled. A warning will appear in the console.

Q: Can I change the currency symbol? The ₹ symbol in messages is part of your economy plugin's display format — change it there.

Q: Does this work with offline/offline-mode servers? Yes, player data is stored by UUID so it works on both online and offline mode servers.

Q: Can I reset a player's cooldown so they can spin again immediately? Yes — run /spinadmin reset <playername>. This clears their stats and cooldown.

🐛 Support

Found a bug or have a suggestion? Open an issue or leave a comment on the Modrinth project page.

Navigation Menu