# GenSprout 1.3.0-beta1 Supports Paper/Purpur 1.21.7 through 26.3. Java 21. ## New Features ### Teams & Co-op * Native teams with `/team` (aliases `/coop`, `/party`, `/c`). * Create teams, invite players, accept or deny invites, kick members, promote or demote, transfer leadership, disband, and use team chat. * Roles: Leader, Co-Leader and Member, with their own permissions. * Team settings for sharing generator drops and generator management. * Dialog menus with player heads, plus player search. * New scoreboard and tab list placeholders: `{team}` and `{team_role}`. ### New Player Experience * First join runs `/start`: a Sprout Hoe, starter generators, then a choice between Solo and Team mode. * The starter flow can't be skipped by accident. It ends with a **Start Playing** button. * New `/guide` (also `/help`) with categories for Farming, Generators, Tools, Prestige, Teams and the Shop. Addons can add their own categories. ### Active Farming * **Combo streaks**: fast harvests build a combo worth up to +50% XP and Essence. Reaching 50 starts a 15-second **Sprout Frenzy**. * **Golden & Cosmic Sprouts**: rare harvest finds that award bonus Essence and money. Cosmic Sprouts also give a booster. * **Boosters**: Generator Overclock, Essence Surge and XP Surge. * **Bounties** (`/bounties`): three rolling objectives with Essence, money and booster rewards. * **Magnet** hoe enchant (max level 3) pulls nearby drops to you. * Sprout Hoes can no longer be dropped or lost on death. * Particle auras on high-tier generators, and effects when you upgrade. ### Generators * **Bulk upgrade**: upgrade all your placed generators in one click from `/genshop` or `/gensprout bulkupgrade`. ### Leaderboards * `/gensprout top [prestige|level|essence|balance]`, plus a Leaderboards button in the main menu. ### Admin Tools * `/gensprout selftest` runs built-in health checks on a live server. * `/gensprout booster <player> <type> <seconds>` grants a booster. ### Addons * Optional **chyarolib** support for addons, hot reloads and update checks. GenSprout still works fully without it. * **GenSprout SkyBlock Addon 1.3.0-beta1**: * Void-world team islands with roles, protection, visits and resets. * Island upgrades bought with Upgrade Nuggets. * Custom `.nbt` island schematics. * **GenSprout Mine Addon 1.3.0-beta1** (new): * Refilling mines that pay money for every block mined, with a bonus per Prestige. * Mines unlock by Farming Level and Prestige. * Players browse mines with `/mine`; admins manage them with `/mine admin`. ## Storage * Player, generator and farm data moved from YAML files to SQLite (`plugins/GenSproutData/gensprout.db`). * The one-time migration backs up the old files and leaves them untouched if anything fails. * Boosters and bounty progress now survive restarts and reloads. ## Security & Exploit Fixes * Fixed generator duplication through old menu buttons. Menu buttons now only work once, and only on the menu you currently have open. * Sell Wands can no longer sell the contents of chests you aren't allowed to open. * Auto-Sell can no longer sell other players' generator drops. Magnet only pulls drops you're allowed to pick up. * Players can no longer use `/sell`, `/genshop`, `/start` and similar commands on other players, or on `@a`. That now needs `gensprout.command.others`, which only ops have by default. * Fixed endless XP and Essence from breaking unripe or hand-placed crops (for example stacked sugar cane) with the Sprout Hoe. * Harvest Area now respects land-claim and island protection. * The `/start` kit can only be claimed once. * Upgrade bounties can no longer pay out more money than the upgrades cost. * Purchases only go through once the payment has actually succeeded, and shop quantities are checked on the server. * Sell prices come from the config, not from values stored on items. * Team chat can no longer inject clickable commands. * Generators, Sprout Hoes and Sell Wands can no longer be used in crafting. * Admin commands reject invalid numbers. Previously `addxp Infinity` froze the server. ## Bug Fixes * Generators in worlds that load after GenSprout, such as the SkyBlock world, were being deleted. They're now kept. * `/gensprout reload` no longer throws away generator changes made since the last autosave. * Offline earnings are no longer paid twice after a crash. * Fixed messages that showed up as "[Missing string key]": bounty completion, boosters, golden and cosmic sprout finds, Frenzy, and bulk upgrade results. * Bounty and booster names, the bounties menu and the bulk upgrade menu are now translated into all 5 languages. * Team settings show a coloured Enabled/Disabled instead of raw `<green>` tags. * The starter guide no longer resets the team name you're typing. ## Performance * The scoreboard no longer scans every generator each second. * Faster checks on generator ticks and harvests. * Crop visuals are sent as batched block updates. * The team invite menu only scans offline players when you search. * Several memory leaks fixed, including menu buttons that were kept for 10 years. ## Notes for Server Owners * New permission: `gensprout.command.others` (default: op). * The database migrates automatically on first start. * Addon jars go in `plugins/GenSprout/addons/` and need chyarolib.

