ВЕРСИИ (25)

Fixed {description} placeholder in messages.

# Changelog ## v3.2 ### Features !!! Updated Support to 26.3! From on now please use MINIMUM UltimateAdvancementAPI 3.0.0-beta-4 !!! - **MythicMobs filter for the KILL trigger** - Restrict a `KILL` advancement to a specific MythicMobs mob, faction, and/or level range. MythicMobs is a soft dependency (optional). - Set the mob's internal name via the in-game GUI (slot 20 of the KILL editor) or the web editor (v3.2+ gated), or directly in YAML (`mythicMob`, `mythicFaction`, `mythicMinLevel`, `mythicMaxLevel`). - Mob names and factions are matched case-insensitively; the GUI validates the mob ID against the installed MythicMobs before saving. - Kill detection uses `MythicMobDeathEvent` combined with the standard Bukkit `LivingEntity#getKiller()` tracking, so the killer is resolved reliably even though MythicMobs' own `getKiller()` is not populated at death time. - If MythicMobs is missing, filtered advancements are disabled with a console warning and an in-game admin notification , mirroring the existing WorldGuard `REGION_ENTER` behaviour. - **UltimateAdvancementAPI 3.0.0-beta-4** - Upgraded the hard dependency from `3.0.0-beta-3` to `3.0.0-beta-4` (API-compatible and backward-compatible with beta-3). - **Hide custom tabs from the vanilla advancements GUI** - New `hide-tabs-from-vanilla-gui` config option. When enabled, PremiumAdvancements custom tabs are not shown in the vanilla advancements screen (the L key), while all advancement functionality (progression, rewards, placeholders, webhooks, `/padv` commands) keeps working. Useful for using the plugin purely as an advancement backend and building a custom GUI with plugins like CommandPanels. - **Silent advancement grant** - `/padv give <player> <advancement> --silent` (also `-s`, `--NoMessages`, `--NoFeedback`) now grants without sending the "You have been granted..." notification or the admin success message. - **Minecraft 26.3 support** - Added Paper/Spigot/Purpur 26.3 to the CI compatibility matrix. - **Web editor icon library expansion** - Added ~150 new icons to the icon picker: all wood types (and their stripped variants), copper doors/bars/chains/lanterns/golem-statue with their oxidation and waxed variants, cut copper stairs & slabs, all 23 pottery sherds, leather/iron/golden/diamond horse armor, 10 banner patterns, 19 smithing templates (armor trims + upgrade), 16 colored bundles, 16 colored ghast harnesses, and misc items (spawner, breeze rod, stick). The icon downloader (`scripts/download_icons.py`) now resolves the correct inventory item textures. - **Searchable connection target dropdown** - The "Connection Target" field in the web editor is now a single searchable combobox: type directly in the field to filter the advancement list inline, with the first match auto-highlighted , no more scrolling through a long list. - **Enchanted icon glint** - New "Enchanted Glint" toggle (web editor, and `iconEnchanted: true` in YAML) that renders the advancement icon with an enchantment glint in the vanilla advancements GUI. ### Fixes - **Placeholder condition missing from the create GUI** - The placeholder condition slot (slot 35, the "redstone powder") now appears in the create GUI, not just in the edit GUI of existing advancements. - **`REGION_ENTER` trigger not firing** - The region check now uses the player's destination block (`PlayerMoveEvent#getTo()`) instead of a possibly-stale `player.getLocation()`, and the region handler no longer silently swallows WorldGuard errors (it logs them). Added diagnostic logging. - **`DisposedException` spam / memory pressure on reload** - Replaced per-unit `incrementProgression()` loops with a single batched `incrementProgression(player, N)` call when restoring progression. A `requiredAmount: 350000` advancement previously queued 350,000 async UAA progression updates per player on load/complete - if a `/padv reload` happened during the flush, that burst into thousands of `AdvancementTab is disposed` warnings and allocated large amounts of memory. Each path now sends one update instead of N: - `PlayerDataListener.onPlayerLoadCompleted` - completed/in-progress restoration uses a single call. - `TriggerService.completeAdvancement` / `completeAdvancementForced` - "catch-up to max" uses a single call. - `TriggerService.recheckDependents` - dependent progression sync uses a single call. ---

# Changelog ## v3.1 ### Features - **COMMAND trigger** - Fires when a player executes a specific command (e.g. `/sethome`, `/home`, `/spawn`). Configure one or more command names via the in-game GUI, the web editor, or directly in YAML (`command: sethome`). - Matching is case-insensitive and ignores the leading slash. A filter matches the exact command name, the full command, or a command with arguments (`sethome` also matches `/sethome home1`). Use `sethome home1` to match only that specific argument. - Leave the filter empty to match any command (useful for "run X commands" counters, controlled via `amount`). - Fully integrated with the existing filter/reward/broadcast/webhook/progression systems. ---

