No description
  • Arc 59.2%
  • PLSQL 18.1%
  • C++ 15.5%
  • C 7%
  • CMake 0.2%
Find a file
LeNooby09 1016ecc815
Some checks failed
CI / build (push) Failing after 44s
Minecraft Legacy Console Edition hard fork, linux native
Signed-off-by: LeNooby09 <contact@lenooby09.tech>
2026-03-27 07:15:52 +01:00
.forgejo/workflows Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00
cmake Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00
include Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00
Minecraft.Client Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00
Minecraft.Server Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00
Minecraft.World Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00
.clang-format Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00
.clang-tidy Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00
.gitignore Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00
CMakeLists.txt Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00
CMakePresets.json Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00
COMPILE.md Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00
CONTRIBUTING.md Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00
README.md Minecraft Legacy Console Edition hard fork, linux native 2026-03-27 07:15:52 +01:00

MinecraftLegacy (Linux Port)

Hard fork of MinecraftConsoles ported to Linux x86_64 with Vulkan rendering.

This project is based on Minecraft Legacy Console Edition v1.6.0560.0 (TU19). All console and Windows-specific platform code has been removed; the sole target is Linux 64-bit with a Vulkan graphics backend.

Platform Support

  • Linux x86_64: The only supported platform
  • Rendering: Vulkan (replaces OpenGL 3.3 / Direct3D 11)
  • Windowing: X11 (Xlib)
  • Networking: POSIX sockets (replaces Winsock)
  • Audio: miniaudio (cross-platform, header-only)

Features

  • Linux-native build (GCC / Clang, CMake + Ninja)
  • Vulkan rendering backend (replaces OpenGL 3.3 and Direct3D)
  • X11 windowing with keyboard & mouse input
  • POSIX socket networking layer
  • Dedicated Server Software (Minecraft.Server)
  • Keyboard and mouse input support
  • Fullscreen mode support (toggle using F11)
  • Device screen resolution auto-detection
  • LAN Multiplayer & Discovery
  • Persistent username system via username.txt

Controls (Keyboard & Mouse)

  • Movement: W A S D
  • Jump / Fly (Up): Space
  • Sneak / Fly (Down): Shift (Hold)
  • Sprint: Ctrl (Hold) or Double-tap W
  • Inventory: E
  • Chat: T
  • Drop Item: Q
  • Crafting: C Use Q and E to move through tabs
  • Toggle View (FPS/TPS): F5
  • Fullscreen: F11
  • Pause Menu: Esc
  • Attack / Destroy: Left Click
  • Use / Place: Right Click
  • Select Item: Mouse Wheel or keys 1 to 9
  • Game Info (Player list and Host Options): TAB
  • Toggle HUD: F1
  • Toggle Debug Info: F3

Build Requirements

  • Linux x86_64
  • CMake 3.24+
  • Ninja (recommended) or Make
  • GCC 11+ or Clang 14+
  • Vulkan SDK (headers + loader)
  • X11 development libraries (libx11-dev)

Build & Run

# Configure
cmake --preset linux64

# Build (Debug)
cmake --build --preset linux64-debug --target Minecraft.Client

# Build (Release)
cmake --build --preset linux64-release --target Minecraft.Client

Dedicated Server

cmake --build --preset linux64-release --target Minecraft.Server

Client Launch Arguments

Argument Description
-name <username> Overrides your in-game username
-fullscreen Launches the game in Fullscreen mode

Example:

./Minecraft.Client -name Steve -fullscreen

Dedicated Server

See server.properties for configuration. The server supports the same properties as the upstream project.

Launch Arguments

Argument Description
-port <1-65535> Override server-port
-ip <addr> Override server-ip
-bind <addr> Alias of -ip
-name <name> Override server-name (max 16 chars)
-maxplayers <1-8> Override max-players
-seed <int64> Override level-seed
-loglevel <level> Override log-level (debug/info/warn/error)

Changes from MinecraftConsoles

  • Removed platforms: Xbox 360, Xbox One (Durango), PS3, PS Vita, Orbis (PS4), Windows (Win32/Win64)
  • Added platform: Linux x86_64
  • Rendering: Replaced OpenGL 3.3 / Direct3D 11 with Vulkan
  • Windowing: Replaced Win32 window management with X11 (Xlib)
  • Networking: Replaced Winsock with POSIX sockets
  • Build system: CMake presets target Linux64 only; removed all MSVC/.lib references