> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qomicex.top/llms.txt
> Use this file to discover all available pages before exploring further.

# Instance management

## Instance management

An **instance (Instance)** is a self-contained copy of Minecraft you can run independently — game files, mods (Mods), worlds and its own settings. The launcher's instances page creates, installs and manages them.

## Instance list

Click **Instances** in the sidebar to open it. The list supports:

* **Search**: filter quickly by name
* **Filter**: switch between the **All / Modded / Vanilla / Snapshots / April Fools / Broken** tabs by version category, or filter by a custom group
* **Pin to home**: pin frequently used instances to the home page and launch them in one click from the home launch bar
* **Open details**: click an instance card to open its details page and view information, change settings, and manage mods and worlds

## Install a new game

Three ways: **install by downloading** a fresh copy, **install a modpack** to set up everything at once, or **migrate an existing game** to take over a `.minecraft` installed by another launcher (multiple game directories, scan and import, complete missing files).

See **[Install a game](https://docs.qomicex.top/en/guide/installing-games.md)**.

Installation progress is shown in [Downloads](https://docs.qomicex.top/en/guide/downloads.md). When it finishes, the instance appears in the list — click it to open its details page.

## Instance details

Click any instance to open its details page, which contains the following sections:

| Section | Description |
| :- | :- |
| **General** | Instance information at a glance and quick actions (launch, open folder, pin to home) |
| **Settings** | Instance name, icon, Java runtime, memory allocation, JVM arguments, integrity check, version isolation, linked account |
| **Game settings** | `options.txt` and key binding editor (search settings, customize keys) |
| **Worlds** | Single-player world list with rename / backup / delete |
| **Screenshots** | Browse in-game screenshots |
| **Mods** | Mod list with enable/disable, update and bulk delete, plus one-click search in Resource Center |
| **Resource packs** | Manage resource packs |
| **Shader packs** | Manage shader packs |
| **Data packs** | Manage world data packs |
| **Schematics** | Manage Litematica schematic files (preview / rename / delete) |
| **Servers** | Server list from `servers.dat` |

## Version isolation

When **version isolation (Version isolation)** is on, each instance keeps its mods, worlds, resource packs, shaders and other data in its own directory without interfering with others; when it is off, they all share the common folders under the game directory (the habit of older modpacks).

* Turn version isolation on or off for a single instance in **Instance details → Settings**;
* Change the global default in **Settings → Launcher settings**.

Keeping it on is generally recommended.

## Delete an instance

Right-click an instance card and choose **Delete instance**, or open Instance details → **General** and delete it there; a running instance cannot be deleted. Deleting removes the instance record from the launcher and permanently deletes the corresponding version directory — **back up personal data such as worlds beforehand**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.