Documentation

Getting Started

Installation

1. Download the installer from the latest release.
2. Run Loom-Setup-1.6.4.exe and follow the prompts.
3. Loom will open automatically after installation.

Signing In

On first launch, Loom walks you through a setup wizard. You'll sign in with your Microsoft account — the same one linked to your Minecraft purchase. Loom supports multiple accounts, so you can add more later from the account page.

Creating Your First Instance

1. Open the Library from the sidebar.
2. Click the + button to create a new instance.
3. Choose a Minecraft version and a mod loader (Fabric, Forge, NeoForge, or Quilt). You can also leave it on Vanilla.
4. Set your RAM allocation. 4 GB is a safe default for vanilla, 6–8 GB for modded.
5. Click Create. Loom downloads everything it needs and your instance is ready to launch.

Instances

An instance is a self-contained Minecraft installation — its own version, mods, worlds, and settings. You can have as many as you want.

Managing Instances

• Edit — Change the name, version, loader, RAM allocation, or icon.
• Clone — Duplicate an instance with all its mods and settings.
• Delete — Moves the instance to trash. You can recover it later or delete it permanently.
• Open Folder — Opens the instance directory in Windows Explorer.

File Explorer

Each instance has a built-in file explorer. You can browse, rename, delete, and copy files without leaving the launcher. This is useful for dropping in config files, maps, or resource packs manually.

Custom Icons

Right-click an instance and select Change Icon to set a custom image. Accepts PNG, JPG, or WEBP.

Mods & Modpacks

Installing Mods

1. Select an instance and open the Mods tab.
2. Search for a mod by name. Results come from Modrinth.
3. Click Install. Loom picks the right version for your game version and loader automatically.

To remove a mod, go to your installed mods list and click Uninstall.

Resource Packs

You can search and install resource packs the same way — from the Mods tab, switch to the Resource Packs section.

Modpacks

Loom supports Modrinth modpacks. You can either:

• Search for modpacks in the launcher and install directly.
• Drop a local .mrpack file into the launcher.

Loom creates a new instance for the modpack and downloads all the mods automatically.

Mod Vault

When the same mod is installed on multiple instances, Loom stores it once and uses hard links to share it. This saves disk space — you can see your total savings in Settings > Mod Vault.

Loomie AI

Loomie is Loom's built-in AI assistant, powered by Gemini. You can find it in the sidebar.

Setup

Loomie requires a Gemini API key to work. Go to Settings > Connected Apps > Gemini and paste your key. Your key is encrypted and stored locally — it's never sent anywhere except Google's API.

What Loomie Can Do

• Diagnose crashes — When your game crashes, Loomie reads the log, identifies the broken mod, and can remove or replace it for you.
• Install mods — Ask "install Sodium" and Loomie will find it on Modrinth and install it to your active instance.
• Change settings — Ask it to adjust RAM, switch loaders, or change preferences.
• Answer questions — Crafting recipes, enchantment guides, redstone help — anything Minecraft.
• Screen analysis — Loomie can see your screen. Ask "what's on my screen?" and it captures a screenshot for analysis.
• Voice input — Talk to Loomie instead of typing.

Crash Diagnosis

When Minecraft crashes, the Dynamic Island shows a crash notification. Click Fix with Loomie and it sends the crash log to the AI. Loomie identifies the problem — usually a mod conflict or missing dependency — and offers to fix it automatically.

Chat History

Your conversations with Loomie are saved. You can create new chats, rename them, and go back to old ones from the sidebar in the Loomie page.

Dynamic Island

The Dynamic Island is a small floating bar at the top of the launcher that shows contextual information. It also works as a transparent overlay on top of the game.

States

• Idle — Hidden or minimized.
• Launching — Shows download and install progress with a percentage.
• Running — Green indicator. Click to view game logs.
• Music — Album art, track name, and playback controls when Spotify is connected.
• Crash — Expands with crash details and a "Fix with Loomie" button.
• Loomie — Embedded chat when Loomie is in "On the Go" mode.

In-Game Overlay

While Minecraft is running, the Dynamic Island appears as a transparent overlay on top of the game window. It's click-through — it won't interfere with gameplay. You can minimize it to a small dot or expand it to see full details.

Bedrock Edition

Loom can detect, launch, and manage Minecraft Bedrock Edition alongside Java. You'll find it in the Bedrock page in the sidebar.

Requirements

Bedrock Edition must already be installed from the Microsoft Store. Loom detects it automatically.

Features

• World Browser — View your Bedrock worlds.
• Addon Installation — Install .mcpack and .mcaddon files. You can also queue multiple addons for batch install.
• Pack Browser — View installed resource and behavior packs.
• Ad Blocking — Block Marketplace ads in Bedrock. Toggle this on from the Bedrock page.
• Direct Server Connect — Launch Bedrock and connect directly to a server by URL and port.

