No description
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
sooox-cc 51c52f8428
Some checks failed
Lifecycle / Release Please (push) Has been cancelled
Lifecycle / build (push) Has been cancelled
Lifecycle / test (macos-latest) (push) Has been cancelled
Lifecycle / test (windows-latest) (push) Has been cancelled
Lifecycle / docker-build (linux/amd64) (push) Has been cancelled
Lifecycle / docker-build (linux/arm64) (push) Has been cancelled
Lifecycle / build-1 (push) Has been cancelled
Lifecycle / build-2 (push) Has been cancelled
Lifecycle / build-3 (push) Has been cancelled
Lifecycle / build-4 (push) Has been cancelled
Lifecycle / deploy-pages (push) Has been cancelled
Lifecycle / build-mc-runtime-test (map[branch:286a6d64008be90fc82f8ffadb8f111adab6907e dir:112 java:8 lex:14.23.5.2860 mc:1.12.2 neo:]) (push) Has been cancelled
Lifecycle / build-mc-runtime-test (map[branch:286a6d64008be90fc82f8ffadb8f111adab6907e dir:12111 java:21 lex:61.0.6 mc:1.21.11 neo:35-beta]) (push) Has been cancelled
Lifecycle / build-mc-runtime-test (map[branch:286a6d64008be90fc82f8ffadb8f111adab6907e dir:189 java:8 lex:11.15.1.2318-1.8.9 mc:1.8.9 neo:]) (push) Has been cancelled
Lifecycle / build-mc-runtime-test (map[branch:286a6d64008be90fc82f8ffadb8f111adab6907e dir:263 java:25 lex:66.0.2 mc:26.3 neo:6-beta]) (push) Has been cancelled
Lifecycle / mc-runtime-test (map[java:21 mc:1.21.11 modloader:neoforge type:neoforge xvfb:false]) (push) Has been cancelled
Lifecycle / mc-runtime-test (map[java:21 mc:1.21.11 modloader:neoforge type:neoforge xvfb:true]) (push) Has been cancelled
Lifecycle / mc-runtime-test (map[java:25 mc:26.3 modloader:fabric type:fabric xvfb:false]) (push) Has been cancelled
Lifecycle / mc-runtime-test (map[java:25 mc:26.3 modloader:fabric type:fabric xvfb:true]) (push) Has been cancelled
Lifecycle / mc-runtime-test (map[java:25 mc:26.3 modloader:forge type:lexforge xvfb:false]) (push) Has been cancelled
Lifecycle / mc-runtime-test (map[java:25 mc:26.3 modloader:forge type:lexforge xvfb:true]) (push) Has been cancelled
Lifecycle / mc-runtime-test (map[java:25 mc:26.3 modloader:neoforge type:neoforge xvfb:false]) (push) Has been cancelled
Lifecycle / mc-runtime-test (map[java:25 mc:26.3 modloader:neoforge type:neoforge xvfb:true]) (push) Has been cancelled
Lifecycle / mc-runtime-test (map[java:8 mc:1.12.2 modloader:forge type:lexforge xvfb:false]) (push) Has been cancelled
Lifecycle / mc-runtime-test (map[java:8 mc:1.12.2 modloader:forge type:lexforge xvfb:true]) (push) Has been cancelled
Lifecycle / mc-runtime-test (map[java:8 mc:1.8.9 modloader:forge type:lexforge xvfb:false]) (push) Has been cancelled
Lifecycle / mc-runtime-test (map[java:8 mc:1.8.9 modloader:forge type:lexforge xvfb:true]) (push) Has been cancelled
Lifecycle / server-test fabric 1.21.1 ubuntu-latest (push) Has been cancelled
Lifecycle / server-test forge 1.21.1 ubuntu-latest script (push) Has been cancelled
Lifecycle / server-test neoforge 1.21.1 ubuntu-latest script (push) Has been cancelled
Lifecycle / server-test vanilla 1.21.1 ubuntu-latest (push) Has been cancelled
Lifecycle / server-test fabric 1.21.1 windows-latest (push) Has been cancelled
Lifecycle / server-test forge 1.21.1 windows-latest script (push) Has been cancelled
Lifecycle / server-test neoforge 1.21.1 windows-latest script (push) Has been cancelled
Lifecycle / server-test vanilla 1.21.1 windows-latest (push) Has been cancelled
Lifecycle / server-test forge 1.21.1 ubuntu-latest mock-java (push) Has been cancelled
Lifecycle / server-test neoforge 1.21.1 ubuntu-latest mock-java (push) Has been cancelled
Lifecycle / server-test forge 1.21.1 windows-latest mock-java (push) Has been cancelled
Lifecycle / server-test neoforge 1.21.1 windows-latest mock-java (push) Has been cancelled
Lifecycle / server-test fabric 26.3 ubuntu-latest (push) Has been cancelled
Lifecycle / server-test forge 26.3 ubuntu-latest script (push) Has been cancelled
Lifecycle / server-test neoforge 26.3 ubuntu-latest script (push) Has been cancelled
Lifecycle / server-test vanilla 26.3 ubuntu-latest (push) Has been cancelled
Lifecycle / server-test fabric 26.3 windows-latest (push) Has been cancelled
Lifecycle / server-test forge 26.3 windows-latest script (push) Has been cancelled
Lifecycle / server-test neoforge 26.3 windows-latest script (push) Has been cancelled
Lifecycle / server-test vanilla 26.3 windows-latest (push) Has been cancelled
Lifecycle / server-test forge 26.3 ubuntu-latest mock-java (push) Has been cancelled
Lifecycle / server-test neoforge 26.3 ubuntu-latest mock-java (push) Has been cancelled
Lifecycle / server-test forge 26.3 windows-latest mock-java (push) Has been cancelled
Lifecycle / server-test neoforge 26.3 windows-latest mock-java (push) Has been cancelled
Lifecycle / docker-release (push) Has been cancelled
Lifecycle / merge (push) Has been cancelled
Lifecycle / release (push) Has been cancelled
Lifecycle / Publish to Maven Central (push) Has been cancelled
feat(lwjgl): stb_truetype font names and usable struct buffers in headless mode
Meteor Client builds its font list and glyph tables at startup and crashed
headless. Two generic redirections fix it:
- stbtt_InitFont remembers each fontinfo's data (by identity, since the patched
  struct's equals/hashCode are no-ops) and stbtt_GetFontNameString reads the
  record from the font's name table in Java. Registered after
  ForgeDisplayWindowRedirections, whose stbtt_InitFont stub would win otherwise.
