LapisMC Documentation

LapisMC is an open-source, ultra-low-latency Minecraft server software compiled natively in Go. Designed for massive scalability without GC pauses or JVM overhead.

⚡ Requirements

LapisMC runs as a single static binary on Linux, macOS, and Windows. If compiling from source, Go 1.22+ is required.

Why Go for LapisMC?

LapisMC is built from scratch in Go to avoid heavy garbage collection pauses and JVM thread overhead. It leverages Go channels, lock-free ring buffers, and asynchronous network I/O via native epoll/kqueue event loops.

⚡ Zero JVM Overhead

Single compiled binary execution with ultra-fast startup times and minimal memory footprint.

🧵 Goroutine Concurrency

Parallelized tick processing, packet decoding, and chunk generation powered by Go worker pools.

🔌 Go Plugin Module Support

Extend functionality using dynamic Go shared libraries (.so) loaded at runtime.

Quickstart Installation

Option A: Pre-compiled Go Binary

Bash (Linux x86_64)

wget https://dl.lapismc.org/latest/lapismc-linux-amd64 -O lapismc
chmod +x lapismc
./lapismc --init

Option B: Build Native Binary with Go

Bash

git clone https://github.com/lapismc/lapismc.git
cd lapismc

# Build release binary with stripped debug symbols
go build -ldflags="-s -w" -o lapismc ./cmd/lapismc

./lapismc -config config.toml