[b][size=20pt]Orpheon's Hosting Utilities[/size][/b]

[b][size=12pt]Description:[/size][/b]
I've noticed that there is no server-mod anymore, because both Vindicator and Ajf (and Artemis) decided to discontinue their mods.
This is not a very good thing, since there are several features that are easy to code and very useful for hosting yet do not exist in the standard gg2 for various reasons (like kicking).

That's why I've decided to make my own.

It features kicking, banning, classlimits, plugin support, map changing, chat, rcon and the newest version of the Tempest Bot.


[b][size=12pt]Command List and the Console:[/size][/b]

The console is in the bottom-left of your screen. You can activate/desactivate it pressing Enter.
When you type a command, add arguments like this:
[code]myCommand -arg1 -arg2 -arg3[/code]

Rcon commands must simply be preceded with "rcon ", like this:
[code]rcon addBot -red -pyro[/code]

You can make some commands execute automatically once you host/join a server. To do this, create a text file called "autoexec.txt" inside your OHU Directory.
Then, inside, mark your commands with the following syntax:
[code]addBot -red -pyro|chat|Hello, I'm your host|/exit[/code]
(This is an example, of course)


-The current Command List-
[spoiler]
[i]addBot -team -class[/i]
team can be: -red, -blue or -blu
class can be: -scout, -runner, -soldier, -rocketman, etc...
This adds a bot to the game of the given team and class, obviously.
Warning: It will not work in Dynamic Mode, this is intended.

[i]removeBot[/i]
Removes the last bot created.

[i]kick -playerName[/i]
Kicks the player with that name.

[i]ban -playerName[/i]
Writes the IP of that player to a file called "banlist.txt" and kicks the player.
When a player joins, the game first checks whether that IP was banned, if yes it refuses the connection and sends a small message to the console.

[i]showIP -playerName[/i]
Writes the players IP to the console.

[i]nextMap[/i]
Ends the game with a Stalemate and goes to the next map.

[i]changeMap -mapName[/i]
Ends the game with a Stalemate and goes to the map of your choice. After that map is finished the game will continue where it left off in your rotation.

[i]chat[/i]
Starts Chat mode. Details below.

[i]help[/i]
Shows a list of all the available commands, including plugins.
Was mostly included as a test.

[i]setCrossTeamChat -on/off[/i]
What it says; it lets different teams all chat together.

[i]setRconPass -password[/i]
Sets the rcon password.
[b]This must imperatively be done at the start of the match![/b]

[i]rconPass -password[/i]
This is how the client tries to become a rcon, by typing this.[/spoiler]


[b][size=12pt]Plugins, how to use and how to make them:[/size][/b]

I used the .spy extension on wish of a few members, but the plugins are still a normal text.
To use plugins, just put the plugin into the folder "Plugins" and it should get automatically loaded.

To make plugins, just write the code in GMK, paste it into Notepad/Gedit/whathaveyou and give it the extension .spy

I defined two commands that are useful for the making of plugins: print(string), which displays a message to the console; and addCommand(name, command), which adds a command to the list.


[b][size=12pt]Plugin List:[/size][/b]

[b]Warning: I do not guarantee that any of these plugins work or do not break OHU.[/b]
[url=http://www.ganggarrison.com/forums/index.php?action=dlattach;topic=28839.0;attach=10776]Damage Indicator[/url]
[url=http://www.ganggarrison.com/forums/index.php?action=dlattach;topic=28839.0;attach=10779]Taunt-heal[/url]
[url=http://www.ganggarrison.com/forums/index.php?action=dlattach;topic=28839.0;attach=10774]Bullet Coloration[/url]
[url=http://www.ganggarrison.com/forums/index.php?action=dlattach;topic=28839.0;attach=10777]FPS Indicator[/url]
[url=http://www.ganggarrison.com/forums/index.php?action=dlattach;topic=28839.0;attach=10778]Sprite Loader[/url]+[url=http://www.ganggarrison.com/forums/index.php?action=dlattach;topic=28839.0;attach=10775]The default sprites[/url]
[url=http://www.ganggarrison.com/forums/index.php?action=dlattach;topic=28839.0;attach=10810]Hat Loader[/url]+[url=http://www.ganggarrison.com/forums/index.php?action=dlattach;topic=28839.0;attach=10809]Hap Sprites[/url]


[b][size=12pt]Rcon and you:[/size][/b]

The first thing a hoster should do is define a rcon password. This is done by typing
[code]setRconPass -my_very_secret_password[/code]

Clients can then connect using
[code]rconPass -the_secret_password[/code]

A rcon client can do everything the host can.
Beware: Error messages will appear on the hosts console, because I haven't made a system to convey them back yet.
Be careful to type your commands correctly.

A rcon will have a light-blue colored chat text.


[b][size=12pt]The Chat:[/size][/b]

You can activate the chat mode by typing "chat" inside the console.

By pressing "u" everything you type will be for your team only, and by pressing "y" you'll let everyone know.

Default is private chat.

The host will always have a yellow text color for everyone, and rcons light-blue text.
Else simply the team color, with green for Spectators.

If the host wants to kick someone from the chat, type in chat mode "/kick -playerName".

NOTE: It's possible, if you do a bit of research in the source, for a client to send text in about every color.
You don't even need to modify anything. So don't be surprised if suddenly the chat gets colorful.


[b][size=12pt]Credits:[/size][/b]

   -I ripped several parts from TTS, most notably the console itself, as well as a few algorithms. Credit to ajf.
   -I ripped a bit of the design concept from the Artemis chat into my own. I'm talking about the chat background. I made it myself, but I ...inspired myself from Artemis.

[b]Also Huge thanks to:
[list]
[li]Derp(new)
[/li][li]Goodness and Light[/li]
[li]Jazzi
[/li][li]Gangsterman
[/li][li]CrazNoDooder
[/li][li]ViP3R
[/li][li]Muse
[/li][li]rolfcake
[/li][li]Trog (also known as gorT)
[/list]

for bug-testing and various small helps.


[b][size=12pt]Download:[/size][/b]
[url=http://www.mediafire.com/?42ycf8ya5o4749u]The exe[/url]
[url=http://www.mediafire.com/?69y2cg945ek78cy]The zip (for people with oversensitive Anti-virus)[/url]
[url=http://www.mediafire.com/?rvphn5p2kaqghfg]The source (as gmk)[/url]
[url=http://git://github.com/Orpheon/Gang-Garrison-2.git]The source (at GitHub)[/url]


[b][size=12pt]A hilarious example of the Tempest Bot, provided by rolfcake:[/size][/b]
[spoiler][flash=640,480]http://www.youtube.com/watch?v=X_niZgRAqCk&feature=player_detailpage[/flash][/spoiler]
And yeah, you can do this with Scouts, Pyros, Soldiers, Heavies, Medics, Engineers, Snipers and any combination of those!
More information on the Tempest Bot can be found [url=http://www.ganggarrison.com/forums/index.php?topic=25580.0]here[/url].


[b]This is a WIP, I can still use help.[/b]
Plugins, Questions, Requests, Bug Reports and Ideas are very appreciated


PS: Moved because Haxxy ended.