headlesshq/MC-Runtime-Test

Runs the MC client inside your CI

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Jul 6, 2026
License
MIT

Pinned Snippet

workflow.ymlSHA-pinned
uses: headlesshq/mc-runtime-test@9d9ea4af8ef6d82648051f750c49905f75d0c3bb # 4.4.0

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
mcMinecraft version to runyes
modloaderModloader to install (forge, neoforge, fabric)yes
regexRegex to match the modloader jar (i.e. .*fabric.*)yes
javaJava version to use (8, 16, 17, 21, 25)yes
dummy-assetsUse dummy assets during testingtrue
mc-runtime-testMC-Runtime-Test jar to download (none, lexforge, neoforge, fabric)yes
xvfbRuns the game with Xvfb (if false, add the -lwjgl argument)true
headlessmc-commandCommand-line arguments for HeadlessMC--jvm "-Djava.awt.headless=true"
fabric-apiFabric API version to download (e.g. 0.97.0) or nonenone
fabric-gametest-apiFabric GameTest API version (e.g. 1.3.5+85d85a934f) or nonenone
download-hmcDownload HeadlessMCtrue
hmc-versionHeadlessMC version2.10.0
cache-mcCache .minecraft (blacksmith, github, true (defaults to blacksmith), false)github

no outputs