This animation here is compressed. When you use the tracker the framerate will be higher and the resolution perfectly sharp.
This tracker supports an arbitrary number of advancements, recipes, custom statistics, unlocks, multi-stage goals, manual goals, and custom counters for over 100 Minecraft versions.
Advancely is fully speedrun legal based on the Minecraft Speedrunning rules (A.3.10.a, A.11.1) by only reading from within the 'advancements', 'stats' and 'unlocks' (25w14craftmine) folders of a world that update when the game saves. With the Hermes Mod tracker updates are instant and don't require pausing (Minecraft Speedrunning rules (A.8.14 and A.8.15)).
Built for flexibility, Advancely supports everything from vanilla speedruns to modded adventures and datapacks through the creation of custom templates with a built-in template editor. It automatically detects changes in your latest singleplayer world, providing real-time progress updates.
- Become a Supporter!
- Socials
- What is Advancely?
- Core Features
- Performance & Optimization
- Getting Started
- Download Once, Update Forever
- The Tracker Window
- The Stream Overlay
- The Template Editor
- The Settings Window
- Extensive Version Support
- Officially Added Templates
- Known Limitations
- You have a feature idea?
- Running into Issues?
- Command Line Arguments
- Beta Testers
- Contributors
- License
- Credits
📺 Video Guide: Jump to Support Section (33:53)
Love using Advancely? You can have your name immortalized in the tracker!
Supporters:
- Totorewa: $31
- ethansplace98: $30
- zurtleTif: $20
- Zesskyo: $10
Simply donate here and include the word "Advancely" in your donation message. With the next release your name will be added to the official supporter showcase that appears on the stream overlay when anyone completes a run and you'll get a special role on my Discord.
Thank you for supporting the project!
Put #Advancely in your content to support the project!
- Support Advancely (be featured on the overlay by mentioning
Advancelyin your donation message) - (Affiliate Link) Amazon
- My YouTube
- My Twitch
- My Twitch Archive + Advancely Devlogs
- Official Advancely Discord w/ Unofficial Releases!
- Tiktok
- X/Twitter
- My GitHub
📺 Video Guide: Intro (0:00) • The Basics (1:50)
This screenshot has the Tracker Font Size set to 24.
Advancely is a sophisticated, data-driven progress tracker (just like AATool) - that works on Windows, Linux and macOS - designed for Minecraft speedrunners, completionists, and content creators. Unlike other tools that only track vanilla advancements (e.g., AATool by Darwin Baker), Advancely can be configured to monitor virtually any goal imaginable. It operates in real-time by watching your singleplayer save files for changes, meaning your progress is always up-to-date without any manual intervention.
The tracker's true power lies in its .json template system, which allows you to define exactly what you want to track
for any version, mod, or playstyle. A template isn't just a list of advancements; it's a complete ruleset that can
include custom stats, multi-stage goals, manual counters, and more.
You don't need to be a developer to customize Advancely. The built-in Template Editor gives you full control to import, create, copy, and modify any template directly within Advancely.
Read more about Editor Features
- Import from Your World: The fastest way to get started is by importing directly from an existing game save. The editor can automatically scan your player data and pull in all advancements/achievements, recipes, statistics, or unlocks to build a new template for you.
- Full Customization: Edit any goal's name, icon, or properties. Create complex multi-stage goals with several sequential steps, or add manual counters with hotkeys for objectives that can't be tracked automatically.
- Easy Translation: Every template has separate language files, allowing you to easily edit display names or provide translations without altering the core template logic.
- Share Your Templates: You can export any template—including all its language files—into a single
.zipfile to share with the Advancely community. Likewise, you can import (.zip) templates created by others. - Manual Layout & Visual Layout Editor: Position every goal, criterion, and decoration precisely on the tracker map. Enable "Manual Layout" in settings, then use the Visual Layout Editor in the Template Editor to drag-and-drop items directly on the live tracker. Select multiple items at once with a selection rectangle and move them together.
- Decorations: Add visual elements to your manual layout that aren't tied to game data. Text Headers display custom text using the tracker font, Lines connect or separate areas with configurable thickness and opacity, and Arrows visually link goals together with customizable arrowheads, bend points, and goal-linked opacity.
This powerful and flexible system makes Advancely the ultimate tool for any Minecraft challenge, from a vanilla "All Advancements" run to a heavily modded playthrough with hundreds of custom milestones.
View All Core Features
-
Automatic Instance Tracking (default): Advancely automatically detects which Minecraft instance you are actively playing and tracks it, even if multiple instances are open at once. This is the default path detection mode. It works with Prism Launcher, MultiMC, and similar launchers. Find out more here.
-
Fixed World Mode: Lock the tracker to one specific world folder. Unlike the default mode which always follows your most recently played world, Fixed World Mode keeps the tracker focused on a single chosen world regardless of which world you open next. Useful for long-form playthroughs, modded runs, or setups where you want the tracker to stay on a specific save. Configure it in Settings by selecting "Fixed World" and browsing to the world folder.
-
Hermes Mod Live Tracking: When the Hermes mod is installed, Advancely can read its encrypted
play.log.encin real-time, updating stats and advancements as they happen rather than waiting for the game to save. Enable this in Settings under "Using Hermes Mod (Live Tracking)". The update timer in the info bar and overlay changes fromUpd:toSynced:when Hermes is active, indicating the last full disk sync rather than the last live event. All values self-correct on every normal game save. Compatible ultimately with all Fabric versions. Stat and advancement/achievement changes are applied instantly; the game files remain the authoritative source of truth. -
Interactive Map View: The main tracker window is an interactive map where you can pan by holding
Right-ClickorMiddle-Click, zoom with theMouse Wheel, and lock the layout in place by pressingSPACE. -
Scrollable Lists: Goals containing large numbers of sub-items (like "All Animals Bred" or complex stats) are automatically converted into scrollable lists to save screen space.
-
Comprehensive Real-Time Tracking: Advancely operates in real-time by watching your singleplayer save files for changes. It can monitor a wide range of data types, including:
- Advancements & Recipes: Tracks completion status and individual criteria for any advancement or recipe from vanilla, mods, or datapacks.
- Statistics: Monitors any in-game statistic (e.g., blocks mined, distance flown) against a target value.
Supports nested "sub-stats" under a single category and allows for manual completion overrides via an in-app
checkbox. Stats and sub-stats can also be auto-completed by linking them to other goals (advancements, unlocks,
counters, etc.) with an
AND(all must be completed) orOR(at least one) mode. - Unlocks: Fully tracks the unique "unlocks" progression system from the
25w14craftminesnapshot.
-
Advanced Goal Types:
- Custom Counters & Manual Goals: For objectives that can't be automatically tracked (like counting structures
visited), you can create manual checklist goals or counters with target values. All progress is saved
automatically into
settings.json. Switching templates will thus ERASE the progress of these custom goals.- Hotkeys: Use configurable hotkeys to increment or decrement your custom counters. Up to 32 hotkeys are supported. Hotkeys only work when the tracker window is in focus.
- Multi-Stage Goals: Create long-term objectives that combine several smaller steps. A single goal can require you to first complete a stat, then an unlock, then a specific advancement criterion (e.g., visiting a specific biome), and finally an entire advancement in sequence. You can assign unique icons to each stage to visualize progression.
- Counters: Track how many of a selected set of goals are completed. Link any combination of advancements, criteria, stats, sub-stats, unlocks, custom goals, or multi-stage goal stages to a counter. It displays a main icon, a display name, and progress text (e.g., "3/10"). The background texture changes based on progress: default at zero, half-done for partial progress, and done when all linked goals are completed. Searching for a counter's display name also shows its exact linked goals in the search results.
- Custom Counters & Manual Goals: For objectives that can't be automatically tracked (like counting structures
visited), you can create manual checklist goals or counters with target values. All progress is saved
automatically into
-
Manual Layout Mode: Break free from the automatic grid and position every goal exactly where you want it. When enabled, each item's position is defined by coordinates stored in the template file. Use the built-in Visual Layout Editor to drag items directly on the tracker map, or set coordinates numerically in the Template Editor. Templates with existing layout data are marked with (has layout) in the settings dropdowns so you can easily find them. Each position (icon, text, progress) can be individually hidden using per-position
Hidecheckboxes in the Template Editor, giving you fine-grained control over what appears on your layout. -
Decorations: Add purely visual elements to your manual layout. Text Headers render custom text using the tracker's font and size, perfect for labeling sections of your map. Text headers can also have Linked Goals (any combination of goals and counters) so that searching for the header's text keeps all linked items visible, allowing you to categorize your search. Lines draw between two endpoints with configurable thickness and opacity, using the tracker's text color. Arrows draw a path from a tail through optional bend points to an arrowhead tip, and can be linked to a Start Goal and End Goal to change opacity based on completion state, ideal for all achievement runs, where the completion order matters.
-
Section Completion Counters: Each section header displays dynamic counters showing completed items versus the total visible items for that section, respecting both the current Goal Visibility setting and any active search filter.
- Format:
- Sections with sub-items (Advancements/Recipes with criteria, Statistics with sub-stats, Multi-Stage Goals) show counts for both main items and sub-items.
- Sections without sub-items (Unlocks, Custom Goals, simple Statistics) show counts for main items only.
- Format:
-
Powerful In-App Template Editor: You don't need to manually edit files. The built-in editor allows you to create, copy, and modify any template. You can instantly build a new template by importing advancements, stats, and unlocks directly from your world save. Find more information here.
-
Customizable Stream Overlay: An animated overlay is available to show your progress to viewers. You can customize its scroll speed, font, colors, FPS, if the 3rd row remains visible and which information is displayed. Find more information here.
-
Full Mod & Datapack Support: The tracker is designed to be data-driven. It correctly parses items, stats, and advancements from any mod or data pack (e.g.,
conquest:,blazeandcave:) without being limited to the vanillaminecraft:namespace. -
Extensive Version Support: Advancely is built to work with over 100 Minecraft versions, from 1.0 to 1.21.9+ and beyond, including all April Fool's snapshots.
-
Automatic Updates: The tracker automatically checks for new versions on startup and will prompt you to download and install them, ensuring you're always up-to-date.
Advancely tries to be as lightweight as possible when it comes to system resources despite allowing for 1000+ goals being displayed at once.
View Technical Details (SDL3, ImGui, Culling & LOD)
- Efficient Tech Stack: The application is built on SDL3, a
high-performance, low-level media library.
- Tracker Window: Utilizes Dear ImGui for a responsive, interactive, and highly customizable interface.
- Stream Overlay: Bypasses UI libraries entirely to use raw SDL3 hardware acceleration. This ensures perfectly smooth 60fps+ animations with virtually zero overhead.
- Virtual Scrollable Lists: Templates with thousands of criteria (e.g. "All Items") are automatically converted into virtualized scrollable lists. This keeps the layout compact and ensures rendering remains performant regardless of list size.
- Smart Culling: The tracker features a robust culling system. It only processes and renders items that are currently visible within the window. You can have a template with thousands of goals, but if you are zoomed in on just ten of them, only those ten are drawn.
- Level of Detail (LOD): To maintain clarity and performance when viewing the entire map:
- Text Hiding: As you zoom out, sub-text (progress) and then main titles fade away to declutter the screen.
- Icon Simplification: At the furthest zoom levels, complex item icons are replaced by simple, colored squares.
- Note: These thresholds are fully customizable in the Settings window.
📺 Video Guide: How to Download (1:23)
Go to the releases page and download the .zip file that matches
your operating system. The vX.X.X is the Advancely version, that is also displayed in the title of the main window.
- Windows:
Advancely-vX.X.X-Windows.zip - Linux (Portable):
Advancely-vX.X.X-Linux.zip— The standalone executable (no installation required). - Linux (Debian/Ubuntu):
advancely-vX.X.X-Linux.deb— The native installer for Ubuntu 25+ (or systems with SDL3 installed). - Linux (Fedora/RHEL):
advancely-vX.X.X-Linux.rpm— The native installer for Fedora/RedHat systems. - macOS:
Advancely-vX.X.X-macOS-Universal.zip— For both Intel (down to macOS 13 Ventura) and Silicon Macs.
- Arch Linux (AUR):
Three packages are available on the AUR — pick whichever suits you:
| Package | Description |
|---|---|
| advancely | Compiles from the latest release |
| advancely-bin | Precompiled binary from the latest release (fastest install) |
| advancely-git | Compiles from the latest commit |
Use your favorite AUR helper, e.g.:
paru -S advancely-bin
Massive thanks to R0dn3yS for the AUR packages!
- NixOS:
Advancely is available via mcsr-nixos, a collection of NixOS packages for Minecraft speedrunning.
Add the following to your flake.nix inputs:
inputs.mcsr-nixos = {
url = "https://git.uku3lig.net/uku/mcsr-nixos/archive/main.tar.gz";
inputs.nixpkgs.follows = "nixpkgs";
};Then add it to your system configuration:
{ pkgs, mcsr-nixos, ... }:
let
mcsrPkgs = mcsr-nixos.packages.${pkgs.stdenv.hostPlatform.system};
in
{
environment.systemPackages = [
mcsrPkgs.advancely
];
}Massive thanks to uku3lig for the NixOS package!
To ensure the application works correctly, please follow the instructions for your operating system.
✔️ Important: Use English-Only (ASCII) File Paths
To prevent errors, please make sure the entire folder path to your Advancely application contains only standard English (ASCII) characters.
🍎 macOS Instructions
Due to macOS security (Gatekeeper), you cannot run the app directly from the Downloads folder.
⚠️ CRITICAL: Fix for "App Translocation" / Permission ErrorsIf you try to run Advancely directly from your Downloads folder, macOS will isolate it in a read-only temporary location (App Translocation).
You MUST move the app to fix this:
- Drag
Advancely.appAND theresourcesfolder from Downloads to your Applications folder or Desktop.- Run it from the new location.
Authorizing the App (First Run):
✔️ Method 1: Terminal Authorization If you still encounter issues, you can strip the quarantine tags manually:
- Open the Terminal app.
- Type
xattr -cr(note the space at the end). - Drag the
Advancely.appfile from Finder onto the Terminal window. - Press Enter.
✔️ Method 2: The Right-Click Trick
- After moving the app to your Applications folder or Desktop...
- Right-click (or Control-click)
Advancely.appand select Open from the menu. - A warning will appear. Click Open. macOS will now remember that you trust this application.
✔️ Method 3: System Settings (If Method 1 and 2 fail) If the app still refuses to open:
- Open System Settings -> Privacy & Security.
- Scroll down to the Security section.
- Look for a message stating "Advancely was blocked...".
- Click Open Anyway and confirm with your password.
🪟 Windows & 🐧 Linux Instructions
Your application folder contains the main executable, required library files, and the resources folder. The executable
must always stay in the same folder as its supporting files.
✔️ Correct Way to Run:
- To run Advancely from another location like your Desktop, please create a shortcut to the main executable.
- Windows: Right-click
Advancely.exe→ "Create shortcut". - Linux: Right-click the
Advancelyfile → "Create Link".
- Windows: Right-click
- You can then move this new shortcut or link anywhere you like.
- Do not move or copy the original executable file by itself, as it will fail to start or find its resources.
Launch Advancely by running the executable (or the shortcut you created). On its first run, it will default to finding
your most recently played world from the standard Minecraft installation. To begin customizing, press the ESC key to
open the settings window, where you can switch to Auto-Track Active Instance if you use Prism Launcher, MultiMC or
some other custom launcher.
📺 Video Guide: Auto-Updates Explained (33:01)
Advancely is designed to be easy to maintain. By default, the tracker will automatically check for new versions on startup. When an update is available, you will be notified with a prompt offering to download and install it for you. This process is designed to be as safe as possible for your custom files.
How the Automatic Update Works
The updater is smart about which files it replaces to ensure your personal configurations are preserved.
-
✅ Files that are SAFE and WILL NOT be replaced:
- Your main
settings.jsonfile. - Your
_notes.txtfiles for each template. - Any custom templates or user-created files in the
resourcesfolder.
- Your main
-
⚠️ Files that WILL BE REPLACED:- The main application executable (
Advancely.exe,Advancely.app, etc.). - Core library files (
.dll,.so). - Official templates, fonts, icons, reference_files, and GUI assets included with the release.
- The main application executable (
To prevent losing your work during an automatic update, it's highly recommended to avoid editing official template files directly. Instead, use the Template Editor to create your own safe-to-edit versions. The correct method depends on the types of changes you want to make.
If you only want to change display names:
The best approach is to create a new language file for the official template. This keeps your custom names separate while still allowing the underlying template structure (the goals, criteria, icons, etc.) to receive official updates.
- Open the Template Editor and select the official template you wish to customize.
- In the "Languages" section, select the "Default" language and click Copy Language.
- Give your new language a unique flag (e.g.,
customormypack). - You can now select your custom language in the main settings, and your display names will be safe from updates.
If you have changed goals, criteria, or icons (core functionality):
The best approach is to create a complete copy of the template. This makes your version fully independent and protects it from being overwritten.
- Open the Template Editor and select the official template you want to use as a base.
- Click the Copy Template button.
- Give your new version a unique name, typically by adding an Optional Flag (e.g.,
_custom). - You can now safely edit your new, independent template in any way you wish.
Your custom template will appear separately in the template list and will not be touched by the auto-updater.
📺 Video Guide: Main Tracker Overview (18:23) • Controls & Navigation (6:22)
The main window is an interactive canvas where all your tracked goals are displayed. You can freely zoom in and out to rearrange the items in view to suit your needs, making it easy to focus on what matters most for your current run. The order of the sections (advancements, recipes, multi-stage goals, ...) can be configured in the settings window.
Controls & Features (Pan, Zoom, Search, Notes)
You can manipulate the view using several intuitive controls:
- Pan: Hold
Right-ClickorMiddle-Clickand drag to move the entire map of goals. - Zoom: Use the
Mouse Wheelto zoom in and out, allowing you to see an overview or focus on specific details. - Scroll Lists: When hovering over a goal with many sub-items, the
Mouse Wheelwill scroll the list contents instead of zooming the map. You can also left-click and drag the scrollbar. - Lock Layout: Press the
SPACEkey to lock the grid layout. This prevents goals from rearranging when you resize the window, giving you precise control over how many items appear in each row. - Reset Camera: Click the
Reset Camerabutton in the bottom-right corner to instantly reset the pan and zoom to their default positions.
To quickly find a specific goal, press Ctrl+F (or Cmd+F on macOS) to focus the search box in the bottom-right
corner. The filter is case-insensitive and intelligently searches across different goal types. Using the search filter
also dynamically updates the completion counters in the section headers.
- Advancements, Recipes & Statistics: Shows a category if its main title or any of its sub-criteria/sub-stats match the search term. If only a sub-item matches, it will be the only one shown under its parent.
- Unlocks & Custom Goals: Shows the goal if its name matches the search term.
- Multi-Stage Goals: Shows the goal if its main title or the text of its currently active stage matches the search term.
- Counters: Shows the counter if its name matches. Additionally, all goals linked to a matching counter are shown as exact matches; linking to an advancement shows only the advancement itself (not its criteria), and linking to a specific criterion shows only that criterion under its parent.
- Text Headers: Searching for a text header's display text shows all goals and counters directly linked to that header. Like counters, this uses exact matching and is one layer deep so a linked counter will show up, but the counter's own linked goals will not.
Each section header (e.g., "Advancements", "Statistics") now displays dynamic counters reflecting the completion status based on the currently visible items. These counters respect both the "Goal Visibility" setting and any active search filter.
Format:
- Sections with sub-items (Advancements/Recipes with criteria, Statistics with sub-stats, Multi-Stage Goals) show:
(Completed Main / Total Main - Completed Sub / Total Sub) - Sections without sub-items (Unlocks, Custom Goals, Counters, simple Statistics) show:
(Completed Main / Total Main)
How Goal Visibility Affects Counters:
- Hide All Completed: Since only incomplete items are shown, the counters display only the total number of
remaining
items (e.g.,
(Remaining Main - Remaining Sub)or(Remaining Main)). - Hide Template-Hidden Only: Counts show completed vs. total for all items not marked as hidden in the
template (
e.g.,
(Completed Main / Total Main)). - Show All: Counts show completed vs. total for every single item defined in the template for that section,
including hidden ones (e.g.,
(Completed Main / Total Main)).
Hiding in Manual Layout vs. Automatic Layout:
Advancely has two separate hiding systems that target different layout modes:
Hiddencheckbox (per goal, in the Template Editor): Controls visibility on the automatic layout and the stream overlay. This checkbox is completely ignored when using the manual layout.- Per-position
Hidecheckboxes (per icon/text/progress position, in the Template Editor): Controls visibility on the manual layout only. Each position (icon, text, progress) can be hidden independently. These checkboxes only take effect inHide All CompletedandHide Template-Hidden Onlymodes;Show Allignores them.
In Hide All Completed mode, completed goals fully disappear from the manual layout. In Hide Template-Hidden Only
mode, completed goals are greyed out but remain visible.
A transparent info bar at the top of the window provides a live summary of your run. It includes:
- World: The name of the world currently being tracked.
- Run Details: The Minecraft version, template category, and optional flag you have selected.
- Progress: The main advancement/achievement counter and the overall completion percentage, which includes every single sub-task from all categories (recipes, criteria, stats, etc.).
- IGT: The total in-game time for the current world, read directly from the stats file.
- Update Timer: A timer showing how long it has been since the game last saved its files.
A powerful notes editor can be toggled via the "Notes" button in the bottom-right corner. All text is saved instantly as you type. The notes system has two distinct modes, which can be changed from within the notes window:
- Per-World Mode (Default): Notes are saved for each world individually. This is perfect for keeping track of world-specific information like coordinates or To-Do lists. The tracker automatically remembers the notes for your last 32 played worlds.
- Per-Template Mode: Notes are tied directly to the loaded template. This is useful for storing general strategies or information that applies to every run using that specific template.
The notes window also supports live-reloading (if you edit the .txt file externally, the window updates instantly) and
allows you to switch to the UI font for improved readability.
📺 Video Guide: Overlay Setup & Customization (18:45) • Overlay Progress (14:10)
This animation here is compressed. When you use the overlay the framerate will be higher and the resolution perfectly sharp.
Advancely includes a dedicated, customizable window perfect for showing your progress to viewers. It's an animated, real-time display that you can easily add to your stream layout.
Setup in OBS & Customization Guide
- Enable the Overlay: In Advancely's settings (
ESC), check theEnable Overlaybox and clickApply Settingsor hitENTER. A newAdvancely Overlaywindow will appear. - Add a Source: In your streaming software (like OBS), add a new
Game Capturesource on Windows or Linux and aWindow Capturesource on macOS. - Select the Window: Choose the
[Advancely.exe]: Advancely Overlaywindow from the list. - Add a Color Key Filter: Right-click the new source, go to "Filters", and add a "Color Key" filter.
- Set the Color: Use the color picker to select the overlay's background color. You can copy the exact HEX code
from the Advancely's
Overlay Background Colorsetting to ensure a perfect match. - Adjust Settings: For a clean, transparent background, it's recommended to set the Similarity to
1and * Smoothness* to around210.
Important for Streamers: Applying any changes in Advancely's settings will restart the overlay window. You may need to re-select the window in your capture source properties afterward.
The overlay is organized into three horizontally scrolling rows, each dedicated to different types of goals:
- Row 1 (Top): This row displays the icons of the smallest sub-tasks. It shows the individual criteria for advancements/recipes and the sub-stats for complex stat goals.
- Row 2 (Middle): This row shows the main parent goals, such as primary advancements, recipes, and unlocks. It can also include Stats, Custom Goals, Multi-Stage Goals, and Counters if forced via the Template Editor. Items in this row always hide when completed.
- Row 3 (Bottom): This row is the standard location for all other goal types, including statistics, custom goals, multi-stage goals, and counters.
Nearly every aspect of the overlay can be tailored to your liking from the settings window:
- Speed & Direction: Adjust the
Overlay Scroll Speed. A positive value scrolls left-to-right, while a negative value scrolls right-to-left. A value of 0 makes the items static. - Animation: Set the
Overlay FPS Limitand toggle theSpeed Up Animationoption. You can also temporarily speed up the animation by holdingSPACEwhile the overlay window is focused. - Stat Cycling: For multi-stat goals, you can set the
Sub-Stat Cycle Intervalto control how frequently the overlay cycles through displaying each sub-stat. Note: Sub-stats marked as "Hidden" in the template will be skipped during this cycle. - Visibility: Choose whether to hide completed goals from Row 3 (items in Row 1 & 2 always hide), and toggle the
visibility of each section of the
top info bar (
World,Run Details,Progress,IGT,Update Timer). - Alignment: The main progress text at the top of the overlay can be aligned to the
Left,Center, orRight. - Spacing: You can fully adjust the
spacingbetween each row to either be dynamic based on the longest text width within that row or be fully fixed. When two items within the first row share the same texture (based on hashing) their parent icon will be overlaid to distinguish them further. Thesizeof this overlaid icon can also be configured.
📺 Video Guide: Template Editor Chapters (Click to View)
This is the heart of Advancely's customization. The in-app editor gives you complete control to define, modify, and
share the rulesets or templates that the tracker uses. You can access it by opening the settings (ESC) and clicking
the Edit Templates button.
Detailed Editor Usage
From the main editor view, you can manage entire template packages:
- Create New Template: Builds a new, empty template from scratch for the selected version. You provide a unique
Category Nameand anOptional Flag. - Copy Template: Duplicates an existing template, including all its language files. This is the perfect starting point for creating a variation of a complex template.
- Delete Template: Permanently removes a template and all of its associated language and notes files.
- Import Template: Imports a full template package from a
.zipfile. You can confirm or change the version, category, and flag before the files are added. If the zip contains bundled icon files, an Import bundled icon files checkbox will appear and enabling it extracts those icons directly into yourresources/icons/folder so they resolve automatically with no further setup required (icons get put into the same folder structure as the template). - Export Template: Packages the selected template and all its language files into a single
.zipfile, perfect for sharing with others on the Official Advancely Discord. Clicking the button opens a small confirmation popup where you can optionally enable Bundle icon files before confirming and this copies all icon files referenced by the template into anicons/folder inside the zip. This is strictly a copy operation and your localresources/icons/folder is never modified or deleted. Recommended whenever your template uses custom icons not included with a standard Advancely install, so recipients get everything they need in a single file.
Each template can have multiple language files for localization. The editor allows you to manage these for any selected template:
- Create Language: Creates a new, blank language file. Display names will initially default to their internal root names.
- Copy Language: Duplicates an existing language file to a new one, preserving all translations.
- Delete Language: Removes a specific language file (you cannot delete the default
_lang.json). - Import/Export Language: Import a single
.jsonlanguage file from an external source or open the folder containing the selected language file to export it.
Opening a template reveals a tabbed interface where you can define every goal.
Important: For GIFs to work correctly, they must be unoptimized with all frame data intact. You can prepare any GIF by uploading it to ezgif.com/maker, selecting the "Don't Stack Frames" option, and exporting the result.
- Sorting & Reordering: You can easily rearrange any goals, categories, criteria, or stages. Click the small badge next to an item to assign it a sequential sort order. Once you've numbered the items you want to move, click the Sort button to instantly reorder them, or use Reset Order to clear your selections. Combine the search feature with the badge sorting for efficient template creation!
- Visibility Controls: Each goal has a
Hiddencheckbox that controls visibility on the automatic layout and the stream overlay. Separately, when a goal has manual positions set (for use with Manual Layout mode), each position (icon, text, progress) gains its ownHidecheckbox that controls visibility on the manual layout only. This lets you, for example, hide a goal's progress text in the manual layout while still showing it on the overlay. - Advancements & Recipes: List all achievements or advancements you want to track. Each entry has a
Root Name(the in-game ID, e.g.,minecraft:story/mine_stone), aDisplay Name, and anIcon Path. You can also import or addCriteriato track sub-tasks, and a checkbox designates an entry as aRecipeto sort it into its own section and move it to the percentage progress calculation instead. - Statistics: Track any in-game statistic.
- Simple Stats: A single goal with a
Targetvalue (e.g., track "Blocks Mined" until a goal of 10,000 is reached). - Multi-Stat Categories: Group related stats under one parent icon. Each
Sub-Stathas its own name, icon, and target, and will cycle on the stream overlay. - Auto-Complete via Linked Goals: Both stat categories and individual sub-stats support automatic completion
through linked goals. Use the
Select Goalsbutton to pick any combination of advancements, criteria, stats, sub-stats, unlocks, custom goals, or multi-stage goal stages. Choose betweenANDmode (all selected goals must be completed) orORmode (at least one selected goal must be completed) using the dropdown next to the goal list. When the condition is met, the stat is automatically marked as done — in addition to natural progress-based completion and manual checkbox overrides. - Row 2 Toggle: You can check the "Row 2" box to force a stat category to appear in the middle row of the overlay instead of the bottom row.
- Simple Stats: A single goal with a
- Unlocks: For the
25w14craftminesnapshot, this tab allows you to track the completion of player unlocks likeminecraft:exploration. - Custom Goals & Counters: Create goals for things that can't be automatically tracked. The "Target Goal" value
defines its behavior:
0: A simple on/off toggle (manual checklist item).>0: A progress-based counter that completes when the target is reached.-1: An infinite counter with no completion state.- Row 2 Toggle: You can check the "Row 2" box to force a custom goal to appear in the middle row of the overlay.
- Multi-Stage Goals: Design complex, sequential objectives. Each goal has a parent name and icon, and a list of
Stages. You can toggle Per-Stage Icons to assign a specific image to every individual step. Each stage is a smaller goal that must be completed in order. A stage'sTypedetermines its trigger:- Stat/Achievement: Triggers when a specific stat reaches its target or an achievement is earned (read from the
statsfolder). - Advancement: Triggers when a specific advancement or recipe is earned (read from the
advancementsfolder). - Criterion: Triggers when a specific sub-criterion of a parent advancement is met (e.g., visiting a single biome for "Adventuring Time").
- Unlock: Triggers when a specific player unlock is obtained (read from the
unlocksfolder). - Final: The mandatory last stage that completes the entire multi-stage goal.
- Row 2 Toggle: You can check the "Row 2" box to force a multi-stage goal to appear in the middle row of the overlay.
- Stat/Achievement: Triggers when a specific stat reaches its target or an achievement is earned (read from the
- Counters: Track how many goals from a selected set are completed. Each counter has a
Root Name,Display Name, andIcon Path. Use the Select Goals button to open a multi-select popup where you can pick any combination of advancements, criteria, stats, sub-stats, unlocks, custom goals, or multi-stage goal stages. Hold Shift and click to select a range. The counter displays progress as "(completed / total)" and uses the default, half-done, and done background textures based on progress. Only full completion (all linked goals done) contributes to the overall progress percentage.- Row 2 Toggle: You can check the "Row 2" box to force a counter to appear in the middle row of the overlay.
The Decorations tab in the Template Editor allows you to add visual elements to your manual layout that are not tied to any game data. These elements are only visible when "Manual Layout" mode is enabled.
- Text Headers: Display custom text on the tracker map using the main tracker font and font size. Useful for labeling different sections or areas of your layout. Each text header has a position that can be set numerically or dragged in the Visual Layout Editor.
- Lines: Draw a line between two endpoints on the map. Lines use the tracker's text color and have configurable Thickness and Opacity sliders. Each endpoint can be dragged independently in the Visual Layout Editor, or you can drag the line's midpoint marker to move the entire line at once.
- Arrows: Draw a directional path from a Tail to an arrowhead Tip, optionally passing through up to 16
Bend points. Arrows use the tracker's text color and have configurable Thickness and Arrowhead Size.
All points (tail, bends, tip) can be dragged independently in the Visual Layout Editor, or use the midpoint marker
to move the entire arrow at once. Arrows support Goal Linking:
- Start Goal: Select any goal, sub-goal, or multi-stage goal stage from the template. Before this goal is completed the arrow renders at its Opacity Before value (default: faded). Once completed, the arrow transitions to Opacity After (default: fully opaque).
- End Goal: When this goal is completed and the Goal Visibility setting is set to "Remove Completed Goals", the arrow is hidden entirely.
- Use the Select Goal popup (with search via
Ctrl+F/Cmd+F) to pick goals from any tab in the template.
The Visual Layout Editor is the fastest way to build a manual layout. It lets you drag-and-drop items directly on the live tracker map instead of typing coordinates by hand.
- Activation: Click the "Visual Layout Editor" button in the top-right corner of the Template Editor. The button is only available when the template you are editing is also the one currently applied in Settings. Activating the editor automatically enables "Manual Layout" mode, sets "Goal Visibility" to "Show All", and auto-saves any pending template changes.
- Dragging: Left-click and drag any goal icon, text label, progress text, decoration, or criterion to reposition it. A crosshair appears at the item's anchor point while dragging, and a tooltip shows the current coordinates.
- Multi-Select: Click and drag on empty space to draw a selection rectangle. All items whose center falls inside the rectangle are selected and highlighted. You can then drag any selected item to move the entire group together. Click on empty space to deselect.
- Saving: Changes made in the Visual Layout Editor are synced back to the Template Editor in real-time. Click "Stop Visual Editing" when finished, then click "Save" in the Template Editor to persist your layout to disk.
- Restrictions: While the Visual Layout Editor is active, applying settings and switching templates are disabled to prevent reloads. Custom Goal Hotkeys are also disabled.
To save you from manually typing hundreds of root names, nearly every editor tab has an "Import..." button. This powerful feature allows you to:
- Click the button (e.g., "Import Advancements").
- Select a player data file (
.jsonor.dat) from one of your world saves. - A popup will appear with a searchable list of every single advancement, stat, or unlock present in that file.
- Simply check the boxes for the items you want to add to your template and confirm. They will be instantly added, ready for you to assign icons and display names.
If you need help finding the correct root name for an item or want to see examples, click the "Help" button in the
editor. This will open the resources/reference_files folder, which contains guides, examples, and version-specific
lists of game data to assist you in building the perfect template.
📺 Video Guide: Settings Chapters (Click to View)
The true power of Advancely lies in its deep customization. Every feature can be configured in real-time from the
settings window, which can be opened at any time by pressing the ESC key. The settings window is divided into 7 tabs.
All the settings are then saved to resources/config/settings.json, meaning you can easily back up the settings.json
file as it requires that exact naming, but make sure Advancely IS CLOSED while renaming the settings.json file. The
settings file also saves the status on manual overrides of stats and custom goals, which get erased when switching
templates.
View Full Settings List
| Tab & Setting Group | Options & Features |
|---|---|
| Paths & Templates | |
| Path Settings | Choose how Advancely finds your saves. Auto-Detect finds the default Minecraft path. Track Custom Saves Folder lets you specify a manual path. Auto-Track Active Instance automatically finds and follows the instance you are playing from Prism Launcher, MultiMC etc. You may also track a Fixed World path and the Open Instances Folder button helps you quickly navigate to your launcher's instance directory. |
| Template Settings | Select the Template Version (functional version), Display Version (visual-only), enable Using StatsPerWorld Mod compatibility for legacy Minecraft versions (1.0 - 1.6.4) as well as Using Hermes Mod for real-time updates, Category, Optional Flag, Display Category (visual-only), and Language. Changing the Template Version, Category, or Optional Flag will automatically pre-fill the Display Category text. You can check the Lock box next to the display name to prevent this auto-update behavior. Templates that contain manual position data are marked with (has layout) in the Category or Optional Flag dropdowns. Enable the Manual Layout checkbox to use these positions instead of the automatic grid. You can also use the Open Template Folder button for quick access. |
| Tracker Visuals | |
| Window & Behavior | Set the Tracker FPS Limit and keep the tracker Always On Top. |
| Goal Visibility | Fine-tune which completed goals are displayed on the tracker with three modes: Hide All Completed (strictest), Hide Template-Hidden Only, or Show All. This setting also affects which items are counted in the section completion counters. |
| Layout & Spacing | Drag and drop to reorder the sections (Advancements, Stats, Unlocks, etc.) in the main tracker window. Adjust the Tracker Vertical Spacing (in pixels) between rows of items. You can also enable Custom Section Item Width to adjust the horizontal width (in pixels) for each item within a specific section (e.g., set "Advancements" to 150px), overriding the dynamic width calculation. |
| Level of Detail & Lists | Adjust the zoom thresholds at which elements disappear to declutter the view and improve performance (Hide Sub-Item Text, Hide Main Text/Checkbox, Simplify Icons). Control how long lists are handled by setting the Scrollable List Threshold to determine when a list becomes a scrollable box, and adjust the List Scroll Speed. |
| Fonts & Aesthetics | Independently set the font and sizes (Main, Sub, UI) for the Tracker window. Full RGBA color customization for the tracker background and text. Customize the Default, Half-Done, and Done background textures by selecting .png or .gif files from the resources/gui folder. |
| UI Visuals | |
| UI Fonts | Select the font and size for UI windows (Settings, Editor, Notes). Note: Requires an application restart. |
| UI Colors | Customize the appearance of the interface (Settings, Editor, Notes windows). Adjust colors for UI Text, Window Background, Frame Background (and its hovered/active states), Active Title Bar, Button (and states), Header (collapsible sections), and Check Mark. Note: Requires an application restart. |
| Overlay | |
| General | Enable Overlay and set the Overlay FPS Limit independently from the tracker. |
| Content & Behavior | Configure which Overlay Text Sections to display (World, Run Details, Progress, IGT, Update Timer). Choose whether to Hide Completed Row 3 Goals. Set the Sub-Stat Cycle Interval for multi-stat animations and adjust the Overlay Scroll Speed (negative values reverse the direction). |
| Layout & Spacing | Adjust the Overlay Width with a pixel-perfect slider and align the top progress text (Left, Center, or Right). Configure the horizontal spacing for Row 1 Icon Spacing, adjust Row 1 Shared Icon Size, or enable a fixed custom width for Row 2 and Row 3. |
| Aesthetics | Customize the Overlay Font, Overlay Background Color, and Overlay Text Color. |
| Co-op | |
| Co-op | Coming Soon... |
| Hotkeys | |
| Hotkey Settings | This section appears if your template contains custom counters using a target value different from 0. Assign keyboard hotkeys to increment or decrement any counter (hotkeys only work when the tracker window is focused). |
| System & Debug | |
| System & Developer | Toggle Auto-Check for Updates on startup. Toggle Print Debug To Console for detailed status updates in your terminal or advancely_log.txt and advancely_overlay_log.txt for the overlay. |
| (Bottom Bar) | |
| Action Buttons | Apply Settings (Enter or Ctrl/Cmd+S), Revert Changes (Ctrl/Cmd+Z), Reset To Defaults, Restart Advancely (required for ui/font/size changes), and the Support Advancely! button. If you try to close Advancely with unsaved changes in Settings or the Template Editor, a confirmation popup will appear telling you exactly what has unsaved changes and letting you choose to exit (Enter) or cancel (Escape). |
You can find the default settings in the
resources/reference_filesfolder assettings.jsonandDefault_Settings.png. The Help button within the template editor opens this folder.
Advancely supports over 100 Minecraft versions (1.0 - 1.21.9+), including every full release from 1.0 upwards and all April Fool's snapshots.
- Playtime Tracking: The tracker reads total playtime directly from the world's stats file, which is measured in in-game ticks (20 ticks per second).
View Era-Specific Logic (1.0 - 26.1+)
- 1.0 – 1.6.4 (Legacy): Advancely supports two modes for these versions:
- Default (Snapshot Mode): For vanilla play, it reads the global stats file. When you load a new world, it takes a "snapshot" of your progress and tracks all new stats and achievements against that baseline, effectively simulating per-world stats.
- StatsPerWorld Mod Support: If you are using Legacy Fabric with
the StatsPerWorld Mod, Advancely can be configured to
read local
.datstat files directly, just like in modern versions. Playtime is tracked via the ID:1100.
- 1.7.2 – 1.11.2 (Mid-Era): Reads achievements and stats from the per-world stats JSON file. Playtime is tracked
via
stat.playOneMinute. - 1.12 – 1.12.2 (Hybrid): Reads from separate, per-world modern advancements and mid-era stats files. Playtime
is tracked via
stat.playOneMinuteas it's still the mid-era flat stats format. - 1.13 – 1.16.5 (Modern): Reads from separate, per-world advancements and stats files. Playtime is tracked via
minecraft:play_one_minute. - 1.17-1.21.11: Same as above, but playtime is tracked via the renamed
minecraft:play_timestatistic. - 25w14craftmine: Fully supports the unique advancements, stats, and unlocks files from this snapshot.
- 26.1+: Players' advancements and statistic files are now within the
players/advancementsandplayers/statsfolders instead ofadvancementsandstats.
It may still work for minecraft pre-releases or snapshots by selecting the closest Template Version, but no guarantee is given.
These will get replaced through auto updates!
The versions mentioned below are the functional Template Versions that the templates were created for. You may still
choose a different Display Version within the same version range (e.g., 1.21.6 and 1.21.10 for all_advancements)
to make it clear to your viewers (on the overlay and the progress texts) what exact subversion you're playing.
This way templates don't need to be copied for each subversion.
View Template List
| Category | Template Version(s) | Optional Flag(s) | Languages |
|---|---|---|---|
any% |
25w14craftmine | Default | |
AMI |
25w14craftmine | Default | |
all_achievements |
1.0, 1.1, 1.2.5, 1.3.1, 1.4.7, 1.5.2, 1.6.4 | Default, ger | |
all_achievements |
1.11 | Default | |
all_advancements |
1.12, 1.13, 25w14craftmine | Default | |
all_advancements |
1.16.1, 1.21.3, 1.21.6, 1.21.11, 26.1 | Default, ger, zh_cn | |
all_advancements |
1.21.3, 1.21.6, 1.21.11, 26.1 | _optimized |
Default, ger, zh_cn |
miku% |
1.21 | Default | |
all_trims |
1.21 | Default | |
test |
1.0, 1.6.4, 1.11.2, 1.16.1, 25w14craftmine | 1 |
Default |
The test1 templates are for you to learn and understand how templates work. These test templates include all the core
functionalities of all goal types. The Default language is the standard english template (_lang.json). Any
non-default languages are appended after lang_.
Credits to creators of templates):
- @towardstars and @yumekotism on dc:
zh_cntranslations forall_advancementstemplates. Make sure you use theSourceHanSansCN-Normal.otffont in all places (tracker, overlay and UI). - MoreTrident:
all_trimstemplate.
(Submit your template through the official discord.
View Known Limitations
- Symbolic Links: On Windows and macOS, the real-time file watcher may not function correctly if your
.minecraft/savesfolder is a symbolic link. For best results, please provide a direct path to your saves folder in the settings if you use a custom location. - Font Support: The default
Minecraft.ttffont doesn't support many more characters beyond the standard english language. Simply import your own.ttfor.otffile if needed (has to be within theresources/fontsfolder). - UI Language Support: The UI language is hardcoded to english only the language files of display names can be changed.
- No Coop/Server Support: Unfortunately this tracker doesn't fully support coop speedruns as it always updates based
on the
player file that has most recently been modified. This means Advancely doesn't
combineprogress of multiple players. (e.g., each player completes different advancements). If you're playing on a server then the required player files are not saved locally so Advancely can't read them. - Overlay Recording: Especially on a Windows machine and OBS you must use Gamecapture to capture the overlay. A window capture can cause weird issues.
- PNG Image Compatibility: On Linux and macOS, custom icons must be standard 8-bit per channel (32-bit RGBA)
PNG files. Files with 16-bit depth, interlacing, or complex color profiles may fail to load (showing as pink squares
on the overlay within the first row or being invisible on the tracker). Checking the
advancely_log.txtoradvancely_overlay_log.txtfile will tell you about incompatible images. To fix this, re-save the images in a standard format or use ImageMagick:magick mogrify -define png:format=png32 -interlace none -strip -depth 8 *.png. - Frame drops when no saves folder: Whenever Advancely is set to track the active instance, but no instance is open, it might hook onto a different java process and unsuccessfully try to locate a saves folder from it.
Suggest it in the Official Advancely Discord within the 📊│advancely-tracker channel or
create a new issue on GitHub!
View Troubleshooting Steps
- Is Windows Defender blocking the application?: I've contacted Microsoft so windows defender does not falsely detect Advancely.exe as a virus. So make sure your Windows Defender version is up to date. Get the latest version here. Also don't open Advancely using Jingle.
- Is the tracker in a path with special characters?: Ensure the full folder path to
Advancely.exe(e.g.,C:\Users\Jörg\...) contains only standard English letters and numbers. Special characters can cause errors when loading files. - Multiple Advancely Windows: If for whatever reason you have Advancely open multiple times the Overlay will most
likely glitch out as it's a separate process and it then doesn't know from which main Advancely process to read
from. So make sure to only ever have
ONE Advancely windowopen at all times. - Check log file: First, look into the
advancely_log.txtfile to see if there are any errors that were caused by wrong usage of the application. With thePrint Debug To Consolesetting enabled, the log file will also contain detailed progress updates, not just errors. - Report an Issue: If you have any issues that aren't caused by incorrect usage, please contact me on Discord @lnxseus or create a new issue on GitHub!
View Command Line Arguments
Advancely supports several command-line arguments to customize its behavior. These are particularly useful for package maintainers or advanced users who want to override default behaviors.
| Argument | Description |
|---|---|
--settings-file <path> |
Specifies a custom absolute or relative path for the settings.json configuration file. Useful for system-wide installations where config should reside in ~/.config/ or similar. |
--disable-updater |
Disables the automatic update check on startup. Recommended for package maintainers (e.g., AUR, RPM, DEB) to prevent the app from modifying itself. |
--use-home-dir |
Linux ONLY: So Advancely uses the users home directory for applicable files that need to be user-writable such as templates, notes and config. Used within the package manager. |
--version |
Prints the current version of Advancely to the console and exits. |
--overlay |
Launches the application in "Overlay Mode". Note: This is primarily used internally by the main process to spawn the overlay window. |
--test-mode |
Enables test mode for debugging and development purposes. This is mainly used by the github action runners to assure functionality and forcing termination after 5 seconds. |
--updated |
Internal Flag: Signals to the application that it has just been updated, triggering the release notes popup. |
View Beta Testers
Massive thanks to all the beta testers who tested Advancely before its full release.
- Windows: ethansplace98, Yumeko, zurtletif, 3emis, MoreTrident, PhoenixAUS_, metal_silver1234, 36_Official, TheDogmaster28, Fangfang, Zesskyo, xiaojiangshi (Dilu)
- macOS: Slackow, TheDogmaster28, ethansplace98, DesktopFolder, Zesskyo
- Linux: DesktopFolder, ShadowFlower64, me_nx, TheDogmaster28
View Contributors
Massive thanks to all people involved in improving and shaping Advancely:
- Oskar33: Initial inspiration to even start work on Advancely.
- ethansplace98: Early interest in Advancely. Helped bringing ideas for early development. Advancely supporter.
- Yumeko: Many feature suggestions, also mainly responsible for chinese translations of templates.
- zurtleTif: Has used my tracker more than anyone else. Suggested features, provided background textures and is Advancelys first supporter.
- TowardStars: Helped with Chinese translations.
- InFectDilu: Feature suggestions along with help on chinese translations, also provided custom background textures.
- Slackow: Massive help with optimizing the macOS implementation and making the automatic instance detection possible.
- DesktopFolder: Crucial macOS tester.
- Zesskyo: Advancely supporter. Many feature suggestions. Important macOS tester.
- me_nx: Help with Linux implementation.
- amathew4538: Important contribution to fixing macOS imports and building.
- R0dn3yS: Helped fixing renaming issue for 1.16 all_advancements templates and crash on Linux w/ nikander100.
- nikander100: Helped fixing Segmentation fault on Linux.
- uku: NixOS package via mcsr-nixos.
Copyright (c) 2026 LNXSeus. All Rights Reserved.
This project is proprietary software. You are granted a license to use the software as-is. You may not copy, distribute, modify, reverse-engineer, or use this software or its source code in any way without the express written permission of the copyright holder.
View Credits
This project uses dmon by Sepehr Taghdisian, licensed under the BSD 2-Clause License. This project's user interface is powered by the excellent Dear ImGui library. *This project also uses the SDL3 library suite and cJSON. This project uses curl/libcurl to download the latest update from github. This project uses the miniz compression library to unzip the downloaded files. This project uses tiny file dialogs to open file dialogs. More information can be found in the LICENSES.txt file.
Lots of assistance was provided by Gemini Pro and Claude. Massive thanks to Jannox78 for allowing me to use his MacBook Pro for testing. Minecraft item .png files downloaded from Minecraft Asset Cloud and block renders from the Minecraft Wiki (downloaded by Dogmaster) Shoutout to Oskar for providing me his project files (kAAmel) and Darwin Baker for creating AATool, which served as inspiration!





