[list][*]PHP 4 or 5 ([url=http://www.php.net/manual/en/ini.core.php#ini.short-open-tag]short_open_tag must be enabled[/url])
[*]MySQL 4.1 or 5
[*][url=http://forums.eventscripts.com/viewtopic.php?f=90&t=39199]EventScripts CS:S Public Beta: OrangeBox v2.1.1.338[/url]
[*]Special Case for Windows Servers Only: If you do not trust my included wget.exe file, then grab it from here: http://gnuwin32.sourceforge.net/packages/wget.htm[/list]
This combination of ES Scripts and PHP scripts allows you and your fellow admins to ban players from ALL your servers in-game or out of game.
All bans are stored in a MySQL database on your webserver, no more need to mess with Valve's banned_users.cfg file!
I have encompassed as much as possible into the web front end as possible, much more will be added as time goes on. If you use steambans, then this script probably is not for you, this script was written for those that wish to maintain their own ban system.
Installation
[size=150][color=blue][b]Installation (Full Install):[/b] [/color][/size]
I have done my best to be as descriptive as possible with installation of this ban application. Either post or email if any step is unclear. It is assumed that you already have knowledge with MySQL and installing websites. [i]If you are upgrading, skip down to the upgrade section.[/i]
[b]Web Server (Full Install):[/b]
[list=1][*]Within the GlobalBan zip file, there is a ./banned/ folder. Save this folder to your webserver. If you save it to htdocs everything will be in htdocs/banned. You should then be able to access the web front end by going to yourdomain.com/banned. If you wish to use SMF integration, extract banned folder to your SMF folder.
[*]Once extracted, point your browser to http://www.yourdomain.com/banned/install.php and enter the input it asks for. (if you use an external web host, you may need to set file ./banned/config/class.Config.php and folder ./banned/demos/ as writables)
[*]Login and add set your configuration, add your servers (be carefull with the RCON mistakes).
[*](SMF users can skip this step) At this point you can get all your other "members" to create a user, but you will need to give them the basic user create code. This will create them as a basic user. You modify their level of admin rights on the webpages through the "Manage Admins" link. (This is an optional step if they wish to be able to add bans through the website).
[*]There are now multiple css style sheets in the css folder. Pick one you want by re-naming it to banned.css
[*]Before saving your configuration through the web, be sure to install and load the GlobalBan ES script[/list]
[i]Note: Make sure you have outgoing UDP/TCP port 27015 (or whatever port you server is on) open on your web server. This will require you to ask you web host to open the port.[/i]
[b]CS:S Orange Box Server (Full Install):[/b]
[list=1][*]Make sure ES 2.1 is installed.
[*]Within the GlobalBan zip file, there is an ./eventscripts/ folder.
[*]Save ./GlobalBan/ to your ./addons/eventscripts/ folder.
[*]Add all your admins/members through the web application (if you wish for them to be able to access the website you must have them sign up with the special "User Create Code" or other option is that a FullPower member registed all them using Admin->Users->Add New Admin and enter in an nickname, email address, Steam_ID for each of them and GlobalBan send them a email with the account password to login). Those flagged as "admin" or higher will be allowed to add bans right away, however members who add a ban greater than 1 day are placed in "pending" mode for review (config value determines if the banned person is banned during the pending period for X days; if X days is set to 0, the banned person can rejoin until the pending flag is removed).
[*]Add [b]es_load GlobalBan[/b] to your autoexec.cfg
[*]Restart your server OR exec the above two es_loads through rcon.
[*]Once on you CSS server and loaded, add the server(s) through the web and then click "Save Configuration" on the Configuration page. This will sync all of your CSS servers with the GlobalBan webapp. If you modified the Ban Reasons or Ban Lengths, be sure to save those as well.
[*]At this point, it is recommended to change maps or execute es_reload GlobalBan.
[*]All members can access the banmenu buy typing !banmenu in say.
[*]You may need to reload GlobalBan twice if you add an admin group with Mani or SourceMod powers.[/list]
[size=150][color=blue][b]Installation (Upgrade from 2.2+ to 3.4 r137):[/b] [/color][/size]
[b]Web Server (Upgrade):[/b]
[list=1][*]Point your browser to http://www.yourdomain.com/banned/upgrade.php, select the right upgrade option for you and click upgrade!
[*]The web upgrade is now complete![/list]
[b]CSS Server (Upgrade):[/b]
[list=1][*]Extract the new GlobalBan files into the GlobalBan folder.
[*]Delete es_GlobalBan.txt if it still exists
[*]Reload your admins through the webapp at the end of this upgrade guide if you are upgrading from 2.2
[*]You can now remove clan_db completely if you upgraded from 2.2.
[*]On the Configuration Page, do a "Save Configuration". On the Ban Reasons and Ban Lengths pages, do a "Save to CSS Servers".
[*]You may need to reload GlobalBan twice if you add an admin group with Mani or SourceMod powers.
[*]The upgrade is complete![/list]
[size=150][color=blue][b]Levels of Power:[/b] [/color][/size]
[b]Super User[/b] - Full access to the web site (setting up servers, managing admins) and full ban privs.
[b]Ban Manager[/b] - They can modify ALL bans and recieve email notifications for bans and/or demos and full ban privs.
[b]Admins[/b] - They can only modify their own bans only and have full ban privs (includes ip banning)
[b]Members[/b] - They can only modify their own bans, and any ban they do that is greater than 1 hour is placed in "pending mode" if you have the pending day variable > 0. If it's pending, the ban is only active for x days. If no action is taken (the pending not removed), the banned person is able to re-join the server after x days.
[b]This application has been tested on both Windows and Linux as well as on MySQL 4.1 and 5 and PHP 4 and 5. An work after CS:S Upgrade to Orange Box[/b]
[size=150][color=blue][b]FAQ:[/b] [/color][/size]
[b]Question: I get a blank page after running the install.php page, why?[/b]
Answer: This means the installer successfully installed the database tables and created your super-user, however, due to permissions with your webserver, it failed to write the class.Config.php file to the config directory. To fix this, copy or rename class.Config.php.sample to class.Config.php and manually edit that file to suit your needs. Next, set the permission of that file to 777 so that it can be saved to in the future.
[b]Question: After register on GB website, I join game and type in game chat: [i]!banmenu[/i] but answed me 'You are not a admin' and didnĀ“t display the ban menu, why?[/b]
Answer: Are you [b]create the Admin_Group[/b] with plugings and flags?
Ex: Clan_Members with GlobalBan admin flag and Mani_Admin_Pluging all flags.
Are you [b]Add[/b] each admin to each server assigned a Admin_Group or asigned a Group_Server to varios Server with the allows admin.
Ex: Create a Group_Servers "Publics" and click on "Admins", in the new page click on "Add All", select all check box and go down page on "Set selected admins to the following group" -> Select Ex: Clan_Members created on previous step and click "Set Selected to Group"
Change map or click "Save Users" in Admin->users after all this to changes take effect.
[b]Question: I banned a player from game and it shows up on the website, but they don't get kicked when they re-join, why?[/b]
Answer: Check the RCON that you are using and set in GB web. On Windows game server don`t forget that you need install the wget.exe and that some rented servers provider block files .exe (ask them about autorization to FTP upload the file). Check game console looking errors: invalid rcon or gb_config command imput when you click Save Config to Servers. Check if your game server have properly set the DNS servers and can resolve web URL. You did not read the installation instructions fully. There is a note right after step 6 of the web install (Ex: Firewall).
[b]Question: How I bind tha BanMenu to F12 keyboard key?[/b]
Answer: Type in console the next command: [b]bind "F12" "say !banmenu"[/b]
[b]Question: All of my db files in the GlobalBan folder are 0 bytes! Why?[/b]
Answer: This is an access issue on your webserver. Please make sure you have a .htaccess file setup correctly that allows appropriate access.
Version Notes For v3.4.1 r154
Updated on: 2011-05-15 14:49:44 EST by odonel (View Zip Contents)
[LIST]
[*]Fix some grammatical PHP errors in the code
[/LIST]