@amxts/perms 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kukson777
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PAWN.md

@@ -0,0 +1,53 @@
+# Perms for Pawn plugins
+
+[English](PAWN.md) | [Русский](PAWN.ru.md)
+
+A Pawn plugin needs nothing from Perms to keep working: the module gives each
+player AMX Mod X's flags from his `amxx.*` nodes, so `get_user_flags`,
+`access`, `cmd_access` and `register_concmd` with flags behave as they do with
+`admin.amxx`.
+
+To check permission nodes of its own, a plugin writes `#include <perms>`; the
+package ships `include/perms.inc`:
+
+```pawn
+#include <amxmodx>
+#include <perms>
+
+public plugin_init()
+{
+	register_plugin("My plugin", "1.0", "you");
+	perms_declare("myplugin.trail", "A trail behind the player");
+	register_clcmd("say /trail", "CmdTrail");
+}
+
+public CmdTrail(id)
+{
+	if (!perms_has(id, "myplugin.trail"))
+	{
+		client_print(id, print_chat, "You have no trail");
+		return PLUGIN_HANDLED;
+	}
+
+	new group[32];
+	perms_get_group(id, group, charsmax(group));
+	client_print(id, print_chat, "Your trail, %s", group);
+	return PLUGIN_HANDLED;
+}
+
+public perms_changed(id)
+{
+	// the player's permissions changed: he joined, a command or the editor changed them
+}
+```
+
+| Native | What it does |
+| --- | --- |
+| `bool:perms_has(id, const node[])` | whether the player has the node |
+| `perms_declare(const node[], const description[], bool:byDefault = false)` | declares a node for the web editor; `byDefault` gives it to every player |
+| `perms_get_group(id, out[], len)` | the player's primary group |
+| `bool:perms_in_group(id, const group[])` | whether the player is in a group |
+| `perms_add_group(id, const group[], seconds = 0)` | puts him into a group, for `seconds` or for good |
+| `perms_remove_group(id, const group[])` | takes him out of it |
+
+`public perms_changed(id)` is called when a player's permissions change.

package/PAWN.ru.md

@@ -0,0 +1,53 @@
+# Perms для Pawn-плагинов
+
+[English](PAWN.md) | [Русский](PAWN.ru.md)
+
+Pawn-плагину ничего не нужно от Perms, чтобы работать: модуль ставит каждому
+игроку флаги AMX Mod X из его узлов `amxx.*`, поэтому `get_user_flags`,
+`access`, `cmd_access` и `register_concmd` с флагами ведут себя так же, как с
+`admin.amxx`.
+
+Чтобы проверять свои узлы прав, плагин пишет `#include <perms>`; пакет
+поставляет `include/perms.inc`:
+
+```pawn
+#include <amxmodx>
+#include <perms>
+
+public plugin_init()
+{
+	register_plugin("My plugin", "1.0", "you");
+	perms_declare("myplugin.trail", "A trail behind the player");
+	register_clcmd("say /trail", "CmdTrail");
+}
+
+public CmdTrail(id)
+{
+	if (!perms_has(id, "myplugin.trail"))
+	{
+		client_print(id, print_chat, "You have no trail");
+		return PLUGIN_HANDLED;
+	}
+
+	new group[32];
+	perms_get_group(id, group, charsmax(group));
+	client_print(id, print_chat, "Your trail, %s", group);
+	return PLUGIN_HANDLED;
+}
+
+public perms_changed(id)
+{
+	// права игрока изменились: он зашёл, их изменила команда или редактор
+}
+```
+
+| Натив | Что делает |
+| --- | --- |
+| `bool:perms_has(id, const node[])` | есть ли у игрока узел |
+| `perms_declare(const node[], const description[], bool:byDefault = false)` | объявляет узел для веб-редактора; `byDefault` даёт его всем игрокам |
+| `perms_get_group(id, out[], len)` | основная группа игрока |
+| `bool:perms_in_group(id, const group[])` | состоит ли игрок в группе |
+| `perms_add_group(id, const group[], seconds = 0)` | добавляет его в группу на `seconds` секунд или навсегда |
+| `perms_remove_group(id, const group[])` | убирает его из группы |
+
+`public perms_changed(id)` вызывается, когда права игрока меняются.

