Customize
Disk space, shortcuts, and portable installs
Reclaim space, put an instance on your desktop, share screenshots, and run Agora from a USB stick.
Two versions of this page follow. Step by step walks through the task in order. In depth explains the underlying behavior. They describe the same product, at different levels of detail.
Step by step
Follow the steps in order. No prior modding knowledge assumed.
Several small features deal with where things live on disk and how you reach them. None of them are needed to play, and all of them are reversible.
After this you will be able to
- Reclaim runtime files no instance is using.
- Create a desktop shortcut for an instance.
- Share one screenshots folder across instances.
Reclaim disk space
Minecraft versions, libraries, native files, and asset objects accumulate as you create instances and move between game versions. The reclaim scan lists what no instance can currently reach, grouped by category, and changes nothing until you choose categories and confirm.
Put an instance on your desktop
Instance integration can create a desktop shortcut. Opening it brings Agora to that instance, ready to play. It stops there rather than starting the game outright, because one click should not put a window on screen you did not ask for. If Agora is already running, the shortcut moves the existing window rather than opening a second one.
Share a screenshots folder
Minecraft always writes to a screenshots folder inside the instance, with no setting to change it. Agora can link each instance to one shared folder so every screenshot lands in the same place. Existing screenshots are moved into the share rather than left behind, and unlinking stops sharing without deleting anything.
In depth
How the system actually behaves, and why, for readers who prefer the model to a recipe.
The same group of features covers portable installs, wrapper commands, and per-instance launch history. Each is a small, local mechanism with no service behind it.
After this you will be able to
- Run Agora from removable media.
- Wrap the launch command with a tool such as a frame-rate overlay.
- Read launch history without over-reading it.
Portable installs
A file named portable.txt beside the executable makes Agora keep its data next to itself instead of in your user profile. Empty means a data folder alongside the executable; otherwise its first line names the folder, resolved relative to the executable rather than wherever you happened to run it from. Sign-ins travel with it too: a portable copy never uses your computer’s credential store, and keeps Microsoft and GitHub sign-ins encrypted in its data folder instead — so anyone who can read that folder can read them.
Wrapper commands
A wrapper command runs in front of the real launch command, which is how tools like performance overlays and compositors attach themselves. Agora still builds the true command and then applies the wrapper as a visible transform, so what actually runs stays inspectable. A malformed quote is rejected in the settings field rather than at launch time.
Launch history
Agora records preparation time, session length, outcome, and enabled mod count for each launch, keeps the most recent entries, and deletes them with the instance. It is local, with nothing sent anywhere.
This guide is the same text Agora shows in its built-in Help & Guide, which is searchable and links directly to the screens it describes.