LlamaEconomy

LlamaEconomy is a lightweight economy plugin for PowerNukkitX. It provides the essential commands for managing player balances, supports multiple storage backends, and exposes an API and events for other plugins.

Features

• Player accounts are created automatically on first join
• Configurable starting balance and currency symbol
• YAML, MySQL, and MongoDB storage
• Balance, payment, administration, and leaderboard commands
• Configurable command names, aliases, descriptions, usage messages, and permissions
• Customizable messages
• Optional PlaceholderAPI integration
• Public Java API and economy events for plugin developers

Requirements

• A PowerNukkitX server compatible with API 3.0.0
• JDK 21 for building and running the plugin
• PlaceholderAPI (optional)
• DBDrivers installed on the server when using MySQL

Installation

1. Download a LlamaEconomy JAR or build it from source.
2. Place the JAR in your server's plugins directory.
3. Start the server once to generate the configuration files.
4. Edit plugins/LlamaEconomy/config.yml if required.
5. Restart the server after changing the main configuration.

The default YAML provider works without an external database.

Configuration

The generated config.yml contains the storage, economy, and command settings:

Provider: "yaml"

DefaultMoney: 1000.0
MonetaryUnit: "$"

MongoDB:
  Uri: "mongodb://localhost:27017"
  Database: "llamaeconomy"

MySql:
  Host: "127.0.0.1"
  Port: "3306"
  User: "root"
  Password: "change-me"
  Database: "llamaeconomy"

Set Provider to yaml, mysql, or mongodb. Database credentials are only used by the selected provider. Do not commit real database credentials to source control.

Command properties can be changed under Commands. Keep each Parameters entry unchanged because it defines the parameters expected by the plugin. Player-facing text and formatting can be customized in .