Task guides
These are the same guides built into the desktop app under Help & Guide, published here so you can read them before installing or link someone straight to an answer.
The following guides cover what Agora does and how to do it. Each one is written twice: step by step for following along, and in depth for understanding the behavior behind the steps. Pick whichever suits you — they describe the same product.
Start
Set Agora up and learn the vocabulary before you change anything.
Getting started with Agora
Set up Agora, understand what it does, and reach your first playable instance.
Modding foundations
Learn versions, loaders, dependencies, and the different kinds of Minecraft add-ons.
Home and navigation
Use the dashboard, sidebar, alerts, recommendations, and keyboard navigation.
Play
Build instances, find content, install it safely, and launch.
Creating and managing instances
Create isolated instances, edit their content, lock the stable ones, and manage their lifecycle.
Browse, search, and the catalog
Find curated and live content, filter for compatibility, and understand trust labels.
Installing, removing, and updating mods
Review dependency-aware plans and make content changes with recovery protection.
Launching Minecraft and health checks
Choose a launch mode, resolve preflight findings, and understand running-state controls.
Playing with a controller
Use Agora from the couch with a gamepad, and add controller support to Minecraft itself.
Manage
Keep an instance organized, and move instances between machines.
Managing mods and game content
Organize mods, resource packs, shaders, and data packs inside an instance.
Packs, import, export, and reproduction
Move complete instances between machines and verify that another instance matches.
Moving an instance to a new Minecraft version
Check whether every mod has a build for another Minecraft version, then move across in one confirmed step.
Recover
Diagnose crashes and roll back to a state that worked.
Customize
Tune Java, appearance, accessibility, privacy, and offline use.
Java, memory, and performance
Select a compatible runtime and tune memory and garbage collection without guesswork.
Settings, appearance, and accessibility
Adjust Agora to your display, input, accessibility, and update preferences.
Privacy, networking, and offline use
See every network category, disable egress, and prepare Agora for offline operation.
Disk space, shortcuts, and portable installs
Reclaim space, put an instance on your desktop, share screenshots, and run Agora from a USB stick.
Connect
Optional accounts, community governance, and AI integrations.
Accounts and optional services
Understand why Agora offers GitHub, Microsoft, and Modrinth connections.
Community governance and curation
Understand curated entries, triage polls, reviews, resolutions, and the transparency log.
Getting help with a crash
Export a redacted crash report to share with the community or an AI assistant of your choosing.
MCP and external AI tools
Connect an external local AI client and control what it may do to instances.
Looking for exact syntax instead?
Guides explain workflows. For command flags, exit codes, file locations, and evidence collection, use the reference documentation.