LiteEco

Documentation | Permissions | Placeholders | Debugging

💡 About the Project

LiteEco is a high-performance, lightweight economy solution designed for modern Minecraft servers. After a short break, the project is back with full support for the latest server software and features.

⚙️ Requirements & Compatibility

• Server Software: Paper or Folia (Full Multi-threading support!)
• Paper API: Required. This plugin will NOT work on standard Spigot/CraftBukkit.
• Vault Support: Vault or VaultUnlocked
• Permissions: LuckPerms (Recommended)

🔌 Integrations

• PlaceholderAPI: Download
• MiniPlaceholders: Supported natively.

⚠️ Known Conflicts

• Towny: May break compatibility due to fake UUID generation.
• Proxy: No native BungeeCord/Velocity support.

📜 Commands & Permissions

👤 Player Commands

Permission: lite.eco.player

Command · Description · Permissions
/money · Main player command · lite.eco.money
/money help · Show command list · lite.eco.help
| /money bal [player] [currency] | Check your or another player’s balance | • lite.eco.balance (Basic access)

• lite.eco.balance.your_currency
• lite.eco.balance.others
• lite.eco.balance.* (Full access) |

/money top [page] [currency] · Show the richest players · lite.eco.top
| /money pay [currency]
(Alias: /pay ...) | Send money to another player.
(Requires confirmation unless bypassed) | • lite.eco.pay.your_currency

• lite.eco.pay.*
• lite.eco.admin.bypass.confirmation (Bypass) |

🛠️ Admin Commands

Permission: lite.eco.admin

Extra Permission: lite.eco.suggestion.players (Suggest player nicknames to admins)

General & Balance Management

Command · Description · Notes / Examples · Permission
/eco · Main admin command · — · lite.eco.admin.eco
/eco help · Show admin commands · — · lite.eco.admin.help
| /eco create [currency] | Create a new economy account.
(Requires confirmation unless bypassed) | Bypass Perm:
lite.eco.admin.bypass.confirmation | lite.eco.admin.create |
| /eco add [currency] | Add money to a player | Compatible with vanilla selectors:
/eco add Notch 15 dollars
/eco add @a 15 dollars | lite.eco.admin.add |
/eco set [currency] · Set player's balance · Uses @a when no players are online · lite.eco.admin.set
/eco withdraw [currency] · Withdraw from player's account · Vanilla selector compatible · lite.eco.admin.withdraw
| /eco delete [currency] | Delete player's account and balance.
(Requires confirmation unless bypassed) | Example: /eco delete Notch dollars
Bypass Perm:
lite.eco.admin.bypass.confirmation | lite.eco.admin.delete |
/eco monolog [page] [player] · View transaction logs · Example: /eco monolog 1 Notch · lite.eco.admin.monolog

Database & Configuration Operations

Command · Description · Details / Options · Permission
| /eco database purge [currency] | Purge data from database.
(Requires confirmation unless bypassed) | Arguments: ACCOUNTS, TEST_ACCOUNTS, NULL_ACCOUNTS, DEFAULT_ACCOUNTS, MONOLOG
Bypass Perm: lite.eco.admin.bypass.confirmation | lite.eco.admin.purge |
| /eco database export [currency] | Export database.
(Requires confirmation unless bypassed) | Formats: SQL, CSV, LEGACY_TO_NEW, SQL_LITE_FILE
Bypass Perm: lite.eco.admin.bypass.confirmation | lite.eco.admin.export |
| /eco database import [into_currency] [--from ] | Import data from other plugins.
(Requires confirmation unless bypassed) | Plugins: EssentialsX, BetterEconomy, ScruffyBoyEconomy, EzEconomy, TheosisEconomy, CMIEconomy
Bypass Perm: lite.eco.admin.bypass.confirmation | lite.eco.admin.import |
/eco config lang · Change plugin language · Languages: CS_CZ, EN_US, ES_ES, JA_JP, DE_DE, PL_PL, PT_BR, TR_TR, ZH_CN · lite.eco.admin.lang
/eco config reload · Reload plugin config · — · lite.eco.admin.reload

🐞 Debug Commands

