✦ Developer API (new)

• Full public API via Bukkit ServicesManager
• WWKHarvestAPI.getOptional(getServer()) — safe instance access
• getPlayerData(), getActiveEvent(), isEventActive(), getTopPlayers()
• getPlayerMissions(), getPlayerAchievements(), getPlayerTickets()
• getCurrentSeason(), getSeasonDaysRemaining(), getLiveTop()
• 6 custom cancellable Bukkit events for third-party integration:
  • HarvestEventStartEvent / HarvestEventEndEvent
  • PlayerCropHarvestEvent — cancellable, modify harvest amount
  • PlayerMissionCompleteEvent
  • PlayerAchievementUnlockEvent
  • PlayerTicketEarnEvent

✦ Multi-World Support (new)

• Each world can have its own crop list, multiplier and enabled state
• Falls back to global config if world-specific key is missing
• allowed-crops: ALL to allow every crop in a world

✦ In-Game Admin Editor (new)

• Open with /harvest editor
• Edit missions, achievements and seasons directly in-game
• No yml editing required — changes save and apply instantly
• No restart or reload required

✦ Smart Auto-Updater (new)

• Three clear console states: UPDATE_AVAILABLE, DEV_BUILD, UP_TO_DATE
• Admins notified in-game on join when a new version is available
• /harvest update to check manually
• Set spigot_resource_id: 0 in config to disable

✦ New Commands

• /harvest editor — open in-game admin editor (admin)
• /harvest update — check for updates (admin)
• /harvest spendticket — spend tickets via command
• /harvest redeemticket / /harvest redeemmedal — redeem items via command

✦ 2 New Crops

• Torchflower (TORCHFLOWER_CROP) — Sniffer plant, 1.20+
• Pitcher Crop (PITCHER_CROP) — Sniffer plant, 1.20+
• Total crops now: 14

✦ Code Quality

• MiniMessage throughout — full gradient and hover support
• Zero hardcoding — every value configurable
• All DB and file I/O fully async
• @NotNull / @Nullable on all public API methods

✦ Compatibility

• Tested and compatible with Paper 1.21 through MC 26.x
• Java 21+ required

Multi-Language System

• Added full multi-language support — set language: en or language: es in config.yml
• All visible text is now controlled by messages_en.yml and messages_es.yml
• English is now the default language for broader compatibility
• Easy to add new languages — just create messages_XX.yml

✅ What's translated

• All chat messages, titles and action bars
• BossBar and Scoreboard
• All 15 special items (names, descriptions, abilities)
• All GUIs — stats menu, ticket shop, medal shop, achievements, missions
• All crop names
• All achievement announcements
• Season end messages

Bug Fixes

• Fixed automatic event not starting after server restart
• Fixed duplicate "event starts in 1 minute" message
• Fixed medal shop button not opening the GUI
• Fixed scoreboard title not updating dynamically
• Reduced scoreboard and action bar update frequency to reduce flickering

✦ WHAT'S NEW IN v3.0

Medal System (new)

• Full medal system with 3 tiers — Gold (1st), Silver (2nd), Bronze (3rd)
• Medals are physical stackable items with configurable custom_model_data for resource packs
• Independent Medal Shop (/evento tiendamedallas) separate from the Ticket Shop
• Mixed-cost items requiring medals + tickets simultaneously — deeper economy
• /evento darmedalla <player> <gold|silver|bronze> [amount] admin command
• PlaceholderAPI placeholders for medal counts (%eventocosecha_medallas_oro%, etc.)
• Medals configurable per position — amount, type, even give multiple types at once
• Participation reward now supports tickets and medals in addition to money

Shops (new)

• Both shops have independent toggles — disable either if you use NPC shops
• When a shop is disabled, its button is hidden from the menu and commands return a clean message
• Medal Shop shows live balance of medals AND tickets in the top row
• Items with mixed cost (medals + tickets) show clearly what you can and cannot afford
• Survival section in Ticket Shop — enchanted weapons, material kits, food kits, crate keys, ranks
• Guante Rustico added to Ticket Shop (removes mining fatigue passively)
• Varita del Cosechador added to Ticket Shop (highlights ripe crops with particles)

Daily Missions (new)

• 3 missions per day per player — Easy, Normal, Hard — randomly assigned from a configurable pool
• 6 mission types: harvest N crops, reach N points, finish top 3, win an event, participate N times, harvest a specific crop
• Missions reset automatically at midnight (server time)
• Configurable reward per mission: tickets + optional money
• Progress tracked in real time during events
• Full database persistence — progress survives disconnects and restarts

Achievements (new)

• 14 unlockable achievements across 7 types: wins, streaks, participations, points, distinct crops, perfect score
• Each achievement has its own reward: tickets + physical item + optional commands
• Global announcement when a player unlocks an achievement
• Achievement progress visible in /evento menu

Season System (new)

• Configurable season duration in days
• End-of-season prizes for top 3 players: tickets + money + commands
• Optional reset of wins, streaks, achievements and ticket inventory at season start
• Season number and days remaining available as PlaceholderAPI placeholders

Win Streaks & Cooldowns (new)

• Win streak tracking with global announcement at configurable threshold
• Separate racha_primero counter — consecutive first-place finishes
• Winner cooldown system — blocks prizes after N consecutive wins to prevent domination
• All streak data persisted in database

Permissions (new)

• evento.use permission added and applied to all player-facing commands
• evento.admin now inherits evento.use automatically via plugin.yml hierarchy
• Players without evento.use cannot open shops, menu or see top

Bedrock Compatibility (new)

• All MiniMessage gradients replaced with solid colors across all Java files and config.yml
• Tested across ItemsEspecialesManager, GUIManager, GUIListener, CosechaListener, ConfigManager and EventoManager
• Custom model data on medals and ticket is optional — plugin works without a resource pack

Bug Fixes & Improvements

• Scheduler task for daily purge now stored and cancelled properly on onDisable — fixes reload crashes
• Orphaned MiniMessage closing tags removed — no more visible </gold> text in GUIs
• plugin.yml updated with full command usage, permission hierarchy and website field
• Oraxen removed from softdepend — loaded via reflection only, no declaration needed

Fixed auto-updater incorrectly reporting a new version available when the plugin was already up to date.

Complete rewrite with major new features:

- Anti-farm: each block scores only once per event, resets when it grows back
- MySQL support with automatic fallback to stats.yml
- /cosecha stats [player] — works for offline players too
- /evento top — no permission required, shows your own position if outside top 3
- /evento siguiente — countdown to next event (no permission needed)
- /evento historial — last 10 events with date, crop and TOP 3
- Win streak system with configurable title, subtitle and sound
- Winner cooldown — previous winner can't receive prizes back-to-back
- Universal reward system via console commands (any plugin compatible)
- Configurable streak broadcast, title and sound in config.yml
- Fixed %cosecha_victorias% placeholder path