... a blind XMPP client for Warface (FPS game).

After my analysis of Warface in-game protocol, I've decided to write a blind client that will perform various statistical tasks. While developing it, I've found it could be used for other means, such as create solo games, which could be the opportunity for legit players to face new difficulties.

It is mandatory to understand the concept of licensing and free software that yields in the GNU world. Indeed, this program is distributed under the terms of AGPLv3. Please take the time to read and understand the file LICENSE shipped within this repository.

This is a XMPP client for Warface only, as the latter uses a special overlay protocol to hide the fact that it's using XMPP. It's a blind client because it performs lobby actions without the need of launching a resource-needing game and can be ran on a dedicated server.

This program is shipped fully functionnal but is intended to be customized (such as adding support to Cleverbot, adding stats, or custom commands).

It also features a little XMPP console that lets you (at your own risks !) send XMPP queries. It can be also used to enter owner-only commands.

This program acts like a normal game client. It's basically a dummy implementation of both Warface overlay protocol, XMPP, and the custom queries used by Warface. XMPP is a standard presence protocol. All the lobby and shop actions are made using custom XMPP queries.

It is composed of two parts, similary to the game:

• wb.sh - The launcher. It is responsible to log you in to the authentication server which will provide us a "session token". The launcher is made seperate in order to be scriptable and customizable (for instance, you can make it work for different Warface servers such as VN, RU, or BR);
• wb - The actual program. It uses the "session token" given by the launcher to login to the XMPP service. Once there, this program acts like the real game does.

This program lacks of several features that would make it totally undetectable. Here is the TODO list:

