CobblemonQuests

[1.6.3] — 2026-04-20 — "Readable Rewards"

Targeted fixes from a server-admin bug report. No breaking config changes — existing config.conf files work unchanged.

Fixed — Reward tooltips showed raw item IDs

• Player-facing reward lines rendered item rewards as 10× cobblemon:rare_candy instead of the localized Minecraft item name (10× Rare Candy). The raw id was coming straight out of Reward.summary(fmt) into the {item} placeholder.
• {item} now resolves through a new util/ItemNames helper: admin override map → Minecraft registry localized name → raw id fallback (with a single WARN per unknown id, no log spam).
• {key} for CRATE_KEY rewards honours the same override map so crate keys can be renamed without a per-reward override.
• Admin GUIs, audit logs, and failure reports still use the raw id via the no-arg summary() — operators need to see what a reward actually is, not its pretty name.

Added — rewards.display-names rename map

• New optional HOCON block in config.conf:

  rewards {
    display-names {
      "cobblemon:rare_candy" = "Rare Candy"
      "weekly" = "Weekly Crate Key"
    }
  }
  

• Values win over the registry lookup, so admins can ship a fully-branded tooltip set without touching every quest file.
• Empty block is written on first save with an inline comment so the feature is discoverable.

Added — Per-reward display override now round-trips

• ConfigWriter.writeReward was dropping the existing display = "<custom MiniMessage>" field on save. Admin-edited quests that round-tripped through the config GUI lost their overrides.
• The field is now persisted alongside the other reward properties.

Added — /questsadmin debug stars <player> + DEBUG log

• New subcommand prints starsBalance and lifetimeStarsEarned for a player. Admins can use it to reproduce a "stars not awarded" report against the authoritative player-data store (rather than a possibly-stale GUI view).
• ImpactorEconomy.depositStars now logs player, amount, before, and after at DEBUG level on every credit — off by default, enable with -Dorg.slf4j.simpleLogger.log.CobblemonQuests=debug or the equivalent log4j/logback config.

Technical notes

• ItemNames caches its "unknown id" warning set per JVM, so a typo in a hot GUI path logs once instead of on every open.
• The stars deposit path itself is unchanged; the earlier reports appear to be reproducible only through the claim-mode = manual click flow (which is working as designed). The new diagnostics are for localizing any future report to balance / UI / flow.