FeathersEconomy
A fully-featured, configurable economy plugin
Vault · PlaceholderAPI · SQLite / MySQL / MariaDB
Overview
FeathersEconomy is a lightweight, production-ready economy plugin built for Economy Servers. It comes with a fully configurable currency system, dual chat and action bar notifications, per-event sound effects, SQLite/MySQL/MariaDB storage, Vault integration, and a PlaceholderAPI expansion with top-30 leaderboard support.
Features
Configurable Currency Set the name, plural form, symbol, symbol position (before/after), decimal places, and thousands separator from config.
SQLite + MySQL + MariaDB SQLite works out of the box with zero setup. Switch to MySQL or MariaDB for multi-server networks with a single config change.
Vault Integration Registers as a Vault economy provider at the highest priority. Any plugin that supports Vault will automatically work with FeathersEconomy — no extra configuration required.
Transaction Log
Every deposit, withdrawal, admin change, and transfer is logged per-player in the database. Viewable with /fe history. Configurable max entries per player.
Starting Balance New players automatically receive a configurable starting balance when they first join.
Dual Notifications Every message can be delivered to chat, the action bar, or both at the same time. Configured independently per channel.
Separate Channel Text Write different text for chat or action bar using sub-keys. Shorter text for the action bar, full text for chat.
Commands
Admin — /featherseconomy / /fe
| Command | Description | Permission |
|---|---|---|
/fe add <player> <amount> |
Add balance to a player | economy.admin |
/fe remove <player> <amount> |
Remove balance from a player | economy.admin |
/fe set <player> <amount> |
Set a player's exact balance | economy.admin |
/fe check <player> |
Check any player's balance | economy.admin |
/fe leaderboard |
Show the top-N balance leaderboard in chat | economy.admin |
/fe history <player> [limit] |
View a player's last N transactions (max 50) | economy.admin |
/fe sounds |
Toggle personal sound effects on/off | everyone |
/fe reload |
Reload config.yml without restarting | economy.admin |
/fe help |
Show the command reference | economy.admin |
General Commands
| Command | Description | Permission |
|---|---|---|
/bal [player] |
Check your balance, or another player's (admin only) | economy.use |
/balance [player] |
Alias for /bal | economy.use |
/money [player] |
Alias for /bal | economy.use |
/wallet [player] |
Alias for /bal | economy.use |
/pay <player> <amount> |
Transfer money to an online player | economy.pay |
Permissions
| Node | Description | Default |
|---|---|---|
economy.use |
Use /bal, /wallet, /money, /balance | true |
economy.pay |
Use /pay to send money to other players | true |
economy.admin |
All /fe admin commands | op |
economy.leaderboard |
Access to the leaderboard command | true |
economy.* |
All economy permissions | op |
PlaceholderAPI Placeholders
Requires PlaceholderAPI to be installed. All placeholders use the %feathers_...% identifier.
Player Placeholders
| Placeholder | Description | Example |
|---|---|---|
%feathers_balance% |
Formatted balance with symbol | $1,250.00 |
%feathers_balance_raw% |
Raw numeric balance | 1250.0 |
%feathers_balance_plain% |
Formatted number, no symbol | 1,250.00 |
%feathers_currency_name% |
Currency name (singular) | Dollar |
%feathers_currency_plural% |
Currency name (plural) | Dollars |
%feathers_currency_symbol% |
Currency symbol | $ |
%feathers_rank% |
Player's leaderboard rank position | #3 |
Leaderboard Placeholders (Ranks 1–30)
Replace N with any number from 1 to 30.
| Placeholder | Description | Example |
|---|---|---|
%feathers_top_name_N% |
Username of the player at rank N | N1ghtc1 |
%feathers_top_balance_N% |
Formatted balance of the player at rank N | $50,000.00 |
%feathers_top_balance_raw_N% |
Raw balance of the player at rank N | 50000.0 |
Performance note: Leaderboard placeholders are cached for 60 seconds to avoid hammering the database on scoreboards that refresh frequently. The cache is automatically invalidated when you run
/fe reload.
Requirements
| Dependency | Type | Notes |
|---|---|---|
| Paper 1.21.11+ | Required | Spigot is not supported |
| Java 21+ | Required | Ships with Paper 1.21.11 by default |
| Vault | Soft-depend | Only needed if other plugins require economy access |
| PlaceholderAPI | Soft-depend | Only needed for scoreboards and PAPI placeholders |
| MySQL / MariaDB | Optional | Only if switching from the default SQLite storage |
SQLite is set up by default — no configuration needed to get started.
Support
Bug Reports & Feature Requests Contact me on Discord or through BuiltByBit Messages. Please include your server version, Java version, full error log from console, and steps to reproduce.
Quick Troubleshooting
- Plugin fails to enable → Make sure you are on Paper 1.21.11+ and Java 21+
- Database errors → Check your credentials in
config.ymland that your MySQL/MariaDB server is reachable - Messages not updating → Run
/fe reloadafter any config change - Sounds not working → Check
sounds.enabledistrueand the sound name is valid for your server version - Placeholders showing blank → Make sure PlaceholderAPI is installed and the player has joined at least once
FeathersEconomy v1.0.0 · Made by N1ghtc1
