TITLE: HLC RCON MOD (HolyLandClan) VERSION: 5.2 UNITED OFFENSIVE PB-Enabled (you have to be running THE UNITED OFFENSIVE EXPANSION AND PunkBuster in order to use this version!) SCRIPTING: [HOLY] Moses {GEN}, [ADM] S1l3nt St4lk3r SCRIPTING SUPPORT: JOhn Whitten, a.k.a Whiplash COMPATIBILITY: Call of Duty (version 1.5): UNITED OFFENSIVE EXPANSION (version 1.51) WITH PUNKBUSTER with no additional mods that alter menu system. USER NOTE: Use this version of this UTILITY IF YOU ARE RUNNING A COD:UO ONLY SERVER. IF YOU HAVE BOTH COD AND COD:UO Servers, DOWNLOAD THE HLC_RCON_v5.2_COD_and_UO.zip VERSION OF THIS MOD INSTEAD! WORK WITH SV_PURE SERVER: See comments under TO INSTALL section. TESTED ON WINDOWS DEDICATED SERVER: YES. TESTED ON LINUX DEDICATED SERVER: YES. ****MODIFICATIONS TO THIS UTILITY SHOULD BE MADE IN ACCORDANCE WITH THE USER_LICENSE.TXT FILE INCLUDED WITH THIS MOD!*** ***Your use of this mod implies consent to the comments in the USER_LICENSE.TXT file****** ***************************************************************************************************************************************** THIS IS A CLIENT-AND-SERVER-SIDE MOD! You do need to install the HLC RCON mod on your server AND on any client that has rcon access and wants to use the menu system. If this pak3 file is not stored in the server's \MAIN folder, users will not have access to it. ***************************************************************************************************************************************** ***************************************************************************************************************************************** TO INSTALL: THIS SECTION HAS BEEN UPDATED> MAKE SURE YOU READ IT! *****If you are using a previous version of this mod, delete the pak3 file associated with it AND the HLCRCON.CFG file (if present).**** **NOTE: If you are going to configure the Custom Map section (optional), REVIEW THE CUSTOM MAP SETUP SECTION BELOW BEFORE INSTALLING!** 1. Zipped archive contains 1 (one) .pk3 files titled "zzz_HLCRCON_v5.2_UO_ONLY.pk3, 1 (one) textfile titled "USER_LICENSE.TXT", this readme.txt file, and the following .cfg files: -resetall.cfg -nosnipers.cfg -snipersonly.cfg -riflesonly.cfg 2. Save the "zzz_HLCRcon_v5.2_UO_ONLY.pk3" pak file to the Call of Duty \UO directory (NOT THE /MAIN DIRECTORY) on the Game Server AND on the client. The client MUST ALSO HAVE the the mod in their \UO folder in order to have access to it! *If you do not have access to the files on your game server, then you need to contact your admin to upload the file. *If you do not wish your clients to be able to download this utility, then modify the pk3 file name to include _svr_: zzz_HLCRcon_v5.2_UO_ONLY-svr_.pk3 3. Upload the .cfg files to the server's COD\UO directory. You may edit these files if you wish, but they can (and probably should) be used as-is. YOU MUST DO THIS IN ORDER TO USE THE WEAPON SHORTCUT BUTTONS! 4. RESTART THE GAME SERVER. 5. On the client ONLY, open the UO_CONFIG_MP.CFG file located in the CoD\UO directory of the client PC with a text editor and copy/paste the following line at the very end of the file: seta rconpassword "" 6. Re-save the file. You DO NOT NEED TO TYPE ANYTHING IN THE QUOTES. Do NOT MODIFY your desktop shortcut for CoD. MAKE SURE YOU COPY AND PASTE the text exactly as it is written above! 7. YOU MUST DO THIS TO AVOID RECEIVING ERROR MESSAGES OF "BAD RCONPASSWORD"! ***ON FIRST STARTUP: Open the HLC RCON Menu from the CoD Main Menu. Click on SET RCONPASSWORD and type your password in the box provided and click OK. Connect to your server and re-open the HLC RCON menu. Open the SERVER SETTINGS submenu and click on the SERVER STATUS button. **********CUSTOM MAP SETUP******************CUSTOM MAP SETUP*********************************************************************** CUSTOM MAP SETUP: (this must be done BEFORE loading the pak files onto the server!) 1. OPEN THE zzz_HLCRcon_v5.2_cod_uo.pk3 FILE WITH A PAK3 FILE EDITOR (LIKE PAKSCAPE). 2. Navigate to the ui_mp\scriptmenus\ directory. 3. Locate and save the mapcontrol.menu file to your desktop. 4. Open the mapcontrol.menu file from your desktop with a text editor (Araneae or MS Notepad). Scroll down to the CUSTOM MAP SETUP section. 5. REPLACE EACH INSTANCE OF "custom1","custom2","custom3", ETC. WITH YOUR MAP NAME FOR EACH ITEMDEF. FOR EXAMPLE, IF YOU WANT TO MAKE THE CUSTOM MAP "NEUNEN" THE FIRST CUSTOM MAP BUTTON, THEN REPLACE EVERY INSTANCE OF . "custom1" WITH THE MAP CALL-NAME FOR "NEUNEN". 6. RESAVE FILE and copy it to the pk3 file. Resave the pak file and then follow the installation instructions above. **********CONFIG FILE SETUP******************CONFIG FILE SETUP*********************************************************************** In order to use the Weapon Settings Shortcut buttons in the HLC RCON Utility (No Snipers, Snipers Only, etc), the .cfg filesincluded in this .zip archive must be loaded to the COD\UO directory . If you want to edit the files, they can be edited with a text editor such as the one you're using to read this. **********SERVER CONFIG FILE SETUP******************SERVER CONFIG FILE SETUP*********************************************************************** CUSTOM SERVER CONFIG SETUP: (this must be done BEFORE loading the pak files onto the server!) THIS STEP IS PERFORMED BY THE PRIMARY ADMIN OF YOUR CALL OF DUTY/COD:UO SERVER. If you are only an RCON admin, you must obtain the edited pak3 file from your PRIMARY SERVER ADMIN. 1. OPEN THE PAK3 FILE THAT YOU WANT TO EDIT WITH A PAK3 FILE EDITOR (LIKE PAKSCAPE). SPECIFICALLY, IF YOU WANT TO SETUP CUSTOM SERVER CONFIG BUTTONS for COD:UO, then open the zzz_HLCRcon_v5_cod_uo.pk3 file. If you want to setup custom server config buttons for COD (original), then open the zzz_HLCRcon_v5_cod_main.pk3 file. 2. Navigate to the ui_mp\scriptmenus\ directory. 3. Locate and save the mapcontrol.menu file to your desktop. 4. Open the mapcontrol.menu file from your desktop with a text editor (Araneae or MS Notepad). Scroll down to the CUSTOM SERVER CONFIG SETUP section. 5. REPLACE EACH INSTANCE OF "customconfig1","customconfig2","customconfig3", ETC. WITH YOUR SERVER CONFIG NAME FOR EACH ITEMDEF. FOR EXAMPLE, IF YOU WANT YOU HAVE AN ALL PRIVATE SLOTS CONFIG, AND YOU WANT TO BE ABLE TO EXEC THIS CONFIG BY HITTING THE CONFIG 1 BUTTON, THEN REPLACE EVERY INSTANCE OF "customconfig1" WITH THE server config CALL-NAME FOR your all-private-slots config file. Example: "private" ***************************************************************************************************************************************** USAGE: THIS SECTION HAS BEEN UPDATED> MAKE SURE YOU READ IT! The User must have admin control over the server (i.e. know the rcon password). I have assumed that users have at least fundemental knowledge of how RCON commands work. This version of the HLC RCON Utility was written specifically for admins who play ONLY on a COD:UO server. IF you run both COD and COD:UO servers, then download the BOTH GAMES version of this update. The HLC RCON Menu is accessible from the Call of Duty Main screen, and the ESC menu. If you are currently connected to a server, a "BACK TO GAME" option will appear at the bottom of each menu. By clicking on that, all menus will close and your game screen will return. *NOTE* When issuing commands through the interface (i.e., clicking on buttons) be sure to close the console window before doing so. The interface will not accept commands if the console window is open. If the server does not return a status and gives you a "bad rconpassword" warning, review your installation. Most likely, you did not edit the CONFIG_MP.CFG file correctly, did not enter your rconpassword, or you entered the wrong rconpassword. If the server does return the server status, then your installation was successful and all other commands will work. ***************************************************************************************************************************************** KNOWN ISSUES: 1) The game will not accept commands from the HLC RCON menu system if the console window is OPEN. Don't ask me why, just believe me. You must close the console window to interact with the HLC RCON menu system. 2) If you use one of the WEAPON SHORTCUTS (NO SNIPERS, RIFLES ONLY, RESET ALL), The weapon shortcut buttons send several consecutive commands to the server with one click. This WILL TAKE SEVERAL MOMEMTS. Do not try to access other menu features or send rcon commands until the confirmation message is broadcasted. 3) When changing a setting, ALWAYS wait for the confirmation message before sending another command! 4) If you have general questions about RCON commands and how to use them, please post your questions in a web-forum like www.frankenworks.com (my support site) or www.codadmin.com If a console command does not work via the HLC RCON menu but does work using a typed console entry, then email moses@frankenworks.com 5) Since this version of the HLC RCON mod is PunkBuster-Enabled, please keep in mind that the client slot numbers generated by the PunkBuster pb_sv_plist command (and the corresponding HLC RCON button labeled "PLAYER LIST" are "/rcon status" slot numbers +1. That is, if you typed /rcon status in the console, your client number may be 1, but when you click on the PLAYER LIST button to obtain the player list as generated by Punkbuster, your client number is 2. 6) ALL COMMANDS IN THIS VERSION HAVE BEEN COVERTED TO THEIR PUNKBUSTER COUNTERPARTS WHEN AVAILABLE. For example, instead of the ClientKick buttons sending the "/rcon clientkick [slot#]" command, they now send the "/rcon pb_sv_kick [slot#]" command. KEEP THIS IN MIND SO YOU DON'T KICK OR BAN THE WRONG PLAYERS!!!! ***************************************************************************************************************************************** CONTACT: moses@frankenworks.com WEBSITE: www.frankenworks.com (Admin support site, tailoring to LINUX server admins. Still under construction, but functional) EMAIL: moses@frankenworks.com MAIN DISCUSSION FORUMS: http://www.frankenworks.com (go here first. This is our primary admin support site, especially for LINUX admins) http://www.codadmin.com Look for future versions to have enhanced features. ***************************************************************************************************************************************** MODIFICATION HISTORY: 5.2: -Reconfigured FriendlyFire, Avatar, and KillCam functions to utilize non-read-only CVARs -Added 4 more customizable Custom Map buttons, bringing the total to 20 -Added map buttons for the new maps Tigertown (COD 1.5), Streets, Peaks, as well as the converted COD stock maps (UO Dawnville, etc) -Added ENABLE/DISABLE ALL JEEPS to Weapons/Vehicles menu -Added ENABLE/DISABLE ALL TANKS to Weapons/Vehicles menu -Added 5 customizable Server Config buttons to exec different server.cfg files with a "click" 5.1: UO-Only version specific modifications: -Added menus for accessing the HLC RCON prior to selecting team. The 5.0 UO Only version was missing specific menus that allowed the admin to access the HLC RCON utility while in spectator mode. 5.0: -Updated for compatibility with Call of Duty: United Offensive expansion. -Redesigned mapcontrol.menu to support all stock maps, plus added 15 customizable custom map buttons -Updated serversettings.menu to support UO cvars -updated weaponcontrol.menu to support UO weapons and vehicles -updated interface -updated ESCAPE menu access .menu's. -misc other things 4.1.41 Stock: For Call of Duty v1.4 -Fixed syntax command for NEXT MAP button in MAP CONTROL submenu. Thanks to TOMMYNATOR from CoDAdmin forums for pointing out the mistake. 4.1.4 Stock: For Call of Duty v1.4 -UPDATED HLC Rcon utility command system to use PunkBuster commands when available. Example: The Client Kick section now sends "/rcon pb_sv_kick [slot#]" instead of the CoD default "/rcon clientkick [slot#]". Banning commands have been replaced also. Also, the PLAYER LIST buttons now replace the old SERVER STATUS buttons in previous HLC RCON versions. -Added support for PB_SV_Banlist -Added support for PB_SV_BanEmpty -Replaced ClientKick with PB_SV_Kick command and made all kicks for 5 minutes -Replaced TempBanClient with PB_SV_Kick command but with a duration of 4 hours -Replaced BanClient with PB_SV_BAN command -Replaced all Server Status buttons with PLAYER LIST buttons to use the PB_SV_PLIST command to obtain accurate slot #'s for use with new PB commands -Added NEUVILLE and BOCAGE map support to Map Control submenu, SPECIAL THANKS TO TOM CRAMER, aka "S1l3nt St4lk3r" -Added STALINGRAD map support to Map Control submenu -Increased "WAIT" time between consecutive commands to prevent servers from ignoring second-string commands -Updated interface, headings, etc -Updated Broadcast Messages selections 4.1 Stock: For Patched Call of Duty v1.2 -Removed YES/NO switchboxes from Weapon Control submenu. Patched game was not sending correct weapon availibilty data back to client. replaced with OFF&ON boxes. -Increased WAIT time between consecutive statements to help prevent rcon commands from being skipped. 4.0 Stock: For Patched Call of Duty v1.2 (not released publicly) -All modifications of 3.2 Stock -Removed QUICKMESSAGES access, added access through ESC menu shortcut via the HLC RCON v4.0 tab. NOW ACCESSIBLE ALL THE TIME! ROCK ON! -Added support for Temporary Banning (up to 34 clients) -Added support for Permanent Banning (up to 34 clients) -Added support for Temporary Ban Duration (15 min, 30 min, 45 min, 60 min, 6 hours, 24 hours) -Added support for KILLCAM ENABLE/DISABLE -Added support for FREE SPECTATE ENABLE/DISABLE -Added support for ENEMY SPECTATE ENABLE/DISABLE -Added support for AUTO BALANCE ENABLE/DISABLE -Added support for FRIENDLY FIRE setting #3 (Shared damage) 3.2 Custom PRM: -Modified HLC RCON MENU to accomodate most PRM controls and settings. 3.2 Stock: For Call of Duty v1.1 (not released publicly) -Added color to BROADCAST messages. -Fixed bug with BAR weapon control. Version 3.1, BAR would not re-activate correctly because of scripting error. -Redesigned layout.Totally. -Added functions to control Call Vote and other settings. -Added shortcuts to disable all snipers, for Rifles only mode, and RESET ALL WEAPONS. -HLC RCON Menu system now broadcasts changed settings. 3.1: For Call of Duty v1.1 -Redesigned WEAPON CONTROL menu: Now menu lets user know the current status of each weapon (Allow? yes/no). Easier to turn them on/ off. -Added back ingame access through QUICKMESSAGE MENU ("v" key), then by pressing "4". HLC RCON Menu is still available thru MAIN menu. 3.0: For Call of Duty v1.1 -Eliminated the necessity of using the QUICKMESSAGES window by adding a MAIN menu option to load the RCON menu. Now available at all times. -Eliminated "MINIMIZE" buttons and Added "BACK TO GAME" buttons that appear on RCON MENU and it's submenus to immediately close the RCON controls and return the user to the game. BACK TO GAME buttons only appear if the user is currently connected to a server. 2.0: For Call of Duty v1.1 -Created "mini" QUICKMESSAGES window. Menu can be called up using 'V' then left up while playing. -Added MINIMIZE buttons to minimize HLC RCON to mini-quickmessages window. Removed EXIT buttons. -Increased Clientkick feature to support 34 total clients. -Standardized button layouts/borders/etc, cleaned up interface. 1.1: For Call of Duty v1.1 Added FG42 control to WEAPONS CONTROL submenu; switched OFF/ON buttons for AVATAR control. ***************************************************************************************************************************************** HELP/THANKS: RUDEDOG at WWW.CODADMIN.COM for his outstanding support of my work! Thanks! ALOU at WWW.CODCOMMAND.COM for his support, and for lending me admin privileges on his server to Test versions 4.0 and 4.1. Thanks to Alou, version 4.1 was released on-schedule! MOMMA at CoDAdmin.com for moderating our forum section there, answering questions, and doing a great job! Thanks Momma! SPECIAL THANKS TO TOM CRAMER, aka "S1l3nt St4lk3r" for adding Neuville and Bocage Map support! TABOOMAN for adding the fundamental scripting for a DEMO RECORDING submenu. Unfortunately, the game engine places a limit on how many in-game menus can be cached, so this menu was not included in this release. COTTO1984 for pointing out the BAR control bug to me. VALOCHE for pointing out the HLC menu is less interfering if set at #4 on the QUICKMESSAGE window so as not to screw up users' quick binds or memories! CYBERDOC for being a helpful community member of Frankenworks.com! Thanks bro! The Admins and moderators at CODADMIN.COM (AADiC, RudeDog), ALOU at (CODCOMMAND.COM; now also a HOLY!), and RUGGBUTT at CALLOFDUTY.ORG for supporting the release and distribution of the mod. Everyone who has already downloaded the mod and is using it, and to those that have provided thoughtful suggestions!