// vim: set ts=4 sw=4 tw=99 noet: // // AMX Mod X, based on AMX Mod by Aleksander Naszko ("OLO"). // Copyright (C) The AMX Mod X Development Team. // // This software is licensed under the GNU General Public License, version 3 or higher. // Additional exceptions apply. For full license details, see LICENSE.txt or visit: // https://alliedmods.net/amxmodx-license #if defined _amxmisc_included #endinput #endif #define _amxmisc_included #if !defined _amxmodx_included #include #endif stock is_user_admin(id) { new __flags = get_user_flags(id); return (__flags > 0 && !(__flags & ADMIN_USER)); } stock cmd_access(id, level, cid, num, bool:accesssilent = false) { new has_access = 0; if (id == (is_dedicated_server() ? 0 : 1)) { has_access = 1; } else if (level == ADMIN_ADMIN) { if (is_user_admin(id)) { has_access = 1; } } else if (get_user_flags(id) & level) { has_access = 1; } else if (level == ADMIN_ALL) { has_access = 1; } if (has_access == 0) { if (!accesssilent) { console_print(id, "%L", id, "NO_ACC_COM"); } return 0; } if (read_argc() < num) { new hcmd[32], hinfo[128], hflag; get_concmd(cid, hcmd, charsmax(hcmd), hflag, hinfo, charsmax(hinfo), level); console_print(id, "%L: %s %s", id, "USAGE", hcmd, hinfo); return 0; } return 1; } stock access(id, level) { if (level == ADMIN_ADMIN) { return is_user_admin(id); } else if (level == ADMIN_ALL) { return 1; } return (get_user_flags(id) & level); } /** * Flags related to cmd_target: * 1 - obey immunity * 2 - allow yourself * 4 - must be alive * 8 - can't be bot */ #define CMDTARGET_OBEY_IMMUNITY (1<<0) #define CMDTARGET_ALLOW_SELF (1<<1) #define CMDTARGET_ONLY_ALIVE (1<<2) #define CMDTARGET_NO_BOTS (1<<3) stock cmd_target(id, const arg[], flags = CMDTARGET_OBEY_IMMUNITY) { new player = find_player("bl", arg); if (player) { if (player != find_player("blj", arg)) { console_print(id, "%L", id, "MORE_CL_MATCHT"); return 0; } } else if ((player = find_player("c", arg)) == 0 && arg[0] == '#' && arg[1]) { player = find_player("k", str_to_num(arg[1])); } if (!player) { console_print(id, "%L", id, "CL_NOT_FOUND"); return 0; } if (flags & CMDTARGET_OBEY_IMMUNITY) { if ((get_user_flags(player) & ADMIN_IMMUNITY) && ((flags & CMDTARGET_ALLOW_SELF) ? (id != player) : true)) { new imname[MAX_NAME_LENGTH]; get_user_name(player, imname, charsmax(imname)); console_print(id, "%L", id, "CLIENT_IMM", imname); return 0; } } if (flags & CMDTARGET_ONLY_ALIVE) { if (!is_user_alive(player)) { new imname[MAX_NAME_LENGTH]; get_user_name(player, imname, charsmax(imname)); console_print(id, "%L", id, "CANT_PERF_DEAD", imname); return 0; } } if (flags & CMDTARGET_NO_BOTS) { if (is_user_bot(player)) { new imname[MAX_NAME_LENGTH]; get_user_name(player, imname, charsmax(imname)); console_print(id, "%L", id, "CANT_PERF_BOT", imname); return 0; } } return player; } /** * Standard method to show activity to clients connected to the server. * This depends on the amx_show_activity cvar. See documentation for more details. * * @param id The user id of the person doing the action. * @param name The name of the person doing the action. * @param fmt The format string to display. Do not put the "ADMIN:" prefix in this. * * @noreturn */ stock show_activity(id, const name[], const fmt[], any:...) { static __amx_show_activity; if (__amx_show_activity == 0) { __amx_show_activity = get_cvar_pointer("amx_show_activity"); // if still not found, then register the cvar as a dummy if (__amx_show_activity == 0) { __amx_show_activity = register_cvar("amx_show_activity", "2", FCVAR_PROTECTED); } } new prefix[10]; if (is_user_admin(id)) { copy(prefix, charsmax(prefix), "ADMIN"); } else { copy(prefix, charsmax(prefix), "PLAYER"); } new buffer[512]; vformat(buffer, charsmax(buffer), fmt, 4); switch (get_pcvar_num(__amx_show_activity)) { case 5: // hide name only to admins, show nothing to normal users { for (new i = 1; i <= MaxClients; i++) { if (is_user_connected(i)) { if (is_user_admin(i)) { client_print(i, print_chat, "%L: %s", i, prefix, buffer); } } } } case 4: // show name only to admins, show nothing to normal users { for (new i = 1; i <= MaxClients; i++) { if (is_user_connected(i)) { if (is_user_admin(i)) { client_print(i, print_chat, "%L %s: %s", i, prefix, name, buffer); } } } } case 3: // show name only to admins, hide name from normal users { for (new i = 1; i <= MaxClients; i++) { if (is_user_connected(i)) { if (is_user_admin(i)) { client_print(i, print_chat, "%L %s: %s", i, prefix, name, buffer); } else { client_print(i, print_chat, "%L: %s", i, prefix, buffer); } } } } case 2: // show name to all { client_print(0, print_chat, "%L %s: %s", LANG_PLAYER, prefix , name , buffer); } case 1: // hide name to all { client_print(0, print_chat, "%L: %s", LANG_PLAYER, prefix, buffer); } } } /** * Standard method to show activity to one single client. * This is useful for messages that get pieced together by many language keys. * This depends on the amx_show_activity cvar. See documentation for more details. * * @param idtarget The user id of the person to display to. 0 is invalid. * @param idadmin The user id of the person doing the action. * @param name The name of the person doing the action. * @param fmt The format string to display. Do not put the "ADMIN:" prefix in this. * * @noreturn */ stock show_activity_id(idtarget, idadmin, const name[], const fmt[], any:...) { if (idtarget == 0 || !is_user_connected(idtarget)) { return; } static __amx_show_activity; if (__amx_show_activity == 0) { __amx_show_activity = get_cvar_pointer("amx_show_activity"); // if still not found, then register the cvar as a dummy if (__amx_show_activity == 0) { __amx_show_activity = register_cvar("amx_show_activity", "2", FCVAR_PROTECTED); } } static prefix[10]; if (is_user_admin(idadmin)) { copy(prefix, charsmax(prefix), "ADMIN"); } else { copy(prefix, charsmax(prefix), "PLAYER"); } static buffer[512]; vformat(buffer, charsmax(buffer), fmt, 5); switch (get_pcvar_num(__amx_show_activity)) { case 5: // hide name only to admins, show nothing to normal users { if (is_user_admin(idtarget)) { client_print(idtarget, print_chat, "%L: %s", idtarget, prefix, buffer); } } case 4: // show name only to admins, show nothing to normal users { if (is_user_admin(idtarget)) { client_print(idtarget, print_chat, "%L %s: %s", idtarget, prefix, name, buffer); } } case 3: // show name only to admins, hide name from normal users { if (is_user_admin(idtarget)) { client_print(idtarget, print_chat, "%L %s: %s", idtarget, prefix, name, buffer); } else { client_print(idtarget, print_chat, "%L: %s", idtarget, prefix, buffer); } } case 2: // show name to all { client_print(idtarget, print_chat, "%L %s: %s", idtarget, prefix, name, buffer); } case 1: // hide name to all { client_print(idtarget, print_chat, "%L: %s", idtarget, prefix, buffer); } } } /** * Standard method to show activity to one single client with normal language keys. * These keys need to be in the format of standard AMXX keys: * eg: ADMIN_KICK_1 = ADMIN: kick %s * ADMIN_KICK_2 = ADMIN %s: kick %s * This depends on the amx_show_activity cvar. See documentation for more details. * * @param KeyWithoutName The language key that does not have the name field. * @param KeyWithName The language key that does have the name field. * @param __AdminName The name of the person doing the action. * @extra Pass any extra format arguments for the language key in the variable arguments list. * * @noreturn */ stock show_activity_key(const KeyWithoutName[], const KeyWithName[], const ___AdminName[], any:...) { // The variable gets used via vformat, but the compiler doesn't know that, so it still cries. #pragma unused ___AdminName static __amx_show_activity; if (__amx_show_activity == 0) { __amx_show_activity = get_cvar_pointer("amx_show_activity"); // if still not found, then register the cvar as a dummy if (__amx_show_activity == 0) { __amx_show_activity = register_cvar("amx_show_activity", "2", FCVAR_PROTECTED); } } new buffer[512]; new keyfmt[256]; new i; switch (get_pcvar_num(__amx_show_activity)) { case 5: // hide name to admins, display nothing to normal players { while (i++ < MaxClients) { if (is_user_connected(i)) { if (is_user_admin(i)) { LookupLangKey(keyfmt, charsmax(keyfmt), KeyWithoutName, i); // skip the "adminname" argument if not showing name vformat(buffer, charsmax(buffer), keyfmt, 4); client_print(i, print_chat, "%s", buffer); } } } } case 4: // show name only to admins, display nothing to normal players { while (i++ < MaxClients) { if (is_user_connected(i)) { if (is_user_admin(i)) { LookupLangKey(keyfmt, charsmax(keyfmt), KeyWithName, i); vformat(buffer, charsmax(buffer), keyfmt, 3); client_print(i, print_chat, "%s", buffer); } } } } case 3: // show name only to admins, hide name from normal users { while (i++ < MaxClients) { if (is_user_connected(i)) { if (is_user_admin(i)) { LookupLangKey(keyfmt, charsmax(keyfmt), KeyWithName, i); vformat(buffer, charsmax(buffer), keyfmt, 3); } else { LookupLangKey(keyfmt, charsmax(keyfmt), KeyWithoutName, i); // skip the "adminname" argument if not showing name vformat(buffer, charsmax(buffer), keyfmt, 4); } client_print(i, print_chat, "%s", buffer); } } } case 2: // show name to all users { while (i++ < MaxClients) { if (is_user_connected(i)) { LookupLangKey(keyfmt, charsmax(keyfmt), KeyWithName, i); vformat(buffer, charsmax(buffer), keyfmt, 3); client_print(i, print_chat, "%s", buffer); } } } case 1: // hide name from all users { while (i++ < MaxClients) { if (is_user_connected(i)) { LookupLangKey(keyfmt, charsmax(keyfmt), KeyWithoutName, i); // skip the "adminname" argument if not showing name vformat(buffer, charsmax(buffer), keyfmt, 4); client_print(i, print_chat, "%s", buffer); } } } } } stock colored_menus() { static ColoredMenus = -1; if (ColoredMenus == -1) { new const ModNames[][] = { "cstrike", "czero", "dmc", "dod", "tfc", "valve" }; new ModName[32]; get_modname(ModName, charsmax(ModName)); for (new Iterator = 0; Iterator < sizeof(ModNames); Iterator++) { if (equal(ModName, ModNames[Iterator])) { ColoredMenus = 1; break; } } if (ColoredMenus == -1) ColoredMenus = 0; } return ColoredMenus; } stock cstrike_running() { new mod_name[32]; get_modname(mod_name, charsmax(mod_name)); return (equal(mod_name, "cstrike") || equal(mod_name, "czero") || equal(mod_name, "csv15") || equal(mod_name, "cs13")); } stock is_running(const mod[]) { new mod_name[32]; get_modname(mod_name, charsmax(mod_name)); return equal(mod_name, mod); } stock get_basedir(name[], len) { return get_localinfo("amxx_basedir", name, len); } stock get_configsdir(name[], len) { return get_localinfo("amxx_configsdir", name, len); } stock get_datadir(name[], len) { return get_localinfo("amxx_datadir", name, len); } stock register_menu(const title[], keys, const function[], outside = 0) { register_menucmd(register_menuid(title, outside), keys, function); } /** * Backwards Compatibility * don't use it! */ stock get_customdir(name[], len) { return get_localinfo("amxx_configsdir", name, len); } /** * Add a menu item to Menus Front-End plugin ("amxmodmenu"). * * @param MENU_TEXT Text that will be shown for this item in menu. * @param MENU_CMD Command that should be executed to start menu. * @param MENU_ACCESS Access required for menu. * @param MENU_PLUGIN The exact case-insensitive name of plugin holding the menu command. * * @noreturn */ stock AddMenuItem(const MENU_TEXT[], const MENU_CMD[], const MENU_ACCESS, const MENU_PLUGIN[]) { AddMenuItem_call(MENU_TEXT, MENU_CMD, MENU_ACCESS, MENU_PLUGIN, false); } /** * Add a menu item to "amx_menu", that should also be accessible by non-admins. * * @param MENU_TEXT Text that will be shown for this item in menu. * @param MENU_CMD Command that should be executed to start menu. * @param MENU_ACCESS Access required for menu. * @param MENU_PLUGIN The exact case-insensitive name of plugin holding the menu command. * * @noreturn */ stock AddClientMenuItem(const MENU_TEXT[], const MENU_CMD[], const MENU_ACCESS, const MENU_PLUGIN[]) { AddMenuItem_call(MENU_TEXT, MENU_CMD, MENU_ACCESS, MENU_PLUGIN, true); } /** * Internal function used by above stocks. */ stock AddMenuItem_call(const MENU_TEXT[], const MENU_CMD[], const MENU_ACCESS, const MENU_PLUGIN[], const bool:ADD_TO_CLIENT_MENU) { new pluginid = is_plugin_loaded("Menus Front-End"); if (pluginid == -1) { log_amx("Can't add menu item ^"%s^" from plugin ^"%s^" to menu set because the Menus Front-End plugin itself is not loaded!", MENU_TEXT, MENU_PLUGIN); return; // Menus Front-End doesn't exist, return. } new filename[64], b[1]; get_plugin(pluginid, filename, charsmax(filename), b, charsmax(b), b, charsmax(b), b, charsmax(b), b, charsmax(b)); new status = callfunc_begin(ADD_TO_CLIENT_MENU ? "AddClientMenu" : "AddMenu", filename); new bool:failed = true; switch (status) { case 1: { failed = false; } case 0: { log_amx("Run time error! (AddMenuItem_call failed)"); } case -2: { log_amx("Function not found! (AddMenuItem_call failed)"); } case -1: { log_amx("Plugin not found! (AddMenuItem_call failed)"); } } if (failed) { return; } // Item text callfunc_push_str(MENU_TEXT); // Cmd callfunc_push_str(MENU_CMD); // Access callfunc_push_int(MENU_ACCESS); // Menu exists in this plugin callfunc_push_str(MENU_PLUGIN); callfunc_end(); } stock constraint_offset(low, high, seed, offset) { new numElements = high - low + 1; offset += seed - low; if (offset >= 0) { return low + (offset % numElements); } else { return high - (abs(offset) % numElements) + 1; } return 0; // Makes the compiler happy -_- } /** * Tells if the user has ANY of the provided flags. * * @param id Client index * @param flags Flag string * * @return 1 if the user has ANY of the provided flags, 0 otherwise */ stock has_flag(id, const flags[]) { return (get_user_flags(id) & read_flags(flags)); } /** * Tells if the user has ALL of the provided flags. * * @param id Client index * @param flags Flag string * * @return 1 if the user has ALL of the provided flags, 0 otherwise */ stock has_all_flags(id, const flags[]) { new FlagsNumber = read_flags(flags); return ((get_user_flags(id) & FlagsNumber) == FlagsNumber); } /** * Resets a client's menu. * * @note This is just a wrapper around show_menu for the sake of readability. * * @param index Client to reset menu to, use 0 to reset to all clients * * @noreturn */ stock reset_menu(index) { show_menu(index, 0, "", 0); }