crank
crank is a friendly IRC bot with the primary purpose of querying game servers and messaging the results into a channel. Other features include: supporting multiple servers, can auto-op friends, has the usual anti-flood and is really good at idling.
Basic
- List of all current triggers: !triggers
- List of all triggers for a channel: !<#channel>
- Query a server with a trigger: !<triggername> <modifier(s)>
- Custom query server: !query <protocol&modifier(s)> <ip1 ip2 ip3...>
Modifiers
- - = Hide players
- + = Show players
- < = Hide if no players
- > = Show if no players
- ~ = Show stats
- @ = /query you instead of messaging the channel
Examples
Display all #oztf triggers: !#oztf
Use a trigger: !s
Trigger with forced show players: !s +
Show players on the server but hide it if there are none: !s +<
Hide the server with no players and display stats: !s <~
Show all players: !s +>
Custom query of 1 server: !query qws 203.96.92.69:27500
Custom query of 2 servers, hide empty servers and hide players: !query qws-< 203.96.92.69:27500 203.96.91.1
Custom query of 3 servers with stats: !query qws~ 203.96.92.69:27500 203.96.91.1 210.50.4.21:27500
Download
crank v1.546, 178KB (Windows only)
Source code (For all operating systems)
Protocol List
- a2s - HalfLife 2 new server
- bfs - BFRIS server
- d3g - Descent3 Gamespy Protocol server
- d3p - Descent3 PXO protocol server
- d3s - Descent3 server
- dm3s - Doom 3 server
- efs - Star Trek: Elite Force server
- etqws - Enemy Territory Quake Wars
- eye - All Seeing Eye Protocol server (Battlefield 1942)
- fcs - FarCry server
- gps - Gamespy Protocol server
- grs - Ghost Recon server
- gs2 - Gamespy V2 Protocol server
- gs3 - Gamespy V3 Protocol server (Battlefield 2)
- gs4 - Gamespy V4 Protocol server (Battlefield 2142)
- h2s - Hexen II server
- hl2s - HalfLife 2 server
- hls - HalfLife server
- hrs - Heretic II server
- hws - HexenWorld server
- jk3s - Jedi Knight: Jedi Academy server
- kps - Kingpin server
- prs - Pariah server
- q2s - Quake II server
- q3s - Quake III: Arena server
- q4s - Quake 4 server
- qs - Quake server
- qws - QuakeWorld server
- rss - Ravenshield server
- rws - Return to Castle Wolfenstein server
- sas - Savage server
- sfs - Soldier of Fortune server
- sgs - Shogo: Mobile Armor Division server
- sns - Sin server
- t2s - Tribes 2 server
- tbs - Tribes server
- ts2 - Teamspeak 2 server
- uns - Unreal server
- ut2s - Unreal Tournament 2003 server
History
Programming language: C.
In the beginning, crank was just another mIRC client tied together with a bunch of perl scripts using qstat. Then for some unknown reason I decided to write an IRC bot, mostly because everyone has to create one at some point so I decided to get mine out of the way. I originally coded all the game query code myself but in the end I went back to using qstat seeing as they do a great job at it.
In the beginning, crank was just another mIRC client tied together with a bunch of perl scripts using qstat. Then for some unknown reason I decided to write an IRC bot, mostly because everyone has to create one at some point so I decided to get mine out of the way. I originally coded all the game query code myself but in the end I went back to using qstat seeing as they do a great job at it.