//============================================================================// // // // ABOUT PLUGIN_CVAR (Version 1.0) // // // //============================================================================// This plugin was made to replace all of the plugins to set server cvars. The problem with the previous ones, were that each command was registered seperately, making for an extensive list of commands to remember. You also had to recompile if you wanted to change access levels for each command, and adding new commands was a pain. With this plugin, you just list which cvars you want to have access to and set their reqired access levels in an external file, and you're off and running. However, be careful how you configure this. It's a powerfull command, and if misconfigured, you could do something like give access to everyone to change sv_cheats or something like that :o) If you have any questions or Comments: Post it in adminmod scripting forum at http://www.ozforums.com/forumdisplay.php?s=&forumid=62. I check there often, and will try to get back to you ASAP. //============================================================================// // // // USAGE // // // //============================================================================// admin_cvar [|help|list|version] [value] admin_cvar help This this will show an ingame help line, in case you forget syntax, or want to know what options you have. Basically THIS usage section. admin_cvar list This will read through the configured cvars, and return a list that the calling user has access to run. admin_cvar version Simply displays the plugin version. admin_cvar [value] If you enter no value, it gets the current state of the cvar, and returns it back to, along with the help message defined in the file for that cvar. If you enter a cvar not on the list, or one you dont have access to, it will tell you so. //============================================================================// // // // CONFIGURING THE CVARS.INI FILE // // // //============================================================================// Here, you will define which cvars you want your admins to have access to. It is completely changeable, and any cvar that can be run from the server console/rcon can be defined. This means you can add all off the standard cvars, adminmod cvars, clanmod cvars, etc etc etc. Be carefull though, once you get up to 30 lines, the script will stop reading cvars. This can be changed by setting MAX_COMMANDS in the script file before compiling. The script will automatically ignore lines that start with ; or //. HOWEVER, IT DOES NOT RECOGNIZE MULTILINE QUOTES /* */. DO NOT USE THESE. SYNTAX: alias|Cvar|Access|Help (The delimiter (|) can be changed if you need to use it for one of your help lines. If you're carefull, you can use the delimiter character in the help line, as long as you make sure to fill in EVERYTHING ELSE for that line. If you dont, it will not recognize the line as being the incorrect format. Under most circumstances, if you accidentally leave out an option (such as access) the script will catch your mistake, and disregard the line. HOWEVER, BE VERY CAREFULL WHEN CONFIGURING THIS FILE!! I have also manually filtered out some commands that if run could just just mess up your server, but I'm sure I forgot some. PLEASE NOTE: The help line length is limited to 80 characters at the moment use them wisely. Anything beyond 80 will simply get clipped off. The command is actually called by the alias following the format "admin_cvar alias value". It compares the alias in your command to those in the file, and if it finds a match and your access matches that in the Acess column, it runs the Cvar. If you run the cvar without a value, it pulls the current value, and displays that along with the help string defined in the file. //============================================================================// // // // VERSIONS & RELEASE NOTES // // // //============================================================================// v1.0 First Release. //============================================================================// // // // CREDITS & THANKS // // // //============================================================================// Many, many, many thanks to sr71Goku for fixing and helping me figure out a lot of my bugs and problems with this plugin and for writing some code for me to base this plugin off of. To Cavey and Sharp for also contributing code and ideas in the forums. (Boy, I'm not so hot at writing documentation. heh.) ~Cheek