Semiclip

Кто сквозь кого проходит — правилом над двумя игроками
v0.2.2kukson777 kukson777

Семиклип позволяет игрокам проходить сквозь друг друга. amxts делает это на сервере сам, парами игроков; этот модуль даёт плагину сказать, кто сквозь кого проходит, правилом над двумя игроками, (player, target) => boolean, и держит пары в курсе.

Возможности

  • Работает сразу после установки. Союзники проходят друг сквозь друга, вблизи полупрозрачны, а вплотную не рисуются; граната союзника пролетает сквозь вас, а на голове союзника можно стоять — ещё до того, как какой-то плагин что-то сказал.
  • Правило, а не пары вручную. Одна функция говорит, проходит ли один игрок сквозь другого; модуль рассчитывает каждую пару.
  • Держится в курсе сам. Появление, смерть, смена команды, вход игрока и изменение любого поля, которое плагины добавили в Player, заново рассчитывают пары — только пары того игрока, с которым это случилось.
  • Больше ничего на сервере. Модуль AMX Mod X не нужен: пары — собственные у amxts.
  • Один экземпляр на сервер. Все плагины, которые им пользуются, задают одно и то же правило.

Установка

Проекту нужен @amxts/core 0.3.5 или новее.

npx amxts module add semiclip

Команда ставит пакет и добавляет его в amxts.config.ts проекта:

export default 
defineConfig
({
modules
: ["@amxts/semiclip"],
});

Использование

Плагин пользуется модулем как semiclip, без строки импорта: сборка добавляет импорт в те плагины, которые им пользуются, и собирает модуль, только когда им пользуется хоть один.

Установленному модулю плагин не нужен: союзники проходят друг сквозь друга; партнёр полупрозрачен ближе 250 юнитов, а ближе 60 исчезает и не рисуется (настройки проекта). Кто сквозь кого проходит, плагин меняет правилом — например, все сквозь всех на KZ-сервере:

semiclip
.
rule
= () => true;

Больше ничего не нужно: модуль рассчитывает каждую пару и заново рассчитывает пары игрока, когда тот появляется, умирает, меняет команду или входит. semiclip.rule = null делает всех твёрдыми; когда плагин, который задал правило, останавливается (его выгрузили или перезагрузили), снова проходят союзники — пока правило не задано снова.

Правило, которое меняется в игре

spawnProtected ниже — собственное поле плагина в Player, объявленное через declare module: сначала оно false, его читают и пишут все плагины сервера, а когда игрок уходит, оно сбрасывается. Только что появившийся игрок 3 секунды проходит сквозь всех живых, а союзники — сквозь друг друга:

declare module "@amxts/core" {
    interface Player {
        
spawnProtected
: boolean;
} }
semiclip
.
rule
= (
player
,
target
) =>
player
.
isAlive
&&
target
.
isAlive
&& (
player
.
spawnProtected
||
player
.
team
==
target
.
team
);
game
.
addEventListener
("spawn", ({
player
}) => {
player
.
spawnProtected
= true; // 3 секунды проходит сквозь всех
setTimeout
(() => (
player
.
spawnProtected
= false), 3000);
});

Модуль сам заново рассчитывает пары, когда поле меняется, — при появлении и когда таймер его снимает, — без вызова update().

Когда пары рассчитываются

КогдаКакие пары
задано ruleвсе пары
игрок вошёл в игруего
игрок появился, умер или сменил командуего
у игрока изменилось поле, которое плагины добавили в Player, — любым плагином или Pawnего
игрок ушёлего пары уходят вместе с ним
semiclip.update(player)пары player
semiclip.update()все пары

update() — для того, что читает правило, но чего модуль не слышит: режим раунда в переменной, собственная запись плагина об игроке:

let 
everyone
= false;
semiclip
.
rule
= (
player
,
target
) =>
everyone
||
player
.
team
==
target
.
team
;
server
.
addCommand
("/party", () => {
everyone
= !
everyone
;
semiclip
.
update
();
});

Пару пропускает любая сторона

rule(player, target) говорит, проходит ли player сквозь target, но пара одна: двое либо проходят сквозь друг друга, либо нет. Пара проходит, когда правило разрешает хотя бы одному — rule(a, b) || rule(b, a). Правило, которое говорит да для защищённого игрока, пропускает его сквозь всех и всех сквозь него, без || target.spawnProtected.

Настройки проекта

Партнёр вблизи полупрозрачный, а вплотную не рисуется, чтобы не закрывать обзор; граната пролетает сквозь партнёров бросившего её игрока; а игрок, который целиком выше партнёра, стоит у него на голове, а не проваливается сквозь него. Проект задаёт всё это в amxts.config.ts — ниже значения по умолчанию:

export default 
defineConfig
({
modules
: ["@amxts/semiclip"],
semiclip
: {
fadeDistance
: 250, // ближе 250 юнитов партнёр полупрозрачный; 0 — выключено
opacity
: 0.4, // на hideDistance непрозрачен на 40%, целиком — на fadeDistance
hideDistance
: 60, // ближе 60 юнитов исчезает, не рисуется, и прицел сквозь него; 0 — выключено
grenades
: true, // false: граната отскакивает от партнёра бросившего
standOnHead
: true, // false: партнёр сверху проваливается
}, });

Выстрел, свет флешки и взрыв останавливаются на партнёре, как на любом. Всё это работает на любом сервере, с ReHLDS и ReGameDLL и без них.

Стоять на голове только в одном режиме

Плагин задаёт semiclip.standOnHead на то время, пока работает. Сервер с несколькими режимами оставляет буст с головы в одном и выключает его в другом плагином этого режима:

semiclip
.
standOnHead
= false; // пока работает этот плагин, партнёр сверху проваливается

Когда плагин останавливается — его выгрузили или режим сменился и он не загружен, — возвращается standOnHead проекта.

Одно правило

Правило на сервере одно. Плагин, который задаёт его поверх правила другого плагина, заменяет его, а консоль предупреждает: действует последнее заданное. Плагины, у каждого из которых есть своё слово, пишут его в поля (player.spawnProtected), которые читает одно правило.

API

ЧленЧто это
semiclip.rule(player, target) => boolean — проходит ли player сквозь target; пара проходит, когда разрешает любая сторона. Присваивание рассчитывает каждую пару; null снова делает всех твёрдыми.
semiclip.standOnHeadboolean — стоит ли игрок, целиком выше партнёра, у него на голове; настройка проекта, пока плагин её не задал, и снова — когда этот плагин остановился.
semiclip.update(player?)Заново рассчитывает пары player или всех, после того как изменилось то, что читает правило и чего модуль не слышит.