Invest

InvestPlugin 📈

Bring a dynamic, fully-simulated stock market directly to your Minecraft server! InvestPlugin allows your players to invest their hard-earned money into virtual companies, manage their own portfolios, and ride the highs and lows of a living economy.

Whether they want to play it safe with low-risk bonds or gamble on highly volatile startups, there's an investment strategy for everyone!

✨ Features

• Live Market Simulation: Stock prices fluctuate naturally in the background. The market ticks every 5 minutes (configurable), updating prices based on each stock's unique volatility and trend settings.
• Random Market Events: Watch out for sudden Booms, Crashes, and Volatility Spikes! When an event triggers, a dramatic announcement is broadcast to the entire server, shaking up the economy.
• Detailed Portfolios: Players can view exactly how many shares they own, their average buy price, and their live Profit/Loss (P/L) margins.
• Transaction History: Every buy and sell is logged so players can review their past trades.
• Minecraft-Themed Default Stocks: Comes out of the box with 8 immersive lore-friendly stocks including DiamondCorp, NetherTech, EnderLogistics, and the OverworldIndex.
• Admin Control: Powerful admin commands to create custom stocks, force price changes, or manually trigger market events.

🛠️ Dependencies

• Vault: Required for all economy transactions.
• Economy Provider: You must have an economy plugin installed (such as EssentialsX or EconomyLite) that hooks into Vault.

🎮 Player Commands

| Command | Description | |---|---| | /invest market | View all available stocks, live prices, and % changes. | | /invest info <stock> | View detailed info and risk-level for a specific stock. | | /invest buy <stock> <amount> | Purchase shares (includes a configurable 2% transaction fee). | | /invest sell <stock> <amount> | Sell shares and cash out your profits. | | /invest portfolio | View your total holdings, total value, and overall Profit/Loss. | | /invest history | View your recent transaction history. |

⚙️ Admin Commands

(Requires invest.admin permission)

| Command | Description | |---|---| | /investadmin createstock <name> <price> <volatility> | Create a brand new stock on the market. | | /investadmin removestock <name> | Delete a stock from the market. | | /investadmin setprice <name> <price> | Manually override a stock's current price. | | /investadmin triggerevent <event_type> | Force a market event (boom, crash, volatility_spike, etc). | | /investadmin forcetick | Force the market to immediately update all prices. |

🚀 Installation

1. Download the InvestPlugin-1.0.0.jar.
2. Place the JAR file into your server's plugins/ folder.
3. Ensure you have Vault and a valid economy plugin installed.
4. Restart your server.
5. (Optional) Edit the config.yml to adjust the transaction fee, max shares, tick rate, or default stocks!