CobblemonQuests

[1.6.0] — 2026-04-19 — "Admin Control Update"

Total admin control over every aspect of the plugin. Configurable slot positions, custom command buttons, progress bar styling, reward display formats, event hooks, milestone pagination, admin quick actions, quest sorting, and optional Claim All / Community Goal buttons.

Added — Configurable Slot Positions & GUI Sizes

• Every button position is now a slot field in the config. Admins pick exactly which slot (0-53) each button occupies.
• rows field on every GUI menu (1-6). Resize any menu.
• daily-slots and weekly-slots arrays define exactly which slots hold quests in the main grid.
• milestone-slots array for the milestone GUI.
• player-slots array and max-entries for the leaderboard.
• quest-slot, claim-main-slot, claim-bonus-slot, reroll-slot for the detail GUI.
• All buttons have a visible toggle to show/hide them.

Added — Custom Filler Items

• filler-item field on every GUI. Set any item ID to replace glass pane backgrounds. Leave empty for default glass panes with bgColor.

Added — Custom Command Buttons

• custom-buttons array on every GUI. Each entry defines: slot, item, name, lore, glow, command.
• Commands run from console with {player} placeholder.
• Add unlimited custom buttons: store links, Discord, voting, etc.
• Example in config: { slot = 8, item = "minecraft:emerald", name = "<green>Store</green>", command = "openstore {player}" }

Added — Progress Bar Customization

• progress-bar section in main_menu.conf with: filled-char, empty-char, length, filled-color, empty-color, bracket-open, bracket-close.
• Change bar characters, colors, length, and brackets from config.

Added — Quest Name Format

• name-format field in quest-text: "{status}{type}{name}".
• Reorder or remove parts of the quest display name.

Added — Reward Display Format

• reward-formats section: customize how each reward type renders in lore. Fields: pokedollars, stars, item, crateKey, command with placeholders {amount}, {count}, {item}, {key}, {command}.

Added — Milestone Pagination

• Prev/Next page buttons when milestones exceed the slot count.
• Configurable prev-page and next-page buttons with slots.

Added — Configurable Leaderboard Layout

• player-slots array replaces the hardcoded pyramid. Place heads in any slot arrangement.
• max-entries controls how many players show.

Added — Quest Sort Order

• quest-sort-order in main_menu.conf: none, by-progress, by-rarity, alphabetical, by-status.

Added — Optional Claim All Button

• claim-all button section in main_menu.conf. Set visible = true to show it. {ready} placeholder shows claimable count.

Added — Optional Community Goal Button

• community-goal button section. Set visible = true to show when a server goal is active. {goal_name}, {progress}, {target} placeholders.

Added — Reroll Hint in Main Grid

• show-reroll-hint and reroll-hint in quest-text. When enabled, shows a hint line on quest items in the main grid.

Added — Event Command Hooks

• event-hooks section in config.conf. Fire console commands on:
  • quest-complete — {player}, {quest}
  • milestone-reached — {player}, {milestone}
  • streak-milestone — {player}, {streak}
  • claim — {player}, {quest}
• Wire up Discord webhooks, give items, broadcast messages, etc.

Added — Admin Quick Actions

• Right-click any quest in the main grid (with admin permission) to open a quick-action menu: Complete, Reset Progress, View Details. One-click admin management.

Added — Conditional Button Visibility

• All buttons have visible = true/false. Hide any button from any menu. Disabled features (milestones, streaks) auto-hide when enabled = false in config.

Changed — Shared renderButton Methods

• BaseGui now provides shared renderButton(), renderButtonGlowOverride(), fillBackground(), renderCustomButtons(), and handleCustomButtonClick() methods. Eliminates duplicate code across all 5 player GUIs.

Internal

• New QuestSortOrder enum with 5 sort modes.
• New EventCommandHooks dispatcher for event hook commands.
• New QuestAdminActionGui for admin right-click actions.
• GuiConfig expanded with CustomButton, ProgressBarConfig, RewardFormats inner classes. All menus have rows, fillerItem, customButtons, slot positions.
• GuiConfigLoader reads all new fields including int arrays, custom buttons, progress bar config, reward formats.
• Reward.summary(RewardFormats) overload for configurable display.
• CobblemonQuestsConfig.EventHooks inner class with hook lists.
• ConfigLoader reads event-hooks section.
• Event hooks wired into ProgressTracker, MilestoneManager, StreakManager, QuestClaimService.