Installation

Diese Anleitung beschreibt, wie du Steel baust und ausführst.

Voraussetzungen

• Rust Nightly Toolchain – Steel nutzt Features der Rust 2024 Edition
• 64-Bit-Betriebssystem – Linux, macOS oder Windows
• Git – Zum Klonen des Repositories

Rust installieren

Falls du Rust noch nicht installiert hast, nutze rustup:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Steel benötigt die Nightly-Toolchain. Das Repository enthält eine rust-toolchain.toml, die automatisch die richtige Version auswählt.

Aus dem Quellcode bauen

# Das Repository klonen
git clone https://github.com/Steel-Foundation/SteelMC.git
cd SteelMC

# Im Release-Modus bauen (empfohlen)
cargo build --release

# Du findest die fertige Binary unter target/release/steel

Build-Befehle

Befehl	Zweck
cargo build	Debug-Build (schnellere Kompilierung, langsamere Laufzeit)
cargo build --release	Release-Build (langsameres Kompilieren, optimiert)
cargo check	Schnelle Syntax- und Typprüfung
cargo test	Führt die Testsuite aus
cargo clippy	Startet den Linter

Build-Features

Steel unterstützt optionale Build-Features, die mit --features aktiviert werden können:

# EDeadlock-Erkennung aktivieren (nur Debug)
cargo build --features deadlock_detection

# Heap-Profiling mit dhat aktivieren
cargo build --features dhat-heap

# Den Standard-mimalloc-Allocator deaktivieren
cargo build --no-default-features

Verfügbare Features:

Feature	Beschreibung
mimalloc	Verwendet den mimalloc-Allocator (standardmäßig aktiviert)
deadlock_detection	Aktiviert parking_lot Deadlock-Erkennung zum Debuggen von Lock-Problemen
dhat-heap	Aktiviert Heap-Profiling mit dhat

Deadlock Detection ist besonders während der Entwicklung hilfreich, wenn es zu Hängern kommt oder Lock-Probleme vermutet werden. Wenn aktiviert, erkennt parking_lot mögliche Deadlocks und bricht mit Diagnoseinformationen ab.

Server starten

# Direkt mit cargo ausführen (Debug-Modus)
cargo run

# Mit Release-Optimierungen ausführen
cargo run --release

# Oder die gebaute Binärdatei direkt starten
./target/release/steel

Der Server wird:

1. Eine Datei config/steel_config.json5 erstellen, falls sie nicht existiert
2. Standardmäßig an 0.0.0.0:25565 binden
3. Minecraft-1.21.11-Clients akzeptieren

Vorgebaute Binärdateien

Vorgebaute Binaries sind auf der Seite GitHub Releases verfügbar für:

• Linux (x86_64)
• Windows (x86_64)
• macOS (x86_64 und ARM)

Nächste Schritte

Nachdem Steel läuft, gehe weiter zu Configuration, um deinen Server anzupassen.