MMOCore
Обзор
MMOCore подключает RPG-плагин MMOCore к TypeWriter. Он предоставляет профиль игрока в MMOCore (класс, уровень, очки, характеристики, профессии, навыки, дерево навыков, путевые точки, группа и гильдия) в виде фактов и переменных TypeWriter, чтобы ваши диалоги, квесты и аудитории могли на него реагировать.
Он также добавляет цели квестов, следящие за событиями MMOCore (опыт профессии, уровень профессии, использование навыков), действия, управляющие системой путевых точек и опытом профессий, и две групповые записи, чтобы группа или гильдия могли делить прогресс квестов.
Большинство записей только читают данные. Само расширение ничего не хранит: каждое значение берётся из MMOCore в реальном времени, когда его запрашивает TypeWriter.
Возможности
- Факты профиля — считывайте уровень, опыт, очки, здоровье, ману, выносливость и стеллиум с помощью одного выбираемого значения.
- Факты классов и профессий — проверяйте текущий класс, уровень класса и уровень или опыт любой профессии.
- Факты навыков — считывайте уровень навыка класса, разблокирован ли он и привязан ли слот навыка.
- Факты дерева навыков — считывайте уровень узла дерева навыков или проверяйте, разблокирован ли он или достиг ли максимума.
- Путевые точки — разблокируйте, блокируйте или телепортируйте игрока к путевой точке MMOCore и проверяйте, разблокирована ли она.
- Цели квестов — цели на опыт профессии, уровень профессии и использование навыков для квестов TypeWriter.
- Группа и гильдия — число участников как факты, название, тег, идентификатор, владелец и участники гильдии как переменные.
- Группы — делитесь фактами TypeWriter внутри группы или гильдии MMOCore.
- Переменные-списки — разблокированные навыки, разблокированные узлы, путевые точки, привязанные навыки, друзья и активная цепочка использования навыков.
Установка
- Установите на сервер MMOCore и его библиотеку MythicLib.
- Убедитесь, что установлено официальное расширение TypeWriter Quest. Три цели требуют его.
- Получите расширение в магазинах (см. кнопки в сводной панели выше) и поместите JAR-файл в
plugins/Typewriter/extensions/. - Перезапустите сервер. При запуске консоль выводит
[MMOCoreExtension] MMOCoreExtension enhancements initialized successfully.
Начало работы
Сделайте шаг квеста, который завершается, когда игрок достигает 10 уровня в профессии добычи, а затем разблокирует путевую точку:
- В веб-панели TypeWriter откройте страницу sequence и добавьте действие Unlock Waypoint. Задайте
waypointIdравным идентификатору путевой точки MMOCore, напримерspawn_town. - Откройте (или создайте) страницу static с вашим квестом и добавьте Profession Level Objective.
- Заполните
questвашей записью квеста,display— текстом, показываемым в трекере квестов,profession— идентификатором профессии (например,mining), аlevel— значением10. - Задайте
onCompleteравным действию Unlock Waypoint из шага 1. - Опубликуйте. Когда игрок с активным квестом достигнет уровня, путевая точка будет разблокирована.
Чтобы использовать класс игрока в условии диалога, добавьте Class Fact с classId, равным идентификатору класса MMOCore. Он возвращает 1, если у игрока этот класс, и 0 в противном случае, поэтому его можно использовать в критерии со value, равным 1.
Оставьте profession пустым в Profession Level Objective или в Add Profession Experience, чтобы вместо профессии использовать уровень и опыт основного класса.
Как это работает
Факты и переменные считываются по запросу. Цели прослушивают события MMOCore (получение опыта, повышение уровня, использование навыка) и учитываются только для игроков, которые соответствуют criteria цели и у которых активен квест. Цели на опыт и использование навыков хранят свой прогресс в связанном вами fact, который должен быть постоянным (кэшируемым) фактом, например постоянным или сессионным.
Плейсхолдеры
Поле waypointId действий с путевыми точками принимает плейсхолдеры PlaceholderAPI. Они обрабатываются для игрока до поиска путевой точки.
| Поле | Принимает |
|---|---|
waypointId у Unlock Waypoint, Lock Waypoint и Warp Waypoint | Идентификатор путевой точки или плейсхолдер, возвращающий его. |
Записи
Записей: 38, сгенерированы из исходного кода расширения.
Действия5
- 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
Цели3
- Mmocore Profession Exp ObjectiveGain MMOCore profession experience
- Mmocore Skill Cast ObjectiveCast specific MMOCore skills
- Profession Level ObjectiveReach a certain MMOCore profession level
Факты15
- 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
Переменные13
- 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
Группы2
- Guild GroupGroup for the whole guild
- Party GroupGroup for the whole party
Устранение неполадок
Расширение не загружается. MMOCore и MythicLib должны быть установлены и включены, а расширение TypeWriter Quest должно присутствовать. Проверьте при запуске первую ошибку в консоли.
Факт всегда равен 0. У игрока нет профиля MMOCore (например, у NPC Citizens) либо идентификатор неверен. classId, professionId, skillId, fullId и waypointId должны совпадать с конфигурацией MMOCore. Class Fact игнорирует регистр для classId; остальные идентификаторы передаются MMOCore как написано.
Ничего не происходит при выполнении действия. Действия с путевыми точками записывают в лог предупреждение вида Attempted to unlock unknown waypoint '...' for <player>, когда такого идентификатора нет в MMOCore. Проверьте идентификатор в конфигурации путевых точек MMOCore. Add Profession Experience молча ничего не делает, если идентификатор профессии неизвестен.
Цель на опыт или использование навыка никогда не продвигается. Свяжите постоянный факт в fact, убедитесь, что квест в quest активен для игрока и что игрок соответствует criteria. Для цели на использование навыка skillIds принимает идентификаторы обработчиков навыков MMOCore, а requireSuccess игнорирует неудавшиеся использования.
Цель профессии учитывает все профессии. У Profession Exp Objective пустой profession принимает опыт любой профессии. Заполните его, чтобы отслеживать одну профессию.
Телепортация не действует или стоит слишком дорого. Warp Waypoint использует собственную телепортацию MMOCore со stelliumCost. Стоимость обрабатывается MMOCore, поэтому игроку нужно достаточно стеллиума, и действуют правила путевой точки.
Связанные расширения
- MMOItems — сопутствующая интеграция для предметов и крафта MMOItems.