selectDungeon

Choose a dungeon and its difficulty.

Tags and their game types come from `lobby.dungeons`. When `gameType` is omitted it is looked up from that list, so passing just the tag is enough. The chosen type comes back in the reply.

In Dungeons.

Request

POST /api/v1/sessions/{accountKey}/actions/selectDungeon

Parameters

NameTypeRequiredDescription
dungeonIdTag (tag)stringyesWhich dungeon, from `lobby.dungeons`.
gameType (game_type)integernoNormal, high-roller and so on. Looked up from the tag when omitted.
gearPoolIndexintegernoGear pool for the run.

Example request

{ "dungeonIdTag": "Goblin_Caves", "gameType": 1 }

Response

`{ ok, result, gameType, dungeonIdTag }`.

FieldTypeMeaning
gameTypeintegerThe type actually selected — the resolved one when you left it out.

Example response

{ "ok": true, "result": 1, "gameType": 1, "dungeonIdTag": "Goblin_Caves" }

Errors

CodeWhen
action_failedNo character is in the lobby.
plan_limitNot on the free plan.

See also

DarkerAPI is an independent project. It is not affiliated with, endorsed by or associated with IRONMACE Co., Ltd. or Valve Corporation. “Dark and Darker” and related marks belong to their respective owners.