Spotify

Loom connects to Spotify so you can control music from inside the launcher and the in-game overlay.

Setup

1. Go to Settings > Connected Apps > Spotify.
2. Follow the setup wizard — you'll need to create a Spotify Developer app and enter your Client ID.
3. Authorize the connection. Loom uses OAuth2 — your credentials are encrypted locally.

Controls

Once connected, the Dynamic Island shows your current track with album art. You can play, pause, skip, go back, and adjust volume. Lyrics are available for supported tracks.

Twitch & Media

Twitch Setup

Connect your Twitch account from Settings. Once connected, Loom shows your followed streams and notifies you when someone goes live.

In-Game Media

Loom can play Twitch streams and YouTube videos in an overlay while you're playing Minecraft. Search for content from the media viewer and it opens in a floating window.

Chat

You can connect to Twitch IRC chat and send messages directly from the launcher.

Recording

Loom has built-in screen recording powered by FFmpeg.

First-Time Setup

Loom downloads FFmpeg automatically when you first use recording. No manual setup required.

Recording

Start and stop recording from the launcher. Your recordings are saved locally and appear in the Gallery.

Replay Buffer

Enable the replay buffer to keep a rolling recording in the background. When something noteworthy happens, hit the save button and Loom saves the last N seconds as a clip. You never miss a moment.

Video Editor

The Gallery includes a built-in editor with:

• Trim — Cut the start and end of a clip.
• Speed — Speed up or slow down (0.25x to 4x).
• Text Overlay — Add text at the top, center, or bottom.
• Merge — Combine multiple clips into one video.

Sharing

Share recordings and screenshots to Discord via webhook. Set up your webhook URL in Settings > Connected Apps.

Discord

Loom can show a "Playing Minecraft" status on your Discord profile with the instance name and elapsed time.

Setup

1. Go to Settings > Connected Apps > Discord.
2. Enter your Discord Application ID (you can create one at the Discord Developer Portal).
3. Click Connect. Your status updates automatically when you launch a game.

Settings

Appearance

• Accent Color — Choose from 6 preset colors for the launcher UI.
• Home Background — Set a custom background image on the home screen.
• Font Scale — Adjust UI text size.
• Quick Launch — Show a button on the splash screen to jump to your last-played instance.

Performance

• Performance Mods — Auto-install Sodium, Lithium, and Iris on new Fabric instances.
• Optimized JVM Flags — Apply Aikar's G1GC flags for better garbage collection.
• High Process Priority — Give Minecraft more CPU priority.
• Optimized Game Settings — Apply performance-friendly video settings on new instances.
• Windows Defender Exclusion — Exclude the game folder from real-time scanning. Requires admin.
• Power Plan — Switch to High Performance power plan during gameplay.
• Network Optimization — Tune TCP settings for lower ping. Requires admin.
• Iris Shaders — Auto-install Iris for shader support.
• Cache & Skip — Cache baked models and textures to shave 2–5 seconds off repeat launches.

File Sync

File Sync keeps configs, mods, and resource packs consistent across multiple instances.

How It Works

1. Open Settings > File Sync.
2. Create a sync group and choose what to sync (configs, mods, resource packs).
3. Add instances to the group.
4. Sync is bi-directional — push changes from one instance, pull them into others.

Loom uses file-level hashing to detect changes, so only modified files are copied.

Migration

Switching from another launcher? Loom can import your existing setup.

Supported Launchers

• Prism Launcher
• MultiMC
• CurseForge
• ATLauncher
• Modrinth App
• Vanilla (official Minecraft launcher)

How to Migrate

Loom auto-detects installed launchers during the setup wizard. You can also trigger migration manually from Settings > About > Replay Setup Wizard. Loom imports instances, worlds, mods, resource packs, and settings.

Troubleshooting

Game Won't Launch

• Make sure you're signed in with a Microsoft account that owns Minecraft.
• Check that the game version matches your mod loader version.
• Try increasing RAM allocation — some modpacks need 6–8 GB.
• Check the game logs (click the logs icon in the sidebar) for specific errors.

Mods Not Showing Up

• Make sure you selected a mod loader (not Vanilla) when creating the instance.
• Check that the mod is compatible with your game version and loader.
• Open the instance file explorer and verify files are in the mods folder.

Loomie Not Responding

• Verify your Gemini API key is set in Settings > Connected Apps > Gemini.
• Check your internet connection — Loomie needs to reach Google's API.
• Try starting a new chat from the Loomie sidebar.

Resetting Loom

To reset the launcher to a clean state, go to Settings > About and use Replay Setup Wizard or Reset Customization. This does not delete your instances or mods.

Where Are My Files?

• Instances — Right-click an instance and click Open Folder.
• Recordings — Open the Gallery and right-click any recording.
• Logs — Available from the log viewer during or after a game session.
• Config — Stored in %APPDATA%/loom.