Подземелья

Подземелье (в коде — Dark Hole, «тёмная дыра») открывается предметом-ключом и идёт по текстовому сценарию. Ключ — строка BattleDungeonItem.dat (таблица предметов 23, коды ix…, категория «Предметы»); сценарий — файл Quest\<имя>.txt (в коде «квест»: квест → миссии → задачи); связь ключ → сценарий — Quest\Index.ini [MATCH], производный файл; карта — обычная карта типа 1, все объекты сценария (точки, порталы, зоны) берутся из пустышек её .spt.

BattleDungeonItem.dat                  Quest\Index.ini [MATCH]          Quest\<имя>.txt
строка N: m_strCode = ixkey01   ──►    ixkey01 = Dungeon00_1520_winBoss ──► квест → миссии → задачи
Map\Dungeon00\Dungeon00.spt  ◄──────── use_map, dummy:, area, start_pos ───┘

Как работает

• Канал — один запущенный экземпляр подземелья на отдельном слое карты; дыра — объект-вход на поле рядом с открывшим. Число каналов и задержка закрытия на Sirin настраиваются ModDarkHole*.lua.
• Сценарий пишется в CP949 с табуляцией и завершается [END_OF_FILE]; ключи квеста идут после ###, миссии — после ##, задачи — после #. Порядок важен: use_map до ссылок на пустышки, area до dummy:, type до contents, respawn_monster до своих опций, change_monster до своих if.
• У каждой миссии: start_pos (dp* внутри area) и lim_time_sec > 0; у квеста — limit_lv_max (и limit_lv_min), иначе ключ не откроется. Номер квеста = номер строки ключа, поэтому порядок строк BattleDungeonItem важен; m_bQualification ключа должно равняться membership_party ≠ 0 его сценария.
• Награды reward_item — пороги, а не доли; DarkHoleRewardRate из ServerRate.ini на них не влияет. Коды description и complete_msg (≤ 16 байт) должны существовать в текстах NDItem.edf каждого языка клиента.
• Пределы без проверок в коде: блоки, группы, inner, respond, add_time, change_monster, gate_pos, реакции — за ними следит редактор.