Command · Description · Permission
/eco debug failmode · Toggles database error simulation on/off. · lite.eco.admin.debug.failmode
/eco debug test-janitor · Runs an automated test simulating a database error and credits $500. · lite.eco.admin.debug.testjanitor
/eco debug janitor · Immediately triggers automatic synchronization. · lite.eco.admin.debug.janitor
/eco debug inspect · Displays a detailed readout of the player's internal cache. · lite.eco.admin.debug.inspect
/eco debug stress [iterations] · Runs a concurrent stress test for transaction atomicity. · lite.eco.admin.debug.stress
/eco debug stress-shutdown [accounts] · Run global shutdown sync stress test on multiple cached accounts. · lite.eco.admin.debug.stress
/eco debug dupe-test [source] [amount] [requests] [currency] · Runs a concurrent transfer dupe test to verify thread-safety locks and race condition prevention. · lite.eco.admin.debug.stress

📄 Configuration

Click to Expand config.yml

Official settings for this plugin.

You can see our official wikipedia page: liteeco.github.io/

plugin:

List of supported locales for translations.

See more at: github.com/EncryptSL/LiteEco/tree/main/src/main…

translation: en_us

Plugin prefix displayed in chat.

prefix: [Eco] »

Enable or disable plugin metrics collection.

metrics: true

Enable or disable Vault debug messages.

vault_debug: true

Settings for player suggestions in commands

true: Suggests offline players

false: Suggests only online players.

offline_suggestion_players: true
economy:

Applicable since version 1.4.8 and newer.

Currency Settings Guide:

- currency_name: Internal name of the currency.

- currency_plural_name: Name used when amount is plural (e.g., dollars).

- currency_singular_name: Name used when amount is singular (e.g., dollar).

- currency_format: Pattern for display. Use '' as a placeholder.

- starting_balance: The initial amount granted to new players.

- balance_limit: The maximum allowed balance for a player.

- balance_limit_check: If enabled, enforces the balance limit.

- compact_display: Converts large values into compact format (e.g., 1M).

The key of each currency corresponds to its table name in the database.

Changing this value may result in data loss.

currencies:
dollars:
currency_plural_name: dollars
currency_singular_name: dollar
currency_format: $
starting_balance: 30
balance_limit: 1000000
balance_limit_check: true
compact_display: false
top_balances:
filtering: false
blacklist:

• ExamplePlayerName
• TestAccount123
• Notch

Enable logging of economic activities such as adding, setting, withdrawing, and paying money.

View logs using the command: /eco monolog [player]

monolog_activity: true
formatting:

The format pattern for displaying currency values.

currency_pattern: '#,##0.00'

The format pattern for displaying compacted currency values.

compacted_pattern: '#,##0.0##'

The locale used for currency symbols and formatting.

currency_locale: en-US
placeholders:

Text displayed when a name placeholder is empty.

empty_name: EMPTY

These settings control message notifications.

messages:
global:
notify_add: true
notify_withdraw: true
notify_set: true
target:
notify_add: true
notify_withdraw: true
notify_set: true

Settings for database connection (SQLite, MySQL, MariaDB, PostgreSQL).

database:

Connection URL for the database. Examples:

SQLite: jdbc:sqlite:plugins/LiteEco/database.db

MySQL: jdbc:mysql://your_host:port/name_of_database

MariaDB: jdbc:mariadb://your_host:port/name_of_database

PostgreSQL: jdbc:postgresql://your_host:port/name_of_database

Database drivers:

MariaDB: org.mariadb.jdbc.Driver (Note: See youtrack.jetbrains.com/issue/EXPOSED-170 for potential issues)

MySQL: com.mysql.cj.jdbc.Driver (Do not use if you have MariaDB version 11.X or newer)

PostgreSQL: org.postgresql.Driver

SQLite: org.sqlite.JDBC

connection:

The full class name of the JDBC driver.

driver_class_name: org.sqlite.JDBC

The JDBC connection URL.

jdbc_url: jdbc:sqlite:plugins/LiteEco/database.db

The username for connecting to your database (MySQL/MariaDB/PostgreSQL only).

username: minecraft

The password for connecting to your database (MySQL/MariaDB/PostgreSQL only).

password: password

Enable SQL plugin logger for debugging database-related problems.

sql_plugin_logger: true

📺 Media

Showcase (Germany)