### Generator Economy and Progression Rebalance * **50 Generator Tiers**: Expanded generator tiers from 25 to 50 tiers; each configured with unique block materials, drop items, display names, and drop names. * **25-Hour Progression Timeline**: Balanced generator purchase prices and drop value curves across starter, mid-game, and endgame phases targeting ~25 hours of active gameplay to reach tier 50. * **Master Sell Wand**: Added Tier 2 Master Sell Wand (15,000 Essence cost, 2.5x sell multiplier) alongside Tier 1 Sell Wand (1,500 Essence cost, 1.5x sell multiplier). * **Scaling Essence Generator Slots**: Rebalanced Essence generator slot purchases with scaling formula `300 + (current_slots * 150)` up to a cap of 25 slots. * **Generator Item Protection**: Blocked placeable generator items from being sold via `/sell`, Sell Wands, or auto-sell routines. ### Multi-Language and Localization Support * **Multi-Language Bundles**: Added full translation support for English, Spanish, German, French, and Chinese. * **Automatic Client Locale Matching**: Detects and applies player language settings based on Minecraft client locale. * **Global Server Language Option**: Added global configuration option to enforce a single server-wide language. * **Live Inventory Locale Updates**: Automatically updates item names and lore in player inventories when switching client languages. * **Sprite and Formatting Fixes**: Standardized tool item texture namespace tags and dual placeholder tags (`<tag>` and `{brace}`) across all language bundles. * **Configurable Server Discord Link**: Added default `server.discord` setting in `config.yml` configured to `https://discord.gg/bJjyy8q9wb`. * **Deployment Config Synchronization**: Added direct upload of `config.yml` to `/plugins/GenSprout/config.yml` during remote deployment. ### Farming Mechanics and Sprout Hoe Enchants * **Per-Player Instanced Farms**: Shared farm regions are instanced per player. Harvesting a crop triggers regrowth for that specific player while remaining harvestable for others. * **Reach Enchantment**: Added Reach hoe enchantment (levels 1-5), extending block interaction range via Paper attribute modifiers. * **Crop-Only Auto-Sell**: Added Auto-Sell hoe enchantment (5,000 Essence cost) for instant crop selling on harvest. * **500-Level Hoe Enchants**: Expanded XP Booster, Essence Finder, and Crop Doubler maximum levels to 500 with dynamic level-selection sliders. * **Easier Essence Drops**: Increased base Essence drop rates and yield during harvesting. ### UI, Scoreboard, and Tablist Enhancements * **Paper Dialog Shop Redesign**: Reorganized `/shop` with categories for Generators, starter Diamond tools, and Netherite tools with Efficiency V. * **Interactive First-Join Guide**: Converted starter tutorial into an interactive guide covering farming, hoe upgrades, generator production, offline earnings, and key commands. * **Scoreboard & Tablist Card Redesign**: Implemented modern sectioned card scoreboards (`PLAYER` and `ECONOMY`), rich tablist entries displaying rank prefixes (`{player_prefix}`), farming level, and expanded prestige level (`Lvl {level} • Prestige {prestige}` instead of `P0`), and removed `file-version` auto-backup logic from `LanguageManager`. * **Full Cube Block Generators**: Ensured 100% of generator block types use solid 1x1x1 full cube blocks, replacing non-full models (Sculk Shrieker, Heavy Core, Vault, End Portal Frame, Conduit, Enchanting Table, Dragon Egg, Beacon) with full blocks (`SCULK`, `POLISHED_TUFF`, `CHISELED_TUFF_BRICKS`, `END_STONE`, `DARK_PRISMARINE`, `BOOKSHELF`, `BLACK_CONCRETE`, `CYAN_CONCRETE`). * **Tier 45 Generator Material Fix**: Corrected tier 45 block-type material from invalid `CHISELED_END_STONE_BRICKS` to `END_STONE` in `config.yml` and added `Material.matchMaterial` fallback handling in `GeneratorManager`. * **Universal /help Override**: Overrode Bukkit and vanilla `/help` commands to present GenSprout's starter guide dialog. ### Generator Protection and Anti-Lag Guards * **Online-Only Generation**: Generators spawn live item drops while the owner is online. Offline generation processes at a 20% calculation rate on login. * **Complete Drop and Block Protection**: Protected generator blocks against unauthorized breaks, upgrades, piston movement, explosions, liquid flow, and block overwrites while preventing unauthorized drop pickups. * **Hopper Pickup Compatibility**: Allowed hoppers to pick up generator drops while preserving ownership protection against unauthorized players. * **Disable Hunger Option**: Added `disable-hunger: true` configuration setting to maintain full saturation at all times. * **Isolated Data Folder**: Moved player profiles, generator locations, and farm regions to `plugins/GenSproutData/` to prevent loss during configuration resets.

