mirror of
https://github.com/yushijinhun/authlib-injector.git
synced 2024-11-15 06:11:09 +01:00
No description
9b2075775e
- add option: -Dauthlibinjector.mojangNamespace={default|enabled|disabled} - add option: -Dauthlibinjector.legacySkinPolyfill={default|enabled|disabled} - add metadata field: feature.no_mojang_namespace - update options doc |
||
---|---|---|
.github/workflows | ||
src | ||
.gitignore | ||
build.gradle | ||
CONTRIBUTING.md | ||
LICENSE | ||
license-header.txt | ||
README.en.md | ||
README.md | ||
settings.gradle |
- English
- 简体中文(Chinese Simplified)
authlib-injector
authlib-injector enables you to build a Minecraft authentication system offering all the features that genuine Minecraft has.
See the wiki for documents and detailed descriptions.
Download
You can download the latest authlib-injector build from here.
Build
Dependencies: Gradle, JDK 8+
Run:
gradle
Build output can be found in build/libs
.
Deploy
Configure Minecraft server with the following JVM parameter:
-javaagent:{/path/to/authlib-injector.jar}={Authentication Server URL}
Options
-Dauthlibinjector.mojangNamespace={default|enabled|disabled}
Whether to enable Mojang namespace (@mojang suffix).
It's enabled by default if the authentication server does NOT send feature.no_mojang_namespace option.
If enabled, virtual player <username>@mojang will have the same skin as premium (Mojang) player <username>.
For example,
- /give @p minecraft:skull 1 3 {SkullOwner:"Notch@mojang"}
- /npc skin Notch@mojang
will display Notch's skin.
Note that the virtual player does NOT have the same UUID as its corresponding premium player.
To distinguish virtual players from actual ones, the most significant bit of time_hi_and_version is set to 1 (see RFC 4122 section 4.1.3).
For example:
069a79f4-44e9-4726-a5be-fca90e38aaf5 Notch
069a79f4-44e9-c726-a5be-fca90e38aaf5 Notch@mojang
We use this approach because, in RFC 4122, UUID version has only 6 possible values (0~5), which means the most significant is always 0.
In fact, Mojang uses version-4 (random) UUID, so its corresponding virtual player has a version-12 UUID.
-Dauthlibinjector.mojangProxy={proxy server URL}
Use proxy when accessing Mojang authentication service.
Only SOCKS protocol is supported.
URL format: socks://<host>:<port>
-Dauthlibinjector.legacySkinPolyfill={default|enabled|disabled}
Whether to polyfill legacy skin API, namely 'GET /skins/MinecraftSkins/{username}.png'.
It's enabled by default if the authentication server does NOT send feature.legacy_skin_api option.
-Dauthlibinjector.debug (equals -Dauthlibinjector.debug=verbose,authlib)
or -Dauthlibinjector.debug={comma-separated debug options}
Available debug options:
- verbose enable verbose logging
- authlib print logs from Mojang authlib
- dumpClass dump modified classes
- printUntransformed print classes that are analyzed but not transformed, implies 'verbose'
-Dauthlibinjector.ignoredPackages={comma-separated package list}
Ignore specified packages. Classes in these packages will not be analyzed or modified.
-Dauthlibinjector.disableHttpd
Disable local HTTP server.
Features (see below) depending on local HTTP server will be unavailable:
- Mojang namespace
- Legacy skin API polyfill