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** (lite.eco.player) ```yaml /money help: permission: "lite.eco.help" description: "Displays help for all available player commands." /money bal [username] (currency): permissions: ["lite.eco.balance", "lite.eco.balance.others", "lite.eco.balance.(currency)"] description: "Check your balance or others. Supports multiple currencies." /money top: permission: "lite.eco.top" description: "Displays the leaderboard of the wealthiest players." /money pay (currency): permissions: ["lite.eco.pay", "lite.eco.pay.(currency)"] description: "Sends money to another player." ``` #### **Admin Commands** (lite.eco.admin) ```yaml /eco add/set/withdraw (currency): permissions: ["lite.eco.admin.add", "lite.eco.admin.set", "lite.eco.admin.withdraw"] description: "Manage player balances. Supports vanilla selectors (@a, @p)." /eco database import/export : permission: "lite.eco.admin.import" / "lite.eco.admin.export" description: "Manage database migrations. Now includes faster batch processing." /eco config lang/reload: permission: "lite.eco.admin.lang" / "lite.eco.admin.reload" description: "Quickly change language or reload configuration files." /eco debug : permission: "lite.eco.admin.debug.*" description: "Advanced tools for database testing and synchronization." ``` > **Note:** For deep debugging, use /eco debug . --- ### 📄 Configuration Click to Expand config.yml ```yaml # Official settings for this plugin. plugin: # List of supported locales for translations. # See more at: https://github.com/EncryptSL/LiteEco/blob/main/src/main/kotlin/encryptsl/cekuj/net/api/enums/LangKey.kt 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: false # Settings for player suggestions in commands. # Enabled: Suggests offline players. # Disabled: Suggests only online players. offline-suggestion-players: true economy: currencies: # Applicable since version 1.4.8 and newer. # Do not change this currency key as it is integrated with Vault. # The key of each currency corresponds to its table name in the database. # Changing this value may result in data loss. dollars: currency_name: dollars currency_plural_name: dollars currency_singular_name: dollar # Format for displaying currency values. currency_format: '$ ' # The initial amount granted to new players who do not have an existing account. starting_balance: 30 # The maximum allowed balance for a player. balance_limit: 1000000 # Enable or disable the balance limit check. # If disabled, players can exceed the limit through paid amounts, or amounts given/set by administrators. balance_limit_check: true # Convert large currency values into a more compact format (e.g., 1,000,000 to 1M). compact_display: false # Top Leader Settings top_balances: # 'filtering' determines whether the 'blacklist' should be applied to exclude specific player names # from the TOP balance leaderboards. Note: Names like 'NULL', 'CONSOLE', and 'SERVER' are always filtered out internally. filtering: false # A list of player names that will be EXCLUDED from the TOP leaderboards. # This list is only applied if 'filtering' is set to 'true'. # Names in this list are compared in a case-insensitive manner. blacklist: - ExamplePlayerName - TestAccount123 - Notch # Example of an additional currency. # Do not change this currency key as it is integrated with Vault. # The key of each currency corresponds to its table name in the database. # Changing this value may result in data loss. # credits: # currency_name: credits # currency_plural_name: credits # currency_singular_name: credit # Format for displaying currency values. # currency_format: '€ ' # The initial amount granted to new players who do not have an existing account. # starting_balance: 30 # The maximum allowed balance for a player. # balance_limit: 1000000 # Enable or disable the balance limit check. # If disabled, players can exceed the limit through paid amounts, or amounts given/set by administrators. # balance_limit_check: true # Convert large currency values into a more compact format (e.g., 1,000,000 to 1M). # compact_display: false # Top Leader Settings # top_balances: # 'filtering' determines whether the 'blacklist' should be applied to exclude specific player names # from the TOP balance leaderboards. Note: Names like 'NULL', 'CONSOLE', and 'SERVER' are always filtered out internally. # filtering: false # A list of player names that will be EXCLUDED from the TOP leaderboards. # This list is only applied if 'filtering' is set to 'true'. # Names in this list are compared in a case-insensitive manner. # 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 global chat when money is added. notify_add: true # Notify global chat when money is withdrawn. notify_withdraw: true # Notify global chat when money is set. notify_set: true target: # Notify the target player when money is added to their account. notify_add: true # Notify the target player when money is withdrawn from their account. notify_withdraw: true # Notify the target player when their money is set. 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. driverClassName: "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: user_name # 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: false ``` --- ### 📺 Media Showcase (Germany)