Семиклип позволяет игрокам проходить сквозь друг друга. amxts делает это на сервере сам, парами игроков; этот модуль даёт плагину сказать, кто сквозь кого проходит, правилом над двумя игроками, (player, target) => boolean, и держит пары в курсе.
Возможности
- Работает сразу после установки. Союзники проходят друг сквозь друга, вблизи полупрозрачны, а вплотную не рисуются; граната союзника пролетает сквозь вас, а на голове союзника можно стоять — ещё до того, как какой-то плагин что-то сказал.
- Правило, а не пары вручную. Одна функция говорит, проходит ли один игрок сквозь другого; модуль рассчитывает каждую пару.
- Держится в курсе сам. Появление, смерть, смена команды, вход игрока и изменение любого поля, которое плагины добавили в
Player, заново рассчитывают пары — только пары того игрока, с которым это случилось. - Больше ничего на сервере. Модуль AMX Mod X не нужен: пары — собственные у amxts.
- Один экземпляр на сервер. Все плагины, которые им пользуются, задают одно и то же правило.
Установка
Проекту нужен @amxts/core 0.3.5 или новее.
npx amxts module add semiclip
pnpm amxts module add semiclip
yarn amxts module add semiclip
bunx 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.standOnHead | boolean — стоит ли игрок, целиком выше партнёра, у него на голове; настройка проекта, пока плагин её не задал, и снова — когда этот плагин остановился. |
semiclip.update(player?) | Заново рассчитывает пары player или всех, после того как изменилось то, что читает правило и чего модуль не слышит. |