LiteEco

 [Documentation](https://liteeco.github.io/) | [Permissions](https://liteeco.github.io/docs/user-guide/commands-permissions) | [Placeholders](https://liteeco.github.io/docs/user-guide/placeholders) | [Debugging](https://liteeco.github.io/docs/user-guide/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](https://papermc.io/) or [Folia](https://github.com/PaperMC/Folia) (Full Multi-threading support!) * **Paper API:** Required. This plugin will **NOT** work on standard Spigot/CraftBukkit. * **Vault Support:** [Vault](https://www.spigotmc.org/resources/vault.34315/) or [VaultUnlocked](https://www.spigotmc.org/resources/vaultunlocked.117277/) * **Permissions:** [LuckPerms](https://www.spigotmc.org/resources/luckperms.28140/) (Recommended) **🔌 Integrations** * **PlaceholderAPI:** [Download](https://www.spigotmc.org/resources/placeholderapi.6245/) * **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 ```yaml # Official settings for this plugin. # You can see our official wikipedia page: https://liteeco.github.io/ plugin: # List of supported locales for translations. # See more at: https://github.com/EncryptSL/LiteEco/tree/main/src/main/resources/locale 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 https://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)