- create/malloc/calloc(int) on XYZ.Buffer remember the capacity, capacity()
  returns it, and StructBuffer.get()/get(int) return an XYZ instead of a bare
  Struct that fails the caller's cast.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-17 13:07:31 +02:00
.github chore(ci): update actions/setup-java digest to b843ebf (#478) 2026-10-17 11:46:32 +02:00
docs chore(docs): add dev documentation 2026-10-15 12:44:38 +02:00
gradle feat(specifics): pass specifics to game system properties (#470) 2026-10-15 01:22:59 +02:00
headlessmc-application fix(launcher): fix lwjgl patching for older versions (#449) 2026-10-10 17:40:55 +02:00
headlessmc-auth chore(build): prepare for hmc-specifics compatibility (#469) 2026-10-14 16:38:55 +02:00
headlessmc-bom feat: 3.0.0-RC1 (#432) 2026-10-04 11:01:56 +02:00
headlessmc-commands chore(build): prepare for hmc-specifics compatibility (#469) 2026-10-14 16:38:55 +02:00
headlessmc-config feat(specifics): pass specifics to game system properties (#470) 2026-10-15 01:22:59 +02:00
headlessmc-console feat(specifics): pass specifics to game system properties (#470) 2026-10-15 01:22:59 +02:00
headlessmc-docs feat: 3.0.0-RC1 (#432) 2026-10-04 11:01:56 +02:00
headlessmc-exceptions chore(build): prepare for hmc-specifics compatibility (#469) 2026-10-14 16:38:55 +02:00
headlessmc-files fix(windows): fixed line ending and patching issues (#466) 2026-10-13 18:54:53 +02:00
headlessmc-java fix(windows): fixed line ending and patching issues (#466) 2026-10-13 18:54:53 +02:00
headlessmc-launcher chore(ci): only build ubuntu native image outside of releases, test on windows and macos (#475) 2026-10-15 02:34:15 +02:00
headlessmc-logging feat: 3.0.0-RC1 (#432) 2026-10-04 11:01:56 +02:00
headlessmc-lwjgl feat(lwjgl): stb_truetype font names and usable struct buffers in headless mode 2026-10-17 13:07:31 +02:00
headlessmc-mods feat(packwiz): Add packwiz support (#440) 2026-10-06 15:02:15 +02:00
headlessmc-net fix(net): delete files when hash verification failed (#474) 2026-10-15 01:23:14 +02:00
headlessmc-os fix: GraalVM wasm compile bug workarounds 2026-10-06 17:03:23 +02:00
headlessmc-patcher Revert "feat(lwjgl): hmc.lwjgl.ignore.packages leaves whole LWJGL packages unpatched" 2026-10-17 13:07:31 +02:00
headlessmc-platform feat(specifics): pass specifics to game system properties (#470) 2026-10-15 01:22:59 +02:00
headlessmc-plugins feat: 3.0.0-RC1 (#432) 2026-10-04 11:01:56 +02:00
headlessmc-secrets feat: 3.0.0-RC1 (#432) 2026-10-04 11:01:56 +02:00
headlessmc-test fix(test): fix test WAIT timeout (#476) 2026-10-15 17:22:22 +02:00
headlessmc-util feat: 3.0.0-RC1 (#432) 2026-10-04 11:01:56 +02:00
headlessmc-version fix(launching): fix library merging of version.jsons (#447) 2026-10-08 17:53:52 +02:00
scripts fix(windows): fixed line ending and patching issues (#466) 2026-10-13 18:54:53 +02:00
src feat: 3.0.0-RC1 (#432) 2026-10-04 11:01:56 +02:00
.dockerignore feat: 3.0.0-RC1 (#432) 2026-10-04 11:01:56 +02:00
.gitattributes fix(windows): fixed line ending and patching issues (#466) 2026-10-13 18:54:53 +02:00
.gitignore fix(config): fixed cookies test 2026-10-05 18:16:13 +02:00
.release-please-manifest.json chore(main): release 3.0.0-RC8 (#467) 2026-10-15 11:17:57 +02:00
build.gradle fix(net): delete files when hash verification failed (#474) 2026-10-15 01:23:14 +02:00
CHANGELOG.md chore(main): release 3.0.0-RC8 (#467) 2026-10-15 11:17:57 +02:00
gradle.properties chore(main): release 3.0.0-RC8 (#467) 2026-10-15 11:17:57 +02:00
gradlew feat: 3.0.0-RC1 (#432) 2026-10-04 11:01:56 +02:00
gradlew.bat feat: 3.0.0-RC1 (#432) 2026-10-04 11:01:56 +02:00
LICENSE chore(license): add back license 2026-10-04 11:06:14 +02:00
logo.svg feat: 3.0.0-RC1 (#432) 2026-10-04 11:01:56 +02:00
lombok.config feat: 3.0.0-RC1 (#432) 2026-10-04 11:01:56 +02:00
mkdocs.yml feat: 3.0.0-RC1 (#432) 2026-10-04 11:01:56 +02:00
README.md chore(docs): fix download count 2026-10-17 10:01:49 +02:00
release-please-config.json chore(ci): setup renovate and release-please (#451) 2026-10-12 16:29:24 +02:00
settings.gradle feat(packwiz): Add packwiz support (#440) 2026-10-06 15:02:15 +02:00

中文 | English

HeadlessMc

A command line launcher for Minecraft Java Edition.

logo

Mc-Runtime-Test | HMC | HMC-Specifics | HMC-Optimizations

Codacy Badge GitHub All Releases GitHub Docker Image Size Github last-commit

Warning

NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.

HeadlessMc will not allow you to play without having bought Minecraft! Accounts will always be validated. Offline accounts can only be used to run the game headlessly in CI/CD pipelines.

HeadlessMc is a feature rich launcher for Minecraft Java Edition that runs in your terminal. It can run the Minecraft client in headless mode, e.g. enabling you to run it on CI/CD runners. What's more, it handles various mod loaders, modpacks, mods, resourcepacks, shaderpacks, datapacks... Even servers can be managed using HeadlessMc.

Download the latest release and visit our Getting Started page to get started, it's as easy as:

> headlessmc login
> headlessmc launch fabric 26.3