amxmodx/plugins/adminhelp.sma

/* AMX Mod X
*   Admin Help Plugin
*
* by the AMX Mod X Development Team
*  originally developed by tcquest78
*
* This file is part of AMX Mod X.
*
*
*  This program is free software; you can redistribute it and/or modify it
*  under the terms of the GNU General Public License as published by the
*  Free Software Foundation; either version 2 of the License, or (at
*  your option) any later version.
*
*  This program is distributed in the hope that it will be useful, but
*  WITHOUT ANY WARRANTY; without even the implied warranty of
*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
*  General Public License for more details.
*
*  You should have received a copy of the GNU General Public License
*  along with this program; if not, write to the Free Software Foundation,
*  Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
*  In addition, as a special exception, the author gives permission to
*  link the code of this program with the Half-Life Game Engine ("HL
*  Engine") and Modified Game Libraries ("MODs") developed by Valve,
*  L.L.C ("Valve"). You must obey the GNU General Public License in all
*  respects for all of the code used other than the HL Engine and MODs
*  from Valve. If you modify this file, you may extend this exception
*  to your version of the file, but you are not obligated to do so. If
*  you do not wish to do so, delete this exception statement from your
*  version.
*/

#include <amxmodx>

#define DISPLAY_MSG // Comment to disable message on join
#define HELPAMOUNT 10 // Number of commands per page

public plugin_init() {
  register_plugin("Admin Help",AMXX_VERSION_STR,"AMXX Dev Team")
  register_dictionary("adminhelp.txt")
  register_concmd("amx_help","cmdHelp",0,"<page> [nr of cmds (only for server)] - displays this help")
}

#if defined DISPLAY_MSG
public client_putinserver(id) {
  if (is_user_bot(id))
	return
  set_task(15.0,"dispInfo",id)
}

public client_disconnect(id) {
	remove_task(id)
}
#endif

public cmdHelp(id,level,cid) {
	new arg1[8], flags = get_user_flags(id)
	new start = read_argv(1,arg1,7) ? str_to_num(arg1) : 1

	new lHelpAmount = HELPAMOUNT
	if (id == 0 && read_argc() == 3)
		lHelpAmount = read_argv(2, arg1, 7) ? str_to_num(arg1) : HELPAMOUNT

	if (--start < 0)
		start = 0

	new clcmdsnum = get_concmdsnum(flags,id)

	if (start >= clcmdsnum)
		start = clcmdsnum - 1

	console_print(id,"^n----- %L -----",id,"HELP_COMS")
	new info[128], cmd[32], eflags
	new end = start + lHelpAmount // HELPAMOUNT

	if (end > clcmdsnum)
		end = clcmdsnum

	for (new i = start; i < end; i++) {
		get_concmd(i,cmd,31,eflags,info,127,flags,id)
		console_print(id,"%3d: %s %s",i+1,cmd,info)
	}
	console_print(id,"----- %L -----",id,"HELP_ENTRIES",start+1,end,clcmdsnum)

	if (end < clcmdsnum)
		console_print(id,"----- %L -----",id,"HELP_USE_MORE",end+1)
	else
		console_print(id,"----- %L -----",id,"HELP_USE_BEGIN")

	return PLUGIN_HANDLED
}

#if defined DISPLAY_MSG
public dispInfo(id) {
  client_print(id,print_chat,"%L",id,"TYPE_HELP")
  new nextmap[32]
  get_cvar_string("amx_nextmap",nextmap,31)
  if (get_cvar_float("mp_timelimit")) {
    new timeleft = get_timeleft()
    if (timeleft > 0) {
      client_print(id,print_chat, "%L" , id, "TIME_INFO_1", timeleft / 60, timeleft % 60,nextmap)
    }
    else {
      client_print(id,print_chat,"%L",id,"TIME_INFO_2",nextmap)
    }
  }
}
#endif