RealInvest brings a full-featured banking system with unique IBAN accounts and a dynamic stock market to your Minecraft server. Built for Paper 1.21 and Vault, it lets players create bank accounts, deposit/withdraw money, transfer funds, and trade stocks with prices that change based on the issuer’s real‑time wealth.

✨ Features

Banking System

• Create personal bank accounts with a unique IBAN (e.g., RI123456789012)
• Deposit and withdraw money directly from your Vault economy balance
• Transfer funds between IBANs (configurable fee)
• Authorize other players with VIEW or MANAGE permissions on your accounts
• List all your accounts and check balances
• Fully YAML‑based data storage (bankdata.yml)

Stock Market

• Players can create their own stocks with a ticker (e.g., AAPL, RIOT)
• Set total shares and initial price (price limits configurable)
• Buy shares from the issuer (money goes to issuer’s pocket)
• Sell shares back to the issuer (issuer must have enough funds)
• Dynamic pricing – stock price = base price × (current issuer wealth / reference wealth)
• Price drivers: can use bank balance only or bank + pocket money
• Automatic price updates every X minutes (configurable)

Integrations

• Vault – required for economy handling
• PlaceholderAPI – dozens of placeholders for bank balances, IBANs, top rankings, stock prices, and share amounts

️ Commands & Permissions
Detailed permission nodes for fine‑grained control (see plugin.yml). Defaults give most players access to basic commands; ops get management rights.

Configurable Messages (New)

• All player-facing messages are now stored in messages.yml – you can edit colors, wording, and even create translations without touching the code.
• A custom prefix can be set in config.yml (default &6[RealInvest] &r), making it easy to change the plugin’s chat tag.

Commands

/bank
/stock
PlaceholderAPI Expansion

Identifier: realinvest

Placeholder	Description
%realinvest_bank_balance%	Total sum of all your bank accounts (comma‑formatted)
%realinvest_bank_balance_plain%	Same as above but with plain decimal (no commas)
%realinvest_bank_balance_<IBAN>%	Balance of a specific IBAN
%realinvest_bank_balance_<IBAN>_plain%	Same as above, plain format
%realinvest_bank_iban%	IBAN of your first account
%realinvest_top_bank_<rank>_name%	Player name at that rank (by total bank balance)
%realinvest_top_bank_<rank>_balance%	Bank balance at that rank
%realinvest_top_bank_<rank>_balance_plain%	Plain format balance at that rank
%realinvest_stock_shares_<ticker>%	Number of shares you own of a stock
%realinvest_stock_price_<ticker>%	Current price of a stock (comma‑formatted)
%realinvest_stock_price_<ticker>_plain%	Current price (plain decimal)

⚙️ Configuration (config.yml)

All message texts are in messages.yml – edit colors and wording freely.

Permissions (excerpt)

Permission	Default	Description
realinvest.bank.create	true	Create bank accounts
realinvest.bank.use	true	Use basic bank commands
realinvest.bank.transfer	true	Transfer funds
realinvest.bank.manage	op	Add/remove authorized users
realinvest.bank.viewothers	op	View other players’ accounts
realinvest.stock.create	true	Create a stock
realinvest.stock.buy	true	Buy shares
realinvest.stock.sell	true	Sell shares
realinvest.stock.portfolio	true	View portfolios
realinvest.stock.viewothers	op	View others’ portfolios
realinvest.update.notify	op	Receive update notifications

Dependencies

• Required: Vault with an economy plugin (e.g., EssentialsX, CMI, etc.)
• Optional: PlaceholderAPI – for placeholders

Beta Status

RealInvest is currently in early beta. The code has been tested only in basic scenarios. You may encounter:

• Data loss or corruption (always make backups!)
• Performance issues with many stocks/accounts
• Unexpected price calculations
• Missing features or incomplete commands

Please report bugs on the issue tracker (if available). Use on production servers at your own risk.


RealInvest – bring real‑world investing and banking to your Minecraft world. Create a thriving economy with IBAN accounts, dynamic stock prices, and full integration with Vault & PlaceholderAPI.