MMOCore
Présentation
MMOCore relie le plugin RPG MMOCore à TypeWriter. Il expose le profil MMOCore d'un joueur (classe, niveau, points, statistiques, métiers, compétences, arbre de compétences, waypoints, groupe et guilde) sous forme de facts et de variables TypeWriter, afin que vos dialogues, quêtes et audiences puissent y réagir.
Il ajoute aussi des objectifs de quête qui suivent les événements MMOCore (expérience de métier, niveau de métier, lancers de compétences), des actions qui pilotent le système de waypoints et l'expérience de métier, ainsi que deux entrées de groupe pour qu'un groupe (party) ou une guilde puisse partager la progression des quêtes.
La plupart des entrées ne font que lire des données. Rien n'est stocké par l'extension elle-même : chaque valeur provient en direct de MMOCore lorsque TypeWriter la demande.
Fonctionnalités
- Facts de profil — lisez le niveau, l'expérience, les points, la santé, le mana, l'endurance et le stellium avec une seule valeur sélectionnable.
- Facts de classe et de métier — vérifiez la classe actuelle, le niveau de classe et le niveau ou l'expérience de n'importe quel métier.
- Facts de compétence — lisez le niveau d'une compétence de classe, si elle est débloquée, et si un emplacement de compétence est lié.
- Facts d'arbre de compétences — lisez le niveau d'un nœud de l'arbre de compétences, ou vérifiez qu'il est débloqué ou au maximum.
- Waypoints — débloquez, verrouillez ou téléportez un joueur vers un waypoint MMOCore, et vérifiez si l'un d'eux est débloqué.
- Objectifs de quête — objectifs d'expérience de métier, de niveau de métier et de lancer de compétence pour les quêtes TypeWriter.
- Groupe et guilde — nombre de membres sous forme de facts, nom, tag, identifiant, propriétaire et membres de la guilde sous forme de variables.
- Groupes — partagez des facts TypeWriter au sein d'un groupe (party) ou d'une guilde MMOCore.
- Variables de liste — compétences débloquées, nœuds débloqués, waypoints, compétences liées, amis et chaîne d'incantation active.
Installation
- Installez MMOCore et sa bibliothèque MythicLib sur le serveur.
- Vérifiez que l'extension officielle TypeWriter Quest est installée. Les trois objectifs en ont besoin.
- Obtenez l'extension sur les boutiques (voir les boutons du panneau de synthèse ci-dessus) et placez le JAR dans
plugins/Typewriter/extensions/. - Redémarrez le serveur. Au démarrage, la console affiche
[MMOCoreExtension] MMOCoreExtension enhancements initialized successfully.
Premiers pas
Créez une étape de quête qui se termine lorsque le joueur atteint le niveau 10 dans le métier de mineur, puis débloque un waypoint :
- Dans le panneau web de TypeWriter, ouvrez une page de séquence et ajoutez une action Unlock Waypoint. Définissez
waypointIdsur l'identifiant du waypoint MMOCore, par exemplespawn_town. - Ouvrez (ou créez) une page statique avec votre quête, et ajoutez un Profession Level Objective.
- Renseignez
questavec votre entrée de quête,displayavec le texte affiché dans le suivi de quête,professionavec l'identifiant du métier (par exemplemining) etlevelavec10. - Définissez
onCompletesur l'action Unlock Waypoint de l'étape 1. - Publiez. Lorsqu'un joueur ayant la quête active atteint le niveau, le waypoint est débloqué.
Pour utiliser la classe du joueur dans une condition de dialogue, ajoutez un Class Fact avec classId défini sur l'identifiant de la classe MMOCore. Il vaut 1 lorsque le joueur a cette classe, 0 sinon ; vous pouvez donc l'utiliser dans un critère avec value défini sur 1.
Laissez profession vide sur Profession Level Objective ou sur Add Profession Experience pour cibler le niveau et l'expérience de la classe principale plutôt que ceux d'un métier.
Fonctionnement
Les facts et les variables sont lus à la demande. Les objectifs écoutent les événements MMOCore (gain d'expérience, montée de niveau, lancer de compétence) et ne comptent que pour les joueurs qui satisfont les criteria de l'objectif et ont la quête active. Les objectifs d'expérience et de lancer de compétence stockent leur progression dans le fact que vous liez, qui doit être un fact persistant (cachable) tel qu'un fact permanent ou de session.
Placeholders
Le champ waypointId des actions de waypoint accepte les placeholders PlaceholderAPI. Ils sont résolus pour le joueur avant la recherche du waypoint.
| Champ | Accepte |
|---|---|
waypointId de Unlock Waypoint, Lock Waypoint et Warp Waypoint | Un identifiant de waypoint, ou un placeholder qui en renvoie un. |
Entrées
38 entrées, générées depuis la source de l'extension.
Actions5
- 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
Objectifs3
- Mmocore Profession Exp ObjectiveGain MMOCore profession experience
- Mmocore Skill Cast ObjectiveCast specific MMOCore skills
- Profession Level ObjectiveReach a certain MMOCore profession level
Faits15
- 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
Variables13
- 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
Groupes2
- Guild GroupGroup for the whole guild
- Party GroupGroup for the whole party
Dépannage
L'extension ne se charge pas. MMOCore et MythicLib doivent être installés et activés, et l'extension TypeWriter Quest doit être présente. Consultez la console au démarrage pour trouver la première erreur.
Un fact vaut toujours 0. Le joueur n'a pas de profil MMOCore (par exemple un PNJ Citizens), ou l'identifiant est erroné. classId, professionId, skillId, fullId et waypointId doivent correspondre à la configuration de MMOCore. Class Fact ignore la casse pour classId ; les autres identifiants sont transmis à MMOCore tels quels.
Rien ne se passe lorsqu'une action s'exécute. Les actions de waypoint consignent un avertissement tel que Attempted to unlock unknown waypoint '...' for <player> lorsque l'identifiant n'existe pas dans MMOCore. Vérifiez l'identifiant dans la configuration des waypoints de MMOCore. Add Profession Experience ne fait silencieusement rien lorsque l'identifiant du métier est inconnu.
L'objectif d'expérience ou de lancer de compétence n'avance jamais. Liez un fact persistant dans fact, vérifiez que la quête indiquée dans quest est active pour le joueur et que le joueur satisfait criteria. Pour l'objectif de lancer de compétence, skillIds prend des identifiants de gestionnaires de compétences MMOCore, et requireSuccess ignore les lancers qui ont échoué.
Un objectif de métier compte tous les métiers. Sur Profession Exp Objective, un profession vide accepte l'expérience de n'importe quel métier. Renseignez-le pour suivre un seul métier.
La téléportation n'a aucun effet ou coûte trop cher. Warp Waypoint utilise la téléportation propre à MMOCore avec stelliumCost. Le coût est géré par MMOCore : le joueur a donc besoin de suffisamment de stellium et les règles du waypoint s'appliquent.
Extensions associées
- MMOItems — l'intégration compagnon pour les objets et la fabrication de MMOItems.