Nexo

Nexo-Blöcke, -Möbel und -Items in TypeWriter-Ereignissen, -Zielen, -Fakten und -Variablen.

Kostenpflichtigv0.8Integrationen

BenötigtTypeWriter0.9NexoQuest (TypeWriter extension)Basic (TypeWriter extension)

Auf Voxel kaufenAuf BuiltByBit kaufenSupport

Überblick

Nexo fügt deinem Server Custom-Items, -Blöcke und -Möbel hinzu. Diese Erweiterung bringt sie in TypeWriter: Eine Quest kann Spieler auffordern, ein Custom-Erz abzubauen oder deine Möbel zu platzieren, eine Sequence kann starten, wenn ein Spieler einen Block schlägt, und Criteria können prüfen, was ein Spieler hält oder ansieht.

Alles wird über die Nexo-Item-ID angesprochen, zum Beispiel ruby_ore oder oak_chair. Du definierst die Inhalte weiterhin in Nexo; diese Erweiterung liest sie nur und reagiert darauf.

Funktionen

• Block-Events — Abbauen, Platzieren, Bedienen, Beschädigen (ein Spieler beginnt zu graben) und Loot-Drop bei Custom-Blöcken.
• Möbel-Events — Abbauen, Platzieren, Bedienen und Beschädigen bei Möbeln, mit optionalem BetterModel-ID-Filter.
• Zählende Objectives — Custom-Blöcke und -Möbel abbauen oder platzieren als Quest-Objective.
• Item-Inventarwerkzeuge — Nexo-Items geben oder entfernen und auf deren Aufheben, Fallenlassen oder Verbrauchen reagieren.
• Item-Facts — gehaltenes Item, Item-Anzahl und ob das gehaltene Item eine bestimmte Mechanik nutzt.
• Welt-Facts — angesehener oder betretener Block, angesehenes Möbel, Lichtzustand von Möbeln und die Zeit, die zum Abbauen eines Blocks nötig ist.
• Variablen — IDs und Eigenschaften gehaltener Items sowie von Blöcken und Möbeln im Blickfeld, dazu Registry- und Tag-Listen.
• Sound-Entry — verwende eine Nexo-Sound-ID überall dort, wo TypeWriter einen Sound verlangt.

Installation

1. Installiere Nexo auf deinem Server. Diese Erweiterung lädt ohne es nicht.
2. Stelle sicher, dass die TypeWriter-Erweiterungen Quest und Basic installiert sind.
3. Lade die Erweiterung aus den Stores herunter (siehe die Buttons im Panel oben) und lege die JAR in plugins/Typewriter/extensions/ ab.
4. Starte den Server neu.

Erste Schritte

Diese Anleitung startet eine Sequence, wenn ein Spieler einen Custom-Block mit Rechtsklick anklickt, und zählt Möbel für eine Quest.

1. Füge auf einer Sequence-Seite ein Nexo Block Interact-Event hinzu.
2. Setze blockId auf die Nexo-Block-ID, action auf RIGHT_CLICK und verknüpfe triggers mit den auszuführenden Entries, zum Beispiel einem Dialog.
3. Für eine Zählaufgabe erstellst du eine Quest und einen Fortschritts-Fact und fügst dann ein Place Furniture-Objective hinzu.
4. Setze quest, fact, item auf die Möbel-ID und amount auf 5. Fülle display mit der Tracker-Zeile und verknüpfe onComplete mit einer Belohnungs-Sequence, wenn du eine möchtest.
5. Publish und teste mit einem Spieler, der die Quest aktiv hat.

IDs finden

Die Variable Registry IDs listet jede Item-, Block- oder Möbel-ID auf, die Nexo geladen hat. Die Variable Tag Items listet die Items eines Nexo-Tags auf.

So funktioniert es

Events geben an die ausgelösten Entries weiter, was passiert ist: die Block- oder Möbel-ID, ihre Position und, bei Möbeln, die BetterModel-ID. Das Loot-Drop-Event gibt außerdem weiter, wie viele Stacks und Items gedroppt wurden.

Objectives zählen jede Position pro Spieler einmal, sodass das erneute Platzieren und Abbauen derselben Stelle nicht aufaddiert wird. Sie zählen nur, solange der Spieler die verknüpfte Quest aktiv hat. Abgebrochene Aktionen werden ignoriert.

Der Filter betterModelId bei Möbel-Events und -Objectives gleicht den Schlüssel bettermodel_id des Möbelstücks in deiner Nexo-Konfiguration ab. Lass ihn leer, um ihn zu ignorieren.

Konfiguration

Die Objective-Zeilen im Quest-Tracker werden aus zwei TypeWriter-Snippets aufgebaut:

