Авторы:
Благодарность:
Требования:
Мультиязычность:
Ernest Manukyan (kukson777)
Благодарность:
Командам ReHLDS, ReGameDLL и ReAPI, авторам AssemblyScript и WAMR.
Требования:
- Counter-Strike 1.6 на HLDS, Windows или Linux; рекомендуется ReHLDS
- Metamod и AMX Mod X 1.9 или новее
- ReGameDLL — для всех собственных событий игры; без него большинство событий слышно через другие хуки, работает и на обычном HLDS
- ReAPI не нужен
- Для разработки: Node.js или Bun
Мультиязычность:
- EN
- RU
amxts — плагины AMX Mod X на TypeScript. Плагин пишется как обычный TypeScript — с типами, классами,
amxts — это один модуль AMX Mod X: никаких плагинов-посредников, между игрой и вашим кодом нет Pawn. Плагин на TypeScript работает не медленнее того же плагина на Pawn, а на большинстве операций быстрее — это проверяется каждым выпуском. ReAPI не нужен.
Что умеет
Ссылки
async/await, подсказками и проверкой ошибок в редакторе. На вашей машине он компилируется в машинный код (AssemblyScript → WebAssembly → AOT), а сервер загружает готовый файл .aot — так же, как .amxx из .sma. Плагины на Pawn работают рядом как раньше.amxts — это один модуль AMX Mod X: никаких плагинов-посредников, между игрой и вашим кодом нет Pawn. Плагин на TypeScript работает не медленнее того же плагина на Pawn, а на большинстве операций быстрее — это проверяется каждым выпуском. ReAPI не нужен.
Что умеет
- Игроки, сущности и события в понятных именах:
player.health,player.money,player.print(...),server.players,server.addEventListener("killed", …) - События игры (хукчейны ReGameDLL и ReHLDS, функции сущностей) — без ReAPI; на обычном HLDS тоже работает
- Команды с несколькими именами и типизированными аргументами:
/kick <target> [reason]— игрок находится по имени или #userid - Меню AMX Mod X как объекты: пункты с
visible,enabled,onSelect fetchиuseFetchкак в браузере: HTTPS, таймауты, повторы — в своём потоке, игра не ждёт- Хранилище с типами:
new Storage<Profile>("name"), старый файл nVault с тем же именем забирается сам - Файлы и zip-архивы: плагин может скачать карту и распаковать её в потоке модуля, без лага
- MySQL:
new Database(env("MY_DB")), запросы в своём потоке, транзакции и построитель запросов в стиле Drizzle —db.select().from(records).where(eq(records.map, server.map)) - Сжатие gzip и deflate как в Node:
@amxts/core/zlib - Секреты через
env(): токены и ключи хранятся на сервере, а не в коде server.plugins: список плагинов (TypeScript и Pawn), запуск, остановка, перезагрузка- FTP, FTPS и SFTP — модуль
@amxts/ftp; меню из файлов —@amxts/menu-core; конфиги —@amxts/config-core - Боты:
server.addBot, движение, команды - Ошибки с трассировкой по вашему TypeScript: файл, строка и сама строка кода
amxts dev: пересобирает и перезагружает только изменённый плагин, панель с картой, игроками и FPS сервера- Тесты плагинов без сервера:
npx amxts testна встроенном тестовом сервере - Windows и Linux, ReHLDS и обычный HLDS
JavaScript:
plugin({ name: "Hello", version: "1.0.0", author: "me" });
server.addCommand("/hp", ({ player }) => {
player.print(`${player.name}, your HP: ${player.health}`);
});
const shop = new Menu("Shop");
shop.addItem({
title: "Armor - $1000",
enabled: ({ player }) => player.money >= 1000,
onSelect: ({ player }) => {
player.armor = 100;
player.money -= 1000;
},
});
server.addCommand("/shop", ({ player }) => shop.show(player));
Ссылки
- Документация: amxts.github.io/docs
- Официальные модули: amxts.github.io/modules
- Список изменений: amxts.github.io/changelog