package/README.md

@@ -1,3 +1,267 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<img src="assets/logo.svg" width="96" alt="Perms">
+
+# Perms
+
+*Permissions and groups in place of admin.amxx*
+
+[![amxts module](https://img.shields.io/badge/amxts-module-3178c6?style=flat-square)](https://amxts.github.io/)
+[![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)
+
+**English** | [Русский](README.ru.md)
+
+</div>
+
+Permissions and groups for an amxts server, in place of AMX Mod X's `admin.amxx`:
+permission nodes with wildcards and negation, groups with inheritance and
+weights, temporary grants, a file or MySQL, AMX Mod X's admin flags for Pawn
+plugins - and a web editor the server opens with one command.
+
+```ts
+perms.declare({
+	"myplugin.kick": { description: "Kick players" },
+	"myplugin.help": { description: "Use /help", everyone: true },
+});
+
+server.addCommand<KickArgs>("/kick <target>", ({ player, target }) => {
+	if (!perms.has(player, "myplugin.kick")) return player.print("You may not kick");
+
+	target.kick("Kicked");
+});
+```
+
+## Install
+
+```sh
+npx amxts module add perms
+```
+
+`perms` is a global in your plugins, as the core's API is - no import line.
+
+## Permissions
+
+A permission is a **node**: dotted words, the plugin's name first -
+`myplugin.kick`, `shop.discount`, `kz.admin.wipe`.
+
+- `kz.admin.*` gives every node under `kz.admin`; `*` gives everything.
+- `-kz.admin.wipe` takes a node away: a negation.
+- The most specific grant wins: `kz.admin.*` with `-kz.admin.wipe` gives all of
+  `kz.admin` but `wipe`. Of a node granted and negated in one place, the
+  negation wins.
+- A node nothing grants is what its plugin declared: `everyone: true` gives it
+  to every player, otherwise nobody has it.
+
+## Groups
+
+A group has its permissions, the groups it `inherits`, and a `weight`.
+Every player is in `default`, without being written in.
+
+A player's answer for a node comes from the first of these that names it:
+
+1. his own permissions;
+2. his groups, the highest weight first - each group before what it inherits;
+3. `default`.
+
+His **primary group** is his group of the highest weight - `perms.groupOf(player)`,
+for a chat tag or a scoreboard.
+
+A group or a permission may be **temporary**: it stops counting the moment it
+ends, and the file drops it on its next save.
+
+## Players
+
+A player is found by his SteamID, then by his IP, then by his name with a
+password - as `users.ini` finds him:
+
+| Entry | Who it is |
+| --- | --- |
+| `STEAM_0:1:12345` | the player with that SteamID |
+| `ip:1.2.3.4` | a player from that address - for a game without Steam |
+| `name:Bob` | a player named `Bob` whose `setinfo _pw` is the entry's password |
+
+## The file
+
+`perms.yaml` (or `perms.json`) in the configs folder, `addons/amxmodx/configs/` -
+or `configs/<baseDir>/` when the project sets config-core's `baseDir`, as other
+configs are. The commands and the web editor write it, and it is edited by hand
+too; the server console says at start which file it read:
+
+```yaml
+groups:
+  default:
+    permissions: [kz.top]
+  vip:
+    weight: 10
+    permissions: [amxx.reservation, shop.discount]
+  admin:
+    weight: 50
+    inherits: [vip]
+    permissions: [amxx.kick, amxx.ban, "kz.admin.*", "-kz.admin.wipe"]
+users:
+  - id: "STEAM_0:1:12345"
+    name: Bob
+    groups: [admin]
+    permissions: [kz.admin.wipe]
+  - id: "STEAM_0:0:777"
+    groups:
+      - { group: vip, until: 2026-12-01T00:00:00Z }
+```
+
+A permission or a group with an end, or for one server, is an object:
+`{ node: kz.vip, until: 2026-12-01T00:00:00Z, server: kz1 }`. Times are UTC.
+
+> [!WARNING]
+> A file with an error is said in the server console with its line, and the
+> permissions read before it stay - a typo never leaves the server without admins.
+
+## MySQL
+
+Several servers share one set of permissions in MySQL. Give the database's
+address in the server's `addons/amxts/.env`:
+
+```ini
+PERMS_DB=mysql://perms:secret@127.0.0.1:3306/perms
+PERMS_SERVER=kz1
+```
+
+The module makes its tables (`perms_groups`, `perms_grants`, `perms_users`,
+`perms_members`, `perms_revision`) on its first start. A change on one server
+reaches the others within five seconds.
+
+`PERMS_SERVER` names this server: a group or a permission given with
+`server: kz1` counts on it alone.
+
+## In code
+
+```ts
+perms.has(player, "myplugin.kick");                 // true or false
+perms.groupOf(player);                              // "admin"
+perms.groupsOf(player);                             // ["admin", "default"]
+perms.addGroup(player, "vip", { for: 30 * 86400 }); // seconds; permanent without for
+perms.removeGroup(player, "vip");
+perms.set(player, "myplugin.trail", true, { for: 3600 });
+perms.unset(player, "myplugin.trail");
+
+perms.addEventListener("change", ({ player }) => {
+	if (perms.has(player, "myplugin.trail")) startTrail(player);
+});
+```
+
+`"change"` comes when a player's permissions change: he joins, a command or
+the editor changes them, or one ends.
+
+## Commands
+
+In the server console and over rcon:
+
+```
+perms user <player|id> info
+perms user <player|id> group add <group> [30d]
+perms user <player|id> group remove <group>
+perms user <player|id> permission set <node> [true|false] [30d]
+perms user <player|id> permission unset <node>
+perms group <group> create [weight]
+perms group <group> delete | info
+perms group <group> permission set <node> [true|false] [30d]
+perms group <group> permission unset <node>
+perms group <group> parent add|remove <group>
+perms group <group> weight <n>
+perms groups
+perms check <player|id> <node>
+perms nodes [plugin]
+perms editor [close]
+perms reload
+perms import [users.ini]
+```
+
+A player is `#userid`, a part of his name, or an entry's id
+(`STEAM_0:1:12345`). A duration is `45s`, `90m`, `12h`, `30d` or `2w`.
+
+In the game a player with `perms.view` runs the commands that only show -
+`groups`, `check`, `nodes`, `user ... info` and `group ... info` - in his
+console or in chat (`/perms groups`); the answer comes to his console.
+Permissions are changed from the server console and in the web editor only.
+
+## The web editor
+
+```
+perms editor
+[perms] Open the editor (an hour): https://amxts.github.io/modules/perms/editor#k3x9q2mw7a
+```
+
+The link opens the server's permissions in the browser: every plugin's nodes
+with their descriptions, a column per group, the groups, the players. **Save**
+sends the changes back; the server applies them within seconds, without a
+restart, and the page says what it did.
+
+- The server console opens it; no player can.
+- Whoever has the link can edit until the session ends: after an hour, or
+  `perms editor close`. Share it like a password.
+- What goes to the editor: groups, permissions, SteamIDs and names. Passwords and
+  the database's address never leave the server.
+- The editor keeps a session for an hour on amxts's service. To keep them on
+  your own, run the store from this package's `store/` folder (a Cloudflare
+  Worker) and give its address as `PERMS_EDITOR_URL` in `.env`.
+
+## In place of admin.amxx
+
+1. `npx amxts module add perms`, build and deploy.
+2. Comment out `admin.amxx` (or `admin_sql.amxx`) in `plugins.ini`. While one
+   of them runs, the module leaves the players' flags to it and says so in the
+   console.
+3. In the server console: `perms import users.ini`. Each admin becomes an entry
+   with his flags as `amxx.*` permissions of his own. Check one with
+   `perms user <name> info`.
+
+`users.ini` is not read again; it stays for going back.
+
+Pawn plugins work unchanged: the module gives each player AMX Mod X's flags from
+his `amxx.*` nodes, so `get_user_flags`, `access`, `cmd_access`,
+`is_user_admin` and `cmdaccess.ini` see each player's rights. A player with no `amxx.*`
+node gets `amx_default_access` (`z`). The module also keeps `amx_mode`,
+`amx_password_field`, `amx_default_access` and `amx_reloadadmins`, which server
+configs and plugins use.
+
+| Node | Flag |
+| --- | --- |
+| `amxx.immunity` | `a` |
+| `amxx.reservation` | `b` |
+| `amxx.kick` | `c` |
+| `amxx.ban` | `d` |
+| `amxx.slay` | `e` |
+| `amxx.map` | `f` |
+| `amxx.cvar` | `g` |
+| `amxx.cfg` | `h` |
+| `amxx.chat` | `i` |
+| `amxx.vote` | `j` |
+| `amxx.password` | `k` |
+| `amxx.rcon` | `l` |
+| `amxx.levelA` ... `amxx.levelH` | `m` ... `t` |
+| `amxx.menu` | `u` |
+| `amxx.banTemp` | `v` |
+| `amxx.admin` | `y` |
+
+> [!WARNING]
+> **amx_mode**
+>
+> `amx_mode 2` kicks a player without an entry, as `admin.amxx` does: a private
+> server. `amx_mode 0` gives nobody anything.
+
+Pawn plugins can check nodes themselves: [PAWN.md](PAWN.md).
+
+## Options
+
+```ts
+export default defineConfig({
+	modules: ["@amxts/perms"],
+	perms: {
+		file: "perms",   // configs/perms.yaml
+		editor: "",      // the editor's store; PERMS_EDITOR_URL overrides it
+	},
+});
+```
+
+## License
+
+MIT

package/README.ru.md

@@ -0,0 +1,267 @@
+<div align="center">
+
+<img src="assets/logo.svg" width="96" alt="Perms">
+
+# Perms
+
+*Права и группы вместо admin.amxx*
+
+[![amxts module](https://img.shields.io/badge/amxts-module-3178c6?style=flat-square)](https://amxts.github.io/)
+[![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)
+
+[English](README.md) | **Русский**
+
+</div>
+
+Права и группы для сервера на amxts вместо `admin.amxx` из AMX Mod X: узлы прав
+с масками и запретом, группы с наследованием и весом, временные права, файл или
+MySQL, флаги AMX Mod X для Pawn-плагинов - и веб-редактор, который сервер
+открывает одной командой.
+
+```ts
+perms.declare({
+	"myplugin.kick": { description: "Кикать игроков" },
+	"myplugin.help": { description: "Пользоваться /help", everyone: true },
+});
+
+server.addCommand<KickArgs>("/kick <target>", ({ player, target }) => {
+	if (!perms.has(player, "myplugin.kick")) return player.print("Тебе нельзя кикать");
+
+	target.kick("Kicked");
+});
+```
+
+## Установка
+
+```sh
+npx amxts module add perms
+```
+
+`perms` в плагинах - глобальное имя, как API ядра: строка импорта не нужна.
+
+## Права
+
+Право - это **узел**: слова через точку, первым - имя плагина: `myplugin.kick`,
+`shop.discount`, `kz.admin.wipe`.
+
+- `kz.admin.*` даёт все узлы под `kz.admin`; `*` даёт всё.
+- `-kz.admin.wipe` отнимает узел: запрет.
+- Побеждает самое точное право: `kz.admin.*` вместе с `-kz.admin.wipe` даёт весь
+  `kz.admin`, кроме `wipe`. Если в одном месте узел и выдан, и запрещён,
+  побеждает запрет.
+- Узел, который никто не выдал, - такой, каким его объявил плагин:
+  `everyone: true` даёт его всем игрокам, иначе он ни у кого.
+
+## Группы
+
+У группы есть её права, группы, которые она наследует (`inherits`), и вес
+(`weight`). Каждый игрок состоит в `default`, даже если нигде не записан.
+
+Ответ про узел для игрока берётся из первого, что этот узел называет:
+
+1. его личные права;
+2. его группы, начиная с самой тяжёлой, - каждая раньше того, что она наследует;
+3. `default`.
+
+**Основная группа** игрока - его группа с самым большим весом:
+`perms.groupOf(player)`, для тега в чате или таблицы счёта.
+
+Группа или право могут быть **временными**: они перестают действовать в момент
+окончания, а файл убирает их при следующем сохранении.
+
+## Игроки
+
+Игрок находится по SteamID, затем по IP, затем по нику с паролем - так же, как
+его находит `users.ini`:
+
+| Запись | Кто это |
+| --- | --- |
+| `STEAM_0:1:12345` | игрок с этим SteamID |
+| `ip:1.2.3.4` | игрок с этого адреса - для игры без Steam |
+| `name:Bob` | игрок с ником `Bob`, у которого `setinfo _pw` - пароль записи |
+
+## Файл
+
+`perms.yaml` (или `perms.json`) в папке конфигов, `addons/amxmodx/configs/` -
+или `configs/<baseDir>/`, если проект задал `baseDir` у config-core, как и для
+остальных конфигов. Его пишут команды и веб-редактор, его можно править руками;
+какой файл прочитан, сервер пишет в консоль при старте:
+
+```yaml
+groups:
+  default:
+    permissions: [kz.top]
+  vip:
+    weight: 10
+    permissions: [amxx.reservation, shop.discount]
+  admin:
+    weight: 50
+    inherits: [vip]
+    permissions: [amxx.kick, amxx.ban, "kz.admin.*", "-kz.admin.wipe"]
+users:
+  - id: "STEAM_0:1:12345"
+    name: Bob
+    groups: [admin]
+    permissions: [kz.admin.wipe]
+  - id: "STEAM_0:0:777"
+    groups:
+      - { group: vip, until: 2026-12-01T00:00:00Z }
+```
+
+Право или группа со сроком или для одного сервера записываются объектом:
+`{ node: kz.vip, until: 2026-12-01T00:00:00Z, server: kz1 }`. Время - UTC.
+
+> [!WARNING]
+> Ошибку в файле сервер называет в консоли со строкой, а права, прочитанные до
+> неё, остаются: из-за опечатки сервер не останется без админов.
+
+## MySQL
+
+Несколько серверов делят один набор прав в MySQL. Адрес базы пишется в
+`addons/amxts/.env` сервера:
+
+```ini
+PERMS_DB=mysql://perms:secret@127.0.0.1:3306/perms
+PERMS_SERVER=kz1
+```
+
+Модуль создаёт свои таблицы (`perms_groups`, `perms_grants`, `perms_users`,
+`perms_members`, `perms_revision`) при первом запуске. Изменение на одном
+сервере доходит до остальных за пять секунд.
+
+`PERMS_SERVER` - имя этого сервера: группа или право, выданные с `server: kz1`,
+действуют только на нём.
+
+## В коде
+
+```ts
+perms.has(player, "myplugin.kick");                 // true или false
+perms.groupOf(player);                              // "admin"
+perms.groupsOf(player);                             // ["admin", "default"]
+perms.addGroup(player, "vip", { for: 30 * 86400 }); // секунды; без for - навсегда
+perms.removeGroup(player, "vip");
+perms.set(player, "myplugin.trail", true, { for: 3600 });
+perms.unset(player, "myplugin.trail");
+
+perms.addEventListener("change", ({ player }) => {
+	if (perms.has(player, "myplugin.trail")) startTrail(player);
+});
+```
+
+`"change"` приходит, когда права игрока меняются: он зашёл, их изменила команда
+или редактор, или какое-то право закончилось.
+
+## Команды
+
+В консоли сервера и через rcon:
+
+```
+perms user <игрок|id> info
+perms user <игрок|id> group add <группа> [30d]
+perms user <игрок|id> group remove <группа>
+perms user <игрок|id> permission set <узел> [true|false] [30d]
+perms user <игрок|id> permission unset <узел>
+perms group <группа> create [вес]
+perms group <группа> delete | info
+perms group <группа> permission set <узел> [true|false] [30d]
+perms group <группа> permission unset <узел>
+perms group <группа> parent add|remove <группа>
+perms group <группа> weight <n>
+perms groups
+perms check <игрок|id> <узел>
+perms nodes [плагин]
+perms editor [close]
+perms reload
+perms import [users.ini]
+```
+
+Игрок - это `#userid`, часть ника или id записи (`STEAM_0:1:12345`). Срок -
+`45s`, `90m`, `12h`, `30d` или `2w`.
+
+В игре игрок с правом `perms.view` выполняет команды, которые только показывают, -
+`groups`, `check`, `nodes`, `user ... info` и `group ... info` - в своей
+консоли или в чате (`/perms groups`); ответ приходит в его консоль. Права
+меняются только из консоли сервера и в веб-редакторе.
+
+## Веб-редактор
+
+```
+perms editor
+[perms] Open the editor (an hour): https://amxts.github.io/modules/perms/editor#k3x9q2mw7a
+```
+
+Ссылка открывает права сервера в браузере: узлы каждого плагина с описаниями,
+колонка на каждую группу, группы, игроки. **Сохранить** отправляет изменения
+обратно; сервер применяет их за несколько секунд, без рестарта, а страница
+показывает, что он сделал.
+
+- Его открывает консоль сервера; из игры его не открыть.
+- Редактировать может любой, у кого есть ссылка, пока сессия жива: час или до
+  `perms editor close`. Храните её как пароль.
+- В редактор уходят группы, права, SteamID и ники. Пароли и адрес базы никогда
+  не покидают сервер.
+- Сессия хранится час на сервисе amxts. Чтобы хранить их у себя, запустите
+  хранилище из папки `store/` этого пакета (Cloudflare Worker) и укажите его
+  адрес в `PERMS_EDITOR_URL` в `.env`.
+
+## Вместо admin.amxx
+
+1. `npx amxts module add perms`, сборка и выкладка.
+2. Закомментируйте `admin.amxx` (или `admin_sql.amxx`) в `plugins.ini`. Пока
+   один из них работает, модуль оставляет флаги игроков ему и пишет об этом в
+   консоль.
+3. В консоли сервера: `perms import users.ini`. Каждый админ становится записью,
+   а его флаги - его личными правами `amxx.*`. Проверьте любого командой
+   `perms user <ник> info`.
+
+`users.ini` больше не читается; он остаётся, чтобы можно было вернуться.
+
+Pawn-плагины работают без изменений: модуль ставит каждому игроку флаги AMX Mod X
+из его узлов `amxx.*`, поэтому `get_user_flags`, `access`, `cmd_access`,
+`is_user_admin` и `cmdaccess.ini` видят права каждого игрока.
+Игрок без узлов `amxx.*` получает `amx_default_access` (`z`). Модуль держит и
+`amx_mode`, `amx_password_field`, `amx_default_access` и `amx_reloadadmins`,
+которыми пользуются конфиги сервера и плагины.
+
+| Узел | Флаг |
+| --- | --- |
+| `amxx.immunity` | `a` |
+| `amxx.reservation` | `b` |
+| `amxx.kick` | `c` |
+| `amxx.ban` | `d` |
+| `amxx.slay` | `e` |
+| `amxx.map` | `f` |
+| `amxx.cvar` | `g` |
+| `amxx.cfg` | `h` |
+| `amxx.chat` | `i` |
+| `amxx.vote` | `j` |
+| `amxx.password` | `k` |
+| `amxx.rcon` | `l` |
+| `amxx.levelA` ... `amxx.levelH` | `m` ... `t` |
+| `amxx.menu` | `u` |
+| `amxx.banTemp` | `v` |
+| `amxx.admin` | `y` |
+
+> [!WARNING]
+> **amx_mode**
+>
+> `amx_mode 2` кикает игрока без записи, как `admin.amxx`: закрытый сервер.
+> `amx_mode 0` никому ничего не даёт.
+
+Pawn-плагины могут проверять узлы сами: [PAWN.ru.md](PAWN.ru.md).
+
+## Настройки
+
+```ts
+export default defineConfig({
+	modules: ["@amxts/perms"],
+	perms: {
+		file: "perms",   // configs/perms.yaml
+		editor: "",      // хранилище редактора; PERMS_EDITOR_URL важнее
+	},
+});
+```
+
+## Лицензия
+
+MIT