MMOCore
Descripción general
MMOCore conecta el plugin de RPG MMOCore con TypeWriter. Expone el perfil de MMOCore de un jugador (clase, nivel, puntos, estadísticas, profesiones, habilidades, árbol de habilidades, waypoints, grupo y gremio) como hechos y variables de TypeWriter, para que tus diálogos, misiones y audiencias puedan reaccionar a él.
También añade objetivos de misión que siguen los eventos de MMOCore (experiencia de profesión, nivel de profesión, lanzamientos de habilidades), acciones que gestionan el sistema de waypoints y la experiencia de profesión, y dos entradas de grupo para que un grupo o un gremio pueda compartir el progreso de las misiones.
La mayoría de las entradas solo leen datos. La propia extensión no almacena nada: cada valor llega en directo de MMOCore cuando TypeWriter lo solicita.
Características
- Hechos de perfil: lee nivel, experiencia, puntos, salud, maná, resistencia y stellium con un único valor seleccionable.
- Hechos de clase y profesión: comprueba la clase actual, el nivel de clase y el nivel o la experiencia de cualquier profesión.
- Hechos de habilidades: lee el nivel de una habilidad de clase, si está desbloqueada y si una ranura de habilidad está asignada.
- Hechos del árbol de habilidades: lee el nivel de un nodo del árbol de habilidades o comprueba que está desbloqueado o al máximo.
- Waypoints: desbloquea, bloquea o teletransporta a un jugador a un waypoint de MMOCore, y comprueba si uno está desbloqueado.
- Objetivos de misión: objetivos de experiencia de profesión, nivel de profesión y lanzamiento de habilidades para las misiones de TypeWriter.
- Grupo y gremio: recuentos de miembros como hechos; nombre, etiqueta, id, propietario y miembros del gremio como variables.
- Grupos: comparte hechos de TypeWriter entre un grupo o un gremio de MMOCore.
- Variables de lista: habilidades desbloqueadas, nodos desbloqueados, waypoints, habilidades asignadas, amigos y la cadena de lanzamiento activa.
Instalación
- Instala MMOCore y su biblioteca MythicLib en el servidor.
- Asegúrate de que la extensión oficial Quest de TypeWriter está instalada. Los tres objetivos la necesitan.
- Obtén la extensión en las tiendas (consulta los botones del panel de resumen de arriba) y coloca el JAR en
plugins/Typewriter/extensions/. - Reinicia el servidor. Al arrancar, la consola imprime
[MMOCoreExtension] MMOCoreExtension enhancements initialized successfully.
Primeros pasos
Crea un paso de misión que se complete cuando el jugador alcance el nivel 10 en la profesión de minería y que después desbloquee un waypoint:
- En el panel web de TypeWriter, abre una página de secuencia y añade una acción Unlock Waypoint. Establece
waypointIden el id del waypoint de MMOCore, por ejemplospawn_town. - Abre (o crea) una página estática con tu misión y añade un Profession Level Objective.
- Rellena
questcon tu entrada de misión,displaycon el texto que se muestra en el rastreador de misiones,professioncon el id de la profesión (por ejemplomining) ylevelcon10. - Establece
onCompleteen la acción Unlock Waypoint del paso 1. - Publica. Cuando un jugador con la misión activa alcance el nivel, se desbloquea el waypoint.
Para usar la clase del jugador en una condición de diálogo, añade un Class Fact con classId establecido en el id de la clase de MMOCore. Devuelve 1 cuando el jugador tiene esa clase y 0 en caso contrario, así que puedes usarlo en un criterio con value establecido en 1.
Deja profession vacío en Profession Level Objective o en Add Profession Experience para apuntar al nivel y a la experiencia de la clase principal en lugar de a una profesión.
Cómo funciona
Los hechos y las variables se leen bajo demanda. Los objetivos escuchan los eventos de MMOCore (ganancia de experiencia, subida de nivel, lanzamiento de habilidad) y solo cuentan para los jugadores que cumplen los criteria del objetivo y tienen la misión activa. Los objetivos de experiencia y de lanzamiento de habilidad almacenan su progreso en el fact que enlaces, que debe ser un hecho persistente (almacenable en caché), como un hecho permanente o de sesión.
Placeholders
El campo waypointId de las acciones de waypoint acepta placeholders de PlaceholderAPI. Se resuelven para el jugador antes de buscar el waypoint.
| Campo | Acepta |
|---|---|
waypointId de Unlock Waypoint, Lock Waypoint y Warp Waypoint | Un id de waypoint o un placeholder que devuelva uno. |
Entradas
38 entradas, generadas a partir del código fuente de la extensión.
Acciones5
- 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
Objetivos3
- Mmocore Profession Exp ObjectiveGain MMOCore profession experience
- Mmocore Skill Cast ObjectiveCast specific MMOCore skills
- Profession Level ObjectiveReach a certain MMOCore profession level
Hechos15
- 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
Grupos2
- Guild GroupGroup for the whole guild
- Party GroupGroup for the whole party
Resolución de problemas
La extensión no se carga. MMOCore y MythicLib deben estar instalados y activados, y la extensión Quest de TypeWriter debe estar presente. Busca el primer error en la consola al arrancar.
Un hecho siempre devuelve 0. El jugador no tiene un perfil de MMOCore (por ejemplo, un NPC de Citizens) o el id es incorrecto. classId, professionId, skillId, fullId y waypointId deben coincidir con la configuración de MMOCore. Class Fact ignora las mayúsculas en classId; los demás ids se pasan a MMOCore tal como están escritos.
No pasa nada cuando se ejecuta una acción. Las acciones de waypoint registran una advertencia como Attempted to unlock unknown waypoint '...' for <player> cuando el id no existe en MMOCore. Comprueba el id en la configuración de waypoints de MMOCore. Add Profession Experience no hace nada, sin avisar, cuando el id de la profesión es desconocido.
El objetivo de experiencia o de lanzamiento de habilidad nunca avanza. Enlaza un hecho persistente en fact, asegúrate de que la misión indicada en quest está activa para el jugador y de que el jugador cumple criteria. En el objetivo de lanzamiento de habilidad, skillIds admite ids de manejadores de habilidades de MMOCore, y requireSuccess ignora los lanzamientos fallidos.
Un objetivo de profesión cuenta todas las profesiones. En Profession Exp Objective, un profession vacío acepta experiencia de cualquier profesión. Rellénalo para seguir una sola profesión.
El teletransporte no tiene efecto o cuesta demasiado. Warp Waypoint usa el teletransporte propio de MMOCore con stelliumCost. El coste lo gestiona MMOCore, por lo que el jugador necesita suficiente stellium y se aplican las reglas del waypoint.
Extensiones relacionadas
- MMOItems: la integración complementaria para los objetos y la fabricación de MMOItems.