# Changelog ## v3.0 ### Compatibility - **Minecraft 1.20, 1.20.1, 1.20.2, 1.20.4, 1.20.5, 1.20.6 support** - The plugin now loads and runs on **Paper/Spigot/Purpur 1.20.4+** in addition to 1.21.x and 26.x: - **`plugin.yml`** - `api-version` lowered from `1.21` to `1.20`, which unblocks loading on 1.20.x servers (Paper previously rejected the plugin at startup with `Unsupported API version 1.21` while keeping all modern API behavior on newer servers). - **`pom.xml`** - the plugin is now compiled against `paper-api 1.20.4-R0.1-SNAPSHOT` (the lowest supported version), so any API usage missing on 1.20.4 becomes a compile error instead of a runtime `NoSuchMethodError`/`NoSuchFieldError` on older servers. All Paper-specific code (`AdvancementDisplay`, `PlayerTradeEvent`) already existed in 1.20.4 and remains guarded by runtime checks on plain Spigot. - **`AdvancementTriggerListener`** - `Material.OMINOUS_BOTTLE` (added in 1.20.5) was referenced directly in the static `DRINKABLE_ITEMS` initializer, crashing startup on 1.20.4 with `NoSuchFieldError`. The set is now built at runtime via `Material.getMaterial("OMINOUS_BOTTLE")`, so it is silently skipped on versions where it doesn't exist. - **Java 17 bytecode** - the plugin is now compiled with `--release 17`, so it also loads on Java 17 servers (the standard runtime for MC 1.20 - 1.20.4). MC 1.20.5+ still runs on Java 21+. - **CI** - the compat matrix now covers 1.20, 1.20.1, 1.20.2, 1.20.4, 1.20.5 and 1.20.6 across Paper/Spigot/Purpur (Java 17 image for 1.20 - 1.20.2, Java 21 for 1.20.4+), in addition to the existing 1.21.x and 26.x combinations. ### Fixes - **Plugin failing to load on Minecraft 1.21** - Fixed a `NoSuchFieldError` crash at startup on 1.21 servers: `Material.PALE_OAK_LOG` and other Pale Garden materials (added in 1.21.4) were referenced directly in static field initializers, which threw `java.lang.NoSuchFieldError: Class org.bukkit.Material does not have member field 'org.bukkit.Material PALE_OAK_LOG'` and prevented the plugin from enabling entirely. - **`AdvancementTriggerListener`** - the `LOG_BLOCKS` set (used by `CHOP_TREE` and the GUI validation) is now built at runtime via `Material.getMaterial(name)`, so materials that don't exist on the running server are silently skipped instead of crashing the class initializer. - **`AdvancementManager`** - the same runtime resolution was applied to the block types auto-assigned to `CHOP_TREE` advancements when loading YAML files. - Result: the plugin now loads on 1.21, 1.21.4, 26.1 and 26.2 (Pale Oak simply doesn't count toward `CHOP_TREE` on versions where it doesn't exist). - **Duplicate advancement grants (rewards given multiple times)** - Fixed a critical bug where a player could receive the same advancement (and its rewards) repeatedly. Root cause: the 30-second PLACEHOLDER scheduler task ("Task #86") called `isGranted()` without a `try/catch`. When UltimateAdvancementAPI hadn't finished loading the player yet (asynchronous user loading, aggravated during the UAA 2.8 → 3.0.0-beta-3 migration), it threw a `UserNotLoadedException` that crashed the whole task and left the advancement looking "not granted". On subsequent cycles, `forceComplete()` re-granted and re-distributed rewards in a loop because it had no idempotency guard. - **Scheduler (`PremiumAdvancements`)** - `isGranted()` is now wrapped in a `try/catch` that skips the player's check silently when `UserNotLoadedException` (or any API error) is thrown, instead of crashing the task or treating the advancement as unearned. - **`TriggerService.completeAdvancementForced`** - added an idempotency guard (`alreadyCompleted` check + a database `hasAdvancement` re-check) before granting. Rewards are no longer given when the grant throws an exception; the player is skipped and a later cycle can retry once the user is loaded. - **`TriggerService.completeAdvancement`** - same defensive guards applied to the normal grant path, with `UserNotLoadedException` handled silently (no blocking error log, no reward). ---

# Changelog ## v2.9 ### Fixes - **Main-thread SQLite blocking during player quit** - `onPlaytimeQuit`, `onPlaytimeJoin`, and login streak processing now run database operations asynchronously. This eliminates 15-40 second watchdog timeouts when SQLite write contention occurs on the main thread. - `savePlaytimeFor()` - now wraps `setPlayerData()` in `runTaskAsynchronously` - `processStreak()` - entire body runs async, UAA API calls dispatched to main thread via `runTask` - `incrementStreakSync()` / `resetStreakSync()` - DB writes async, in-memory cache updates stay fast - **Removed `Thread.sleep(50)` in `PlayerDataListener.onPlayerQuit()`** - the 50ms main-thread block is eliminated; progress sync now uses `runTaskAsynchronously` - **Text support in placeholder conditions** - `checkPlaceholderCondition()` now supports string comparisons (`==`, `!=`, `contains`) when the placeholder returns text instead of a number. Enables filtering triggers by day name (`%localtime_time_E% == Fri`), player name, biome, etc. - **Spigot compatibility for vanilla advancement display** - Fixed `ClassCastException` on Spigot when reading vanilla advancement display data. Uses `instanceof` check with fallback to Bukkit API (`getTitle()`, `getDescription()`, `getType()`) when Paper API is unavailable. Affects vanilla webhooks and vanilla advancement loading in the editor. ### Fixes - Web Editor - **Advancement disappearing after ID rename** - Fixed `_initTabIds()` stale cache issue. After renaming an advancement ID (e.g. `new_advancement` → `test`), the non-reactive `_idSets` was never re-synced, causing subsequent operations to overwrite `tab.advancementIds` and drop renamed advancements from the sidebar. - **ID rename silently corrupting on duplicate** - Renaming to an ID that already exists in another tab now shows a toast `ID "x" already exists in tab "y"` and safely reverts the ID instead of silently corrupting the advancement object. - **ID rename watch triggering on tab switches** - The rename watcher no longer fires when switching tabs or creating new advancements, preventing false "ID already exists" toasts. - **Toast disappearing too fast** - Fixed timer collision where a new toast inherited the remaining timeout of a previous toast, causing it to vanish almost instantly. - **Toast stacking** - Multiple toasts now stack on top of each other with slide/fade transitions instead of replacing each other.

