Zum Hauptinhalt springen

FakeBlock

Paketbasierte Fake-Blöcke und clientseitige Schematics.

Privatv0.1.0Welt & Bauen
BenötigtTypeWriter0.9.0-beta-177 (BTC build)PacketEventsBTC SkyoptionalDungeonoptional

Für das BornToCraft-Netzwerk entwickelt. Diese Erweiterung ist zu Referenzzwecken dokumentiert und wird nicht verteilt.

Überblick​

FakeBlock zeigt Sponge-Schematics (.schem) nur ausgewählten Spielern. Die Blöcke werden per Paket gesendet: Die echte Welt wird nie verändert, sodass zwei Spieler am selben Ort zwei verschiedene Bauwerke sehen können. Ein Schematic kann einer TypeWriter-Audience folgen (einem Quest-Schritt, einem Item in der Hand, einer Region), als Cinematic abgespielt oder von einem Spieler mit einem „Storage-Block“-Item platziert werden.

Blöcke können clientseitig abbaubar gemacht werden. Abbauvorgänge werden vom Server geprüft, können Loot droppen, lassen sich mit einer Item-Whitelist oder -Blacklist einschränken und werden pro Spieler in einem Artifact gespeichert, sodass das Bauwerk nach einer Wiederverbindung zerstört bleibt.

Funktionen​

  • Bauwerke pro Spieler — zeige ein Schematic einer Audience, einem Cinematic-Betrachter oder dem Spieler, der es platziert hat.
  • Drei Anker — eine feste Weltposition, derselbe Versatz auf jeder BTC Sky-Insel einer Dimension oder eine Position innerhalb einer Dungeon-Instanz.
  • Progressives Platzieren — Blöcke erscheinen in der Reihenfolge LINEAR, HELICAL oder RANDOM, in konfigurierbarer Rate oder sofort.
  • Sicht- und Ausblendedistanz — blende ein Bauwerk ab einer Entfernung aus und lasse es schrittweise verblassen.
  • Clientseitiges Abbauen — servervalidierter Abbau mit optionalem Loot, Whitelist und Blacklist.
  • Persistenter Zustand — abgebaute Blöcke und platzierte Instanzen werden in einem Artifact gespeichert, pro Spieler oder pro Gruppe.
  • Storage-Block — gib Spielern ein Item, das sich beim Platzieren zu einem Schematic entfaltet, einmalig verwendbar oder wieder aufhebbar.

Installation​

  1. Installiere PacketEvents auf dem Server.
  2. Lege die FakeBlock-JAR in plugins/Typewriter/extensions/ ab und starte den Server neu.
  3. Kopiere deine .schem-Dateien nach plugins/Typewriter/schematics/. Führe nach dem Hinzufügen neuer Dateien /fakeblock reload aus.

Erste Schritte​

Zeige Spielern, die einen Quest-Schritt erreicht haben, eine zerstörte Brücke:

  1. Öffne im TypeWriter-Web-Panel eine Manifest-Page und füge einen Schematic Audience-Entry hinzu.
  2. Setze schematic auf den Dateinamen, zum Beispiel bridge_ruined.schem, und centerLocation auf den Einfüge-Ursprung.
  3. Umgib ihn mit einem Audience-Filter, der zum Quest-Schritt passt (zum Beispiel eine Fact- oder Quest-Audience), damit nur diese Spieler ihn sehen.
  4. Damit Spieler den Schutt beseitigen können, aktiviere breakable, setze bei Bedarf dropLoot und verknüpfe in stateArtifact ein Schematic State-Artifact, damit abgebaute Blöcke gemerkt werden.
  5. Veröffentliche die Page und geh mit einem Spieler, der zur Audience passt, zum Ort.
Von Spielern platziert

Damit Spieler ein Bauwerk selbst platzieren können, verwende die Aktion Schematic Block: Sie gibt das spawnItem, und das Platzieren dieses Items entfaltet das Schematic. singleUse und ownerOnlyRetrieval bestimmen, ob es wieder aufgehoben werden kann.

Funktionsweise​

Befehle​

Alle Befehle erfordern typewriter.fakeblock.admin. Aliase: /fb, /schematicblock.

BefehlBeschreibung
/fakeblock listListet jede platzierte Schematic-Instanz auf.
/fakeblock info <instance-id>Zeigt die Details einer Instanz.
/fakeblock undo <instance-id>Entfernt eine platzierte Instanz.
/fakeblock count [player]Zählt die an einen Spieler gesendeten Fake-Blöcke.
/fakeblock reset <player> [entry-id]Stellt die echten Blöcke für einen Spieler wieder her, für alle Entries oder einen Entry.
/fakeblock reloadLädt Schematics von der Festplatte neu.
/fakeblock debugGibt Debug-Informationen aus.

Berechtigungen​

BerechtigungGewährt
typewriter.fakeblock.adminJeden /fakeblock-Befehl.

Entries​

5 Einträge, aus dem Quellcode der Erweiterung generiert.

Aktionen1
Zielgruppen2
Cinematics1
Artefakte1

Fehlerbehebung​

Nichts erscheint. Prüfe den Dateinamen in schematic (mit der Endung .schem) und dass die Datei in plugins/Typewriter/schematics/ liegt. Führe /fakeblock reload aus und stelle dann sicher, dass sich der Spieler innerhalb von viewDistance befindet und zur Audience passt.

Das Bauwerk erscheint an der falschen Stelle. Mit positionMode: ISLAND_DIMENSION ist dimensionOffset relativ zur Insel der Dimension in dimensionTemplateId; mit INSTANCE_DIMENSION wird das Bauwerk nur innerhalb einer aktiven Dungeon-Instanz angezeigt (der in instanceId genannten oder einer beliebigen Instanz, wenn das Feld leer ist), und instanceOffset gibt seine Koordinaten in der Instanzwelt an. Nur CLASSIC verwendet centerLocation.

Abgebaute Blöcke kommen nach einem Neustart zurück. Verknüpfe ein Schematic-State-Artifact in stateArtifact (Audience) oder position (Aktion). Ohne es existieren Abbauvorgänge nur im Speicher.

Spieler können nichts abbauen. breakable muss aktiviert sein. Eine nicht leere whitelist erlaubt nur die aufgeführten Items; die blacklist gewinnt immer.

Verwandte Erweiterungen​

  • BTC Sky — inselrelative Platzierung mit ISLAND_DIMENSION.
  • Dungeon — Dungeon-Instanzen, die von INSTANCE_DIMENSION verwendet werden.