lilend's Simple Economy

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

Building from Source Requirements: JDK 21+, Git git clone https://github.com/lilend/LilendsSimpleEconomy.git cd LilendsSimpleEconomy ./gradlew build Output: build/libs/LilendsSimpleEconomy-1.1.jar

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