Key Features
Custom Advancements
Add your own advancement JSON files and inject them into the game alongside — or entirely in place of — vanilla and mod advancements. The mod reads every
.json file inside the customadvancements/ folder and applies them to all worlds.Blacklist & Whitelist
Remove specific advancements, all recipe advancements, or every advancement in the game via a flexible blacklist. Flip a single config flag to turn that blacklist into a whitelist and keep only the advancements you care about.
Progression System
Enable strict advancement progression so that every advancement is only achievable once its parent has been completed. Four modes —
ALL, MINECRAFT, MODS, and CUSTOM_ADVANCEMENTS — let you scope the enforcement precisely, with per-mod exemptions and optional progress reset on death.Custom Backgrounds
Override the background texture of any root advancement tab with your own image file, then fine-tune how it is drawn using the
largeBackground, shouldBgClip, and bgRatio display fields.Tab Sorting
Control the order of tabs in the advancements screen using three sorting modes:
UNSORTED (default), ALPHABETICALLY, or DEFINED_LIST — where you supply a specific ordered list of root advancement IDs.In-Game Commands
Use built-in commands such as
/ca generate advancement all to export every loaded advancement as an editable JSON file, /ca generate resource_locations to dump all advancement IDs to a text file, or /ca reload to apply your edits without a restart.Internationalization
Ship translation files alongside your advancements. The mod loads
.json language files from customadvancements/data/lang/ and injects them into Minecraft’s language system, so your custom advancement titles and descriptions are fully localizable.BetterAdvancements Support
Custom Advancements detects the BetterAdvancements mod automatically and applies its tab sorting inside the enhanced advancement screen as well. No extra configuration is required.
How the Folder Structure Works
On first launch, Custom Advancements creates acustomadvancements/ folder directly inside your Minecraft game directory (the same directory that holds saves/, mods/, and config/). This folder behaves like a global datapack — its contents are applied to every world you load or host.
Inside customadvancements/, the first subfolder level determines the namespace of every advancement beneath it. The subfolder named customadvancements — matching the mod’s own ID — is where your brand-new advancements go; everything inside it is registered under the customadvancements namespace. Any other subfolder is treated as an override for an existing advancement in that namespace, so a file at customadvancements/minecraft/story/root.json replaces the vanilla minecraft:story/root advancement.
Language files live at customadvancements/data/lang/<locale>.json and texture files at customadvancements/data/textures/<name>.png. The data/ folder is never scanned for advancement JSON.
Supported Platforms & Versions
Custom Advancements 6.3.5 targets Minecraft 1.19.3 on Minecraft Forge.Forge itself is the only hard dependency. The mod declares a Forge version range of
[44,) and a Minecraft version range of [1.19.3, 1.20); version 44.1.0 is the build it is tested against and the recommended minimum.