G'Lib is a shared Fabric library for Minecraft 1.21.1. It provides player skin editing and synchronization, reusable HUD components, editor UI helpers, common utilities, and G'Network friends and chat.
- Minecraft 1.21.1
- Fabric Loader 0.19.3 or newer
- Fabric API
- Java 21
GameProfile profile = player.getGameProfile();
UUID playerId = player.getUuid();
SkinService.createMutableSkin(profile, "edited_skin").thenAccept(texture -> {
SkinOverrideRegistry.set(playerId, texture, player.getSkinTextures());
texture.setRegionPixelArgb(SkinRegions.FACE, 0, 0, 0xFFFF0000);
});Mutable skin textures upload changed pixels on the next client tick. G'Lib also includes region fills, blending, brushes, undo and redo history, animations, face extraction, render hooks, and server-to-client skin synchronization.
Other APIs cover synchronized timers, animated HUD lists, configuration screens, editor layouts, keybind menus, fake players, broadcasts, and lightweight event handling.
G'Lib can capture a Minecraft build as one checksummed .gsave file and run it as a multiplayer, packet-only room. Room blocks are never placed in the host world: G'Lib uses per-player visual block updates, server-authoritative virtual collision, shared room sessions, normalized local coordinates, safe interaction hooks, a live in-game library, atomic hot reload, and optional two-way Railway repository synchronization.
See VIRTUAL_ROOMS.md for the authoring commands, Java helpers, format, Railway repository, and current simulation boundaries.
Press K and open Friends & Chat to send requests to other G'Lib players, see presence, and chat across Minecraft servers. Players authenticate with their current Minecraft session; the G'Network backend never receives their Microsoft/Minecraft access token.
The deployable backend is in backend. See backend/README.md for Railway and local setup. Before publishing the mod, replace the placeholder URL in src/main/resources/glib-network.properties with the Railway HTTPS domain. This URL is public configuration, not a secret.
Security reports and secret-handling guidance are in SECURITY.md.
Clone the repository and run:
./gradlew buildOn Windows, use gradlew.bat build. Built jars are written to build/libs.
G'Lib is licensed under the GNU General Public License v3.0.