MMOCore
Überblick
MMOCore verbindet das RPG-Plugin MMOCore mit TypeWriter. Es stellt das MMOCore-Profil eines Spielers (Klasse, Level, Punkte, Werte, Berufe, Fähigkeiten, Fähigkeitenbaum, Waypoints, Party und Gilde) als TypeWriter-Facts und -Variablen bereit, sodass deine Dialoge, Quests und Audiences darauf reagieren können.
Außerdem fügt es Quest-Objectives hinzu, die MMOCore-Events folgen (Berufserfahrung, Berufslevel, Fähigkeitseinsätze), Aktionen, die das Waypoint-System und die Berufserfahrung steuern, sowie zwei Gruppen-Entries, damit eine Party oder eine Gilde den Quest-Fortschritt teilen kann.
Die meisten Entries lesen nur Daten. Die Erweiterung selbst speichert nichts: Jeder Wert kommt live von MMOCore, wenn TypeWriter danach fragt.
Funktionen
- Profil-Facts — lies Level, Erfahrung, Punkte, Leben, Mana, Ausdauer und Stellium mit einem einzigen wählbaren Wert aus.
- Klassen- und Berufs-Facts — prüfe die aktuelle Klasse, das Klassenlevel und das Level oder die Erfahrung eines beliebigen Berufs.
- Fähigkeits-Facts — lies das Level einer Klassenfähigkeit aus, ob sie freigeschaltet ist und ob ein Fähigkeits-Slot belegt ist.
- Fähigkeitenbaum-Facts — lies das Level eines Knotens im Fähigkeitenbaum aus oder prüfe, ob er freigeschaltet oder auf Maximum ist.
- Waypoints — schalte einen MMOCore-Waypoint frei oder sperre ihn, teleportiere einen Spieler dorthin und prüfe, ob einer freigeschaltet ist.
- Quest-Objectives — Objectives für Berufserfahrung, Berufslevel und Fähigkeitseinsätze für TypeWriter-Quests.
- Party und Gilde — Mitgliederzahlen als Facts, Gildenname, -tag, -ID, -besitzer und -mitglieder als Variablen.
- Gruppen — teile TypeWriter-Facts innerhalb einer MMOCore-Party oder -Gilde.
- Listen-Variablen — freigeschaltete Fähigkeiten, freigeschaltete Knoten, Waypoints, belegte Fähigkeiten, Freunde und die aktive Zauberkette.
Installation
- Installiere MMOCore und seine Bibliothek MythicLib auf dem Server.
- Stelle sicher, dass die offizielle TypeWriter-Erweiterung Quest installiert ist. Die drei Objectives setzen sie voraus.
- Beziehe die Erweiterung in den Stores (siehe die Buttons im Übersichtspanel oben) und lege die JAR in
plugins/Typewriter/extensions/ab. - Starte den Server neu. Beim Start gibt die Konsole
[MMOCoreExtension] MMOCoreExtension enhancements initialized successfully.aus.
Erste Schritte
Erstelle einen Quest-Schritt, der abgeschlossen wird, wenn der Spieler im Beruf Bergbau Level 10 erreicht, und danach einen Waypoint freischaltet:
- Öffne im TypeWriter-Web-Panel eine Sequence-Page und füge eine Unlock Waypoint-Aktion hinzu. Setze
waypointIdauf die MMOCore-Waypoint-ID, zum Beispielspawn_town. - Öffne (oder erstelle) eine statische Page mit deiner Quest und füge ein Profession Level Objective hinzu.
- Fülle
questmit deinem Quest-Entry,displaymit dem im Quest-Tracker angezeigten Text,professionmit der Berufs-ID (zum Beispielmining) undlevelmit10. - Setze
onCompleteauf die Unlock-Waypoint-Aktion aus Schritt 1. - Veröffentliche. Wenn ein Spieler mit aktiver Quest das Level erreicht, wird der Waypoint freigeschaltet.
Um die Klasse des Spielers in einer Dialogbedingung zu verwenden, füge einen Class Fact hinzu, bei dem classId auf die MMOCore-Klassen-ID gesetzt ist. Er liefert 1, wenn der Spieler diese Klasse hat, sonst 0, sodass du ihn in einem Criterion mit value auf 1 verwenden kannst.
Lass profession bei Profession Level Objective oder bei Add Profession Experience leer, um stattdessen Level und Erfahrung der Hauptklasse anzusprechen statt eines Berufs.
Funktionsweise
Facts und Variablen werden bei Bedarf gelesen. Objectives lauschen auf MMOCore-Events (Erfahrungsgewinn, Levelaufstieg, Fähigkeitseinsatz) und zählen nur für Spieler, die zu den criteria des Objectives passen und die Quest aktiv haben. Die Objectives für Erfahrung und Fähigkeitseinsätze speichern ihren Fortschritt im von dir verknüpften fact, der ein persistenter (cachefähiger) Fact wie ein permanenter oder Session-Fact sein muss.
Platzhalter
Das Feld waypointId der Waypoint-Aktionen akzeptiert PlaceholderAPI-Platzhalter. Sie werden für den Spieler aufgelöst, bevor der Waypoint nachgeschlagen wird.
| Feld | Akzeptiert |
|---|---|
waypointId von Unlock Waypoint, Lock Waypoint und Warp Waypoint | Eine Waypoint-ID oder einen Platzhalter, der eine zurückgibt. |
Entries
38 Einträge, aus dem Quellcode der Erweiterung generiert.
Aktionen5
- Add Profession ExperienceAdd experience to a MMOCore profession
- Mmocore Leave Skill CastingForce the player to exit MMOCore's casting mode
- Mmocore Lock WaypointRemove access to a MMOCore waypoint
- Mmocore Unlock WaypointUnlock a MMOCore waypoint for the player
- Mmocore Warp WaypointWarp the player to a MMOCore waypoint using stellium
Ziele3
- Mmocore Profession Exp ObjectiveGain MMOCore profession experience
- Mmocore Skill Cast ObjectiveCast specific MMOCore skills
- Profession Level ObjectiveReach a certain MMOCore profession level
Fakten15
- Class Level FactPlayer's MMOCore class level
- Guild Members FactNumber of members in the player's guild
- Guild Online Members FactNumber of online members in the player's guild
- Mmocore Attribute Value FactNumber of points invested in a specific MMOCore attribute
- Mmocore Class FactCheck the player's current MMOCore class
- Mmocore Player Boolean FactExpose boolean values from a player's MMOCore profile
- Mmocore Player Number FactExpose various numeric values from a player's MMOCore profile
- Mmocore Profession FactRetrieve information about a MMOCore profession
- Mmocore Skill FactRead state about a specific MMOCore class skill
- Mmocore Skill Slot Bound FactCheck whether a MMOCore skill slot currently holds a skill
- Mmocore Skill Tree Node FactInspect a specific MMOCore skill tree node
- Mmocore Stat Value FactExpose MMOCore stat values, either total or base
- Mmocore Waypoint Unlocked FactCheck if the player unlocked a specific MMOCore waypoint
- Party Members FactNumber of members in the player's party
- Profession Level FactPlayer's level in a MMOCore profession
Variablen13
- Mmocore Active Casting Skills VariableReturns the list of skill identifiers available in the current casting chain
- Mmocore Bound Skill VariableReturns the skill identifier bound to a specific MMOCore slot
- Mmocore Friends List VariableReturns the UUIDs of the player's MMOCore friends
- Mmocore Guild ID VariableReturns the identifier of the player's MMOCore guild if any
- Mmocore Guild Members VariableReturns the UUIDs of the members in the player's MMOCore guild
- Mmocore Guild Name VariableReturns the name of the player's MMOCore guild if any
- Mmocore Guild Owner VariableReturns the owner UUID of the player's MMOCore guild if any
- Mmocore Guild Tag VariableReturns the tag of the player's MMOCore guild if any
- Mmocore Player Class VariableReturns the identifier of the player's current MMOCore class
- Mmocore Unlocked Nodes VariableReturns every skill tree node identifier the player has unlocked
- Mmocore Unlocked Skills VariableLists the MMOCore skills unlocked for the player's current class
- Mmocore Waypoints VariableLists every waypoint identifier unlocked by the player
- Player Class VariablePlayer's MMOCore class name
Gruppen2
- Guild GroupGroup for the whole guild
- Party GroupGroup for the whole party
Fehlerbehebung
Die Erweiterung lädt nicht. MMOCore und MythicLib müssen installiert und aktiviert sein, und die TypeWriter-Erweiterung Quest muss vorhanden sein. Suche in der Konsole beim Start nach dem ersten Fehler.
Ein Fact liefert immer 0. Der Spieler hat kein MMOCore-Profil (zum Beispiel ein Citizens-NPC), oder die ID ist falsch. classId, professionId, skillId, fullId und waypointId müssen zur MMOCore-Konfiguration passen. Class Fact ignoriert bei classId die Groß- und Kleinschreibung; die anderen IDs werden unverändert an MMOCore übergeben.
Beim Ausführen einer Aktion passiert nichts. Waypoint-Aktionen protokollieren eine Warnung wie Attempted to unlock unknown waypoint '...' for <player>, wenn die ID in MMOCore nicht existiert. Prüfe die ID in der MMOCore-Waypoint-Konfiguration. Add Profession Experience tut stillschweigend nichts, wenn die Berufs-ID unbekannt ist.
Das Objective für Erfahrung oder Fähigkeitseinsätze kommt nie voran. Verknüpfe in fact einen persistenten Fact, stelle sicher, dass die Quest in quest für den Spieler aktiv ist und dass der Spieler zu criteria passt. Beim Objective für Fähigkeitseinsätze erwartet skillIds MMOCore-Skill-Handler-IDs, und requireSuccess ignoriert fehlgeschlagene Einsätze.
Ein Berufs-Objective zählt jeden Beruf. Bei Profession Exp Objective akzeptiert ein leeres profession Erfahrung aus jedem Beruf. Fülle es aus, um einen Beruf zu verfolgen.
Warp hat keine Wirkung oder kostet zu viel. Warp Waypoint verwendet den eigenen Warp von MMOCore mit stelliumCost. Die Kosten werden von MMOCore verwaltet, der Spieler benötigt also genug Stellium, und die Waypoint-Regeln gelten.
Verwandte Erweiterungen
- MMOItems — die Begleit-Integration für MMOItems-Items und Crafting.