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

# Download mirrors

> QML-Mirror: an acceleration mirror for Minecraft mods and dependency libraries, routing by path prefix to each loader repository.

## Download mirrors

**QML-Mirror** is an acceleration mirror for Minecraft mods and dependency libraries, aimed at players in mainland China. It addresses the timeouts, single-thread throttling, and dropped connections that occur when connecting straight to overseas sources such as Forge, Fabric, or Mojang. The service runs on Tencent Cloud EdgeOne's global edge network.

Highlights:

* **Direct domestic access**: reachable over all three major Chinese networks without a cross-border hop.
* **Strong edge caching**: popular mods and libraries are cached at the edge, so repeat downloads are served from the edge.
* **Multi-threaded range support**: works with concurrent launcher downloads and gets past the official sources' single-thread limits.
* **Full loader coverage**: Forge, NeoForge, Fabric, Quilt, Legacy Fabric, Babric, Cleanroom, and Sponge.
* **HTTPS enforced**: the whole site is HTTPS + HTTP/2.

## How to call it

The mirror routes by **path prefix**: replace the domain in the original URL with `mirror.shenv.top` and prepend the prefix for that repository. The rest of the path stays the same.

For example, a Forge installer:

```text theme={null}
# Original URL
https://maven.minecraftforge.net/net/minecraftforge/forge/1.20.1-47.2.0/forge-1.20.1-47.2.0-installer.jar

# Mirrored URL
https://mirror.shenv.top/mc-forge/net/minecraftforge/forge/1.20.1-47.2.0/forge-1.20.1-47.2.0-installer.jar
```

## Path mapping

> [!WARNING]
>
> Prefixes marked "Temporarily unavailable" currently fail; they are being fixed. All other prefixes work normally.

### Core loaders (Maven repositories)

| Upstream domain | Mirror prefix | Example path |
| :- | :- | :- |
| `maven.minecraftforge.net` | `/mc-forge/` | `/mc-forge/net/minecraftforge/...` |
| `files.minecraftforge.net` | `/mc-forge-files/` | `/mc-forge-files/maven/...` |
| `maven.neoforged.net` | `/mc-neoforge/` | `/mc-neoforge/net/neoforged/...`  (Temporarily unavailable) |
| `maven.fabricmc.net` | `/mc-fabric/` | `/mc-fabric/net/fabricmc/...` |
| `maven.quiltmc.org` | `/mc-quilt/` | `/mc-quilt/org/quiltmc/...` |
| `maven.legacyfabric.net` | `/mc-legacyfabric/` | `/mc-legacyfabric/net/legacyfabric/...`  (Temporarily unavailable) |
| `maven.glass-launcher.net` | `/mc-babric/` | `/mc-babric/...`  (Temporarily unavailable) |
| `repo.maven.apache.org` | `/mc-apache/` | `/mc-apache/maven2/...` |
| `maven.cleanroommc.com` | `/mc-cleanroom/` | `/mc-cleanroom/...`  (Temporarily unavailable) |
| `repo.spongepowered.org` | `/mc-sponge/` | `/mc-sponge/maven/...`  (Temporarily unavailable) |

### Version metadata (Meta)

Note: the QML mirror prefix for `maven.neoforged.net` is currently unavailable. The Qomicex launcher falls back to NeoForge's official CDN `neoforged.forgecdn.net` (paths mirror the official maven); BMCLAPI `/maven` also works. Plugin batch downloads (`download.addBatch`) get these fallbacks automatically.

| Upstream domain | Mirror prefix | Example path |
| :- | :- | :- |
| `meta.fabricmc.net` | `/mc-fabric-meta/` | `/mc-fabric-meta/v2/versions/...` |
| `meta.quiltmc.org` | `/mc-quilt-meta/` | `/mc-quilt-meta/v3/versions/...` |
| `meta.legacyfabric.net` | `/mc-legacyfabric-meta/` | `/mc-legacyfabric-meta/v2/versions/...` |
| `meta.babric.glass-launcher.net` | `/mc-babric-meta/` | `/mc-babric-meta/v2/versions/...`  (Temporarily unavailable) |

### Vanilla base resources

| Upstream domain | Mirror prefix | Example path |
| :- | :- | :- |
| `libraries.minecraft.net` | `/mc-libraries/` | `/mc-libraries/com/mojang/...`  (Temporarily unavailable) |
| `resources.download.minecraft.net` | `/mc-assets/` | `/mc-assets/xx/xxxx...`  (Temporarily unavailable) |

## Architecture and performance

**Caching strategy**: immutable files such as `.jar` and `.pom` are cached at the edge for a long time. Metadata files such as `.xml` and `.json` use short caching or bypass the cache so you always get current version information.

**Origin fetching**: large file requests go straight through EdgeOne's native CDN path, fetching from origin and transferring in ranges without passing through an edge function. This lowers time to first byte (TTFB) and removes the single-thread bandwidth ceiling.

**Measured performance**: downloading an 8 MB Forge installer takes about 14 seconds directly from the official source, versus about 4.3 seconds through this mirror (single-threaded). A second download served from cache finishes in under 1 second.

## Relationship to the Qomicex Launcher

> [!NOTE]
>
> The launcher now integrates QML-Mirror with a traffic-splitting policy: **mod loader metadata and installers** (Fabric/Quilt meta, the Forge installer and its maven dependencies — small, strongly cached files) go through QML-Mirror by default (prefix routing per the table above, with automatic fallback to the official source), while **mod files** stay on the official CDNs (with MCIM as the mirror fallback) — mod files are large and high-traffic, and routing them all through a community mirror would overwhelm the CDN, so the mirror is reserved for loader metadata and installers.

## FAQ

**A download returns 404?** Check that the path prefix matches the mapping table. Some upstream repositories have an extra directory level (for example NeoForge dependencies under `/releases/`); the mirror rewrites those internally.

**Does the mirror log what I download?** No. It acts purely as a CDN cache node and does not record or inspect user activity.

**Is this an official service?** No. It is a community acceleration node maintained by an individual developer, and it has no affiliation with Mojang, Forge, or Fabric.

> For learning and personal game acceleration only. Do not use it commercially or to generate abusive traffic. All game files remain the property of their respective authors.


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