Skip to content

perms v0.1.0

Choose a tag to compare

@github-actions github-actions released this 28 Oct 16:52
· 18 commits to main since this release

The first release of Perms, for cores of the 0.3 line from 0.3.2.

Perms is a permissions module for amxts servers: it replaces AMX Mod X's admin.amxx with
permission nodes, groups and a web editor, the way LuckPerms does for Minecraft servers.
Pawn plugins keep working unchanged, because the module gives every player AMX Mod X's flags
from his amxx.* nodes.

👀 Highlights

🔑 Nodes, groups, weights

A permission is a node, kz.admin.kick. kz.admin.* gives everything under it, and
-kz.admin.wipe takes one away. Groups inherit from each other and have a weight; every player
is in default; and a player's own grants come before his groups. A grant or a group can last
30d and then go by itself, and on a shared database it can count on one server only.

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");
});

perms.addGroup(player, "vip", { for: 30 * 86400 });
perms.addEventListener("change", ({ player }) => refreshTag(player));

🌐 A web editor

perms editor in the server console prints a link. The page shows every plugin's permissions
with their descriptions, a column per group, and the groups and players. Saving sends the changes
back, and the server applies them within seconds, without a restart. Passwords and the database's
address never leave the server.

🗄️ A file or MySQL

The permissions live in perms.yaml, which you can edit by hand. Or, with PERMS_DB in .env,
they live in MySQL, shared by several servers, and a change on one reaches the others within five
seconds.

🧰 In place of admin.amxx

perms import users.ini turns AMX Mod X's admins into entries, with their flags as amxx.*
permissions. access, cmd_access, amx_mode, amx_password_field, amx_default_access and
amx_reloadadmins keep working. Pawn plugins can check nodes themselves through perms.inc:
perms_has, the groups, and the perms_changed forward.

Permissions change from the server console and in the editor. In the game, a player with
perms.view can look them up.

👉 Changelog

commits

🚀 Enhancements

  • Perms, permissions and groups for amxts servers (87bd13f)
  • Permissions change from the server console and the editor only (59bdf72)
  • The editor's store at perms-store.brokukaschannel.workers.dev (69dd613)
  • editor: The page is amxts.github.io/modules/perms/editor (9fba515)

🩹 Fixes

  • SteamIDs from the console, and say which file is read (5da51ef)
  • editor: Bots are not players (cc0b0e3)

❤️ Contributors