Capability sheet

Everything in one window.

SalmonLauncher splits the job of a launcher into seven areas, but they share one config, one instance folder and one task queue. Here is exactly what each area does.

SL / FEATURES
v1.0.3
WIN 10 2004+
01 / INSTALL

Install: manifest to runnable folder

The version list comes from Mojang's official version_manifest_v2.json: the latest 40 releases plus the latest 12 snapshots and historical builds. Pick one and the launcher fills in libraries, assets and natives from the manifest, then finds or downloads a matching Java.

  • Fabric, Quilt, Forge and NeoForge loader installs
  • Automatic BMCLAPI mirror fallback when the primary source fails
  • Resume plus SHA-1 verification; mismatches are downloaded again
  • 2026 natives rules: windows-x64 only, other platforms pruned
install / 1.20.14 STEPS
manifest · version jsonOK
libraries · 58 filesOK
assets · index 12OK
natives · lwjglOK
java · major 17SCAN
02 / LAUNCH

Launch is a visible sequence

Launching is not a click and a wait. Every stage shows up in the task centre: parse metadata, verify libraries, rebuild natives, top up assets, locate Java, assemble arguments, start the process. Success and failure both land in the instance log.

  • Memory, window size and extra JVM arguments per instance
  • Natives are rebuilt on every launch, so stale DLLs never leak in
  • Game stdout and stderr are redirected into the instance log
  • Abnormal exits drop straight into diagnostics
launch / 26.3PID 6844
[09:41:02]loading version json
[09:41:02]74 libraries verified
[09:41:03]natives rebuilt in 0.4 s
[09:41:05]assets: 12 missing, fetched
[09:41:06]java 25.0.1 · temurin
[09:41:07]process alive · 1.8 GB heap
03 / INSTANCES & MODS

Instances are folders, not a database

Each instance owns a full tree under instances/<id>/: meta, versions, mods, resourcepacks, shaderpacks, saves, logs, natives, crash-reports. Removing one instance touches nothing else.

  • Mod toggling is a rename: .jar ↔ .jar.disabled
  • Real metadata read from fabric.mod.json, mods.toml or mcmod.info
  • Local mods import directly, leaving the original untouched
  • Saves can be zipped for backup; migrating is a folder copy
mods / 26.39 ACTIVE
sodium0.6.13
iris1.9.2
fabric-api0.115.0
modmenu11.0.3
lithium0.15.3
xaero-map1.38.8
04 / MULTIPLAYER

Multiplayer: relay, LAN, invite code

The first version ships a local loopback TCP signalling relay. Invite codes look like SLROOM-xxxx-xxxx and the port is picked from the system, so no manual forwarding rules. A public relay needs a server; this release still runs loopback.

  • Host a room and share an invite code for the same machine or LAN
  • LAN scan lists joinable games on the same subnet
  • Manual relay: point at an address you already run
  • Signalling is separate from the game process; closing the launcher leaves the game running
voxlink / roomSLROOM-7K3Q
hostpid 6844
playerlocalhost
lanscan
relaymanual
SIGNALtcp · loopback
05 / CONTENT

Content: three Modrinth categories

Mods, shaders and resource packs share one search view, while the install folder follows the category: mods, shaderpacks, resourcepacks. With an instance selected, finished downloads land in the right folder.

  • Faceted search by category and game version
  • Shaders are not pinned to a game version, so usable projects are not hidden
  • A China mirror can be selected
  • The target instance and folder are shown before install
modrinth / shaders4 RESULTS
Complementary Reimaginedr5.5INSTALL
BSL Shaders8.4INSTALL
Photon Shader1.2INSTALL
Solas Shader2.1INSTALL
target · 26.3 / shaderpacks
06 / ACCOUNTS

Microsoft sign-in, three ways

Signing in does not depend on one embedded browser. Device code suits environments without a browser, and system-browser sign-in pastes the callback link back into the app. Offline accounts are unlimited, with UUIDs generated by the offline rule.

  • Embedded browser authorisation with full-page scrolling
  • Device code sign-in confirmed on any device
  • System browser sign-in opens the default browser and copies the link
  • Sessions persist locally, refresh automatically, and fall back to offline with a notice
accountMSA / OFFLINE
Embedded browser Device code System browser
Microsoft accountmsa
Offline · Riolegacy
Offline · Alt1legacy
SESSION access token valid · refreshed 3 min ago
07 / APPEARANCE

Four languages, two themes, one workshop

The interface ships in Simplified Chinese, Traditional Chinese, English and Japanese, follows the system by default and switches on demand. Light and dark can follow the system or be locked; accent colour, a block-colour theme workshop and wallpapers keep the window from being a grey slab.

  • Theme tokens swap as a whole, with no flicker
  • System-follow listens to AppsUseLightTheme in the registry
  • Custom accent applies immediately
  • Block-colour workshop and wallpapers
appearanceDARK / ZH
简体中文 繁體中文 English 日本語
Dark Light Follow system
08 / DIAGNOSTICS

After a crash, start with the conclusion

Diagnostics read the tail of latest.log through FileStream + FileShare.ReadWrite, sidestepping log4j's file lock. Signatures cover mod conflicts, out-of-memory, Java version mismatch, missing dependencies and OpenGL, then hand back a plain-language explanation and next step.

  • No FileNotFoundException just because the log is held open
  • Signature matching instead of keyword guesswork
  • Actionable advice rather than a pasted stack trace
  • The raw log stays readable and exportable
diagnostics / latest.log1 MATCH
[12:04:11]java.lang.OutOfMemoryError
[12:04:11]  at net.minecraft.client.Main
[12:04:12]process exited with code 1
MATCHED · OUT OF MEMORY The allocated heap is not enough for this pack. Raise memory above 4096 MB in launch settings, or remove heavy mods.
09 —

Boundaries

What it does not do

Not in scope

  • No Minecraft game files are bundled or modified
  • No cracked servers or accounts are provided
  • Mods are not auto-updated; you choose the version
  • A public relay server is not hosted for you

What it relies on

  • A network connection for the first version manifest
  • Game files come from official sources or public mirrors
  • Java is downloaded on demand (Eclipse Temurin)
  • Mods and shaders remain their authors' property
Read enough

Install one and see if it stalls.

A 59.5 MB installer with its runtimes included, no extra dependencies.