Summary

Release 2.1.0 improves particles, debug logging, reload behaviour and the voucher shop GUI. These updates target stability (bossbar/manager lifecycle), compatibility across server versions, and clearer diagnostics for server owners.

---

Particles

• New: comprehensive particles configuration (particles.yml templates included: low / medium / high).
• New: example images and gallery link for reference.
  • Preview: !advanced configurable fly particles
• Config options:
  • effect: (enum) particle type
  • density: integer (affects visual intensity and cost)
  • interval: ticks between spawns
  • radius/offset: spawn area
  • cost-per-second: economy cost (if using Vault)
• Performance notes:
  • Use low/medium templates for busy servers.
  • Disable particle features per-world or via permissions to reduce load.
• Troubleshooting:
  • If particles don't appear, verify particles.enabled: true and permission nodes (e.g., ezflytime.particles.*).

---

Debug mode

• Expanded debug logging across voucher detection, PDC reads, material resolution, bossbar lifecycle, and reload flow.
• How to enable:
  • config.yml: debug: true
  • Logs will print: item types, display names, lore, PDC presence, material resolution fallback paths.
• Use cases:
  • Diagnose voucher mismatches (PAPER vs FEATHER vs legacy names).
  • Verify bossbar creation/cleanup during reload.
• Tip: capture full server log when reproducing issues and share only relevant debug blocks.

---

/flytime reload

• Now reloads ALL configuration files and safely recreates managers:
  • Calls dispose() on existing managers to stop tasks, unregister events and clear bossbars.
  • Reloads vouchers, bossbar, particles and GUI resources from disk.
• Fixes:
  • Prevents bossbar duplication on reload by clearing previous bossbars before creating new ones.
  • Ensures plugin version in plugin.yml is filtered from pom.xml at build time.
• Recommended workflow:
  • Edit configs → /flytime reload (or restart).
  • If bossbar is missing after reload: check logs for "BossBar:" debug lines, ensure bossbar.enabled: true, and confirm player has required permission.

---

Voucher Shop GUI

• Detection robustness:
  • Voucher matching now prefers PersistentDataContainer (PDC) but falls back to legacy display-name and lore when PDC is absent.
  • Material resolution unified via MaterialResolver to avoid LEGACY_* mismatches across server versions.
• GUI changes:
  • GUI creation uses the same resolver/path as voucher parsing — eliminates inconsistencies between shop display item and stored voucher.
  • Improved user-facing display names & lore templates; shop screenshot link: !Flight time voucher GUI shop
• Diagnostics:
  • Debug logs show: item type, meta (name/lore), expected voucher material and resolution path.
• Troubleshooting:
  • If vouchers are not redeemed:
    • Check debug logs for PDC keys presence.
    • Confirm GUI-made items and given vouchers share material/name/custom-model-data.
    • Test on a clean server to rule out external plugins stripping metadata.

---

Administrative & Misc

• Commands:
  • /fly — toggle flight (with fallbacks).
  • /flytime — show remaining time or (no args) open voucher shop GUI for players with ezflytime.buy.
  • /flytime reload — reloads configuration and safely recreates managers.