iWors
Эксперт
Map Manager (менеджер карт) - ресурс, включенный в стандартный комплект поставки MTA DM сервера. Он предлагает команды, функции и события для модов, чтобы динамично распоряжаться их картами. Например, когда race-серверу нужно для каждой гонки подгружать новые треки, вместо того, чтобы хранить их все в одном ресурсе в качестве основного скрипта, они могут храниться в отдельных ресурсах и быть загруженными с помощью обычной функции "changeGamemodeMap" при старте новой гонки.
А именно, Map Manager хранит список всех модов/карт и управляет их загрузкой. То есть распространяется и на настройки текущей карты, затрагивает игровой мир и устанавливает тип игры и имя карты в ASE. Это включает в себя и веб-лист, который обновляется и пишет текущую комбинацию мода/карты.
А именно, Map Manager хранит список всех модов/карт и управляет их загрузкой. То есть распространяется и на настройки текущей карты, затрагивает игровой мир и устанавливает тип игры и имя карты в ASE. Это включает в себя и веб-лист, который обновляется и пишет текущую комбинацию мода/карты.
Простой туториал
Мы добавим простой ресурс-карту, который будет содержать лишь спавны для игроков, и научимся подгружать данные в главный скрипт, когда игроку понадобится спавниться.Для начала, мы создадим папку в
PHP:
/путь-к-вашему-серверу/mods/deathmatch/resources/
Вставьте следующий код в файл meta.xml:
PHP:
<meta>
<info type="map" gamemodes="myserver"/>
<map src="mymap.map"/>
</meta>
Теперь создадим еще один файл внутри /mymap/ и назовем его "mymap.map", затем введем туда следующий код:
PHP:
<map>
<spawnpoint id="spawnpoint1" posX="1959.5487060547" posY="-1714.4613037109" posZ="18" rot="63.350006103516" model="0"/>
</map>
Чтобы подгрузить данные карты, главному скрипту нужен доступ к ресурсу-карте как таковому. Теперь отредактируем файл script.lua в ресурсе "myserver".
Введите следующий код:
PHP:
function loadMap(startedMap)
mapRoot = getResourceRootElement(startedMap)
end
addEventHandler("onGamemodeMapStart", getRootElement(), loadMap)
Имея контроль над ресурсом, мы можем добыть информацию о spawnpoint'ах (респавнах). Взгляните на функцию joinHandler() в script.lua - вместо того, чтобы указывать x, y и z, мы можем использовать данные карты следующим образом:
PHP:
function joinHandler()
local spawn = getElementsByType("spawnpoint", mapRoot)
local x,y,z,r
for key, value in pairs(spawn) do
x = getElementData(value, "posX")
y = getElementData(value, "posY")
z = getElementData(value, "posZ")
r = getElementData(value, "rot")
end
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
end
PHP:
gamemode myserver mymap
Использование
Чтобы использовать Map Manager, ваши ресурсы для начала должны быть отмечены как моды и карты.
Вам придется пометить ресурс-мод соответствующим type в его info-теге:
PHP:
<info description="A gamemode" type="gamemode" />
PHP:
<info description="A gamemode map" type="map" gamemodes="ctv,koth" />
Опциональные атрибуты ресурсов
Все эти атрибуты включаются в тег info соответствующего ресурса.
name: "Дружелюбное" имя для вашего мода или карты, которое будет отображаться при их старте или в списках вместо имен файлов.
Команды
changemap newmap [newgamemode] (меняет карту мода на новую, а опционально - и сам мод)
changemode newgamemode [newmap] (меняет мод на новый, опционально стартуя карту вместе с ним)
gamemode newgamemode [newmap] (аналогично предыдущему)
stopmode (останавливает текущие мод и карту)
stopmap (останавливает текущую карту)
maps [gamemode] (выдает список всех карт на сервере, опционально - только совместимых с указанным модом)
gamemodes (выдает список всех модов)
Настройки
*mapmanager.color [hex color string] (меняет цвет сообщений, выводимых mapmanager'ом) (по умолчанию: #E1AA5A)
*mapmanager.messages [boolean] (включена ли смена карт/модов) (по умолчанию: true)
*mapmanager.ASE [boolean] (будет ли менеджер устанавливать в ASE тип игры / имя карты) (по умолчанию: true)
Экспортированные функции
PHP:
bool changeGamemode ( resource newGamemode, [ resource mapToLoadWith ] )
PHP:
bool changeGamemodeMap ( resource newMap, [ resource gamemodeToChangeTo ] )
PHP:
table getGamemodes ( )
PHP:
table getGamemodesCompatibleWithMap ( resource theMap )
PHP:
table getMaps ( )
Выдаст таблицу указателей всех ресурсов-карт.
PHP:
table getMapsCompatibleWithGamemode ( [ resource theGamemode ] )
PHP:
resource getRunningGamemode ( )
PHP:
resource getRunningGamemodeMap ( )
PHP:
bool isGamemode ( resource theGamemode )
PHP:
bool isGamemodeCompatibleWithMap ( resource theGamemode, resource theMap )
PHP:
bool isMap ( resource theMap )
PHP:
bool isMapCompatibleWithGamemode ( resource theMap, resource theGamemode )
PHP:
bool stopGamemode ( )
PHP:
bool stopGamemodeMap ( )
Срабатывающие события
(Для всех этих событий, "source" - root element (корневой элемент) ресурса.)
PHP:
onGamemodeStart ( resource startedGamemode )
PHP:
onGamemodeStop ( resource stoppedGamemode )
PHP:
onGamemodeMapStart ( resource startedMap )
PHP:
onGamemodeMapStop ( resource stoppedMap )
Поддерживаемые настройки карт
Следующие настройки из регистра применяются map manager'ом при старте карты:
gamespeed [number]: Скорость игры на данной карте.
gravity [number]: Гравитация на данной карте.
time [string of the form hh:mm]: Время на данной карте.
weather [number]: ID погоды на данной карте.
waveheight [number]: Высота волн на данной карте.
locked_time [boolean]: Остановит ли менеджер время на карте или нет.
minplayers [number]: Необходимый минимум игроков для старта карты.
maxplayers [number]: Допустимый максимум игроков на карте.
