Changelog

v2.6

Features

• Global vanilla advancement broadcast - New vanilla-advancements section in config.yml:

  • enabled: Global toggle for the default broadcast message (per-advancement overrides in vanilla-messages.yml still work independently via /padv gui)
  • message: Default broadcast format for all vanilla advancements, supports all color formats (&#RRGGBB, <gradient>, & codes, MiniMessage), PlaceholderAPI (%hexnicks_nick_mm% etc.), and %player%/%advancement%/%description% placeholders

• Namespace-based webhook filtering — New webhook.namespaces section in config.yml:

  • enabled: Toggle namespace filtering (default: true)
  • allowed: List of namespace prefixes allowed to send Discord webhooks (default: ["minecraft:"])
  • When enabled, only advancements belonging to allowed namespaces send webhooks
  • Works for both custom advancements (via tab namespace) and vanilla advancements (minecraft: prefix)
  • When disabled, all advancements can send webhooks (v2.5 behavior)

• Placeholder condition for any trigger — The existing placeholder/placeholderOperator/placeholderValue fields now work as an optional condition on any trigger type (not just PLACEHOLDER). When set, the advancement only progresses if the PlaceholderAPI placeholder meets the condition. Example: trigger: BREAK_BLOCK + placeholder: %player_y% + placeholderOperator: <= + placeholderValue: 100 restricts the advancement to below Y=100. Configured via web editor (v2.6+ gated) or directly in YML.

Bug Fixes

• UserNotLoadedException crash on /padv reload - Fixed a major race condition where UAA ( UltimateAdvancementAPI) would throw UserNotLoadedException when the plugin tried to interact with players too soon after a reload. Added three layers of protection:

  • UAA pending guard: Players are tracked in a pending set on join/reload; onPlayerMove silently skips them until UAA finishes loading
  • Safety timeout: Pending entries auto-expire after 15 seconds to prevent players from getting stuck
  • Tab show retry: showTab() retries up to 5 times with exponential backoff (10 → 20 → 40 → 80 → 160 ticks) if UAA hasn't loaded the player yet

• UserNotLoadedException crash on PlayerMoveEvent - All UAA API calls inside onPlayerMove (isGranted, getProgression, incrementProgression) are now fully protected, eliminating spammy stack traces after join or reload

• NoClassDefFoundError when WorldGuard not installed - Fixed REGION_ENTER trigger crashing with NoClassDefFoundError: com/sk89q/worldguard/WorldGuard on servers without WorldGuard. Added plugin presence guard at method entry and changed catch (Exception) to catch (Throwable) since NoClassDefFoundError extends Error, not Exception

• ConfigUpdater duplicated vanilla-tab-order keys — Fixed a bug where vanilla- prefixed tab order keys (vanilla_story, vanilla_nether) were incorrectly added alongside the correct keys during config updates. The updater now skips vanilla-tab-order (user data, not config schema) and migrates any existing corrupted keys to their correct names.

• Webhook avatar missing for custom advancements — Fixed author.icon_url / thumbnail.url in webhook.yml not falling back to the default player avatar when PlaceholderAPI replacements leave unresolved placeholders (e.g., %skinsrestorer_texture_id_or_steve%). Now auto-fills with player head if the resolved URL still contains %.

---