# multiplayer
(multiplayer_send_message_to_server, <message_type>), - отправить сообщение на сервер(? не использовал ни разу) message_type прописываются в header_common.

(multiplayer_send_int_to_server, <message_type>, <value>), - отправить на сервер информацию, что событие <message_type> должно начаться с одним из параметров, равным <value>. По сути, это тоже вызов скрипта, ведь все события записаны в #script_game_receive_network_message. Однако, в отличие от простого вызовы скрипта, данное событие произойдёт для всех.

(multiplayer_send_int_to_player, <player_id>, <message_type>, <value>), - работает аналогично предыдущей команде, но только для конкретного игрока <player_id>. Как я считаю, эта команда нужна отчасти для того, чтобы сделать событие на сервере видимым для игрока. (Яркий пример - это инвентарь в мультиплеере, позволяющий игроку переодеваться прямо во время битвы. То есть, мы установили новую броню игроку, но никто не заметил изменения одежды. Поэтому следует продублировать изменение брони для всех игроков через эту команду.) Кроме того, она может использоваться для того, чтобы перемещать камеру конкретному игроку и прочего.

 (multiplayer_send_string_to_player, <player_id>, <message_type>, <string_id>), - отправить игроку при событии строковую переменную <string_id>, лежащую в файле module_strigns.py. Или же, вместо неё можно попробывать написать переменную в виде "@абырварг".

 (get_max_players, <destination>), - пишет в переменную то ли максимально возможное количество игроков на сервере, то ли максимально возможное вообще.

(player_is_active, <player_id>), - выдаёт истину, если игрок на сервере. вроде бы, точно не помню.

 (player_get_team_no,  <destination>, <player_id>), - пишет в переменную, в какой команде игрок. 0,1 или 2. 2 - наблюдатели.

 (player_set_team_no,  <destination>, <player_id>), - устанавливает игроку новую команду.

(player_get_troop_id, <destination>, <player_id>), - пишет в переменную, за какой тип солдата играет игрок. Солдаты лежат в module_troops.py

(player_get_troop_id, <destination>, <player_id>), - устанавливаем игроку тип солдата.

 (player_get_agent_id, <destination>, <player_id>), - пишет в переменную идентификатор агента игрока. Агент, как я понимаю, это любое "живое" существо на карте, бот, игрок или лошадь.

(player_get_gold, <destination>, <player_id>),
(player_set_gold, <player_id>, <value>, <max_value>), #set max_value to 0 if no limit is wanted
первая команда пишет в переменную текущее количество золота у игрока, вторая - выдаёт игроку золото в количестве value.




(player_spawn_new_agent, <player_id>, <entry_point>), - заставляет появиться копию игрока на указанной entry_point.

player_add_spawn_item                = 410 # (player_add_spawn_item, <player_id>, <item_slot_no>, <item_id>), - ? как описать, не знаю, но ей выдаются предметы, выбранные в меню закупки.

multiplayer_get_my_team              = 411 # (multiplayer_get_my_team, <destination>),
multiplayer_get_my_troop             = 412 # (multiplayer_get_my_troop, <destination>),
multiplayer_get_my_gold              = 414 # (multiplayer_get_my_gold, <destination>),
multiplayer_get_my_player            = 415 # (multiplayer_get_my_player, <destination>),
пишут в переменные данные о команде, типе солдата, золоте и идентификаторе игрока для игрока.(когда расчёт идёт не для сервера, а для игрока. Лучше не знаю, как объяснить).

multiplayer_set_my_troop             = 413 # (multiplayer_get_my_troop, <destination>),

multiplayer_clear_scene              = 416 # (multiplayer_clear_scene), -?
(multiplayer_is_server),  возвращает истину, если игрок, у которого выполняется код, является сервером, создавшим сервер из игры(?).

multiplayer_is_dedicated_server      = 418 # (multiplayer_is_dedicated_server),-?
game_in_multiplayer_mode             = 419 # (game_in_multiplayer_mode), -?

 (multiplayer_make_everyone_enemy), - это вроде делает всех врагами. для дезматча.(?)




## Set_slot operations. These assign a value to a slot.
Слоты! С ними можно всё. На них строиться код.
Слот - это, по сути, своя переменная с одним и тем же именем для множества однородных объектов.
Допустим, нам надо записать, что квест выполнен наполовину. Для этого можно создать переменную типа :half или $g_half. Но для каждого нового квеста нам придётся создавать новые переменные, дабы отразить его состояние. То есть много лишней информации.
Но мы можем использовать слоты. Слот - это такой ящик, в который мы можем положить любые предметы. Например, у нас два квеста - синий и зелёный. Чтобы записать, что квест пройден наполовину, мы сделаем так.
В module_constants.py сколотим новый ящик в разделе Quest Slots. Например, ящик quest_stage.
Потом мы просто делаем такой же и относим его в синий или зелёный домик.

(quest_set_slot,<quest_id>,<slot_no>,<value>), - quest_set_slot - сама команда, кладущая в ящик информацию; <quest_id>  - идентификатор квеста, в нашем случае "синий" или "зелёный". <slot_no> - это наш ящик; value - значение, вещь, которую мы положили в слот. Это может быть идентификатор игрока или агента, оружия, объекта сцены, самой сцены, любое число.

Итого, если зелёный квест выполнен наполовину, мы напишем:
(quest_set_slot,"qst_зелёный",slot_quest_stage,1)

После этого мы командой quest_get_slot можем в любом другом месте модульной системы(скрипты, триггер миссий) определить состояние нашего квеста.

Или вот так можно. Нам нужно записать, что игрок должен принести случайно выбранное программой оружие. например, был выбран itm_sword. Создадим новый слот quest_weapon.

(quest_set_slot,"qst_зелёный",slot_quest_weapon, "itm_sword").
Теперь мы можем легко проверить, какое оружие у нас должно найтись.

Так, а если нам надо два предмета? То есть, придётся сделать два слота? quest_weapon_1 и quest_weapon_2? Нет, можно проще.

Слот - это ящик, сущность которого одновременно пребывает в разных измерениях в количестве от одного до бесконечности. Так вот. Можно в зелёную комнату принести ещё такой же ящик и на него прикрепить бирку с номером. То есть в зелёной комнате будут два идентичных ящика с номерами 0 и 1.

И вот, второе оружие - лук.
Мы запишем так:
(quest_set_slot,"qst_зелёный",slot_quest_weapon, "itm_sword") - ящик с номером 0
(quest_set_slot,"qst_зелёный",slot_quest_weapon+1, "itm_bow") - ящик с номером 1

Вот и всё. И никаких глобальных переменных в неведомом числе