Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for EncryptSL

EconomyPlugin, Economy, Money, LiteEco

Report 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 <player> <amount> [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 <account> [currency] Create a new economy account.
(Requires confirmation unless bypassed)
Bypass Perm:
lite.eco.admin.bypass.confirmation
lite.eco.admin.create
/eco add <player> <amount> [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 <player> <amount> [currency] Set player's balance Uses @a when no players are online lite.eco.admin.set
/eco withdraw <player> <amount> [currency] Withdraw from player's account Vanilla selector compatible lite.eco.admin.withdraw
/eco delete <account> [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 <argument> [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 <argument> [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 <plugin> [into_currency] [--from <currency>] 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 <lang_key> 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 <player> 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 <player> Displays a detailed readout of the player's internal cache. lite.eco.admin.debug.inspect
/eco debug stress <player> [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 <target> [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: 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: <dark_gray>[<green>Eco<dark_gray>] <dark_green>»</dark_gray>
  # 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 '<money>' 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: $ <money>
      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)

https://bstats.org/signatures/bukkit/liteeco.svg

Sponsors

@Schneidertm

Information

Category
Economy
Published
March 28, 2023
License
Unspecified
640Downloads
3Stars

Pinned Versions

Members

1