Economy Management¶

HTSkyBlock provides economy management commands for manipulating player balances and integrating with external economy plugins.

Admin Balance Commands¶

The /adminbalance command collection (aliases: /adminbal, /eco) provides tools for managing player money.

Base Permission: htskyblock.admin.balance

add¶

Add money to a player's balance.

Usage: /adminbalance add <player> <amount>

Permission: htskyblock.admin.balance.add

Examples:

/adminbalance add PlayerName 1000
/eco add Steve 500.50
/adminbal add Alice 250

Features: - Works for online and offline players - Supports partial name matching - Notifies the player if they are online - Displays the new balance after adding

remove¶

Remove money from a player's balance.

Usage: /adminbalance remove <player> <amount>

Permission: htskyblock.admin.balance.remove

Examples:

/adminbalance remove PlayerName 500
/eco remove Steve 100.25

Behavior: - If the player has less money than the specified amount, removes all available balance - Notifies you of the actual amount removed - Notifies the player if they are online

set¶

Set a player's balance to a specific amount.

Usage: /adminbalance set <player> <amount>

Permission: htskyblock.admin.balance.set

Examples:

/adminbalance set PlayerName 10000
/eco set Steve 0
/adminbal set Alice 5000.75

Use Cases: - Reset a player's balance to starting amount - Correct balance errors - Grant starting funds for events

check¶

Check a player's current balance.

Usage: /adminbalance check <player>

Permission: htskyblock.admin.balance.check

Displays: - Player's current balance (formatted with currency symbol) - Online/offline status - Player UUID

Example:

/adminbalance check PlayerName

Output:

=== Balance Info: PlayerName ===
Balance: $1,250.50
Status: Online
UUID: 550e8400-e29b-41d4-a716-446655440000

help¶

Display available admin balance commands.

Usage: /adminbalance help

Permission: htskyblock.admin.balance

Economy Providers¶

HTSkyBlock supports multiple economy providers. Configure the provider in config.json:

{
  "economy": {
    "enabled": true,
    "provider": "self",
    "currency": "$",
    "startingBalance": 100.0
  }
}

Supported Providers¶

Provider	Description	Configuration Required
`self`	Built-in HTSkyBlock economy	None (default)
`theeconomy`	TheEconomy plugin integration	Install TheEconomy
`ecotale`	EcoTale plugin integration	Install EcoTale
`arefyeconomy`	ArefyEconomy plugin integration	Install ArefyEconomy

Self (Built-in)¶

The default economy system stores player balances in economy.json.

Configuration:

{
  "economy": {
    "enabled": true,
    "provider": "self",
    "currency": "$",
    "startingBalance": 100.0,
    "allowNegativeBalances": false
  }
}

Options: - currency - Symbol displayed before amounts - startingBalance - Initial balance for new players - allowNegativeBalances - Whether players can go into debt

External Economy Providers¶

When using an external economy plugin, HTSkyBlock will delegate all economy operations to that plugin.

Configuration:

{
  "economy": {
    "enabled": true,
    "provider": "theeconomy"
  }
}

Admin Commands with External Providers

When using an external economy provider, the /adminbalance commands will display a message directing you to use that plugin's admin commands instead.

Common Tasks¶

Grant Starting Funds¶

Give all new players a starting balance:

/adminbalance set NewPlayer 1000

Reset Economy¶

To reset all player balances:

Stop the server
Delete plugins/HTSkyBlock/economy.json
Start the server
All players will start with the configured startingBalance

Correct Balance Errors¶

If a player reports an incorrect balance:

Check their current balance: /adminbalance check PlayerName
Review recent transactions in console logs
Set the correct balance: /adminbalance set PlayerName <correct_amount>

Event Prizes¶

Award money for events or competitions:

/adminbalance add Winner1 5000
/adminbalance add Winner2 3000
/adminbalance add Winner3 1000

Player Economy Commands¶

Players can check their own balance using: - /balance or /bal - View current balance - /pay <player> <amount> - Send money to another player (if enabled)

See the Economy guide for full details.

Troubleshooting¶

"Economy disabled" Message¶

If you see "Economy system disabled":

Open config.json
Set economy.enabled to true
Run /htskyblock reload

"Using external provider" Message¶

If you see this message when trying to use admin commands:

You have configured an external economy plugin
Use that plugin's admin commands instead (e.g., /theeconomy admin)
HTSkyBlock's admin commands only work with the built-in economy (provider: "self")

Player Not Found¶

If the command says "Player not found":

Ensure the player name is spelled correctly
The player must have joined the server at least once
Try using more of the player's name (e.g., "Steve" → "SteveTheBuilder")

Permission Summary¶

Command	Permission
Base commands	`htskyblock.admin.balance`
add	`htskyblock.admin.balance.add`
remove	`htskyblock.admin.balance.remove`
set	`htskyblock.admin.balance.set`
check	`htskyblock.admin.balance.check`

Grant all economy admin permissions:

permissions:
  htskyblock.admin.balance.*