CraftConnect

Logowanie i automatyczna próba ukrycia

Obsługa AuthMe Reloaded, nLogin i AuthGatewayX korzysta z pluginu serwerowego CraftConnectBridge. Stan logowania pochodzi z publicznego API pluginu; treść, język i format komunikatów nie mają znaczenia. Wymagane jest zainstalowanie bridge'a na serwerze. Instalacja, API i ograniczenia.

Dopiero po potwierdzeniu uwierzytelnienia i pozycji w świecie aplikacja wysyła /gamemode spectator. Po 3 sekundach bez potwierdzenia spectator wysyła jednorazowo /vanish. Brak bridge'a, brak obsługiwanego API lub błędne hasło nie uruchamiają komend. Obie komendy nadal wymagają uprawnień gracza; nie gwarantują ochrony ekwipunku.

Headless Minecraft protocol client for Android.

CraftConnect connects to Minecraft servers without rendering the game world. The application is intended for chat, commands, player/session information, notifications and connection-oriented tooling rather than gameplay.

Current state

The repository contains the initial Android application skeleton and a functional Jetpack Compose UI prototype.

Implemented now:

• Kotlin + Jetpack Compose Android project,
• dark crimson / neon design system,
• branded launcher, adaptive and in-app logo assets,
• saved server browser,
• direct offline-mode connection using Minecraft Java 26.1 protocol 775,
• chat and command surface,
• online player list,
• settings screen,
• reusable UI components,
• observable session lifecycle and typed diagnostic errors,
• protocol abstraction ready for a real implementation,
• Gradle Wrapper,
• GitHub Actions Android CI,
• repository guidance in AGENTS.md.

The default networking adapter supports direct TCP login to an offline-mode server using Minecraft Java 26.1 protocol 775, including the login, configuration and play states, compression negotiation, keep-alive replies and position acknowledgement. The older protocol 47 adapter remains isolated for later explicit version selection.

The client sends only the selected nickname. In offline mode the server or proxy owns identity assignment and returns the UUID during login; CraftConnect does not allow an arbitrary UUID to be injected. Permission data tied to an offline UUID is only as secure as the server's nickname protection, so this mode must not be exposed as authentication.

Toolchain

• Android Gradle Plugin 9.4.0
• Gradle 9.6.1
• Kotlin 2.2.10
• Compose BOM 2025.06.01
• compileSdk / targetSdk 36
• minSdk 26
• JDK 21 for CI/Gradle daemon

Architecture

See docs/ARCHITECTURE.md.

The main architectural constraint is that Compose code must never depend directly on Minecraft packet implementation classes.

Build

./gradlew :app:assembleDebug

Validation:

./gradlew :app:assembleDebug
./gradlew :app:lintDebug

Per-server Minecraft version

Server creation and editing offer Java 26.1 (775), 26.2 (776), and 26.3 (777). New servers default to 26.3; existing lists retain 26.1 until edited. The selection controls the handshake, login session ID, configuration and play packet IDs, game-mode decoding, and teleport confirmation layout. It is not automatic version detection. Offline authentication limitations still apply. Connection failures display a diagnostic code containing the stage and protocol.

Packet references: ViaVersion Protocol26_1To26_2, Protocol26_2To26_3, ClientboundConfigurationPackets26_3, ClientboundPackets26_3, and EntityPacketRewriter26_3 in https://github.com/ViaVersion/ViaVersion.

Configuration interoperability

The client announces its CraftConnect brand and replies to login/configuration/play cookie requests. Cookies remain in memory for one connection, with bounded size/count. Resource-pack tasks are acknowledged as accepted, downloaded and loaded in headless mode; no files are fetched, textures/audio are applied, or URLs recorded. This is protocol-level completion for a client without rendering. Known-pack selection is empty because the client has no bundled registries.

Failures include the last 12 inbound/outbound packet IDs, prefixed i/o, together with the stage and protocol. The trace contains no packet payloads or credentials. These changes address missing configuration replies; live connectivity to MoonVale has not been verified from the development environment.

Microsoft / premium accounts

Account manager supports Microsoft sign-in in the system browser, verified Java Edition profiles, secure session storage and refresh, and premium account selection for authenticated server connections. Publisher setup in Entra and Mojang AppID approval are required before live use. See Microsoft accounts: setup, security and current limits.