Mod開発者向け

このページは運営によって書かれています。つまり公式情報となります。一般プレイヤーは編集することができません。

ChatAPI

チャットを通じてTheLowの情報を取得することができます。
インターフェースは以下の通りです。

リクエスト

レスポンス

APIのフォーマットについて

レスポンスはチャット欄に表示されます。Modでチャットに表示しないようにしてください。
レスポンスは以下のフォーマットで出力されます。

$api Json形式のレスポンス

「$api 」を削除しjsonをパースして利用してください。

共通

すべてのAPIで共通のフォーマットです。（今は１種類しかありませんが。。。）

プレイヤーステータス

{
  "apiType": "player_status",
  "version": 1,
  "response": {
    "uuid": "67d7d0a0-2e5a-498c-b74b-ea72e0b10b3d",
    "mcid": "Namiken"
    "mainLevel": 60,
    "swordStatus": {
      "leve": 60,
      "exp": 0,
      "maxLevel": 60,
      "reincCount": 60
    },
    "bowStatus": {
      "leve": 60,
      "exp": 0,
      "maxLevel": 60,
      "reincCount": 15
    },
    "magicStatus": {
      "leve": 60,
      "exp": 0,
      "maxLevel": 60,
      "reincCount": 8
    },
    "clanInfo": {
      "clanId": "cf4d122",
      "clanName": "クラン名",
      "clanRank": "UNRANKED"
    },
    "galions": 94645607,
    "unit": 99870060,
    "jobName": "ルーンキャスター"
  }
}

• 補足事項
  • clanInfoはクランに所属している場合のみ設定されます。
  • clanIdはクランごとに採番されるIDです。現時点では利用する必要はありません。

ダンジョン一覧

{
    "apiType": "dungeon",
    "version": 1,
    "response": [
        {
            "x": -1014,
            "y": 71,
            "z": 823,
            "name": "訓練所",
            "difficulty": "With Full Force"
        },
        {
            "x": -950,
            "y": 72,
            "z": -1359,
            "name": "キャラウェイ ",
            "difficulty": "24"
        },
        {
            "x": -1103,
            "y": 74,
            "z": 345,
            "name": "エイドリアン城",
            "difficulty": "68"
        }
    ]
}

• 補足事項
  • responseの内部はリストになっています。

プレイヤーログイン時、まだダンジョン情報がロードされていない可能性があります。
ダンジョン情報がロードされていない場合は以下のメッセージが返却されます。その場合は少し時間(30秒くらい)を開けてリトライしてください。

$api {"apiType":"dungeon","version":1,"response":"not yet reloading..."}

実行者の座標

{
    "apiType": "location",
    "version": 1,
    "response": {
        "worldName": "thelow",
        "x": -243.23572428517824,
        "y": 100,
        "z": -110.29727079660066
    }
}

• 補足事項
  • ワールド名は以下のいずれかになります
    • thelow：地上ワールド
    • dungeon：ダンジョン用のワールド
    • house：ハウジングシステム用のワールド
    • tutorial：チュートリアル用ワールド
    • unknown：その他のワールド

スキル発動時にCoolTime（秒）を表示する

「/thelow_api subscribe SKILL_COOLTIME」を実行することで、武器スキルを発動した瞬間にCooltime（秒）を表示します。
「/thelow_api unsubscribe SKILL_COOLTIME」を実行することで、表示を解除できます。
サーバーが再起動するとこの設定はリセットされます。ログイン時に毎回コマンドを実行することをおすすめします。

{
    "apiType": "skill_cooltime",
    "version": 1,
    "response": {
        "name": "冥府の審判",
        "cooltime": 65.0,
        "type": "SPECIAL_SKILL"
    }
}

• 補足事項
  • typeには以下のいずれかが設定されます。
    • SPECIAL_SKILL：スペシャルスキル
    • NORMAL_SKILL：ノーマルスキル
  • cooltimeにはCooltime（秒）が少数形式で設定されます。この値はポージングなども考慮された時間となります。