# FeathersEconomy<\/p>\n
**A fully-featured, configurable economy plugin**<\/p>\n
> Vault \u00b7 PlaceholderAPI \u00b7 SQLite \/ MySQL \/ MariaDB<\/p>\n
—<\/p>\n
## Overview<\/p>\n
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.<\/p>\n
—<\/p>\n
## Features<\/p>\n
**Configurable Currency**
\nSet the name, plural form, symbol, symbol position (before\/after), decimal places, and thousands separator from config.<\/p>\n
**SQLite + MySQL + MariaDB**
\nSQLite works out of the box with zero setup. Switch to MySQL or MariaDB for multi-server networks with a single config change.<\/p>\n
**Vault Integration**
\nRegisters as a Vault economy provider at the highest priority. Any plugin that supports Vault will automatically work with FeathersEconomy \u2014 no extra configuration required.<\/p>\n
**Transaction Log**
\nEvery deposit, withdrawal, admin change, and transfer is logged per-player in the database. Viewable with `\/fe history`. Configurable max entries per player.<\/p>\n
**Starting Balance**
\nNew players automatically receive a configurable starting balance when they first join.<\/p>\n
**Dual Notifications**
\nEvery message can be delivered to chat, the action bar, or both at the same time. Configured independently per channel.<\/p>\n
**Separate Channel Text**
\nWrite different text for chat or action bar using sub-keys. Shorter text for the action bar, full text for chat.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
### Admin \u2014 `\/featherseconomy` \/ `\/fe`<\/p>\n
| Command | Description | Permission | ### General Commands<\/p>\n | Command | Description | Permission | —<\/p>\n ## Permissions<\/p>\n | Node | Description | Default | —<\/p>\n ## PlaceholderAPI Placeholders<\/p>\n Requires PlaceholderAPI to be installed. All placeholders use the `%feathers_…%` identifier.<\/p>\n ### Player Placeholders<\/p>\n | Placeholder | Description | Example | ### Leaderboard Placeholders (Ranks 1\u201330)<\/p>\n Replace `N` with any number from 1 to 30.<\/p>\n | Placeholder | Description | Example | > **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`.<\/p>\n —<\/p>\n ## Requirements<\/p>\n | Dependency | Type | Notes | > SQLite is set up by default \u2014 no configuration needed to get started.<\/p>\n —<\/p>\n ## Support<\/p>\n **Bug Reports & Feature Requests** **Quick Troubleshooting** —<\/p>\n *FeathersEconomy v1.0.0 \u00b7 Made by N1ghtc1*<\/p>\n","protected":false},"excerpt":{"rendered":" Fully configurable economy plugin<\/p>\n","protected":false},"featured_media":69677,"template":"","meta":{"_minecraft_slug":"feathers-economy","_minecraft_project_id":"4nfBFsBi","_minecraft_author":"N1ghtc1","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":20,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"feathers-economy.zip","_minecraft_size_bytes":18247549,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:31:49.992469Z","_minecraft_date_created":"2026-03-12T03:00:48.400163Z","_minecraft_date_modified":"2026-03-07T17:44:45.095669Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/feathers-economy","_minecraft_icon_attachment_id":69677,"_minecraft_imported_at":"2026-06-03T23:19:28+00:00","_minecraft_import_hash":"22e488e6218bb55153d5ebc5b74c0bcb","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,127],"mod_loader":[132],"minecraft_version":[41],"class_list":["post-69676","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-paper","mod_loader-paper","minecraft_version-1-21-11"],"yoast_head":"\n
\n|—|—|—|
\n| `\/fe add
\n| `\/fe remove
\n| `\/fe set
\n| `\/fe check
\n| `\/fe leaderboard` | Show the top-N balance leaderboard in chat | `economy.admin` |
\n| `\/fe history
\n| `\/fe sounds` | Toggle personal sound effects on\/off | everyone |
\n| `\/fe reload` | Reload config.yml without restarting | `economy.admin` |
\n| `\/fe help` | Show the command reference | `economy.admin` |<\/p>\n
\n|—|—|—|
\n| `\/bal [player]` | Check your balance, or another player’s (admin only) | `economy.use` |
\n| `\/balance [player]` | Alias for \/bal | `economy.use` |
\n| `\/money [player]` | Alias for \/bal | `economy.use` |
\n| `\/wallet [player]` | Alias for \/bal | `economy.use` |
\n| `\/pay
\n|—|—|—|
\n| `economy.use` | Use \/bal, \/wallet, \/money, \/balance | true |
\n| `economy.pay` | Use \/pay to send money to other players | true |
\n| `economy.admin` | All \/fe admin commands | op |
\n| `economy.leaderboard` | Access to the leaderboard command | true |
\n| `economy.*` | All economy permissions | op |<\/p>\n
\n|—|—|—|
\n| `%feathers_balance%` | Formatted balance with symbol | $1,250.00 |
\n| `%feathers_balance_raw%` | Raw numeric balance | 1250.0 |
\n| `%feathers_balance_plain%` | Formatted number, no symbol | 1,250.00 |
\n| `%feathers_currency_name%` | Currency name (singular) | Dollar |
\n| `%feathers_currency_plural%` | Currency name (plural) | Dollars |
\n| `%feathers_currency_symbol%` | Currency symbol | $ |
\n| `%feathers_rank%` | Player’s leaderboard rank position | #3 |<\/p>\n
\n|—|—|—|
\n| `%feathers_top_name_N%` | Username of the player at rank N | N1ghtc1 |
\n| `%feathers_top_balance_N%` | Formatted balance of the player at rank N | $50,000.00 |
\n| `%feathers_top_balance_raw_N%` | Raw balance of the player at rank N | 50000.0 |<\/p>\n
\n|—|—|—|
\n| Paper 1.21.11+ | Required | Spigot is not supported |
\n| Java 21+ | Required | Ships with Paper 1.21.11 by default |
\n| Vault | Soft-depend | Only needed if other plugins require economy access |
\n| PlaceholderAPI | Soft-depend | Only needed for scoreboards and PAPI placeholders |
\n| MySQL \/ MariaDB | Optional | Only if switching from the default SQLite storage |<\/p>\n
\nContact me on Discord or through BuiltByBit Messages. Please include your server version, Java version, full error log from console, and steps to reproduce.<\/p>\n
\n– **Plugin fails to enable** \u2192 Make sure you are on Paper 1.21.11+ and Java 21+
\n– **Database errors** \u2192 Check your credentials in `config.yml` and that your MySQL\/MariaDB server is reachable
\n– **Messages not updating** \u2192 Run `\/fe reload` after any config change
\n– **Sounds not working** \u2192 Check `sounds.enabled` is `true` and the sound name is valid for your server version
\n– **Placeholders showing blank** \u2192 Make sure PlaceholderAPI is installed and the player has joined at least once<\/p>\n