MeowEco Documentation

issues

MeowEco is a High-Efficiency, Lightweight, and Highly Compatible economy plugin designed for modern Minecraft servers.

✨ Key Features

• High Efficiency

  • Asynchronous I/O: All database operations (MySQL/SQLite) are performed asynchronously, ensuring zero impact on the main thread and maintaining stable TPS.
  • Smart Caching: Built-in high-performance caching mechanism reduces database query frequency significantly, providing instant response to balance checks.
  • Lightweight: Optimized codebase with minimal footprint. Database drivers are not shaded (uses server libraries or dynamic loading) to keep the jar size small.

• High Compatibility

  • Paper 1.21+ Ready: Fully compatible with the latest Paper 1.21.11+ core and newer versions.
  • Adventure API: Native support for the Adventure API, enabling modern chat formatting with MiniMessage and RGB color codes.
  • Vault Support: Fully implements the Vault Economy interface, ensuring seamless integration with shop plugins, land claim plugins, and GUIs.

• Feature Rich

  • Supports compact number formatting (e.g., 1.5K, 2.3M, 4.5B).
  • Flexible storage options: SQLite (local file) and MySQL (remote database).
  • Comprehensive PlaceholderAPI support.

1. Installation

1. Drop MeowEco-*.jar into your server's plugins/ folder.
2. Recommended: Install Vault to ensure compatibility with other plugins.
3. Optional: Install PlaceholderAPI if you need placeholders (e.g., for scoreboards).
4. Start the server to generate configuration files.

2. Configuration

2.1 config.yml (Main Config)

Location: plugins/MeowEco/config.yml

# Storage Settings
storage:
  # Database type: sqlite (local file) or mysql (remote)
  type: sqlite
  # MySQL settings (only used if type is mysql)
  mysql:
    host: localhost
    port: 3306
    database: minecraft
    username: root
    password: password
    ssl: false

# Currency Settings
currency:
  singular: "Coin"     # Name for singular amount
  plural: "Coins"      # Name for plural amount
  initial-balance: 0.0 # Starting balance for new players
  decimal-places: 2    # Decimal places to display (0-2)

2.2 messages.yml (Messages)

Location: plugins/MeowEco/messages.yml

Supports standard color codes (&) and MiniMessage format.

• prefix: Plugin message prefix
• Customizable messages for all events

3. Commands

3.1 Player Commands

Command	Description	Permission
/money	Check your balance	meoweco.balance
/money <player>	Check another player's balance	meoweco.balance.other
/pay <player> <amount>	Send money to another player	meoweco.pay
/baltop	View the richest players (Top 10)	meoweco.top

3.2 Admin Commands

Command	Description	Permission
/take <player> <amount>	Force take money from a player	meoweco.take
/eco give <player> <amount>	Give money to a player	meoweco.eco.give
/eco take <player> <amount>	Take money from a player	meoweco.eco.take
/eco set <player> <amount>	Set a player's balance	meoweco.eco.set
/eco hide <player>	Hide player from leaderboard	meoweco.admin
/eco unhide <player>	Show player in leaderboard	meoweco.admin
/eco refresh	Refresh leaderboard cache & fix names	meoweco.admin
/meoweco reload	Reload configuration	meoweco.admin

4. Permissions

All permissions are granted to OPs by default.

• meoweco.admin: Grants all permissions
• meoweco.balance: Allow checking own balance (Default: true)
• meoweco.balance.other: Allow checking others' balance (Default: op)
• meoweco.pay: Allow sending money (Default: true)
• meoweco.top: Allow viewing baltop (Default: true)
• meoweco.take: Allow force taking money (Default: op)
• meoweco.eco.give: Allow giving money (Default: op)
• meoweco.eco.take: Allow taking money (Default: op)
• meoweco.eco.set: Allow setting balance (Default: op)

5. Placeholders

Requires PlaceholderAPI.

Placeholder	Description
%meoweco_balance%	Raw balance amount
%meoweco_balance_formatted%	Formatted balance (e.g. 1.5K)
%meoweco_currency_singular%	Currency singular name
%meoweco_currency_plural%	Currency plural name
%meoweco_top_<rank>_name%	Name of player at rank N

• %meoweco_top_<rank>_balance%: Balance of the player at the given rank (formatted)
• %meoweco_top_<rank>_balance_raw%: Balance of the player at the given rank (raw number)
• %meoweco_top_<rank>_balance_formatted%: Balance of the player at the given rank (with units/abbreviation)

Server Total Placeholders

• %meoweco_server_total%: Total server balance (2 decimal places)
• %meoweco_server_total_raw%: Total server balance (raw number)
• %meoweco_server_total_formatted%: Total server balance (with units/abbreviation)

Example: %meoweco_top_1_name% displays the name of the richest player.