> ## 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.

# Settings reference

## Settings reference

The settings page lives under **Settings** in the sidebar, with category navigation on the left. There are 13 categories: Launcher settings, Basics, Launch settings, Download settings, Storage & Cache, Network settings, Java runtime, Plugins, Appearance, Toolbox, Logs, About, and Debug.

* **Global settings vs instance settings**: the memory, Java, and JVM arguments on this page are **global defaults**; an individual instance can override them in Instance details → Settings (see [Instance management](https://docs.qomicex.top/en/guide/instances.md)).
* The performance tuning deep dive (how much memory to give, which Java to pick, download acceleration) is in [Performance tuning](https://docs.qomicex.top/en/guide/optimize.md).
* The **Debug** category is hidden by default; it appears only after you unlock it on the About page.

## Launcher settings (Launcher settings)

| Setting | Description | Recommendation |
| :- | :- | :- |
| Data directory | Where launcher data is stored; **changing it requires a launcher restart** | Do not change unless you know what you are doing |

## Basics (Basics)

| Setting | Description | Recommendation |
| :- | :- | :- |
| Language | Interface display language | — |
| Translation service | Service used to translate resource descriptions: MyMemory (default) / Google Translate (needs a VPN) / Bing (requires an Azure Translator API key) | Leave it at the default |
| Automatically report critical error logs | Reports error logs plus device information (system and hardware); ordinary launch failures and download or install errors are not reported | ✅ Recommended |
| Anonymous plugin error telemetry | Reports only the plugin ID, version, and error type; off by default | Your choice |
| Log level | How verbose the console and log files are; the default is **Info** | Raise it while troubleshooting |

## Launch settings (Launch settings)

| Setting | Description | Recommendation |
| :- | :- | :- |
| Version isolation (Version isolation) | Keep mods / config / saves separate per version | ✅ On |
| Close launcher after start | Exit the launcher automatically once the game starts | Your preference |

## Download settings (Download settings)

| Setting | Description |
| :- | :- |
| Download threads | **How many files download at the same time** (1–512, default 64). Higher is faster but uses more bandwidth |
| Chunk threads | Parallel chunked download of large files: off / auto / 1–16 |
| Download timeout (seconds) | Retry a file automatically when it stops responding for this long (0 = no timeout, 1–120) |
| Enable HTTP/3 downloads (experimental) | Enables HTTP/3 for CDNs that support it |
| Force HTTP/1.1 parallel connections | Compatibility with some proxies |
| Skip JAR-level version probing | Speeds up version scanning |
| Resource file naming | `[localized name]original name-version` / `[original name]localized name-version` / `localized name-original name-version` / `localized name-version` / `original name-version` / `localized name` / `original name` |

Download settings also contain three download source groups, each with its own **auto-select** switch and latency test:

| Download source | Options |
| :- | :- |
| Download source (game itself) | Official / BMCLAPI mirror + automatically pick the fastest source |
| File download source | Official / mirror + automatically pick a source |
| Resource download source | Modrinth / CurseForge official vs the MCIM mirror + automatically pick the fastest resource source |

## Storage and cache (Storage & Cache)

* **Data directory**: where launcher data is stored; changing it requires a restart to take effect.
* **Version list cache**: clears the HTML cache files of the Forge version list.
* **CurseForge version list concurrency**: how many pages are fetched at once (1–20, default 10).
* **CurseForge version list cache TTL (seconds)**: 0 = cache forever (until a restart or a manual clear); default 300 seconds.
* **NeoForge / FTB version cache, mod list cache, mod update cache, modpack import temporary files**: each has its own clear button.

## Network settings (Network settings)

| Setting | Description |
| :- | :- |
| Proxy type | Off / Follow system / HTTP(S) proxy / SOCKS5 proxy |
| Proxy server address | `host:port`, e.g. `127.0.0.1:7890` |
| Ignore SSL certificates | Skip certificate verification (fixes certificate hijacking by some proxies; it is a security risk, so enable it temporarily only while troubleshooting) |
| Multiplayer relay | Custom EasyTier relay nodes; supports protocols such as `tcp/udp/wg/quic/ws/wss`. Custom nodes take priority; leave the field empty to use official nodes only |
| System integration | Associate or disassociate `qomicex-launcher://` links |

The proxy here applies to **the launcher's own requests** (resource search, downloads, and so on) and does not change in-game networking.

## Java runtime (Java runtime)

* **Quick scan / Deep scan / Refresh list**: detects the Java runtimes on your machine; use **Show invalid entries** to inspect unusable ones.
* **Download Java**: in the download dialog, pick a distribution (those marked "Recommended"), the Java major version, platform, architecture, and target directory.
* **Add manually**: point to the full path of a Java executable already on your machine.
* **Default configuration** (further down this category): the default Java runtime (auto-selection available), memory allocation, and extra JVM arguments — these three are the [Memory and JVM arguments](#memory-and-jvm-arguments) below.

### Memory and JVM arguments

* **Memory allocation**: **Auto** computes it as 70% of available memory (minimum 512 MiB); you can also drag it manually, from 512 MiB up to the available memory in 256 MiB steps.
* **Extra JVM arguments**: JVM arguments appended when Minecraft starts. Fill these in only if the modpack author provides recommended values.

> [!WARNING]
>
> Do not change JVM arguments unless you know what you are doing — wrong arguments can prevent the game from starting.

## Appearance (Appearance)

| Setting | Description |
| :- | :- |
| Theme mode / Theme preset / Accent color | Light or dark; presets are Qomicex Default and Catppuccin (Latte / Frappé / Macchiato / Mocha); the accent color can be set manually or **follow the background (Monet color extraction)** |
| Component material | Default / Frosted glass / Acrylic / Aero / Liquid glass (preview). Enabling Liquid glass asks for confirmation and warns about the performance cost; any non-default material adds a blur strength slider |
| Card opacity / Card border color / Card border width | With the default material: the opacity of category cards (default 50), plus border color and thickness (0–4px, where 0 means no border) |
| Dialog opacity | Background opacity of dialogs, independent of the component material (default 75) |
| Page animations / GPU hardware acceleration / Animation speed | Page transition and dialog animations, the hardware acceleration switch (only shown while page animations are on), and animation speed from 0.25x to 2x |
| Frame rate limit | Unlimited / 30 / 60 / 120 / 144 |
| Window corners | Corner toggle and radius (square / default 8px / large); applies only when the system frame is not used |
| Interface font | Pick an installed system font; it applies to the whole UI immediately |
| Background | Background image (can pick a random one on each start, play animated images, or play video), overlay opacity, blur |
| Watermark | Home page watermark text and subtitle |

## Toolbox (Toolbox)

The toolbox currently has a single capability: **Custom file download** — paste a list of URLs and download them in bulk to a folder you choose.

## Logs (Logs)

Log management: keeps the 10 most recent log files, with search, filtering by level, and export of all logs or export as `.gz`.

## About (About)

Version information, **License** (channel / expiry date / machine ID / activate license), **Updates** (including automatically downloading and installing updates), developers, acknowledgements, reference projects, backend dependencies, frontend dependencies, open-source licenses, and **Copyright & privacy** (the full copyright notice, user agreement, and privacy policy), plus sponsor acknowledgements.


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