Lilend's Simple Economy (LSE)
Version: 1.1 | Language: Kotlin (JVM 21) | Platform: Paper / Purpur 1.21+ | Author: lilend | API: LSEAPI, Vault, PlaceholderAPI
A lightweight, secure, modern economy plugin for Minecraft Paper 1.21+ servers.
Features
- Player balances (YAML / MySQL / MariaDB / SQLite)
- Physical check items (right-click to redeem via GUI)
- Player-to-player payments with confirmation GUI
- Balance leaderboard (/baltop)
- Admin commands (add, remove, set, reload)
- Transaction tax system (configurable rate & per-feature)
- Auto-save mechanism (configurable interval)
- Vault API hook (QuickShop, ChestShop, GriefPrevention, etc.)
- PlaceholderAPI expansion (%lse_balance%, %lse_balancetop_1%, etc.)
- Public developer API (LSEAPI object)
- Fully customizable messages with & color codes and placeholders
- Per-command permissions (default true or op)
- Toggleable features (checks, transfers, tax)
- Transaction logging with daily rotation
- Security validation (overflow protection, NaN checks, balance caps)
- Compact number format: 1K, 1M, 1B, 1T ... Dd (Duodesillion)
- Database support: YAML (default), MySQL, MariaDB, SQLite (v1.1)
Commands
/balance or /bal - Show your balance - lse.balance
/balance <player> - Show another player's balance - lse.balance.others
/pay <player> <amount> - Send money to a player - lse.pay
/check <amount> - Create a physical check - lse.check
/baltop or /top - Balance leaderboard - lse.baltop
/lse add <player> <amount> - Add money to a player - lse.lse.add
/lse remove <player> <amt> - Remove money from a player - lse.lse.remove
/lse set <player> <amount> - Set a player's balance - lse.lse.set
/lse balance [player] - View any player's balance - lse.lse.balance
/lse reload - Reload config, messages & storage - lse.lse.reload
Permissions
lse.balance - true - Check your balance
lse.balance.others - true - Check others' balances
lse.pay - true - Send money to players
lse.check - true - Create physical checks
lse.baltop - true - View balance leaderboard
lse.lse - op - Admin commands base
lse.lse.add - op - Add money to a player
lse.lse.remove - op - Remove money from a player
lse.lse.set - op - Set a player's balance
lse.lse.balance - op - View any balance via /lse
lse.lse.reload - op - Reload plugin configuration
lse.tax.exempt - op - Exempt from transaction taxes
lse.admin - op - All admin permissions (inherits all lse.lse.*)
Database Support (v1.1)
Three storage backends are supported:
storage:
type: yaml # yaml, mysql, mariadb, sqlite
mysql:
host: localhost
port: 3306
database: minecraft
username: root
password: ""
pool-size: 10
sqlite:
file: data.db
- YAML (default): balances.yml, no extra dependencies
- MySQL / MariaDB: HikariCP connection pool, high performance
- SQLite: Single file, no setup required
Use /lse reload to switch storage types (auto-saves before switching).
Installation
1. Download LilendsSimpleEconomy-1.1.jar
2. Place it in your server's plugins/ folder
3. (Optional) Install Vault.jar for cross-plugin economy support
4. (Optional) Install PlaceholderAPI for placeholder expansion
5. Restart or reload your server
6. Edit config.yml and messages.yml to your liking
7. Run /balance to verify
Changelog
v1.1
- MySQL, MariaDB and SQLite database support (HikariCP connection pool)
- /lse reload now also reloads balance manager and storage
- Check item lore now reads from messages.yml (fully customizable)
- Storage connection leak fixed on reload
- Modular StorageAdapter architecture for easy backend switching
v1.0 - Initial release
- Player balances with YAML persistence
- Physical check system (right-click redeem with GUI)
- Player-to-player payments with confirmation GUI
- Balance leaderboard (/baltop)
- Admin commands (/lse add/remove/set/balance/reload)
- Vault API integration & PlaceholderAPI expansion
- Transaction tax system & auto-save mechanism
- Compact number format (K, M, B, T ... Dd)
- Fully customizable messages & thread-safe balance management
- Security validation (overflow, NaN, rounding)
- Transaction logging with daily rotation