Snippet	Standard
advancedQuest.display	<display> <dark_gray>(<gray><current><dark_gray>/<gray><required><dark_gray>)
advancedQuest.completed	<green>✔</green> <st><display></st> <dark_gray>(<gray><current><dark_gray>/<gray><required><dark_gray>)

Entries

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

Aktionen2

• Nexo Give Item ActionGive a Nexo item to the player
• Nexo Remove Item ActionRemove a Nexo item from the player

Ereignisse12

• Nexo on Customblock Break EventTriggers when a Nexo custom block is broken
• Nexo on Customblock Damage EventTriggers when a player starts breaking a Nexo custom block
• Nexo on Customblock Drop Loot EventTriggers when a Nexo custom block drops loot
• Nexo on Customblock Interact EventTriggers when a Nexo custom block is interacted with
• Nexo on Customblock Place EventTriggers when a Nexo custom block is placed
• Nexo on Furniture Break EventTriggers when a Nexo furniture is broken
• Nexo on Furniture Damage EventTriggers when a player hits a Nexo furniture
• Nexo on Furniture Interact EventTriggers when a Nexo furniture is interacted with
• Nexo on Furniture Place EventTriggers when a Nexo furniture is placed
• Nexo on Item Consume EventTriggers when the player consumes a Nexo item
• Nexo on Item Drop EventTriggers when the player drops a Nexo item
• Nexo on Item Pickup EventTriggers when the player picks up a Nexo item

Ziele4

• Nexo Break Customblock ObjectiveAn objective to break Nexo custom blocks
• Nexo Break Furniture ObjectiveAn objective to break Nexo furniture
• Nexo Place Customblock ObjectiveAn objective to place Nexo custom blocks
• Nexo Place Furniture ObjectiveAn objective to place Nexo furniture

Fakten8

• Nexo Break Time FactTicks this player needs to break the Nexo block they are looking at
• Nexo Furniture Light State FactWhether the Nexo furniture the player looks at is lit
• Nexo Holding Item FactWhether the player is holding a Nexo item
• Nexo Item Count FactHow many of a Nexo item the player carries
• Nexo Item Has Mechanic FactWhether the held Nexo item uses a given mechanic
• Nexo Looking at Block FactWhether the player is looking at a Nexo custom block
• Nexo Looking at Furniture FactWhether the player is looking at Nexo furniture
• Nexo Standing on Block FactWhether the player is standing on a Nexo custom block

Variablen8

• Nexo Furniture Property VariableA property of the Nexo furniture the player is looking at
• Nexo Item in Hand ID VariableThe Nexo ID of the item the player holds
• Nexo Item Property VariableA property of the Nexo item the player holds
• Nexo Looking at Block ID VariableThe Nexo ID of the block the player is looking at
• Nexo Looking at Furniture ID VariableThe Nexo ID of the furniture the player is looking at
• Nexo Registry Ids VariableThe list of IDs Nexo has loaded
• Nexo Standing on Block ID VariableThe Nexo ID of the block the player stands on
• Nexo Tag Items VariableThe Nexo items carrying a given tag

Sounds1

• Nexo SoundNexo Sound

Fehlerbehebung

Die Erweiterung erscheint nicht im Panel. Nexo ist nicht installiert oder wurde nicht aktiviert. Jeder Entry ruft die Nexo-API auf, daher lädt die Erweiterung ohne das Plugin nicht.

Ein Event wird nie ausgelöst. Verwende die Nexo-Item-ID exakt (ruby_ore). Eine leere ID passt auf alles. Hast du location ausgefüllt, passt nur diese Blockposition. Events, die von einem anderen Plugin abgebrochen wurden, werden ignoriert. Bei Möbeln blockiert eine betterModelId, die nicht zum bettermodel_id des Möbelstücks passt, das Event.

Das Objective bewegt sich nicht. Der Spieler muss die verknüpfte Quest aktiv haben, und fact muss gesetzt sein. Jede Blockposition zählt pro Spieler nur einmal.

Registry- oder Tag-Variablen sind leer. Nexo lädt seine Items im Hintergrund. Diese Variablen liefern nichts, bis Nexo das Laden beendet hat; lies sie also nicht während des Serverstarts.

Ein Fact liefert immer 0. Das Item oder der Block ist kein Nexo-Objekt. Block-Facts prüfen den ersten Block innerhalb von range Blöcken (standardmäßig 5). Der Fact für die Abbauzeit liefert 0, wenn der Zielblock von Nexo nicht abbaubar ist. Der Mechanik-Fact benötigt die exakte Nexo-Mechanik-ID.

Give Item gibt nichts. Die itemId ist Nexo unbekannt, daher wird kein Item gebaut. Überschüsse, die nicht hineinpassen, werden dem Spieler vor die Füße fallen gelassen, außer dropOverflow ist aus.

Verwandte Erweiterungen

• ItemsAdder und Craft Engine — dieselbe Integration für die anderen Plugins für Custom-Inhalte.