* **Generator Tiers Expanded to 50**: Doubled the total generator tier count from 25 to 50 tiers, each configured with unique block materials, drop items, display names, and drop names. * **25-Hour Max Progression Rebalance**: Tuned generator buy price and drop value compounding curves across 3 phases (Tiers 1-5 Starter, Tiers 6-25 Mid-Game, Tiers 26-50 Endgame Grind) targeting ~8-10 hours to Tier 25 and ~25 hours of active gameplay to max out Tier 50 and all upgrades. * **Scaling Essence Generator Slots**: Rebalanced Essence generator slot purchases from a flat cost to scaling cost formula `base-cost + (current_essence_slots * scaling-factor)` (300 base + 150 per slot). * **Exponential Hoe Enchant Cost Curves**: Adjusted `cost-exponent` to 1.15 for multi-level hoe enchantments (XP Booster, Essence Finder, Crop Doubler) so maxing out level 500 aligns with the 25-hour progression timeline. * **2.5x Master Sell Wand**: Added Tier 2 Master Sell Wand (15,000 Essence cost, 2.5x sell multiplier) alongside Tier 1 Sell Wand (1,500 Essence cost, 1.5x sell multiplier). * **Generator Item Sell Protection**: Prevented placeable generator block items from being sold via `/sell`, Sell Wands, or auto-sell by restricting `getDropValueFromItem` to generator drop items and verifying `isGeneratorItem` returns false in `SellManager.getUnitPrice`.

