Сообщения

Сервер говорит каждому клиенту, что рисовать и играть, сообщениями: строка чата, значок HUD, часы раунда, сообщение об убийстве. Плагин слышит сообщение до того, как оно ушло, читает его, меняет или останавливает:

server
.
addMessageListener
("death", (
event
) => {
    if (
event
.
headshot
) 
print
(0, `${
event
.
killer
?.
name
} - headshot - ${
event
.
victim
?.
name
}`);
});

server
.
addMessageListener
("text", (
event
) => {
    if (
event
.
text
 == "#Round_Draw") 
event
.
preventDefault
();   // клиент его не получит
});

server
.
addMessageListener
("team", (
event
) => {
    if (
event
.
team
 == "SPECTATOR") 
console
.
log
(`${
event
.
target
?.
name
} наблюдает`);
});

server
.
addMessageListener
("roundTime", (
event
) => {
    
event
.
seconds
 = 90;                                         // часы показывают 90
});

server.removeMessageListener("death", listener) снимает обработчик: передайте то же имя и ту же функцию, что добавляли. До плагина доходят только те сообщения, которые он слушает.

Имя сообщения пишется строкой, и редактор подсказывает имена, у каждого — для чего игра шлёт это сообщение и как его называет сама игра: death — это DeathMsg игры, chat — её SayText. Все они — в таблице в конце страницы.

Несколько сообщений игры для плагина — одно и то же, и одно имя слышит их все: progressBar — это BarTime и BarTime2, которое только добавляет, с какого места полоса начинается. У события есть поля их всех, а event.name говорит, какое пришло; поле, которого в пришедшем сообщении нет, читается как 0, null или пусто, а присваивание ему ничего не меняет — startPercent у BarTime равен 0.

server
.
addMessageListener
("progressBar", (
event
) => {
    
console
.
log
(`${
event
.
name
}: ${
event
.
seconds
} с от ${
event
.
startPercent
}%`);
});

Событие

event.player — игрок, которому идёт сообщение, null — если всем, поэтому игрок, о котором сообщение, — отдельное поле: target или его роль — killer, victim, sender. preventDefault() останавливает сообщение. event.name — имя сообщения у игры, "DeathMsg" у death.

Каждое сообщение игра пишет по своей раскладке, и у сообщения с известной раскладкой — а это почти все, что шлёт Counter-Strike, — на каждый аргумент есть поле с именем и типом: игрок — Player (null — никто), признак — boolean, команда — Team, оружие — WeaponKind, маска — массив имён, время — в секундах. Редактор их подсказывает. Присвоить полю — изменить то, что получит клиент: event.team = "CT".

server
.
addMessageListener
("hideWeapon", (
event
) => {
    
event
.
flags
 = 
event
.
flags
.
concat
(["money"]);               // деньги тоже скрыты
});

Сообщение без известной раскладки — прогресс ботов, тексты подсказчика — читается по месту аргументов, через event.args, которые есть у любого сообщения для того, чего не покрывают его поля:

server
.
addMessageListener
("botProgress", (
event
) => {
    
console
.
log
(`${
event
.
args
.
length
} ${
event
.
args
.
number
(0)}`);
});

event.args.number(i) и event.args.text(i) читают аргумент на месте i, 0 — первый; isText(i) говорит, какой он; setNumber(i, value) и setText(i, value) его меняют.

Аргумент, который сообщение не записало, — цвет statusIcon, когда значок прячут, params текста без подстановок, — читается как 0 или пусто, а присваивание ему ничего не меняет. Имя, для которого у игры нет сообщения, — ошибка сборки.

Все сообщения