Invest | Next-Gen Investment System v1.0.6

---

Overview​

ShyamInvest allows players on your server to invest their money and earn passive interest yields over time. Designed from the ground up for massive economies, the plugin features a built-in Caffeine memory cache to prevent main-thread lag, robust multi-server sync, and a completely configurable, symmetric GUI layout system.

To keep your server's economy dynamic and engaging, the plugin incorporates an optional, automated Market Event simulator that triggers market crashes and bull run recovery phases.

---

Key Features​

• Dynamic Investment Tiers: Define custom tiers with varying interest rates. Reward players who invest more money with higher milestone yields.
• Passive Yield Ticker: Interest is calculated and accrued in real-time. Players can collect their pending earnings whenever they open the menu.
• Market Crash & Recovery Events: Keep players on their toes with bear and bull market trends. When a crash is triggered, interest drops significantly. Following a crash, a bull market recovery phase boosts payouts, encouraging players to "HODL" rather than panic withdraw.
• Offline Interest Accrual: Players can earn money even while logged off. Configurations allow you to set duration limits and multipliers for offline income.
• Symmetric GUI Layouts: Every item slot, title, and decoration in the user interface is mapped to a customizable character grid. Change the layout of any menu in seconds.
• Auto-Collection: Grant premium players (via permission nodes) the ability to automatically harvest their pending interest directly to their main balance.
• Interactive Admin Control Panel: Modify player investments, activate global income boosters (e.g. 2.0x interest), trigger manual market cycles, and monitor detailed logs.
• Complete Transaction Logging: Every investment, collection, withdrawal, and admin modification is logged to the local database, searchable in-game via a paginated history GUI.
• SQL & Cache Optimization: Runs on SQLite/MySQL using HikariCP connection pools. Read actions use JVM-level Caffeine caching to guarantee O(1) retrieval speeds with zero main-thread database blocking.
• Developer API: Exposes comprehensive lifecycle hooks, programmatic balance modifiers, and booster managers for easy third-party integration.

---

Commands & Permissions​

Player Commands​

• /invest - Opens the main symmetric investment dashboard. (Permission: shyaminvest.use)
• /invest top - Opens the top investors leaderboard.
• /invest history - Opens the player's personal transaction history logs.

Admin Commands​

• /investadmin gui - Opens the administrative control panel. (Permission: shyaminvest.admin)
• /investadmin reload - Reloads all configuration values and restarts the income tickers.
• /investadmin info <player> - Views investment statistics of a specific player.
• /investadmin history <player> - Opens the paginated transaction history of any player (online or offline).
• /investadmin give <player> <amount> - Grants an investment balance boost to a player.
• /investadmin take <player> <amount> - Deducts investment balance from a player.
• /investadmin set <player> <amount> - Direct-writes a player's investment balance.
• /investadmin reset <player> - Resets a player's account to default stats.
• /investadmin boost <multiplier>x <duration> - Activates a global server-wide interest multiplier (e.g. /investadmin boost 2.0x 1h).
• /investadmin crash trigger <crash|recovery> - Manually triggers a market crash or bull run.
• /investadmin crash end - Forcefully ends the current active market event.
• /investadmin crash monitor - Opens the graphical market event monitor panel.

Additional Permissions​

• shyaminvest.premium - Required to unlock and toggle the automated yield collection feature.
• shyaminvest.perk.max.<tier> - Restricts players to specific maximum investment caps defined in perks configuration.

---

Integrations & Compatibility​

• Folia Support: Multi-threading ready, using thread-safe map wrappers and scheduler abstractions to operate safely on paper-weight region threads.
• Vault & Multi-Economy: Hooks directly into Vault or ExcellentEconomy to handle deposits and withdrawals cleanly.
• PlaceholderAPI Support: Exposes live placeholders for scoreboard, chat, or hover-text displays:
  • %shyaminvest_invested% - Formatted invested balance.
  • %shyaminvest_pending% - Accrued uncollected interest.
  • %shyaminvest_total_earned% - Total interest earned.
  • %shyaminvest_rate% - Player's current active interest rate.
  • %shyaminvest_tier% - Current tier milestone.
  • %shyaminvest_rank% - Leaderboard rank.