https://github.com/desaianand1/ariadnes-thread
A Modrinth collection download helper utility. Got a ton of mods in collections but no one-click solution to download them all? Try Ariadne's Thread!
https://github.com/desaianand1/ariadnes-thread
curseforge curseforge-api minecraft minecraft-mod modrinth modrinth-api modrinth-downloader
Last synced: 2 months ago
JSON representation
A Modrinth collection download helper utility. Got a ton of mods in collections but no one-click solution to download them all? Try Ariadne's Thread!
- Host: GitHub
- URL: https://github.com/desaianand1/ariadnes-thread
- Owner: desaianand1
- License: other
- Created: 2024-12-06T10:37:23.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-07T16:53:41.000Z (2 months ago)
- Last Synced: 2026-04-07T18:02:44.840Z (2 months ago)
- Topics: curseforge, curseforge-api, minecraft, minecraft-mod, modrinth, modrinth-api, modrinth-downloader
- Language: TypeScript
- Homepage: https://modrinth.download
- Size: 1.14 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: docs/README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
- Roadmap: docs/ROADMAP.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# 🧵 Ariadne's Thread
**Download your Modrinth collections as ready-to-play ZIPs.**
[](https://modrinth.download)
[](LICENSE.md)
[](https://svelte.dev)
[](https://pages.cloudflare.com)
[](https://ko-fi.com/ananddesai)
[](https://buymeacoffee.com/ananddesai)
---
Modrinth collections are bookmarks — not modpacks. They don't resolve versions, handle dependencies, or separate client and server mods. Downloading 50+ mods means 50+ individual clicks.
**Ariadne's Thread fixes that.** Paste your Modrinth collection URLs, pick your Minecraft version and mod loader, and get two ZIPs: one for client, one for server. Share a single link with friends and they get the exact same setup.
## How It Works
1. **Paste** one or more Modrinth collection URLs
2. **Pick** your Minecraft version and mod loader (Fabric, Forge, Quilt, NeoForge)
3. **Review** the resolved mod list — versions matched, dependencies included, conflicts flagged
4. **Download** client and server ZIPs, organized into `/mods`, `/resourcepacks`, `/shaderpacks`, and `/datapacks`
## Features
- **Version resolution** — automatically matches each mod to your Minecraft version and loader
- **Dependency resolution** — recursively finds and includes required dependencies
- **Side separation** — splits mods into client-only, server-only, and shared
- **Cross-loader fallback** — Quilt falls back to Fabric mods, NeoForge to Forge
- **Conflict detection** — flags incompatible mods before you download
- **Shareable links** — every configuration is encoded in the URL, no account needed
- **Bulk download** — concurrent downloads with progress tracking and hash verification
## Supported Content
| Type | ZIP Directory |
| -------------- | ---------------- |
| Mods | `/mods` |
| Resource Packs | `/resourcepacks` |
| Shaders | `/shaderpacks` |
| Data Packs | `/datapacks` |
---
## Development
> Requires [Node.js](https://nodejs.org) 18+ and [pnpm](https://pnpm.io).
```sh
pnpm install
pnpm dev
```
| Command | Purpose |
| -------------- | ------------------------ |
| `pnpm dev` | Start dev server |
| `pnpm build` | Production build |
| `pnpm preview` | Preview production build |
---
## Support
If you find Ariadne's Thread useful, consider supporting its development:
[](https://ko-fi.com/ananddesai)
[](https://buymeacoffee.com/ananddesai)
## License
This project is source-available under the [Functional Source License (FSL-1.1-ALv2)](LICENSE.md). You can read, audit, and learn from the code. After two years, each release converts to the Apache 2.0 license.
---
⚒️ Crafted by [Nirnshard](https://nirnshard.com)