Vault-backed investments: open a configurable menu to add principal (GUI, sign, or chat), earn per-second income, collect or auto-collect, withdraw principal with a refund share, optional tier rates and income tax. Paper and Folia 1.21 - 26.x
Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa
Features
• Folia support – Player-bound work uses the entity scheduler; region work for sign restore uses the region scheduler where needed.
• Vault economy – Deposits and withdrawals use the registered Vault economy provider.
• MiniMessage – Player messages from
messages.yml; GUI titles and item text from gui/invest-gui.yml.• Commands and GUI –
/invest opens the menu; optional typed amount on /invest skips straight to the confirm screen when valid. Main menu supports add-investment flow (sign or chat), withdraw confirmation, collect, and auto-collect toggle with on/off materials.• Passive income – Configurable income basis and rate per second, ticker interval, and global max invested; optional tier table overrides basis and rate by invested thresholds.
• Withdraw rules – Refund percent of principal; reinvest cooldown after principal withdraw; pending accrued income remains until collected.
• Offline accrual – Optional accrual while offline with a max window and optional daily or weekly net pay caps.
• Optional tax – Percent of gross accrual before net is stored or auto-paid; tax portion can deposit to a configured player UUID.
• Sign and chat input – Optional temporary sign editor and timed chat prompts for amounts;
invest-sign template lines filter parsed input.• Abbreviated amounts – Optional suffix multipliers (e.g. 10k, 2.5M) when abbreviations are enabled.
• Safety – GUI click debounce, invest and collect intervals, optional max single transaction, and sanity handling for abnormal amounts.
• Admin – Reload (config, messages, GUI file, DB handoff, ticker), help, async stats from the database, and profile reset for a player.
Placeholders
%perfinvest_invested% – Vault-formatted principal invested (cached profile; 0 if not loaded).
%perfinvest_accrued% – Vault-formatted pending income (cached profile; 0 if not loaded).
%perfinvest_income_per_second% – Alias: %perfinvest_income_per_sec%. Vault-formatted modeled income per second for current invested amount.
%perfinvest_autocollect% – Alias: %perfinvest_auto_collect%. true or false from cached profile.
%perfinvest_cooldown_seconds% – Alias: %perfinvest_reinvest_cooldown_seconds%. Seconds remaining on reinvest cooldown after last principal withdraw.
Commands
/invest – Open the investment menu (perfinvest.use)
/invest (amount) – Parse (amount) as a number or abbreviated value and open the confirm investment screen (perfinvest.use)
/investment – Same as /invest (perfinvest.use)
/perfinvest reload – Reload configuration and related resources (perfinvest.admin)
/perfinvest help – Show admin command usage (perfinvest.admin)
/perfinvest stats (player) – Load and display stored investment stats for a player (perfinvest.admin)
/perfinvest reset (player) – Clear saved investment data for a player (perfinvest.admin)
Database
• SQLite
• MySQL