WARNING FROM ON NOW YOU NEED [v3.0.0-beta-3](https://modrinth.com/plugin/ultimateadvancementapi/version/3.0.0-beta-3 ) MINIMUM of UltimateAdvancementAPI for PremiumAdvancement V2.8+ to work. # Changelog ## v2.8 ### Features - **UltimateAdvancementAPI 3.0.0-beta-3 migration** - Full migration from UAA 2.8 to 3.0.0-beta-3. - `createAdvancementTab(namespace, background)` - background texture now passed directly (removed from `RootAdvancement`) - `AdvancementDisplayBuilder` - replaces the deprecated v2.8 constructor - `BaseAdvancement` parameter order changed to `(parent, key, maxProgression, display)` - `registerAdvancements(root, Set<BaseAdvancement>)` - replaces varargs overload for 6+ advancements - All runtime reflection fallback code removed (no more `NamespacedKey` workaround) ### Fixes - **`/padv give` error on UAA 3.0** - Fixed `adv.getApiAdvancement() == null` causing `"this advancement is not initialized"` message. The root cause was UAA 3.0 changing `createAdvancementTab(String)` to `createAdvancementTab(NamespacedKey)`, causing silent tab creation failure. - **Empty reward messages** - Reward confirmation messages (`money-received`, `commands-received`) no longer send empty lines to chat when left blank in the language file. - **`/padv take <tab:adv>` not persisting** - Fixed prefix mismatch: when using tab-qualified IDs (e.g. `new_tab:new_advancement`), the DB revoke was using the raw input `"new_tab:new_advancement"` instead of the internal ID `"new_advancement"`. Also added a player-load safety check that auto-corrects any stale UAA grants. ---

# Changelog ## v2.7.2 ### Features - **Vanilla broadcast namespace filtering** - New `vanilla-advancements.namespaces` config section. When enabled, only advancements from allowed namespaces (default: `minecraft:`) receive the custom broadcast. This excludes datapack advancements from being broadcast. Per-advancement overrides in `vanilla-messages.yml` always take priority regardless of namespace filtering.

# Changelog ## v2.7.1 ### Bug Fixes - **Broadcast not visible to completing player** - Fixed an issue where the custom vanilla advancement broadcast was not shown to the player who completed the advancement (others saw it fine). Now uses per-player `sendMessage()` for all players including the completer, and suppresses the vanilla message via `event.message(null)` to avoid duplicates. - **Chat plugin compatibility** - Replaced `Bukkit.broadcast()` with per-player `Player.sendMessage()` in all broadcast paths to bypass chat formatting plugins (ChitChat, DeluxeChat, etc.) that intercept broadcast messages. ---

# Changelog ## v2.7 ### Bug Fixes - **ProGuard obfuscation breaking Paper API & Adventure** - Added `-keep` rules for `io.papermc.paper.**`, `net.kyori.adventure.**`, and `net.kyori.examination.**` in the ProGuard config. Without these, the obfuscator would rename Paper and Adventure classes at runtime, breaking vanilla advancement webhooks, `AdvancementDisplay` title/description retrieval, and `Bukkit.broadcast(Component)` calls. - **Spigot compatibility** - The plugin no longer crashes on startup or during runtime on Spigot servers: - `PlayerAdvancementDoneEvent` webhook listener registered only if the event class exists (Paper-only) - `PlayerTradeEvent` TRADE trigger moved to `PaperCompatibility` listener (registered only on Paper) - `Adventure API` bundled directly in the JAR (unshaded) for Spigot servers that lack it - `sendActionBar(String)` and `Bukkit.broadcast(Component)` wrapped with fallbacks for Spigot - **`vanillaAdv.getDisplay()` null safety** - Added individual null checks and try-catch for `display.title()` and `display.description()` to handle edge cases where Paper API returns null Components.

# 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 `%`. ---

# Changelog ## v2.5 ### Features - **LISTEN_MUSIC trigger** - Fires when a player inserts a music disc into a jukebox. Supports filtering by specific music disc via the existing item/material system. - **PLAYTIME trigger** - Cumulative play time in minutes across all sessions. Checked every 30 seconds. Uses `amount`. - **LOGIN_STREAK trigger** - Consecutive daily logins. Streak resets to 0 if a day is missed. Uses `amount`. - **BIOME_ENTER trigger** - Enter a specific biome (e.g., `MUSHROOM_FIELDS`, `BADLANDS`). Filter by biome name via entity filter. - **VANILLA_ADVANCEMENT trigger** - Chain custom advancements on vanilla advancement completion. Filter by exact advancement key (e.g., `minecraft:story/mine_diamond`). - **REGION_ENTER trigger** - Enter a WorldGuard region (requires WorldGuard on the server). Filter by region name. - **Trigger list condensed** - In-game GUI now shows first 17 triggers with "and X more triggers" count; current trigger moved to bottom. - **53 total triggers** - Up from 48, covering the most requested trigger types. ### Fixes - **PlaceholderAPI support in webhooks** - Custom and vanilla advancement webhooks now resolve PlaceholderAPI placeholders (e.g., nicknames from nick plugins, prefixes from LuckPerms) via `PlaceholderAPI.setPlaceholders()` - **Vanilla broadcast preview colors** - Chat preview after setting a vanilla broadcast message now renders all color formats (`&#RRGGBB`, `<rainbow>`, `<gradient>`, `&` codes) instead of showing raw codes - **GUI lore colors** - "Current broadcast" in the vanilla advancements GUI now displays formatted colors via `AdvancementManager.translateAll()` - **Vanilla GUI navigation** - Added Back button (slot 49) to return to tab selector; empty navigation slots now filled with glass panes - **ConfigUpdater language files** - Language files are now always replaced on version bump (with backup) to apply value changes like new triggers in `trigger-types` ---

# Changelog ## v2.4 ### Features #### Custom Broadcast Messages for Vanilla Advancements You can now replace the default vanilla Minecraft advancement chat messages with fully customized broadcasts: - **New GUI** (`VanillaAdvancementsGUI`): When viewing a vanilla tab in `/padv gui`, left-click any vanilla advancement to set a custom broadcast message via chat input - **Per-advancement messages**: Each vanilla advancement can have its own unique broadcast format, stored in `vanilla-messages.yml` - **Full formatting support**: `&#RRGGBB` hex colors, `<gradient>`, `<rainbow>`, `<color:#XXXXXX>`, `&#` codes, and all standard `&` color codes - **PlaceholderAPI** support in custom messages - **Hover tooltip**: `%advancement%` automatically shows the advancement description as a hover tooltip in chat (gray text on hover) - **Placeholders**: `%player%`, `%advancement%` (with hover), `%description%` - **Right-click reset**: Right-click a vanilla advancement in the GUI to remove its custom message and revert to default - **Web editor integration**: Tab order for vanilla tabs synced between editor and in-game GUI ### Fixes - Fixed vanilla tab order keys being written with `vanilla_` prefix instead of proper key names in `vanilla-tab-order` - Fixed `vanilla-messages.yml` merge/persist to load existing file before saving (prevents data loss) - Fixed hover tooltip on `%advancement%` being lost when color formatting is applied

# Changelog ## v2.3 ### Features #### Vanilla Advancement Discord Webhooks The plugin now supports sending Discord webhooks for vanilla Minecraft advancement completions (e.g. "Stone Age", " Diamonds!"): - New `webhook.vanilla.enabled` option in `config.yml` (default: `false`) - When enabled, the plugin listens for `PlayerAdvancementDoneEvent` and sends a webhook for every vanilla advancement a player completes - Uses the same webhook URL and formatting from `webhook.yml` - Toggle available in the web editor's **Editor Settings** modal (gear icon) - v2.3+ only - Toggling via the editor and running `/padv apply` will update `config.yml` automatically #### NETHER_ROOF Trigger - Reach the Nether Roof New trigger type that fires when a player reaches the bedrock roof of the Nether (Y=128+): - First-time detection: only triggers once per server session - Available as a selectable trigger in the web editor dropdown (Movement category) - Integrates fully with all existing filter/reward/broadcast systems ### Changes - **WebhookManager** now implements `Listener` to handle vanilla advancement events ### Fixes - **Reward duplication glitch** - Fixed a race condition where rewards/commands could be granted multiple times for a single advancement completion when the async database save hadn't completed before the next trigger fired. Added a `pendingDbSave` tracking set to distinguish "save in progress" from "external reset"

# Changelog ## v2.2 ### Features #### DEATH Trigger - Expanded Death Causes & Entity Types The `DEATH` trigger now supports **15 built-in death causes** and **custom entity type matching**: - New causes: `DROWNING`, `VOID`, `EXPLOSION`, `STARVATION`, `POISON`, `WITHER`, `LIGHTNING`, `SUFFOCATION`, `MAGIC`, `FIRE` - `EXPLOSION` matches both `ENTITY_EXPLOSION` (creeper) and `BLOCK_EXPLOSION` (TNT) - Set `deathCause` to any entity type (e.g. `ZOMBIE`, `ENDERMAN`, `CREEPER`) for mob-specific deaths - In-game GUI: left-click cycles through all built-in causes, right-click opens chat input for custom entity/DamageCause - Web editor: "Custom..." option in Death Cause dropdown (v2.2+ only) with text input field #### Broadcast Tooltip (Hover) When a custom broadcast message is configured, `%advancement%` now automatically shows the advancement description as a hover tooltip (same as vanilla `[Title]` behavior). If the template already wraps `%advancement%` in a `<hover:>` tag, the auto-hover is skipped and the user's custom hover is respected. MiniMessage `<hover:show_text:'...'>` and `<click:open_url/run_command/suggest_command:'...'>` tags are now fully parsed via Adventure's native MiniMessage engine, so hover/click works in custom broadcasts alongside colors, gradients, and formatting. ### Fixes - **RAID_WIN triggered for all players** - now only triggers for players in `raid.getHeroes()` (actual raid participants) - **Duplicate broadcast message** - when a custom broadcast is configured, the API's built-in chat announcement is now suppressed (was causing double messages) - **`&e` color code leak in broadcast** - MiniMessage titles with unclosed `<rainbow>` tags no longer capture trailing `&e` from the broadcast template - **Reload crash after duplicate advancement IDs** - `unregisterUI()` now properly cleans up partially-initialized tabs, preventing permanent `AdvancementTab is already initialised` state - **Cross-tab connections** - advancements referencing a target in a different tab now fall back to root with a clear warning, preventing `AdvancementTab is already initialised` crash on reload - **Web editor broadcast preview** - `<hover:>` and `<click:>` tags are now stripped from the preview (rendered in-game only), so they don't appear as raw text

# Changelog ## v2.1 ### 🎯 Major Features #### 🎨 MiniMessage & Hex Color Support (Editor + In-Game) All color formats now work **everywhere** - web editor preview AND in-game rendering (L menu, GUIs, broadcasts, commands). In-game rendering supports: - **Legacy `&` codes** - `&0`-`&f`, `&l`/`&o`/`&n`/`&m`/`&k`/`&r` (unchanged, always worked) - **Hex `&#RRGGBB`** - Per-character hex colors rendered with proper `§x§R§R§G§G§B§B` Bukkit format - **MiniMessage named colors** - `<red>`, `<blue>`, `<light_purple>`, `<gold>`, etc. → § codes - **MiniMessage formatting** - `<bold>` → §l, `<italic>` → §o, `<underlined>` → §n, `<strikethrough>` → §m, `<obfuscated>` → §k, `<reset>` → §r - **Gradients** - `<gradient:gold:yellow>text</gradient>` - true per-character color interpolation (visible in L menu). Works with or without closing tag - **Rainbow** - `<rainbow>text</rainbow>` - per-character HSL hue cycling. Works with or without closing tag - **`<color:#RRGGBB>` and `<color:name>`** - Full support for both hex and named MiniMessage color tags Web editor preview: - **Color/Format Picker** - 🖌️ button next to Title and Description fields with 16 color swatches + 6 format buttons ( B/I/U/S/O/R), inserts `&` codes at cursor position - **Live preview** - `mcPreview()` renders all formats (MiniMessage, hex, gradients, rainbows, `&` codes) in editor tabs, sidebar, tree view, tooltips - **Version-gated** - Picker/preview only shown on v2.1+; older versions show plain text - **`expandHex()`** - Short hex `#rgb` auto-expands to `#rrggbb` for correct gradient interpolation - **Discord-safe** - Webhook embeds strip ALL color codes before sending to prevent raw markup in Discord #### 📑 Tab Order (In-Game GUI Sorting) Tabs in the advancement GUI (L key) are now sorted by configurable `tabOrder`: - Each tab has a numeric order value (default 999) - Vanilla tabs sorted via `config.yml` → `vanilla-tab-order` section (story: 1, nether: 2, end: 3, adventure: 4, husbandry: 5) - Changes survive plugin reload; persists from editor save to config #### 🖼️ Tab Root Icon Custom Model Data Tab settings now support `rootIconCustomModelData` for resource pack item variants on the tab root icon. ### ✨ Changes - **Inline command editing** - Click a reward command in the editor to edit it directly, instead of deleting and re-adding - **Icon browser** - Browse and select icons for tab root icon directly from the editor Tab Settings modal - **Color hints** - Title and description fields now show available color format hints - **Color picker popover** - Closes on outside click, follows Minecraft button styling - **Broadcast color preview** - Broadcast message field now has live `mcPreview()` rendering and a 🖌️ color picker with full swatches + format buttons - **Version detection** - Editor correctly gates color picker and v2.1 fields via `isV21Plus` check on `editorVersion` ### 🐛 Fixes - **CRITICAL**: Duplicating an advancement corrupted `tab.advancementIds` - fixed `_syncIds()` dedup and removed `deep: true` from tabs watcher - **CRITICAL**: Action bar / Toast / Announce toggles not persisting after reload - fixed `parseSingleAdvEntry` fallback chain - **CRITICAL**: Empty editor after ID change - removed stale `map[oldId].id === oldId` guard - **CRITICAL**: `mcPreview()` gradient rendering broken - `lerpColor()` now correctly expands 3-digit hex (`#rgb` → `#rrggbb`) via `expandHex()`, applied in `parseColor()` and all hex paths - **CRITICAL**: `mcPreview()` count stack corruption - close handler now only pops gradient/rainbow when the closing tag name matches - **Discord webhook** - Title and description now stripped of all color codes (`&`, `&#RRGGBB`, MiniMessage tags, `§`) before sending, preventing raw markup in Discord embed - Firefox modal bottom overflow - `max-height` now uses `min(85vh, 100dvh - 40px)` for dynamic viewport - Various z-index and modal layout fixes ### 💥 Breaking Changes - None - fully backward compatible with v2.0 data

# Changelog ## v2.0 ### 🎯 Major Features #### 📑 Multi-Tabs Support Advancements are now organized into multiple tabs, each as a separate `.yml` file in the `Advancements/` folder. - **Tab System** - Each file in `Advancements/` creates one tab in the Minecraft advancement menu (L key) - **Tab Selector GUI** - `/padv gui` now shows a tab selection screen when multiple tabs exist. Click a tab to view/edit its advancements - **Per-Tab Configuration** - Each file has its own `tab.namespace`, `root.icon`, `root.title`, `root.description`, and `root.background` - **Global IDs** - Advancement IDs are unique across all tabs. Commands like `/padv give`, `/padv take`, `/padv list` work globally - **Tab Placeholders** - New placeholders: `%premiumadvancements_tab_completed_<ns>%`, `_tab_total_<ns>%`, `_tab_percent_<ns>%` #### 🔄 Auto-Migration (v1.70 → v2.0) On first startup, if `advancements.yml` and/or `adv-gui.yml` are detected at the root: - **Backup** - Old files are copied to `backups/migration_YYYY-MM-DD_HH-mm-ss/` - **Merge** - A single `Advancements/default.yml` is created combining `adv-gui.yml` (tab config) + `advancements.yml` (advancements) - **Rename** - Old files are renamed to `.migrated` (never deleted) - **Notification** - Admins receive an in-game message with the backup path #### 🌐 Web Editor - Multi-Tab Support The web editor now fully supports multiple tabs: - **Tab Selector** - Dropdown at the top of the sidebar to switch between tabs - **Tab CRUD** - Create, rename, configure, and delete tabs directly from the editor - **Tab Settings** - Configure namespace, title, description, root icon, and background per tab - **Move Between Tabs** - In the Advanced tab of each advancement, a "Tab" dropdown lets you move advancements between tabs - **Version Gating** - Multi-tab features are only visible for v2.0+ data (old v1.70 data shows a single-tab editor) - **JSON Format** - New `{tabs: {namespace: {tab: {...}, advancements: {...}}}}` format for upload/download ### ✨ Changes - `/padv tabs` - New command listing all tabs with namespace + advancement count - `/padv wiki` - New command opening the plugin wiki link - `/padv info <id>` - Now shows which tab the advancement belongs to - `/padv reload` - Now properly reloads all tabs (unregisters and re-registers all) - `/padv apply` - Reload completes in 1 tick instead of 20 ticks (near-instant UI update) - `/padv gui` - Opens the TabSelectorGUI first when multiple tabs exist - GUI: "← Back to Tabs" and "≡ Tabs" buttons in the advancement list - Advancements/ folder auto-created with a `default.yml` resource file if empty - `config.yml` editor section validation no longer checks for `adv-gui.yml`/`advancements.yml` - **45 trigger types** - Added `MANUAL` (command-only) and `PLACEHOLDER` (PAPI-based) triggers - **14+ placeholders** - Added per-tab placeholders (`tab_completed`, `tab_total`, `tab_percent`) - **Web editor** - Custom Minecraft-themed dropdowns and scrollbars now properly applied - **Web editor** - Trust code modal shown on first visit for browser authorization - **Web editor** - Advancement ID changes now properly update the map key in real-time - **Language files** - Added `gui.back-to-tabs`, `help.commands.tabs`, `help.commands.wiki`, PLACEHOLDER input prompts #### 🧩 Vanilla Advancement Integration Minecraft's built-in advancements (Story, Adventure, Nether, End, Husbandry) are now loaded read-only: - **Auto-loaded** - All 125+ vanilla advancements loaded from Bukkit on startup - **Read-only** - Displayed in the web editor but cannot be edited or deleted - **Proper display** - Icons, titles, descriptions, and tree positions extracted via Paper API - **Hidden toggle** - Editor settings gear (⚙ in toolbar) lets you show/hide vanilla tabs in the dropdown - **Connection lines** - Vanilla parent-child tree structure preserved in the editor tree view - **Hidden advancements** - Properly filtered with the eye toggle in tree view - **No file persistence** - Vanilla tabs are never saved to `.yml` files, always reloaded from Bukkit #### 🖥️ Web Editor - Quality of Life - **Editor settings modal** - ⚙ gear button in toolbar opens settings with vanilla tabs ON/OFF toggle - **Cache busting** - Nginx ETag + no-cache headers so editor updates take effect without Ctrl+F5 - **__version__ persistence** - Editor version preserved in saved data so multi-tab mode survives Save → reload - **Tab row layout** - Improved button sizing and alignment in tab selector (⚙, +, vanilla toggle) - **Lock icon** - Vanilla advancements show a read-only lock indicator ### 🐛 Fixes - **CRITICAL**: `AdvancementTab is already initialised` error on reload - now reuses existing RootAdvancement - **CRITICAL**: `/padv gui` tab-filtered GUI not responding to clicks - fixed title collision with unfiltered GUI - **CRITICAL**: `/padv apply` deleting `default.yml` - file cleanup now checks YAML namespace, not just filename - **CRITICAL**: `/padv apply` failing with `DuplicatedException` - initSingleTab now catches all exceptions and falls back to `getAdvancementTab()` - **CRITICAL**: `/padv apply` creating vanilla `.yml` files on each apply - vanilla tabs are now properly flagged and excluded from file saves - **CRITICAL**: Web editor sidebar showed wrong trigger display - fixed Vue rendering with proper :key bindings - **CRITICAL**: Web editor advancement ID renames corrupted the map - now properly updates keys and tab lists - **CRITICAL**: Web editor `applyCustomDropdowns` and `applyCustomScrollbar` were never called - added lifecycle hooks - **File Name** - `saveTabToFile()` removes old files with matching YAML namespace but different filename (e.g. `default.yml` → `premium_advancements.yml`) - Version now correctly shows `2.0` in plugin.yml and PlaceholderAPI expansion - `gui.back-to-tabs` added to `en.yml` and `fr.yml` language files - Missing `help.commands.tabs` added to both language files - ConfigUpdater: Fixed duplicated comments in config.yml (replaced broken comment re-insertion with backup+merge strategy) - ConfigUpdater: No longer creates `adv-gui.yml` on fresh installs (prevented unnecessary migration trigger) - Fresh installs: `Advancements/default.yml` now included as a JAR resource with 41 sample advancements - Vanilla advancement icons now properly display (GRASS_BLOCK fallback replaced with actual Minecraft item icons) - Vanilla advancement tree positions now correctly extracted via NMS reflection ### 💥 Breaking Changes - **File Structure** - Advancements are now in `Advancements/*.yml` instead of `advancements.yml` + `adv-gui.yml` - **Migration** - Automatic on first startup. Old files renamed to `.migrated`. Manual rollback possible from `backups/` - **Paper 1.21.4+** - Plugin now requires Paper 1.21.4+ for the AdvancementDisplay API used in vanilla advancement extraction

# Changelog ## v1.70 ### 🎯 Major Features #### 🌐 Web Editor (Browser-Based GUI) Run `/padv editor` to get a link to the full-featured browser editor - no local server needed, works via REST API. - **Live Tree View** - Visual advancement hierarchy with real-time positioning, connection lines between nodes, zoom/pan - **Drag & Drop Positioning** - Toggle Move Mode (`✥` button), click an advancement to pick it up, move the mouse to position it in real-time, click again to drop. ESC cancels and reverts to original position - **Undo / Redo** - Ctrl+Z / Ctrl+Y or top-right buttons. Works for both drags and keyboard nudges - **Arrow Key Nudge** - Fine-tune positions with arrow keys (0.5 step, Shift for 1.0) - **Full Creation & Edit Wizard** - Same 5-tab interface (Basic, Trigger, Display, Rewards, Advanced) with dropdowns, tag inputs, icon browser, toggle switches - **Search & Filter** - Filter advancements by name/ID in the sidebar - **Import / Export JSON** - Save and load full advancement presets - **Responsive Layout** - Works on mobile/tablet - **SVG Controls** - All buttons now use centered SVG icons (zoom, reset, eye, move) #### 🔔 Discord Webhook Integration Send customizable Discord embeds when players complete advancements. - Per-advancement toggle in the edit GUI (slot 25) and YAML config - Customizable embed: title, description, color, thumbnail, footer - `%player%` and `%advancement%` placeholders in title/description - Global webhook URL in `webhook.yml` - Works alongside all existing reward types ### ✨ Changes - `/padv editor` - Opens the web editor (generates trust token on first use) - `/padv editor-trust <code>` - Authorizes a browser session for the editor - Webhook toggle in in-game edit GUI (slot 25, below PlayerPoints) - Frame type (TASK/GOAL/CHALLENGE) now correctly displays from `display.frame` in the web editor - **Stats GUI rework** - Player head now shows the actual target skin, recent completions condensed to single slot showing only the most recent, progress display clamped to prevent 101/100 overflow, navigation buttons only show when relevant with proper glass decoration ### 🐛 Fixes - Frame type parsing in web editor: was always showing TASK because `display.frame` was not read - Various web editor UI fixes (button centering, hint layout, responsive breakpoints) ---

# Changelog ## v1.60 ### Major - **No more restart required!!!** Create, edit, delete, or reposition any advancement and run `/padv reload` - it applies instantly. No more waiting for server restarts to see changes. - **Hidden advancements** - new `hidden: true` option. Advancements stay invisible until all `requires` prerequisites are completed. Perfect for secret end-game rewards. - **Connection system** - visually link any advancement to any other with `connection.target`. Create tree branches with clear visual lines instead of everything connecting to root. - **Multi-material support** - specify multiple blocks, items, entities, inputs, or outputs in a single advancement using YAML lists (e.g. break both stone AND deepslate). ### New Trigger - **CHOP_TREE** - breaks any log type automatically (oak, spruce, birch, jungle, acacia, dark oak, mangrove, cherry, pale oak). ### Changes - Coordinates must now be `>= 0` (both x and y). Negative values are rejected by the API. - Removed all "restart required" warnings from reload command. ### Fixes - Hidden advancement unlock messages no longer leak to chat. - Progress restores correctly on rejoin for multi-requirement triggers. - Circular dependency detection prevents infinite loops. - Various GUI slot ordering, pagination, and shutdown fixes.

# Changelog — v1.50 ## What's New ### PlaceholderAPI Integration 8 new placeholders to display player progress anywhere on your server: | Placeholder | Description | |-------------|-------------| | `%premiumadvancements_completed%` | Total completed advancements | | `%premiumadvancements_total%` | Total available advancements | | `%premiumadvancements_progress_<id>%` | Per-advancement progress | | `%premiumadvancements_completed_<id>%` | Completion status (true/false) | | `%premiumadvancements_percent%` | Overall completion % | | `%premiumadvancements_latest%` | Name of last completed advancement | | `%premiumadvancements_ranking%` | Player rank by completions | ### 25+ New Trigger Types | Trigger | Description | |---------|-------------| | `FISH` | Catch fish | | `BREED` | Breed animals | | `TAME` | Tame animals | | `CONSUME` | Drink potions/milk/honey | | `EAT` | Eat food | | `HARVEST` | Harvest crops | | `TRADE` | Trade with villagers | | `ENCHANT` | Enchant with specific enchantment | | `POTION_EFFECT` | Get a potion effect | | `DEATH` | Die by specific causes | | `DAMAGE_DEALT` | Deal damage | | `DAMAGE_TAKEN` | Take damage | | `JUMP` | Jump | | `DROP_ITEM` | Drop specific items | | `SHEAR` | Shear entities | | `MILK` | Milk cows/mooshrooms | | `ARMOR_EQUIP` | Equip armor pieces | | `SNIFF` | Brush suspicious sand/gravel | | `RIPTIDE` | Use riptide trident | | `RAID_WIN` | Win a raid | | `TARGET_BLOCK` | Hit a target block | | `BELL_RING` | Ring a bell | | `CROSSBOW_SHOT` | Shoot a crossbow | | `FIREWORK` | Launch fireworks | | `GLIDE` | Glide with elytra | | `SWIM` | Swim | | `CLIMB` | Climb | | `SLEEP` | Sleep in a bed | | `FILL_BUCKET` | Fill a bucket | | `EMPTY_BUCKET` | Empty a bucket | | `COMPOSTER_USE` | Use a composter | ### New Commands - `/padv info <id>` — View advancement details and placeholder IDs - `/padv placeholders` — List all available placeholders ### GUI Improvements - Advancement ID now shown in GUI lore for easier identification ### Bug Fixes - Fixed progress not restoring on rejoin for multi-requirement triggers - Fixed mooshroom entity naming (`MUSHROOM_COW` → `MOOSHROOM`) - Fixed `MUSHROOM_COW` entity matching for MILK/BREED/TAME/SHEAR triggers - Fixed sound serialization bugs in BREED trigger GUI - Fixed dot-format sound names across all advancements - Fixed chat input listener issues - Fixed TRAVEL_DIMENSION console error spam - Fixed various database shutdown issues - Many other stability improvements and bug fixes

# 📝 Changelog - Premium Advancements v1.40 ## 🎉 Major Update: 7 New Trigger Types + Critical Fixes! This update introduces **7 brand new advancement triggers**, bringing the total to **12 trigger types**, plus critical bug fixes and quality-of-life improvements! --- ## 🐛 Critical Bug Fixes ### Navigation & UI - ✅ **Fixed Previous Page button** not working in `/padv gui` - players can now navigate backwards through pages - ✅ **Fixed page navigation state management** - page position is now properly maintained when reopening GUI - ✅ **Fixed pagination display** - current page and total pages now show correctly ### Travel Distance Tracking - ✅ **Fixed TRAVEL_DISTANCE trigger saving/loading** - distance and travel mode now persist correctly across server restarts - ✅ **Fixed ELYTRA mode** counting walking movement - elytra flight is now properly detected and tracked separately - ✅ **Fixed BOAT mode** counting walking movement - vehicle movement is now correctly isolated from walking - ✅ **Fixed distance not resetting** after completion - players can now repeat travel achievements properly ### Configuration System - ✅ **Fixed language file updates** not preserving user customizations - merge system now correctly keeps user edits - ✅ **Fixed config merge recursion** issues - deep nested sections now update properly without corruption - ✅ **Fixed backup system** creating unnecessary backups - only creates backups when actual changes are detected ### Advancement Registration - ✅ **Fixed Dynamic Advancement Registration** - newly created advancements are now immediately functional without restart - ✅ **Fixed UI initialization order** - prevents "advancement not initialized" errors --- ## ⭐ New Features ### 🆕 Advanced Triggers (7 NEW!) Track items crafted by players in crafting tables or inventory crafting. **Features:** - ✅ Detects crafting table and 2x2 inventory crafting - ✅ Supports shift-clicking (mass crafting) - ✅ Works with vanilla and custom items (ItemsAdder/Oraxen) - ✅ Cumulative tracking across sessions **Example:** ```yaml master_crafter: title: "Master Crafter" description: "Craft 64 diamond pickaxes" icon: DIAMOND_PICKAXE trigger: CRAFT_ITEM item: DIAMOND_PICKAXE amount: 64 ``` --- ### 🔥 2. SMELT_ITEM Trigger Track items smelted in furnaces, blast furnaces, and smokers. **Features:** - ✅ Works with Furnace, Blast Furnace, and Smoker - ✅ Detects the output item (smelted result) - ✅ Supports item filtering - ✅ Tracks cumulative smelting **Example:** ```yaml iron_smelter: title: "Iron Smelter" description: "Smelt 100 iron ingots" icon: IRON_INGOT trigger: SMELT_ITEM item: IRON_INGOT amount: 100 ``` --- ### ⚒️ 3. ANVIL_USE Trigger Track anvil usage including renaming, repairing, and combining items. **Features:** - ✅ Detects all anvil operations - ✅ Optional filtering by input item - ✅ Optional filtering by output item - ✅ Perfect for repair/enchant challenges **Example:** ```yaml item_repairer: title: "Item Repairer" description: "Repair items in an anvil 10 times" icon: ANVIL trigger: ANVIL_USE amount: 10 ``` --- ### 🪨 4. GRINDSTONE_USE Trigger Track grindstone usage for removing enchantments. **Features:** - ✅ Detects enchantment removal - ✅ Optional item filtering - ✅ Tracks each grindstone transaction **Example:** ```yaml disenchanter: title: "Disenchanter" description: "Remove 5 enchantments using a grindstone" icon: GRINDSTONE trigger: GRINDSTONE_USE amount: 5 ``` --- ### ✨ 5. ENCHANT_ITEM Trigger Track enchanting at enchantment tables. **Features:** - ✅ Detects enchantment table usage - ✅ Filter by item type (optional) - ✅ Filter by enchantment type (optional) - ✅ Set minimum enchantment level - ✅ Perfect for progression systems **Example:** ```yaml master_enchanter: title: "Master Enchanter" description: "Apply Sharpness III or higher" icon: ENCHANTING_TABLE trigger: ENCHANT_ITEM item: DIAMOND_SWORD ``` --- ### 🌐 6. ENTER_DIMENSION Trigger Track when players enter the Nether or End dimensions. **Features:** - ✅ Detects dimension changes - ✅ Prevents duplicate triggers on teleport loops - ✅ Supports NETHER and END dimensions - ✅ Perfect for exploration achievements **Example:** ```yaml nether_explorer: title: "Nether Explorer" description: "Enter the Nether for the first time" icon: NETHERRACK trigger: ENTER_DIMENSION dimensionType: NETHER ``` **Dimension types:** - `NETHER` - The Nether dimension - `END` - The End dimension --- ### 🏃 7. TRAVEL_DISTANCE Trigger Track distance traveled by players with different movement modes. **Features:** - ✅ Persistent tracking across sessions - ✅ Multiple travel modes (TOTAL, WALKING, BOAT, ELYTRA) - ✅ Shows progress in action bar - ✅ Perfect for exploration challenges **Example:** ```yaml marathon_runner: title: "Marathon Runner" description: "Walk 10,000 blocks" icon: GOLDEN_BOOTS trigger: TRAVEL_DISTANCE travelMode: WALKING amount: 10000.0 ``` **Travel modes:** - `TOTAL` - Any movement (default) - `WALKING` - Walking/running only - `BOAT` - Boat or vehicle movement - `ELYTRA` - Elytra flight only **Progress tracking:** - Saved every 10 blocks traveled - Persists across server restarts - Shows live progress in action bar --- ## 🔧 Quality of Life Improvements ### Smart Features - ✅ **Smart ID Generation** - advancement IDs are now automatically based on titles (e.g., "Novice Traveler" → `novice_traveler`) - ✅ **Admin Update Notifications** - operators are now notified in chat when language files are updated on server start - ✅ **Improved Backup System** - old language/config files are automatically backed up to `backups/` folder with timestamps - ✅ **Enhanced Error Messages** - clearer feedback when advancements fail to trigger or when conditions aren't met ### User Experience - ✅ **Better Progress Feedback** - action bar shows real-time progress for all counter-based triggers - ✅ **Improved GUI Responsiveness** - faster navigation and item updates - ✅ **Clearer Trigger Types** - all triggers now show helpful descriptions in the GUI --- ## 🔧 Technical Improvements ### Performance & Stability - ✅ Improved event handling for new triggers (minimal performance impact) - ✅ Optimized distance tracking (updates every 10 blocks instead of per-tick) - ✅ Better caching system for dimension changes (prevents spam on rapid teleports) - ✅ Reduced database calls with smarter progress tracking and batching - ✅ Enhanced language file update detection system with smart merging - ✅ Better config merge logic that preserves user customizations - ✅ Improved error handling for dynamic advancement registration - ✅ Fixed memory leaks in cache cleanup methods ### Code Quality - ✅ Refactored trigger handling for better maintainability - ✅ Added comprehensive null checks for item metadata - ✅ Improved async/sync task separation for database operations - ✅ Better exception handling in advancement listeners ### GUI Updates - ✅ New configuration options for all 7 triggers - ✅ Enhanced input validation - ✅ Better error messages for invalid configurations ### Language Support - ✅ Full English translations for new triggers - ✅ Full French translations for new triggers - ✅ 50+ new translation keys ### Database - ✅ Improved progress tracking for distance-based advancements - ✅ Better async saving for travel distance - ✅ Optimized storage for cumulative tracking --- ## 🐛 Additional Bug Fixes ### Trigger-Specific Fixes - ✅ Fixed shift-click crafting not being tracked properly in CRAFT_ITEM - ✅ Fixed dimension change spam on world teleports in ENTER_DIMENSION - ✅ Fixed travel distance not persisting on server restart - ✅ Improved item detection for custom model data items (ItemsAdder/Oraxen) - ✅ Fixed SMELT_ITEM not detecting Blast Furnace and Smoker operations - ✅ Fixed ANVIL_USE triggering on empty anvil clicks - ✅ Fixed GRINDSTONE_USE not properly detecting enchantment removal - ✅ Fixed ENCHANT_ITEM not validating minimum level correctly

# 🔄 Changelog – v1.32 - Fixed Woodcutter Default Advancement. - Fixed all untranslated English texts in French - Added automatic configuration migration system, your configs now update seamlessly between versions while preserving custom changes - Fixed Create Advancement GUI not displaying all configuration options on first open

- Added Support for Formatted Chats e.g &b,&e,&c... - Fixed SLF4J Error - Manual advancement editing is now supported without GUI override

## 🔄 Changelog – v1.3 - Fixed update checker reliability and stability - Added advancement dependencies system (`requires`) - Prevented advancements from being unlocked before required ones - Enabled full progression trees for custom advancements - Added per-world advancement conditions - Added permission-based advancement conditions - Reworked the advancements display GUI (`/padv gui`) - Advancements are now correctly listed and ordered in the GUI - Added multi-page support to the advancements GUI - Improved validation when unlocking advancements - Minor internal optimizations and cleanup

Added Update Checker Added Multiple Language Support Added Custom model Data Advancement Icon Support

The first version