* **Online-Only Generator Production**: Generators produce live item drops only while the owner is online. Offline generation continues at 20% calculation rate on login. * **Drop Ownership Protection**: Prevented players from picking up generator drops belonging to other players. * **Hopper Pickup Support**: Enabled hoppers to pick up generator drops while protecting drops from unauthorized player pickups. * **Complete Generator Block Protection**: Protected generator blocks against unauthorized breaks, upgrades, piston movement, explosions, liquid flow, and block overwrites. * **Centered Drop Spawning**: Positioned generator drops in the exact horizontal center top of generator blocks with zero initial velocity. * **Shop Menu Redesign**: Renamed `/shop` to **Shop**, added a **Tools** category featuring cheap starter Diamond tools ($50-$75) and Tier 2 Netherite tools with Efficiency V ($250-$350), and added a **Generators** category button redirecting directly to `/genshop`. * **Disable Hunger Option**: Added `disable-hunger: true` config setting (enabled by default) to keep player food level and saturation full at all times (infinite food). * **Expanded Starter Guide**: Expanded the first-join tutorial dialog into a comprehensive starter guide covering farming, hoe upgrades, generator production, offline earnings, and key commands. * **Easier Essence Drops**: Significantly increased base Essence drop chance (50%+) and yield when harvesting crops. * **500-Level Hoe Enchants**: Expanded XP Booster, Essence Finder, and Crop Doubler max levels to 500 with cheaper per-level costs, smaller per-level multipliers, and UI descriptions. * **Essence Generator Slots**: Added Essence generator slot purchases in `/genshop` (500 Essence per slot, configurable max cap of 25 slots). * **1.5x Sell Wands**: Converted Sell Wands to cost 1000 Essence (no longer buyable with money) with a 1.5x sell multiplier. * **Sell Wand Placeholder Fix**: Added dual placeholder mapping for `<price>` and `<cost>` in the Sell Wand shop button component. * **Tool Texture Sprite Fix**: Added full `minecraft:items` namespace prefixes to all tool item sprite tags in language bundles (`en`, `de`, `es`, `fr`, `zh`). * **Multi-Level Hoe Enchantment Slider**: Added interactive level selection slider dialog for multi-level hoe enchantments (such as XP Booster, Essence Finder, Crop Doubler), dynamically capped to the player's remaining levels to max. * **Scoreboard Clean-Up**: Removed XP display line from default sidebar scoreboards across all language bundles. * **Tablist Prestige Display**: Added configurable tablist player name formatting (`<white>{player}</white> <gray>[P{prestige}]</gray>`), rendering player prestige level directly to the right of their name in the tab list.

* **Multi-Language Support**: Added translation support for English, Spanish, German, French, and Chinese. * **Automatic Language Matching**: Matches each player's language automatically based on their Minecraft client settings. * **Global Language Option**: Added a config setting to enforce one language for the entire server. * **Translated Menus and Items**: Translated scoreboards, tab lists, custom items, sell wands, and shop menus into all supported languages. * **Live Item Updates**: Custom items in player inventories automatically update names and descriptions when switching client language. * **Protected Data Storage**: Moved player data, generator locations, and farm regions to `plugins/GenSproutData/` to prevent loss during config resets. * **Automated Test Runner**: Added `gensprouttest.bat` to build and test the plugin locally before release.

* **Reach Hoe Enchantment**: Added Reach enchant to Sprout Hoe (levels 1-5), extending block interaction range via Paper attribute modifiers. * **Crop-Only Auto-Sell Hoe Enchantment**: Added 1-level Auto-Sell enchant (5,000 Essence cost) to Sprout Hoe that auto-sells only crops. * **Configurable Start Commands**: Added support for executing player and console commands (e.g. `/plot auto`) when executing `/start`. * **Starting Tutorial Dialog Flow**: The starting tutorial Paper Dialog pops up on a player's first join and when executing `/help` (or `/gensprout help`). Executing `/start` claims items without opening the dialog. * **Universal /help Command Override**: Overrode Bukkit, Vanilla Minecraft, and plugin `/help` commands (`/help`, `/minecraft:help`, `/bukkit:help`, `/gensprout:help`) to display GenSprout's starting guide dialog. * **Release Note**: Version 1.1.3 development build was cancelled and merged into 1.2.0-beta1.

* **Sprout Hoe Upgrade Menu**: Right-clicking with a Sprout Hoe now opens the upgrade menu directly without needing to sneak. * **Pause Menu Links**: Added support for customizable server links (Shop, Discord, Rules, etc.) in the Minecraft pause menu (`Esc` menu). * **Tab Auto-Completion**: Fixed and expanded tab completion across all commands, adding smart filtering and auto-complete for subcommands, player names, generator tiers (1–25), item amounts, and target selectors. * **`/execute` & Datapack Support**: All player and admin commands can now be run seamlessly via command blocks, datapacks, and `/execute` using target selectors (`@p`, `@a`, `@r`, `@s`).

not important

