tuff

A Minecraft Java Edition server written in Rust, for game version 26.3. The vanilla game runs as a set of plugins on an inert core, and external plugins are sandboxed WebAssembly modules.

The documentation lives at tuff.bforward.me. Start with the introduction, or read the same pages in docs/.

Quick start

tuff publishes no prebuilt binaries. Clone the repository and run the install script, which builds the server and installs it at ./tuff-server/tuff:

git clone https://github.com/brenfwd/tuff.git tuff && cd tuff && scripts/install.sh

The script needs git, curl and a C compiler, and installs rustup and bun for your user if they are missing. The build downloads the official server jar from Mojang, so the script asks you to accept the Minecraft EULA first (pass --accept-eula for unattended installs).

Run ./tuff from tuff-server/, add players with whitelist add <name> on the console or set white-list=false in server.properties, then join localhost:25565 with a 26.3 client. For offline-mode accounts, start it with --offline and set server-ip=127.0.0.1.

Current alpha: the release notes in Introduction list what changed in v0.1.0-alpha.2 (2026-10-28), since v0.1.0-alpha.1. It supports worlds from 1.13 or newer, Windows is best effort (use WSL or Docker), anti-cheat only logs by default, and the admin panel needs a reverse proxy for remote access.

To build and run from the checkout instead:

cargo build --release
cargo run --release -- --offline -Dtuff.allowPublicOffline=true

See Installing and Running for requirements, flags and platform notes, and CONTRIBUTING.md for development guidelines.

License

The server is licensed under the GNU Affero General Public License v3.0 only. The plugin SDK, SDK generator, plugin ABI WIT files and example plugins are licensed under the MIT License, so plugins you write may use any license. See License for details. Contributions require agreeing to the Contributor License Agreement.