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.
- 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:
- 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.