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.yml and that your MySQL/MariaDB server is reachable
• Messages not updating → Run /fe reload after any config change
• Sounds not working → 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