Feathers Economy

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.

Placeholders showing blank - Placeholders showing blank → Make sure you are on Paper 1.21.11+ and Java 21+ - Placeholders showing blank → Check your credentials in `config.yml` and that your MySQL/MariaDB server is reachable - Placeholders showing blank → Run `/fe reload` after any config change - Placeholders showing blank → Check `sounds.enabled` is `true` and 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*