Falco: Minestom-Bibliothek für Chunks und Licht

Was ist das?

Falco ist eine Sammlung von Java-Bibliotheken für Minestom, kein Plugin für Paper oder einen anderen Server. Es besteht aus drei Modulen, die sich einzeln verwenden lassen: einem Anvil-Chunk-Loader, einer Block- und Himmelslicht-Berechnung und einer Instanzimplementierung, die ihre Chunks beim Abmelden freigibt.

Was die Module tun

• falco-anvil liest und schreibt Anvil-Welten. Lesen, Dekomprimierung und das Parsen der NBT-Daten laufen parallel. Schlägt ein Lesevorgang fehl, wirft der Loader einen Fehler, statt den Chunk als fehlend zu melden. So kann der Server gespeicherte Daten nicht mit einem neu erzeugten Chunk überschreiben. Welten, die älter als der Snapshot 21w43a sind, werden abgelehnt.
• falco-light berechnet Block- und Himmelslicht. Jeder Aufruf ist thread-sicher, und die Engine ist an keine bestimmte Chunk-Implementierung gebunden.
• falco-instance stellt eine Instance und ihren Chunk bereit. Beim Abmelden entlädt sie jeden geladenen Chunk. Minestoms InstanceManager.unregisterInstance entlädt nur die Chunks eines InstanceContainer. Bei anderen Instanzen bleiben Chunks, Tick-Partitionen und Entities zurück. Für dieses Modul wird kein Geschwindigkeitsvorteil behauptet.

Was du vor dem Einsatz wissen solltest

• Die API ist experimentell. Jeder öffentliche Typ trägt @ApiStatus.Experimental. Signaturen und Verhalten können sich in einem Minor-Release ändern.
• Java 25 ist erforderlich. Das Build zielt auf Java 25.
• Minestom ist nicht enthalten. Die Artefakte kompilieren gegen Minestom, bringen es aber nicht mit. Die Version wählst du selbst. Release 3.0.0 ist gegen Minestom 2026.08.28-26.2 gebaut und läuft nicht auf 26.1.2.
• Die Leistungswerte sind Messungen, keine Versprechen. Die README nennt Benchmark-Ergebnisse. In einem Lauf las der Anvil-Loader Chunks auf zwei Threads 1,9-mal schneller als Minestoms eigener Loader. Ein zweiter Lauf hat diesen Faktor nicht bestätigt. Die Lichtberechnung war in sechs Szenarien 1,11- bis 1,71-mal schneller. Alle Werte stammen von vor dem Wechsel auf Minestom 26.2 und wurden dort nicht erneut gemessen.
• Einrichtung. Schnellstart, Maven-Koordinaten und Build-Anleitung stehen in der Dokumentation. Die Artefakte werden im Maven-Repository von OneLiteFeather unter repo.onelitefeather.dev veröffentlicht.