MMOCore
概要
MMOCore エクステンションは、RPG プラグイン MMOCore を TypeWriter に接続します。プレイヤーの MMOCore プロフィール(クラス、レベル、ポイント、ステータス、職業、スキル、スキルツリー、ウェイポイント、パーティー、ギルド)を TypeWriter のファクトと変数として公開するため、ダイアログ、クエスト、オーディエンスがそれに反応できます。
また、MMOCore のイベント(職業の経験値、職業レベル、スキルの使用)に追従するクエスト目標、ウェイポイントシステムと職業経験値を操作するアクション、パーティーやギルドでクエストの進行状況を共有するための 2 つのグループエントリーも追加します。
ほとんどのエントリーはデータを読み取るだけです。エクステンション自体は何も保存せず、すべての値は、TypeWriter が要求したときに MMOCore からリアルタイムで取得されます。
機能
- プロフィールファクト — レベル、経験値、ポイント、体力、マナ、スタミナ、ステリウムを、1 つの選択可能な値として読み取ります。
- クラスと職業のファクト — 現在のクラス、クラスレベル、任意の職業のレベルや経験値を確認します。
- スキルファクト — クラススキルのレベル、解放済みかどうか、スキルスロットにバインドされているかどうかを読み取ります。
- スキルツリーファクト — スキルツリーのノードのレベルを読み取り、解放済みか、最大レベルかを確認します。
- ウェイポイント — プレイヤーに MMOCore のウェイポイントを解放、ロック、ワープさせ、解放済みかどうかを確認します。
- クエスト目標 — TypeWriter クエスト用の、職業経験値、職業レベル、スキル使用の目標。
- パーティーとギルド — メンバー数をファクトとして、ギルド名、タグ、ID、オーナー、メンバーを変数として取得します。
- グループ — MMOCore のパーティーまたはギルド全体で、TypeWriter のファクトを共有します。
- リスト変数 — 解放済みスキル、解放済みノード、ウェイポイント、バインド済みスキル、フレンド、現在のキャスト連鎖。
インストール
- サーバーに MMOCore と、そのライブラリである MythicLib をインストールします。
- 公式の TypeWriter Quest エクステンションがインストールされていることを確認します。3 つの目標に必要です。
- ストアからエクステンションを入手し(上のサマリーパネルのボタンを参照)、JAR を
plugins/Typewriter/extensions/に配置します。 - サーバーを再起動します。起動時に、コンソールに
[MMOCoreExtension] MMOCoreExtension enhancements initialized successfully.と出力されます。
はじめに
プレイヤーが採掘職業のレベル 10 に到達すると完了し、その後ウェイポイントを解放するクエストのステップを作成します。
- TypeWriter の Web パネルでシーケンスページを開き、Unlock Waypoint アクションを追加します。
waypointIdに、MMOCore のウェイポイント ID(たとえばspawn_town)を設定します。 - クエストのあるスタティックページを開く(または作成する)、Profession Level Objective を追加します。
questにクエストエントリー、displayにクエストトラッカーに表示するテキスト、professionに職業 ID(たとえばmining)、levelに10を入力します。onCompleteに、手順 1 の Unlock Waypoint アクションを設定します。- Publish します。そのクエストが進行中のプレイヤーがそのレベルに到達すると、ウェイポイントが解放されます。
ダイアログの条件でプレイヤーのクラスを使うには、classId に MMOCore のクラス ID を設定した Class Fact を追加します。プレイヤーがそのクラスを持っていれば 1、そうでなければ 0 を返すため、value を 1 にしたクライテリアで使用できます。
Profession Level Objective や Add Profession Experience で profession を空にすると、職業ではなく、メインクラスのレベルと経験値が対象になります。
仕組み
ファクトと変数は、必要に応じて読み取られます。目標は MMOCore のイベント(経験値の獲得、レベルアップ、スキルの使用)を監視し、目標の criteria に一致し、クエストが進行中のプレイヤーに対してのみカウントします。経験値とスキル使用の目標は、進行状況を、リンクした fact に保存します。これは、パーマネントファクトやセッションファクトなどの、永続的(キャッシュ可能)なファクトでなければなりません。
プレースホルダー
ウェイポイントアクションの waypointId フィールドは、PlaceholderAPI のプレースホルダーを受け付けます。プレースホルダーは、ウェイポイントを検索する前に、プレイヤーに対して解決されます。
| フィールド | 受け付ける値 |
|---|---|
Unlock Waypoint、Lock Waypoint、Warp Waypoint の waypointId | ウェイポイント ID、またはそれを返すプレースホルダー。 |
エントリー
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 のプロフィールを持っていない(たとえば Citizens の NPC)か、ID が間違っています。classId、professionId、skillId、fullId、waypointId は、MMOCore の設定と一致している必要があります。Class Fact は classId の大文字小文字を区別しませんが、他の ID は、記述されたまま MMOCore に渡されます。
アクションを実行しても何も起きない。 ウェイポイントのアクションは、その ID が MMOCore に存在しない場合、Attempted to unlock unknown waypoint '...' for <player> のような警告をログに記録します。MMOCore のウェイポイント設定で ID を確認してください。Add Profession Experience は、職業 ID が不明な場合、何も通知せずに何もしません。
経験値またはスキル使用の目標が進まない。 fact に永続的なファクトをリンクし、quest のクエストがプレイヤーに対して進行中で、プレイヤーが criteria に一致していることを確認してください。スキル使用の目標では、skillIds は MMOCore のスキルハンドラー ID を受け取り、requireSuccess は失敗したキャストを無視します。
職業の目標が、すべての職業をカウントする。 Profession Exp Objective では、profession が空だと、あらゆる職業の経験値を受け付けます。1 つの職業を追跡するには、入力してください。
ワープが効かない、またはコストがかかりすぎる。 Warp Waypoint は、stelliumCost を使った MMOCore 自身のワープを使用します。コストは MMOCore が処理するため、プレイヤーには十分なステリウムが必要で、ウェイポイントのルールが適用されます。
関連エクステンション
- MMOItems — MMOItems のアイテムとクラフトのための、対となる連携。