-rcon2irc - IRC gateway for Xonotic servers, using rcon authorization
-
-
-Quick installation guide:
-
-1. Set up rcon access on your Xonotic server, by adding some line like
- rcon_password hackme
- in your server.cfg. This password gives anyone FULL access to your server,
- so do not give it away! This IRC gateway does not work with a
- rcon_restricted_password.
-
-2. Copy rcon2irc-example.conf to another name (e.g. rcon2irc.conf), and edit
- the settings to match your setup. At the very least:
- - change dp_server to the IP (or IP:port) of your Xonotic server
- - change dp_password to the rcon password set above
- - change irc_server to the IRC server to connect to
- - change irc_nick to the nick name to use
- - change irc_channel to the channel to join
-
-3. Run it:
- perl rcon2irc.pl rcon2irc.conf
- You may possibly want to run it in nohup so you can disconnect from your ssh
- connection, like this:
- nohup perl rcon2irc.pl rcon2irc.conf &
- Logging will then go to a file nohup.out in the same directory. Another way
- to run it permanently and to see its output is to run it inside a screen(1).
-
-
-Features:
-
-- Show results of matches in the IRC channel
-
-- Act as a gateway to allow chat between Xonotic server and IRC users, useful
- for making the server more interesting to the public, but also useful as a
- mere helper for the server admin to watch what's happening in game (like, if
- people complain about a problem):
- - Any line written in game using say (not say_team) goes to the IRC channel.
- - Any line written in the channel, prefixed by the bot's nick name and a :,
- goes into the Xonotic game.
- - Example:
- View in game:
- XSAX LTU: GREAT WIN AHAHAHAHAHAHAHAHAH))
- (RedAlert) stop teamkilling!
- .ThreeHeadedMonkey.: I am behind you!
- View on IRC, assuming the IRC gateway has the nick noobXon and is voiced:
- <+noobXon> <XSAX LTU> GREAT WIN AHAHAHAHAHAHAHAHAH))
- <+noobXon> <.ThreeHeadedMonkey.> I am behind you!
-
-- Notify about free slots on the server. Example:
- * noobXon is full!
- * noobXon can be joined again (2 free slots); join now: xonotic +connect 172.23.42.54!
- <+noobXon> ctf_capturecity_v2r1 has begun (2 free slots); join now: xonotic +connect 172.23.42.54
-
-- Display scores at the end of a match in the IRC channel. Example:
- <+noobXon> ctf_capturecity_v2r1 ended: 301:78 Nicole 115, elsteer BLD {Y} 77,
- CensoredNickname 57, 0grueN# 29, Bigus 23, ZeroA 36, ricer 22,
- Treey@suse8 12, cZaR6RUSS7 8, BrightDev1l 0
-
-- Authenticate to the IRC services by Nickserv or Quakenet protocol, so the
- server bot can be set up to always get voice when entering the channel, and
- in case of Nickserv, make sure nobody else prevents it from using its
- configured nick. Other authentication protocols can often be set up using
- configuration, and if not, as plugin.
-
-- Support for /whois queries: the server hostname is put into the real name
- field for /whois, so people can see how to find the server in the server
- list.
-
-- Plugin interface for plugins written in Perl. See included rbiserver.pl for
- an example.
-
-
-License:
-
-Copyright (c) 2008 Rudolf "divVerent" Polzer
-
-Permission is hereby granted, free of charge, to any person
-obtaining a copy of this software and associated documentation
-files (the "Software"), to deal in the Software without
-restriction, including without limitation the rights to use,
-copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the
-Software is furnished to do so, subject to the following
-conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
-OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
-HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-OTHER DEALINGS IN THE SOFTWARE.
+rcon2irc - IRC gateway for Xonotic servers, using rcon authorization\r
+\r
+\r
+Quick installation guide:\r
+\r
+1. Set up rcon access on your Xonotic server, by adding some line like\r
+ rcon_password hackme\r
+ in your server.cfg. This password gives anyone FULL access to your server,\r
+ so do not give it away! This IRC gateway does not work with a\r
+ rcon_restricted_password.\r
+\r
+2. Copy rcon2irc-example.conf to another name (e.g. rcon2irc.conf), and edit\r
+ the settings to match your setup. At the very least:\r
+ - change dp_server to the IP (or IP:port) of your Xonotic server\r
+ - change dp_password to the rcon password set above\r
+ - change irc_server to the IRC server to connect to\r
+ - change irc_nick to the nick name to use\r
+ - change irc_channel to the channel to join\r
+ \r
+3. Run it:\r
+ perl rcon2irc.pl rcon2irc.conf\r
+ You may possibly want to run it in nohup so you can disconnect from your ssh\r
+ connection, like this:\r
+ nohup perl rcon2irc.pl rcon2irc.conf &\r
+ Logging will then go to a file nohup.out in the same directory. Another way\r
+ to run it permanently and to see its output is to run it inside a screen(1).\r
+\r
+\r
+Features:\r
+\r
+- Show results of matches in the IRC channel\r
+\r
+- Act as a gateway to allow chat between Xonotic server and IRC users, useful\r
+ for making the server more interesting to the public, but also useful as a\r
+ mere helper for the server admin to watch what's happening in game (like, if\r
+ people complain about a problem):\r
+ - Any line written in game using say (not say_team) goes to the IRC channel.\r
+ - Any line written in the channel, prefixed by the bot's nick name and a :,\r
+ goes into the Xonotic game.\r
+ - Example:\r
+ View in game:\r
+ XSAX LTU: GREAT WIN AHAHAHAHAHAHAHAHAH))\r
+ (RedAlert) stop teamkilling!\r
+ .ThreeHeadedMonkey.: I am behind you!\r
+ View on IRC, assuming the IRC gateway has the nick noobXon and is voiced:\r
+ <+noobXon> <XSAX LTU> GREAT WIN AHAHAHAHAHAHAHAHAH))\r
+ <+noobXon> <.ThreeHeadedMonkey.> I am behind you!\r
+\r
+- Notify about free slots on the server. Example:\r
+ * noobXon is full!\r
+ * noobXon can be joined again (2 free slots); join now: xonotic +connect 172.23.42.54!\r
+ <+noobXon> ctf_capturecity_v2r1 has begun (2 free slots); join now: xonotic +connect 172.23.42.54\r
+\r
+- Display scores at the end of a match in the IRC channel. Example:\r
+ <+noobXon> ctf_capturecity_v2r1 ended: 301:78 Nicole 115, elsteer BLD {Y} 77,\r
+ CensoredNickname 57, 0grueN# 29, Bigus 23, ZeroA 36, ricer 22,\r
+ Treey@suse8 12, cZaR6RUSS7 8, BrightDev1l 0\r
+\r
+- Authenticate to the IRC services by Nickserv or Quakenet protocol, so the\r
+ server bot can be set up to always get voice when entering the channel, and\r
+ in case of Nickserv, make sure nobody else prevents it from using its\r
+ configured nick. Other authentication protocols can often be set up using\r
+ configuration, and if not, as plugin.\r
+\r
+- Support for /whois queries: the server hostname is put into the real name\r
+ field for /whois, so people can see how to find the server in the server\r
+ list.\r
+\r
+- Plugin interface for plugins written in Perl. See included rbiserver.pl for\r
+ an example.\r
+\r
+\r
+License:\r
+\r
+Copyright (c) 2008 Rudolf "divVerent" Polzer\r
+\r
+Permission is hereby granted, free of charge, to any person\r
+obtaining a copy of this software and associated documentation\r
+files (the "Software"), to deal in the Software without\r
+restriction, including without limitation the rights to use,\r
+copy, modify, merge, publish, distribute, sublicense, and/or sell\r
+copies of the Software, and to permit persons to whom the\r
+Software is furnished to do so, subject to the following\r
+conditions:\r
+\r
+The above copyright notice and this permission notice shall be\r
+included in all copies or substantial portions of the Software.\r
+\r
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,\r
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\r
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\r
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\r
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\r
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\r
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\r
+OTHER DEALINGS IN THE SOFTWARE.\r