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 (lite.eco.player)
/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 <username> <amount> (currency):
  permissions: ["lite.eco.pay", "lite.eco.pay.(currency)"]
  description: "Sends money to another player."
Admin Commands (lite.eco.admin)
/eco add/set/withdraw <username> <amount> (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 <argument>:
  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 <failmode/janitor/inspect/stress>:
  permission: "lite.eco.admin.debug.*"
  description: "Advanced tools for database testing and synchronization."

Note: For deep debugging, use /eco debug <failmode|janitor|inspect|stress>.


📄 Configuration

Click to Expand config.yml

# 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: "<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: 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: '$ <money>'
      # 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: '€ <money>'
          # 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)

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

Sponsors

@Schneidertm

Information

CategoryEconomy
Published onMarch 28, 2023
LicenseUnspecified
Downloads496
Stars3
Watchers1

Pinned Versions

Members