# 🌾 GenSprout - Changelog ## 🚀 Version 1.1.0 ### 🌾 Farming & Prestige * **100% Per-Player Instanced Farms**: Shared farm regions are now completely instanced per-player! Each player has their own independent crop state and regrowth timers—when Player A harvests a crop, it enters regrowth ONLY for Player A, remaining fully grown and harvestable for Player B. * **Crop Unlocks**: Unlock higher tier crops (Wheat → Potatoes → Carrots → Beetroots) as you level up and prestige. * **Smooth Growth Animations**: Clean crop growth with zero visual flashes or glitches. * **On-Screen Alerts**: Includes live action-bar XP progress bars and a big "PRESTIGE AVAILABLE" announcement when you reach prestige requirements. ### 💰 Standalone Economy & Vault Support * **Built-in Vault Economy**: Now only requires Vault! Includes a built-in economy system so you don't need EssentialsX or third-party economy plugins to play. * **Seamless Compatibility**: Automatically connects to EssentialsX, CMI, or other economy plugins if installed. * **Startup Checks**: Automatically checks for Vault on startup and alerts admins if Vault is missing. ### 🪄 Sell Wands & Auto-Sell * **Sell Wands**: Right-click chests, barrels, or containers with a Sell Wand to instantly sell all sellable items inside. * **Auto-Sell**: Option to automatically sell harvested crops and generator drops the moment you pick them up. ### ⚙️ Generators, Shops & Anti-Lag * **Upgradeable Generators**: Place generator blocks that produce sellable drop items over time. Upgrade generator tiers to earn higher payouts. * **Paper Dialog Building Shop**: Dedicated `/shop` (`/supplies`, `/bshop`, `/buildshop`) labeled "Building Shop" in `/gensprout`, built with native Paper 1.21 Dialogs containing 35+ building blocks and generator utilities. Redstone items removed to protect server TPS. * **AFK Anti-Lag Guard**: Generators pause automatically if too many uncollected items pile up nearby to keep your server running fast. * **Auto-Cleanup**: Generators clean up after themselves if broken by explosions, WorldEdit, or commands. ### 📢 Join MOTD, Tutorial & Starter Items * **`/start` Tutorial Command**: Added `/start` (`/sproutstart`, `/tutorial`, `/gensprout start`) to launch the interactive tutorial and claim starter items (1x Sprout Hoe + default generator allowance, i.e., 20 Tier 1 Generators). * **Tester Permission (`gensprout.tester`)**: Players with `gensprout.tester` permission can run `/start` multiple times for testing, while regular players can run it once. * **Manual Starter Item Claiming**: Disabled automatic item dumping into inventory on first join—players now run `/start` to claim starter items and learn mechanics at their own pace. * **Configurable MOTD**: Sends customizable updates and changelogs on player join. ### ⚡ Performance Improvements * **Lag-Free Harvesting**: Instant crop harvesting with background saving so player data never causes server lag. * **Flicker-Free Scoreboard**: Smooth, non-flickering sidebar scoreboard to track your level, balance, prestige, essence, and active generators. ### 🛠️ Enchants & Admin Tools * **`clearstats` Command**: Added `/gensprout clearstats <user>` command to reset all player stats (XP, level, prestige, essence, internal & Vault balance) for online or offline players. * **Sprout Hoe Enchants**: Upgrade your hoe with XP Booster, Essence Finder, Crop Doubler, Replenish, and 3x3 Area Harvest using Essence. * **Easy Admin Commands**: Commands to give generators, sell wands, hoe tools, generator slots, XP, money, clear stats, or define custom farm boundaries. <p> <a href="https://discord.gg/JshjxSMnjv"><img alt="discord-singular" height="56" src="https://raw.githubusercontent.com/MaboroshiKobo/branding/refs/heads/main/socials/128x/discord_icon_bg.png"></a> </p>

### Fixed - Fixed a bug where players could not enter or re-open dialog menus more than once. All click actions on dialog elements (both bootstrap launcher menu and dynamic shop menus) now support unlimited uses and do not expire. ### Changed - Upgraded the plugin version to `1.0.2` in `pom.xml` and `paper-plugin.yml`.