Trestle is a cross-platform Minecraft Java Edition launcher built with Kotlin and Compose Multiplatform.
Download Trestle and read the guides at launcher.6b6t.org. The website source lives in site/.
Play from the library, then open an instance to jump into a world, join a server, or manage content.
Find mods and shaders for the instance you choose, create new instances, and sign in with the method that suits you.
Use the dark or light theme, or follow your system.
The same layout adapts to phones.
Trestle provides:
- Isolated, persisted Minecraft instances with atomic registry writes.
- Vanilla, Fabric, NeoForge, Forge, and Quilt metadata resolution and installation.
- Verified Mojang asset, library, native, logging, and client downloads.
- Managed Mojang Java runtimes, with Eclipse Temurin for Linux ARM64.
- Modrinth, CurseForge, ATLauncher, FTB, FTB Legacy, and Technic catalogs.
- Installed-content updates, hash-based identification, dependency tracking, enable controls, and removal.
- Launcher update notices with release notes and platform-specific downloads.
- Interface text in English, German, Spanish, French, Brazilian Portuguese, Russian, Polish, Turkish, Japanese, Simplified Chinese, Arabic, Persian, Hebrew, and Urdu, with right-to-left layouts for the last four. Choose the language in Settings > Language, or follow the system language.
- Tracked modpack updates with previews, file backups, and rollback.
- Modrinth, CurseForge, Prism Launcher, and MultiMC pack import.
- Portable instance export with Prism-compatible metadata.
- Instance cloning, grouping, custom icons, launch statistics, and component changes.
- World import, copy, rename, backup, data-pack, icon, and seed controls.
- Server status, player counts, ordering, resource-pack policy, and direct join controls.
- Screenshot management, instance notes, searchable game logs, and crash reports.
- Microsoft, imported-session, and offline account profiles.
- Per-instance accounts, custom Java paths, environment variables, and live console output.
- Desktop pre-launch, wrapper, and post-exit commands.
- Android launch support for Vanilla Minecraft 26.2 on compatible ARM64 and x64 devices.
- Android touch, keyboard, mouse, and gamepad input.
- An iPhone and iPad launcher target with Microsoft authentication and instance management.
- A bundled iOS Java 25 and Amethyst-derived runtime bridge for JIT-enabled ARM64 devices.
Android uses a fixed Java 25 and Zink runtime. Android does not support other Minecraft versions or mod loaders yet.
- Android 8.1 or newer (API 27), ARM64 and x64, with Vulkan 1.2 or newer for game launch.
- iOS 16 or newer on ARM64 devices. Game launch needs a compatible JIT or jailbreak environment.
- Linux, macOS, and Windows, with x64 and ARM64 packages and a bundled Java 21 launcher runtime.
Android x64 requires device acceptance tests before stable release. The build checks do not establish Minecraft or GPU compatibility. 32-bit ARM, 32-bit x86, and RISC-V packages are not available.
The shared module contains the interface, product logic, network clients, persistence, installer, and domain model. Platform source sets provide runtime adapters and app storage paths.
- JDK 21
- Android SDK 37 for Android builds
- Xcode 16.4 or newer for iOS builds
Use the included Gradle wrapper. You do not need a separate Gradle installation.
./gradlew :desktopApp:runThe packaged desktop application also provides command-line operations:
trestle --list
trestle --install <instance-id>
trestle --launch <instance-id>
trestle --export <instance-id> [archive-path]The launch command writes Minecraft output to the terminal. It returns the game process exit code.
Modrinth works without an access key. CurseForge requires a key that CurseForge issued for Trestle.
If you have an approved Trestle key, set it before you build or run the application:
export TRESTLE_CURSEFORGE_API_KEY="your-approved-key"
./gradlew :desktopApp:runThe Android build reads the same environment variable and adds it to the application manifest. Do not use the key from another launcher.
./gradlew :androidApp:assembleDebugThe command creates ARM64, x64, and universal debug APKs under androidApp/build/outputs/apk/debug.
Trestle shows CurseForge as unavailable when the key is not set. Modrinth search and installation remain available.
Release APKs and app bundles use a dedicated signing key. See Android release signing for configuration and backup instructions.
Open iosApp/Trestle.xcodeproj on a Mac. Select a development team, then build the Trestle scheme.
You can compile the shared iOS target from Gradle:
./gradlew :shared:compileKotlinIosSimulatorArm64Device builds include the iOS runtime payload. The simulator supports launcher workflows but cannot start the ARM64 device runtime.
See iOS launcher target for the build, signing, and runtime requirements.
Run the shared tests:
./gradlew :shared:allTestsRun Android lint:
./gradlew :androidApp:lintDebugCompile the desktop app:
./gradlew :desktopApp:classesCheck Kotlin style and static analysis:
./gradlew ktlintCheck detektFix formatting with ./gradlew ktlintFormat. ktlint reads its rules from .editorconfig.
detekt reads config/detekt/detekt.yml and ignores the existing findings listed in each module's detekt-baseline.xml.
Fix new detekt findings instead of adding them to the baseline.
GitHub Actions runs these checks for each pull request and each push to main.
androidApp/ Android application and entry point
desktopApp/ Desktop application and entry point
iosApp/ iOS application and Xcode project
shared/ Shared UI, resources, domain model, and tests
site/ Website and guides, published to launcher.6b6t.org
gradle/ Version catalog and Gradle wrapper files
licenses/ Licenses for bundled third-party assets
Trestle source code uses the GNU General Public License version 3 only.
Some third-party code uses the Apache License 2.0. See licenses/Apache-2.0.txt.
The bundled Roboto font uses the SIL Open Font License 1.1. See licenses/OFL-Roboto.txt.
The vendored PlatformTools accent readers use the MIT License. See licenses/MIT-PlatformTools.txt.
Install Lefthook 1.13.6 or newer and Python 3.10 or newer.
Run lefthook install once in each clone or linked worktree.
The commit hook checks staged whitespace without rewriting or staging files. The push hook reads Git's exact ref updates and selects existing checks for changed paths, including deletions. New remote refs and unavailable baselines check the complete tree. Check out the commit that you push, then commit or stash tracked and untracked changes. This makes the working files match the pushed revision. Deletion-only pushes do not run code checks. Hook regression tests run for pushes with changed files. Documentation changes do not compile the application. CI remains enabled.
Use the Java toolchains required by Gradle.
Kotlin, shared code, desktop code, and Gradle changes run :shared:desktopTest, :desktopApp:test, and :desktopApp:classes.
Python tooling changes run python3 -m unittest discover -s scripts/tests -v.
Website changes run the site checks, unit tests, and static build with Bun.
These tests use local fixtures. Android and iOS platform builds remain in CI.
Signing, release packaging, and uploads run separately from hooks.
Preview the complete local check plan:
python3 scripts/check-push.py --all --dry-run --verboseRun all checks against working files before committing:
python3 scripts/check-push.py --allThe explicit --all mode allows uncommitted files. Normal push hooks require a clean working tree.




