Эффекты

Временный эффект — то, что игра рисует на мгновение и забывает: луч, ударная волна, взрыв, искры, свет, кровь. Каждый эффект — функция effects, её настройки — аргументы эффекта, а второй аргумент говорит, кто его видит.

const 
shock
 = 
server
.
precache
("sprites/shockwave.spr");
const 
trail
 = 
server
.
precache
("sprites/laserbeam.spr");

function blast(
here
: number[]) {
    
effects
.
beamCylinder
({ 
at
: 
here
, 
radius
: 385, 
sprite
: 
shock
, 
life
: 0.4, 
width
: 60, 
color
: "#0096ff", 
alpha
: 200 }, { 
near
: 
here
 });
    
effects
.
sparks
({ 
at
: 
here
 });
}

function thrown(
grenade
: Entity, 
thrower
: Player) {
    
effects
.
beamFollow
({ 
entity
: 
grenade
, 
sprite
: 
trail
, 
life
: 1, 
width
: 5, 
color
: "#0096ff" }, { 
to
: 
thrower
 });
}

Спрайты и модели

Эффект рисует спрайт или модель, которые игра прекэшировала. server.precache возвращает их как Resource, и именно его принимают sprite и model эффекта:

const 
shock
 = 
server
.
precache
("sprites/shockwave.spr");   // на верхнем уровне файла

server
.
addEventListener
("precache", () => {
    const 
gibs
 = 
server
.
precache
("models/glassgibs.mdl");  // или в событии "precache"
});

Файл, запрошенный на верхнем уровне плагина, прекэшируется, когда грузится карта; в событии "precache" — сразу. Плагин, перезагруженный посреди карты, снова выполняет свой верхний уровень: файл второй раз не прекэшируется, а Resource находит индекс, который ему дала карта.

resource.path — путь, который ему дали, resource.index — индекс, который принимает натив (0, пока файл не прекэширован).

Кто видит

Эффект отправляется так, как игра отправляет свои: игрок, чьё соединение его потеряло, просто его не увидит.

Единицы

• Время — life — в секундах: life: 0.4.
• Цвет — шестнадцатеричная запись CSS, "#0096ff" или "#09f"; alpha — яркость, от 0 до 255.
• Точки, размеры и скорости — в единицах мира, как entity.origin.
• Несколько размеров — собственные числа эффекта, от 0 до 255, и описание каждой настройки их объясняет: толщина луча width (10 — одна единица), его дрожание noise (100 — одна единица), размер спрайта scale (10 — его собственный размер).
• palette — цвет палитры игры, от 0 до 255: красный цвет крови — 247.

Эффекты

Сначала обязательные настройки; у остальных есть значения по умолчанию.

Настройки луча — sprite, life и width, затем color (белый), alpha (255), noise (0, прямой), frame и frameRate (анимация спрайта) и speed (как быстро спрайт бежит вдоль него). Описание каждой настройки — в редакторе — даёт её диапазон и значение по умолчанию.

Текст на экране — это player.showHud. Декали — дырки от пули, рисунка на стене — среди эффектов пока нет: она отправляется нативами, message_begin и write_* (ограничения).