• Add an AFK trigger. Currently, the bot will never suffer from AFK-like features the game has, since this is a client-side mechanism. It can stay forever in a room until you tell him to leave or someone kicks him;
• Use a real XML parser (or use a XMPP library). Currently, every query is hand-crafted due to historical testings. Besides the untrusty code, everything seems to work flawlessly (until the day the server will start sending some advanced XML I don't handle correctly).

If you wish to use your bots for helping you starting solo games, you need to train them before using this program as they wont be able to join Skilled, Hardcore or survival rooms. Else, skip this section.

Skilled and Hardcore rooms can be unlocked starting from level 4. Thus, you'll need to complete the class tutorials, the initiation and regular maps, and some other PvP games to access this level. It represents 30 minutes of game per account.

Survival rooms are available starting from level 10 (ColdPeak is unlocked at level 25). You'll need to either spend some time in PvP - Storm. This represents 2 days of game per account.

To link your main account with your bot:

1. Create a bot account
2. Launch your bot account with warfacebot
3. Launch your main account with the official game
4. Send a friend request to your bot account from your main account
5. The bot should automatically accept the friend invitation request

Optional (for Skilled/Hardcore and Survival):

6. Launch the bot account with the official game
7. Complete the tutorials and reach level 4.

1. Clone this repository (if you didn't download it already) :

   $ git clone https://github.com/Levak/warfacebot.git
   

2. Compile the application :

   $ cd warfacebot
   $ make
   

3. Run the application by using the provided launcher wb.sh:

   $ ./wb.sh eu
   Email: mybot@trashmail.com
   Password: 
   ...
   

4. Repeat the step 3. for every bot you wish to boot up in another terminal.

5. The bot replies to any follow requests sent from the game to that account. Just ask him to join your room like you would do with any other player.

You can whisper commands to the bot such as:

• leave: Tell him to leave the current game room;
• master: Ask him to give you the room master permissions;
• ready: Set his to lobby state to ready;
• take <class>: Alias to ready <class>. Force him to take a specific class (medic, sniper, engineer, rifleman);
• follow [nickname]: Tell him to follow you or somebody;
• invite [nickname]: Send you an invitation request to the room he's in (in case you left him in a room);
• whois <nickname>: Retreive any connected player's country and lobby status;
• missions: Crown challenge objectives;
• start: If he's master, try to start the room;
• stay: If in a room, make sure to stay even if the room started (for 1h, until it leaves the current room);
• switch: If in PvP, try to switch team;
• unready: If in a room, keep to unready, until it either receives ready or leaves the current room.

Additionally, you can enter owner-only commands directly in the terminal, such as:

• add <nickname>: Send to nickname a friend request;
• remove <nickname>: Remove nickname from the buddy-list;
• say <msg>: If in a room, make him speak;
• open <map/mission>: open a game room with 'map' (PvP) or 'mission' (PvE). The 'map' list is available in the file src/pvp_maps.c. The 'mission' is either 'training', 'easy', 'normal', 'hard', 'survival', 'zombie', 'volcano', 'anubis', or 'campaingnsections';
• name <roomname>: Change the name of the PvP room;
• change <map/mission>: Change to 'map' or 'mission'. See open;
• safe <map>: Create a blacklist-based safe-room (Need customization, see the file src/cmds/cmd_safe.c). Notice the bot won't respond to any invite-requests while in safe-mode. To make him leave the safe-mode, use the command leave;
• channel <channel>: Switch to 'channel';
• whisper <nickname> <message>: Send a private message to a friend of clan mate;
• friends: List friends and clanmates;
• sleep [n]: Hang the readline thread for 'n' seconds (1 second by default);
• stats: List all channel load statistics;
• stay <count> [unit]: If in a room, make sure to stay even if the room started. 'count' is the number of time 'unit' to stay (if 'unit' is not given, then default to seconds);
• randombox [<name> <count>]: Open count boxes from the randombox called name. If neither name nor count is given, display the list of available randomboxes and their price;
• last <nickname>: Display the last seen date of a friend or a clanmate.

In order to dynamically affect the behavior of the bot without the need of recompiling it (either to configure it while running or on launch), couple CVars have been added.

• game_version: Game version used at login (default: NULL);
• game_server_name: Game server identifier (default: NULL);
• game_hwid: HWID used at login (default: 0).

• online_server: Game server host to connect to (default: NULL);
• online_server_port: Game server port (default: 5222);
• online_channel_type: Default channel type to connect to (default: pve);
• online_use_protect: Use an additional encryption layer (default: TRUE);
• online_use_tls: Use TLS encryption(default: TRUE).

• wb_safemaster: Setup the bot as a safemaster (default: FALSE);
• wb_safemaster_room_name: Safemaster default room name;
• wb_safemaster_channel: Safemaster default room channel (default: pvp_pro_1);
• wb_accept_friend_requests: Accept any friends requests (default: TRUE);
• wb_postpone_friend_requests: Do not treat friends requests at all (default: FALSE);
• wb_accept_clan_invites: Accept any clan invitations (default: TRUE);
• wb_postpone_clan_invites: Do not treat clan invitations at all (default: FALSE);
• wb_enable_whisper_commands: Proceed whisper commands (default: TRUE);
• wb_leave_on_start: Automatically leave when the room starts (default: TRUE);
• wb_accept_room_invitations: Whether to accept buddy room inviations or not (default: TRUE);
• wb_enable_invite: Whether to enable or not the invite whisper command (default: TRUE).

CVars can be defined in 4 different ways:

• From the default config file wb.cfg;

• From a config file given at launch;

  $ ./wb.sh eu -f <config.cfg>
  

• From a variable defined at launch;

  $ ./wb.sh eu -d <cvar_name=value>
  

• From the readline prompt.

  $ ./wb.sh eu
  [...]
  CMD# cvar_name = value
  cvar_name = value
  

Config files are single-token-separated files. The token is either a space, an equal sign, or both. Extra tokens after the cvar name are ignored. Below is an example of a valid config file (assuming cvar_name is a valid cvar):

cvar_name 1
cvar_name=1
cvar_name   1
cvar_name = 1

Note: When using wb.sh <server> to launch warfacebot, the config files ./cfg/server/<server>.cfg is used in order to determine the game version and the server host. If the game version changed, you need to modify this file.