Soldat Community Wiki - User contributions [en]

TActivePlayer.WeaponActive

2016-02-24T13:12:42Z

Shoozza:

'''''property TActivePlayer.WeaponActive[ID: Byte]: Boolean'''''
Access mode: W
==Description==
Sets a weapon available/unavailable from the weapon menu for a certain player. 
Weapon ID goes from 1 to 14 (Desert Eagles, HK .... Chainsaw, Law).

==Example==
<syntaxhighlight lang="pascal">
var i: byte;
begin
for i := 1 to 14 do
Players[ID].WeaponActive[i] := i = 12; // deactivate all weapons but knife
end;
</syntaxhighlight>

[[Category:TActivePlayer]]

Anticheat Ideas

2013-07-28T20:59:17Z

Shoozza: Created page with "* Accounts * Paid Accounts (1 or 2€ donation goes to charity) * External Closed-Source Anti-Cheat solution * Authoritative server"

* Accounts
* Paid Accounts (1 or 2€ donation goes to charity)
* External Closed-Source Anti-Cheat solution
* Authoritative server

Known cheats

2013-07-27T22:57:57Z

Shoozza:

== Blatant Cheats ==
* Teleport to mouse
* Teleport to player (while stabbing with knife)
* Teleport to bonus pack (health pack)
* Create bullets (directed at players)
* Airman
* Lying while doing normal movements
* Shoot different bullet types (knife bullets)
* Infinite knives
* Speedhack (move faster)
* Play as spectator
* Choose any weapon (not while dead/just respawned)
* Infinite bullets
* Lagjump
* Powerknife throw
* Remove polygons (don't collide with some polys)

== Subtle Cheats ==
* Aimbot
* Join passworded servers (without original password)
* Double damage
* Show all players in minimap
* See all players in realistic mode
* Disable aim lag
* No weapon reload time
* Infinite jets

== Other Malicious Activities ==
* Flood admin server with login attempts

Known cheats

2013-07-27T22:56:11Z

Shoozza:

Known cheats

2013-07-27T22:53:59Z

Shoozza: added batant and subtle sections

== Blatant Cheats ==
* Teleport to mouse
* Teleport to player (while stabbing with knife)
* Teleport to bonus pack (health pack)
* Create bullets (directed at players)
* Airman
* Lying while doing normal movements
* Shoot different bullet types (knife bullets)
* Infinite knives
* Speedhack (move faster)
* Play as spectator
* Choose any weapon (not while dead/just respawned)
* Infinite bullets
* Lagjump
* Powerknife throw

== Subtle Cheats ==
* Aimbot
* Join passworded servers (without original password)
* Double damage
* Show all players in minimap
* See all players in realistic mode
* Disable aim lag
* No weapon reload time
* Infinite jets

== Other Malicious Activities ==

Known cheats

2013-07-27T22:47:17Z

Shoozza: spelling

* Teleport to mouse
* Teleport to player (while stabbing with knife)
* Teleport to bonus pack (health pack)
* Create bullets (directed at players)
* Aimbot
* Show all players in minimap
* See all players in realistic mode
* Airman
* Lying while doing normal movements
* Shoot different bullet types (knife bullets)
* Infinite knives
* Disable aim lag
* Double damage
* Speedhack (move faster)
* Infinite jets
* Play as spectator
* Choose any weapon (not while dead/just respawned)
* Join passworded servers (without original password)
* Infinite bullets
* No weapon reload time
* Lagjump
* Powerknife throw

Known cheats

2013-07-27T22:46:02Z

Shoozza: spelling

* Teleport to mouse
* Teleport to player (while stabbing with knife)
* Teleport to bonus pack (health pack)
* Create bullets (directed at players)
* Aimbot
* Show all players in minimap
* See all players in realistic mode
* Airman
* Lying while doing normal movements
* Shoot different bullet types (knife bullets)
* Infinite knives
* Disable aim lag
* Double damage
* Speedhack (move faster)
* Infinite jets
* Play as spectator
* Choose any weapon (not while dead and respawned)
* Join passworted servers (without original password)
* Infinite bullets
* No reload time
* Lagjump
* Powerknife throw

Known cheats

2013-07-27T22:44:41Z

Shoozza: added more cheats

* Teleport to mouse
* Teleport to player (while stabbing with knife)
* Teleport to bonus pack (health pack)
* Create bullets (directed at players)
* Aimbot
* Show all players in minimal
* See all players in realistic mode
* Airman
* Lying while doing normal movements
* Shoot different bullet types (knife bullets)
* Infinite knives
* Disable aim lag
* Double damage
* Speedhack (move faster)
* Infinite jets
* Play as spectator
* Choose any weapon (not while dead and respawned)
* Join passworted servers (without original password)
* Infinite bullets
* No reload time
* Lagjump
* Powerknife throw

Known cheats

2013-07-27T22:43:50Z

Shoozza: Created known cheats page

* Teleport to mouse
* Teleport to player (while stabbing with knife)
* Teleport to bonus pack (health pack)
* Create bullets (directed at players)
* Aimbot
* Show all players in minimal
* See all players in realistic mode
* Airman
* Lying while doing normal movements
* Shoot different bullet types (knife bullets)
* Infinite knives
* Disable aim lag
* Double damage
* Speedhack (move faster)
* Infinite jets
* Play as spectator
* Choose any weapon (not while dead and respawned)
* Join passworted servers (without original password)
* Infinite bullets
* No reload time

Command line arguments

2013-03-10T14:38:20Z

Shoozza: wrong commanline example

When running your server from the command line, you can take advantage of what is known as ''command line arguments''. This is, basically, sending data to the binary on-the-fly from the interpreter (shell), such as MS-DOS or bash.

== Options ==

'''-d''' 
''Usage: ./soldatserver -d'' 
Starts your server as a Daemon (runs in the background, even when you log off). Linux only.

'''-pid''' 
''Usage: ./soldatserver -pid soldatserver.pid'' 
Sets the Process ID file name. Located in the /logs/ folder (soldatserver.pid by default).

'''-m''' 
''Usage: ./soldatserver -m xx.txt'' 
Sets the default mapslist file to xx.txt (mapslist.txt by default).

'''-c''' 
''Usage: ./soldatserver -c x.ini'' 
Sets the default configuration file to x.ini (Soldat.ini by default).

'''-p''' 
''Usage: ./soldatserver -p 23073'' 
Start the server on a specific port.

'''-l''' 
''Usage: ./soldatserver -l 12'' 
Limits the number of players that can join the server.

'''-k''' 
''Usage: ./soldatserver -k "my clan only"'' 
Sets a password that will be required by anyone who tries to join.

'''-b''' 
''Usage: ./soldatserver -b "72.232.225.66"'' 
Binds the server to a specific IP Address. Use with caution! You cannot bind to an IP that isn't assigned to your network card!

'''-a''' 
''Usage: ./soldatserver -a #'' 
Enable/Disable All-Seeing Eye registration. #: 1 = enabled, 0 = disabled.

'''-s''' 
''Usage: ./soldatserver -s #'' 
Enable/Disable the SoldatServer Scripting Engine. #: 1 = enabled, 0 = disabled.

'''-safe''' 
''Usage: ./soldatserver -safe #'' 
Enable/Disable Safe Mode for Scripts (On by default). #: 1 = enabled, 0 = disabled.

'''-lock''' 
''Usage: ./soldatserver -lock #'' 
Enable/Disable Locked Mode (Off by default). When Locked Mode is enabled, admins will not be able to type /loadcon, /password or /maxplayers. #: 1 = enabled, 0 = disable$

'''-disallow''' 
''Usage: ./soldatserver -disallow "GetURL,ReadFile"'' 
Disable certain script functions from being used by scripts. Note that this will cause any scripts that use these functions to crash with an "unknown identifier GetURL" error.

'''-debug''' 
''Usage: ./soldatserver -debug #'' 
Enable/Disable Debug Mode (See Debug_Mode in soldat.ini).
<nowiki>#</nowiki>: 0 = No Debug, 1 = Lobby Debug, 2 = Advanced Debug, 3 = Script Core Debug
If you find a bug and report it, please use Debug Mode 2. It helps us alot.

'''-ns''' 
''Usage: ./soldatserver -ns 192.168.2.1'' 
Set the Nameserver your Soldat Server will use to resolve the Lobby DNS. Only use this if you know what you are doing! The server should automatically detect what Nameserver your computer uses!

'''-ls''' 
''Usage: ./soldatserver -ls #'' 
Set the maximum number of scripts which can be loaded by this server.

[[Category:Server]]

BotChat

2012-09-10T15:22:21Z

Shoozza: Formatted code

===Scripting Manual===
''procedure BotChat(ID: Byte; Text: string);''

'''Parameter Info:'''
ID (Byte): ID of the bot (Also works on human players)
Text (string): Text for the bot to speak.

'''Description:'''
This function will make a bot say something! They are alive!
Note that as of Soldatserver 2.7.3 this will also work on human players, it is called BotChat for compatibility with older scripts.

==Examples==
<source lang="pascal">
begin
BotChat(1, 'Oogie boogie I come to you from beyond the grave!');
end;
</source>

[[Category:Server Scripting]][[Category:Server Scripting Functions]]

WriteConsole

2012-09-10T14:07:21Z

Shoozza: Formatted code

===From the Scripting Manual===
''procedure WriteConsole(ID: Byte; Text: string; Colour: LongInt);''

'''Parameter Info:'''
ID (Byte): Player ID to write text to. Set to 0 to write to all players!
Text (string): Text to be written to the console.
Colour (LongInt): Colour the text should be when drawn to the console.

'''Description:'''
This function will add text to the players(ID) console.
Set ID to 0 to write the text to ALL Players in the server!

==Examples==
<source lang="pascal">begin
WriteConsole(0, 'Pickled Onions are nice!', $EE81FAA1);
// Will draw: "Pickled Onions are nice!" to ALL players consoles.
// $EE81FAA1 is the colour, in AA RR GG BB format. (Alpha, Red, Green,Blue);
end;
</source>

==External Links==
* [http://enesce.com/help/index.html?Functions/WriteConsole.html Scripting Manual page for WriteConsole]

[[Category:Server Scripting]][[Category:Server Scripting Functions]]

ForceWeapon

2012-09-10T14:04:11Z

Shoozza: Formatted code

===From the Scripting Manual===
''procedure ForceWeapon(ID, Primary, Secondary, Ammo: Byte);''

'''Parameter Info:'''
ID (Byte): Player ID to change weapon.
Primary (Byte): Weapon Number to set primary weapon to.
Secondary (Byte): Weapon Number to set secondary weapon to.
Ammo (Byte): Ammo to give the player. 0 for default.

'''Description:'''
This function will force the specified player(ID) to change their Primary and Secondary weapons.
NOTE: Set Ammo to 0 to use the default ammo count for the (Primary) gun.

==Examples==
<source lang="pascal">
begin
ForceWeapon(0, 3, 0, 0);
// Forces all players to use AK as primary.
ForceWeapon(ID, 3, 0, 0);
// Forces player 'ID' to use AK as primary.
end;
</source>

[[Category:Server Scripting]][[Category:Server Scripting Functions]]

ForceWeaponEx

2012-09-10T14:03:36Z

Shoozza: Formatted code

===Scripting Manual===
''procedure ForceWeaponEx(ID, Primary, Secondary, Ammo, SecAmmo: Byte);''

'''Parameter Info:'''
ID (Byte): Player ID to change weapon. 0 for all.
Primary (Byte): Weapon Number to set primary weapon to.
Secondary (Byte): Weapon Number to set secondary weapon to.
Ammo (Byte): Primary Ammo to give the player. 0 for default.
SecAmmo (Byte): Secondary Ammo to give the player. 0 for default.

'''Description:'''
This function will force the specified player(ID) to change their Primary and Secondary weapons and/or ammo.

==Examples==
<source lang="pascal">
begin
ForceWeaponEx(0, 3, 0, 0, 1);
// Forces all players to use AK as primary and a USSOCOM with 1 ammo as secondary.
end;
</source>

[[Category:Server Scripting]][[Category:Server Scripting Functions]]

Gamemodes

2012-08-23T21:00:36Z

Shoozza: Redirected page to GameStyle

#REDIRECT [[GameStyle]]

Explode

2012-08-23T20:59:18Z

Shoozza: Redirected page to XSplit

#REDIRECT [[XSplit]]

Pos

2012-08-23T20:58:44Z

Shoozza: Created page with "function pos(substr, s: string): Longint;"

function pos(substr, s: string): Longint;

Data Types

2012-08-23T20:58:12Z

Shoozza: Created page with "<table> <tr> <th>Variables (Notes in parenthesis)</th> <th>VarType</th> <th>SizeOf (possible formula)</th> <th>Can set as variant?</th> <th>Variant impli..."

<table>
<tr>
<th>Variables (Notes in parenthesis)</th>
<th>VarType</th>
<th>SizeOf (possible formula)</th>
<th>Can set as variant?</th>
<th>Variant implicit string</th>
<th>Variant implicit integer</th>
<th>Variant implicit float</th>
<th>Range (if applicable)</th>
</tr>
<tr>
<td>variant (unassigned)</td>
<td>0</td>
<td>16</td>
<td>yes</td>
<td></td>
<td>0</td>
<td>incomplete</td>
<td>Check table category "Can set as variant?"</td>
</tr>
<tr>
<td>variant <null></td>
<td>1</td>
<td>16</td>
<td>yes</td>
<td>exception</td>
<td>exception</td>
<td>incomplete</td>
<td></td>
</tr>
<tr>
<td>smallint (sint16)</td>
<td>2</td>
<td>2</td>
<td>yes</td>
<td>0</td>
<td>incomplete</td>
<td>incomplete</td>
<td>-32768 to 32767</td>
</tr>
<tr>
<td>integer, longint (sint32)</td>
<td>3</td>
<td>4</td>
<td>yes</td>
<td>0</td>
<td>incomplete</td>
<td>incomplete</td>
<td>-2147483648 to 2147483647</td>
</tr>
<tr>
<td>single (fp32)</td>
<td>5</td>
<td>4</td>
<td>yes</td>
<td>0</td>
<td>0</td>
<td>incomplete</td>
<td>(7 significant digits), INF, -INF</td>
</tr>
<tr>
<td>double (fp64)</td>
<td>5</td>
<td>8</td>
<td>yes</td>
<td>0</td>
<td>0</td>
<td>incomplete</td>
<td>(15 significant digits), INF, -INF</td>
</tr>
<tr>
<td>extended (fp80)</td>
<td>5</td>
<td>10</td>
<td>yes</td>
<td>0</td>
<td>incomplete</td>
<td>incomplete</td>
<td>1E-38 to 1E+38 (19 significant digits), INF, -INF</td>
</tr>
<tr>
<td>WideChar</td>
<td>8</td>
<td>2</td>
<td>yes</td>
<td></td>
<td>exception</td>
<td>incomplete</td>
<td></td>
</tr>
<tr>
<td>WideString</td>
<td>8</td>
<td>4</td>
<td>yes</td>
<td></td>
<td>incomplete</td>
<td>incomplete</td>
<td></td>
</tr>
<tr>
<td>IDispatch</td>
<td>9</td>
<td>4</td>
<td>yes</td>
<td>exception</td>
<td>exception</td>
<td>incomplete</td>
<td></td>
</tr>
<tr>
<td>boolean</td>
<td>11</td>
<td>1</td>
<td>yes</td>
<td>False</td>
<td>0</td>
<td>incomplete</td>
<td>true, false</td>
</tr>
<tr>
<td>shortint (sint8)</td>
<td>16</td>
<td>1</td>
<td>yes</td>
<td>0</td>
<td>incomplete</td>
<td>incomplete</td>
<td>-128 to 127</td>
</tr>
<tr>
<td>byte (uint8)</td>
<td>17</td>
<td>1</td>
<td>yes</td>
<td>0</td>
<td>incomplete</td>
<td>incomplete</td>
<td>0 to 255</td>
</tr>
<tr>
<td>enum</td>
<td>17</td>
<td>1</td>
<td>yes</td>
<td>0</td>
<td>0</td>
<td>incomplete</td>
<td>min >= 1; max <= unknown (at least 65536 compiles)</td>
</tr>
<tr>
<td>TIFException</td>
<td>17</td>
<td>1</td>
<td>yes</td>
<td>0</td>
<td>0</td>
<td>incomplete</td>
<td>Cannot set as an integer</td>
</tr>
<tr>
<td>word, TVarType (uint16)</td>
<td>18</td>
<td>2</td>
<td>yes</td>
<td>0</td>
<td>0</td>
<td>incomplete</td>
<td>0 to 65535</td>
</tr>
<tr>
<td>cardinal, longword (uint32)</td>
<td>19</td>
<td>4</td>
<td>yes</td>
<td>0</td>
<td>incomplete</td>
<td>incomplete</td>
<td>0 to 4294967295</td>
</tr>
<tr>
<td>LongBool</td>
<td>19</td>
<td>4</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>Int64 (sint64)</td>
<td>20</td>
<td>8</td>
<td>yes</td>
<td>0</td>
<td>incomplete</td>
<td>incomplete</td>
<td></td>
</tr>
<tr>
<td>char</td>
<td>256</td>
<td>1</td>
<td>yes</td>
<td><#000></td>
<td>exception</td>
<td>incomplete</td>
<td>ASCII character set</td>
</tr>
<tr>
<td>string</td>
<td>256</td>
<td>4</td>
<td>yes</td>
<td></td>
<td>incomplete</td>
<td>incomplete</td>
<td>length from 0 to 1541210095</td>
</tr>
<tr>
<td>array of <type></td>
<td>8204</td>
<td>4</td>
<td>yes</td>
<td>exception</td>
<td>exception</td>
<td>incomplete</td>
<td>length from -7 to 1074241824 (2^30)</td>
</tr>
<tr>
<td>array[min..max] of <type></td>
<td>exception</td>
<td>varies; (max-min)*sizeof(type)</td>
<td>no</td>
<td>exception</td>
<td>exception</td>
<td>exception</td>
<td>max-min <= 536870910 (2^29-2)</td>
</tr>
<tr>
<td>set of <byte/char></td>
<td>exception</td>
<td>32</td>
<td>no</td>
<td>exception</td>
<td>exception</td>
<td>exception</td>
<td></td>
</tr>
<tr>
<td>set of <boolean/enum></td>
<td>exception</td>
<td>1</td>
<td>no</td>
<td>exception</td>
<td>exception</td>
<td>exception</td>
<td></td>
</tr>
<tr>
<td>record</td>
<td>exception</td>
<td>varies; sum of sizeof all content</td>
<td>no</td>
<td>exception</td>
<td>exception</td>
<td>exception</td>
<td></td>
</tr>
<tr>
<td>IUnknown</td>
<td>exception</td>
<td>4</td>
<td>no</td>
<td>exception</td>
<td>exception</td>
<td>exception</td>
<td></td>
</tr>
<tr>
<td>___Pointer</td>
<td>exception</td>
<td>exception</td>
<td>no</td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>function: <type>, procedure</td>
<td>exception</td>
<td>12</td>
<td>no</td>
<td>exception</td>
<td>exception</td>
<td>exception</td>
<td></td>
</tr>
<tr>
<td>PChar</td>
<td>access violation</td>
<td>4</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
</table>

Refer to [[Implicit Conversions|http://devs.soldat.pl/wiki/index.php?title=Implicit_Conversions]] for a list of types that can implicitly convert to another.

TStringArray
TVariantArray

Bullets

2012-08-23T20:57:34Z

Shoozza: Created page with "<ol> <li>plain bullet</li> <li>frag grenade</li> <li>shotgun pellets</li> <li>m79 grenade</li> <li>flame</li> <li>punch</li> <li>arrow</li> <li>flame arrow</li> <li value="10"..."

<ol>
<li>plain bullet</li>
<li>frag grenade</li>
<li>shotgun pellets</li>
<li>m79 grenade</li>
<li>flame</li>
<li>punch</li>
<li>arrow</li>
<li>flame arrow</li>
<li value="10">cluster shrapnel</li>
<li>knife/chainsaw</li>
<li>LAW missile</li>
<li>knife</li>
<li>M2 bullet</li>
</ol>

BGC Massmod

2012-08-23T20:57:10Z

Shoozza: Created page with "<source lang="C"> #include <iostream> #include <string> #include <algorithm> #include <fstream> #include <iterator> #include <vector> #include <stdio.h> #include <stdlib.h> ..."

<source lang="C">

#include <iostream>
#include <string>
#include <algorithm>
#include <fstream>
#include <iterator>
#include <vector>

#include <stdio.h>
#include <stdlib.h>
#include <windows.h>

using namespace std;

int main(int argc, char *argv[]){

WIN32_FIND_DATA findFileData;

HANDLE hFind = FindFirstFile("*.pms", &findFileData);
if(hFind == INVALID_HANDLE_VALUE){
cout << "No *.PMS files found" << endl;
cout << "* make sure you place the application in soldat/maps/ folder" << endl;
FindClose(hFind);
return 1;
}else{
cout << "Starting..." << endl;
}

if(argc != 7){
cout << "Usage: RED GREEN BLUE RED GREEN BLUE" << endl
<< " values in DEC (0-255), first set top, then bottom" << endl;
return 1;
}

int filec = 1;
fstream file;
int length;
char *buffer;

while(FindNextFile(hFind, &findFileData)){
cout << filec << ". " << findFileData.cFileName << "... " << flush;
// get contents
file.open(findFileData.cFileName, ios_base:: in | ios_base::binary);
file.seekg (0, ios::end);
length = file.tellg();
file.seekg (0, ios::beg);
buffer = new char [length];
file.read (buffer,length);
file.close();
//modify contents
// top color
buffer[68] = atoi(argv[3]); // B
buffer[69] = atoi(argv[2]); // G
buffer[70] = atoi(argv[1]); // R
buffer[71] = 0; // A
// bottom color
buffer[72] = atoi(argv[6]); // B
buffer[73] = atoi(argv[5]); // G
buffer[74] = atoi(argv[4]); // R
buffer[75] = 0; // A
//overwrite with new contents
file.open(findFileData.cFileName, ios_base::out | ios_base::binary | ios_base::trunc);
file.write (buffer,length);
file.close();

delete[] buffer;

cout << "Ok!" << endl;
filec++;
}

FindClose(hFind);
return 0;
}

</source>

PHP PMS Background colors mass modifier
<pre>
<nowiki><?php

$files = array_merge(glob("*.PMS"), glob("*.pms"));;

// these are ctf_Steel's colors,
// note: alpha is useless
// C = unsigned char--- B R G A
$new_top = pack("CCCC", 74, 63, 74, 0); // top
$new_bot = pack("CCCC", 39, 39, 22, 0); // bottom

echo "Found " . count($files) . " file(s) - processing...\n\n";

$i = 1;

foreach($files as $file){
echo $i . ". " . $file . " ... ";
$contents = file_get_contents($file, FILE_BINARY);
// replace that
$mod = substr_replace($contents, $new_top, 4+1+38+1+24, 4);
$mod = substr_replace($mod, $new_bot, 4+1+38+1+24+4, 4);
// overwrite
file_put_contents($file, $mod);
echo " ... OK!\n";
$i++;
}

?>

</nowiki>
</pre>

FileExist

2012-08-23T18:01:25Z

Shoozza: Redirected page to FileExists

#REDIRECT [[FileExists]]

ArrayHigh

2012-08-23T18:00:41Z

Shoozza: Created page with "===From the Scripting Manual=== ''function ArrayHigh(X: array of variant): integer;'' '''Parameter Info:''' X (Array of Variant): This paramater can be an array of any d..."

===From the Scripting Manual===
''function ArrayHigh(X: array of variant): integer;''

'''Parameter Info:'''
X (Array of Variant): This paramater can be an array of any data type.

'''Description:'''
This function will return the highest index of an array. Example if you have an array of 5 integers {0,1,2,3,4},
this function will return 4.

(if this function fails for you, please try [[GetArrayLength]])

==Examples==
<source lang="pascal">var
MyArray[0..4] of string;
i: integer;
begin
MyArray[0] := 'noobs';
MyArray[1] := 'foo';
MyArray[2] := 'bar';
MyArray[3] := 'is';
MyArray[4] := 'for';

for i := 0 to ArrayHigh(MyArray) do begin
WriteLn(MyArray[i]);
end;
end;
</source>

'''Output:'''
noobs
foo
bar
is
for

==External Links==
* [http://enesce.com/help/index.html?Functions/Arrayhigh.html Scripting Manual page for Arrayhigh]

[[Category:Server Scripting]][[Category:Server Scripting Functions]]

Lobby Protocol Parsers

2012-08-23T18:00:22Z

Shoozza: Created page with "Here are some parsers/constructors to help communicate with the lobby using the Client-Lobby_Protocol"

Here are some parsers/constructors to help communicate with the lobby using the [[Client-Lobby_Protocol]]

Client-Lobby Protocol

2012-08-23T17:59:55Z

Shoozza: Created page with "Here you will find an explanation of the entire Soldat client<>lobby server protocol. Right now this document explains the protocol used by the Soldat client. A cleaner and ..."

Here you will find an explanation of the entire Soldat client<>lobby server protocol. Right now this document explains the protocol used by the Soldat client. A cleaner and more user-friendly [[3rd party lobby protocol]] will be created in the future to allow for 3rd party applications to more easily communicate with the lobby server.

This is the the protocol used as of Soldat 1.4.0, as implemented by [[FliesLikeABrick]] and [[EnEsCe]]. There is no documentation available for the earlier lobby protocol. As of late January 2011, the [http://forums.soldat.pl/index.php?topic=39553.0 lobby server is partially maintained by jrgp].

General notes:
* The current lobby is available at rr.soldat.pl:13073
* The HTTP lobby is available at http://rr.soldat.pl
* © is used as a field separator in all dealings with the lobby
* All packets to/from the lobby end with \n

Every packet to/from the lobby starts with a byte that indicates what kind of data is contained. These types are involved in client communication with the lobby:
* '''101:''' A request to the lobby for the server list
* '''102:''' List beginning, specifies total number of servers about to be sent
* '''103:''' A server
* '''104:''' Signifies the end of the server list.

==Packet Structures==
===101 Request List===
This is the list request sent from the client to the lobby with all of the filter information set. The request format is:
e©VERSION©DEDICATED©PASSSWORDED©BOTS©SURVIVAL©REALISTIC©BONUSES©ADVANCE©WM©FULL©EMPTY©GAMETYPE©BE\n
Where:
* VERSION is XY, coming from the Soldat version number 1.X.Y. For example, the version for 1.4.2 is 42, 0 is "do not care."
* DEDICATED is 1 to filter "dedicated only," 0 is "do not care," ! is "not dedicated."
* PASSWORDED is 1 to filter "no password," 0 is "do not care," ! is "passworded."
* BOTS is 1 to filter "no bots," 0 is "do not care," ! is "with bots."
* SURVIVAL is 1 to filter "survival mode only," 0 is "do not care," ! is "not survival."
* REALISTIC is 1 to filter "realistic mode only," 0 is "do not care," ! is "not realistic."
* BONUSES is 1 to filter "no bonuses," 0 is "do not care."
* ADVANCE is 1 to filter "advance mode only," 0 is "do not care," ! is "not advanced."
* WM is 1 to filter "wm servers only," 0 is "do not care," ! is "not wm."
* FULL is 1 to filter "non-full games only," 0 is "do not care."
* EMPTY is 1 to filter "non-empty games only," 0 is "do not care."
* GAMETYPE is set to the game type that you want to see:
** -1 is "do not care"
** 0 is "DM only"
** 1 is "PM only"
** 2 is "TM only"
** 3 is "CTF only"
** 4 is "RM only"
** 5 is "INF only"
** 6 is "HTF only"
* BE is 1 to filter "BE-protected servers only," 0 is "do not care."

Setting any fields to values other than those specified here will produce unexpected results.
 

===102 List begin===
This data type indicates the beginning of the server list that is returned from the lobby to the client. It contains no data except the number of servers that the list represents.
f©SERVERCOUNT\n
Where:
* SERVERCOUNT is the number of servers in the list. The list starts with the next packet received in this connection
 
===103 Server Entry===
g©VERSION©IP©PORT©GAMESTYLE©PLAYERS©MAXPLAYERS©MAP©NAME©BOTS
©BONUSFREQ©RESPAWN©CONNECTION©SURVIVAL©REALISTIC©DEDICATED©OS©PASSWORDED©BE©COUNTRY\n
Where:
* VERSION is XY, coming from the Soldat version number 1.X.Y. For example, the version for 1.4.2 is 42
* IP is the IP of the server in dotted-quad format.
* PORT is the port of the server
* GAMESTYLE is the gamestyle of the server:
** 1 is PM
** 2 is TM
** 3 is CTF
** 4 is RM
** 5 is INF
** 6 is HTF
* PLAYERS is the number of players in the server
* MAXPLAYERS is the player limit of the server
* MAP is the server's current map name
* NAME is the name of the server
* BOTS is the number of bots in the server
* BONUSFREQ is the bonus frequency of the server
* RESPAWN is the respawn time for the server
* CONNECTION is the connection type of the server:
** 0 is Modem
** 1 is ISDN
** 2 is DSL
** 3 is T1
* SURVIVAL is 1 for survival mode, 0 for not.
* REALISTIC is 1 for realistic mode, 0 for not
* DEDICATED is 1 for dedicated, 0 for not
* OS is 1 for Linux, 0 for Windows
* PASSWORDED is 1 for "password set," 0 for "no password"
* BE is 1 if the server is BE-protected, 0 for not
* COUNTRY is the 2 letter country code of the server or A1 for unknown
 
===104 List End===
This packet type signifies the end of the server list. It only consists of five field separators and an end-line character. 
h©©©©©\n
 
==Future Work==
There are changes coming in the future. The lobby protocol as of 1.5.1 will most likely allow a client to specify a filter for scripting.

A future version of Soldat, possibly 1.5.2 or 1.6.0 (whatever "major" version there is after 1.5.0) will contain a new lobby that will allow the protocol to support link-dead and Berserker, as well as other games. This is to remove the need to maintain a server and protocol for each game. This new lobby will be called exLobby, and is currently being worked on by FliesLikeABrick

==See Also==
* [[Client-Lobby Protocol Parsers]]

==External Links==
* [http://rr.soldat.pl Soldat Lobby Website]

Security Related Scripts

2012-08-23T17:59:24Z

Shoozza: Created page with "Simple SpamMeter"

[[Simple SpamMeter]]

MM

2012-08-23T17:58:05Z

Shoozza: Created page with "'''Michal Marcinkowski''' is the original sole developer of Soldat, Crimson Glory, and R. His current primary focus is link-dead, which is under heavy development...."

'''Michal Marcinkowski''' is the original sole developer of Soldat, [[Crimson Glory]], and [[R]]. His current primary focus is [[link-dead]], which is under heavy development.

==External Links==
* [http://mm.soldat.pl MM: What I Do] - Michal Marcinkowski's Development Blog

[[Category:Soldat Developers]]

CharlieScore

2012-08-23T17:57:39Z

Shoozza: Created page with "===From the Scripting Manual=== '''Data Type:''' Byte '''Description:''' Current score of the Charlie (Yellow) team. ==External Links== * [http://enesce.com/help/ind..."

===From the Scripting Manual===
'''Data Type:''' Byte

'''Description:'''
Current score of the Charlie (Yellow) team.

==External Links==
* [http://enesce.com/help/index.html?Variables/CharlieScore.html Scripting Manual page for CharlieScore]

[[Category:Server Scripting]][[Category:Server Scripting Variables]]

Version

2012-08-23T17:57:12Z

Shoozza: Created page with "===From the Scripting Manual=== '''Data Type:''' String '''Description:''' Current Soldat Version the Soldat Server supports. (1.3.1) ==External Links== * [http://en..."

===From the Scripting Manual===
'''Data Type:''' String

'''Description:'''
Current Soldat Version the Soldat Server supports. (1.3.1)

==External Links==
* [http://enesce.com/help/index.html?Variables/Version.html Scripting Manual page for Version]

[[Category:Server Scripting]][[Category:Server Scripting Variables]]

NumBots

2012-08-23T17:56:45Z

Shoozza: Created page with "===From the Scripting Manual=== '''Data Type:''' Byte '''Description:''' Current number of BOT Players in the server. ==External Links== * [http://enesce.com/help/in..."

===From the Scripting Manual===
'''Data Type:''' Byte

'''Description:'''
Current number of BOT Players in the server.

==External Links==
* [http://enesce.com/help/index.html?Variables/NumBots.html Scripting Manual page for NumBots]

[[Category:Server Scripting]][[Category:Server Scripting Variables]]

RayCast

2012-08-23T17:56:02Z

Shoozza: Created page with " ''function RayCast(P1X, P1Y, P2X, P2Y: single; var Distance: single; MaxDist: integer): boolean;'' '''Parameter Info:''' P1X (Single): X coordinate of Point 1 P1Y (Sin..."

''function RayCast(P1X, P1Y, P2X, P2Y: single; var Distance: single; MaxDist: integer): boolean;''

'''Parameter Info:'''
P1X (Single): X coordinate of Point 1
P1Y (Single): Y coordinate of Point 1
P2X (Single): X coordinate of Point 2
P2Y (Single): Y coordinate of Point 2
Distance (Single): You must specify a variable that will hold the distance from Point1 to Point2
MaxDist (Integer): Maximum distance that RayCast will scan.

'''Description:'''
This function will check if Point 2 is visible from Point 1, meaning no player/bullet colliding polygons in between the two points.
The main purpose of this is for use with CreateBullet, so it may return true if there are "Only Player Collides" polygons between the two points.

==Examples==
<source lang="pascal">
var
Dist,x,y: Single;
begin
x := GetPlayerStat(1,'x');
y := GetPlayerStat(1,'y');
if not RayCast(x,y,x,y - 700,Dist,800) then begin
// Player 1 must be under cover! So we cant really drop da bomb.
exit;
// CreateBullet goes here.
end
end;
</source>

==External Links==
* [http://enesce.com/help/index.html?Functions/RayCast.html Scripting Manual page for RayCast]

[[Category:Server Scripting]][[Category:Server Scripting Functions]]

BotChat

2012-08-23T17:55:19Z

Shoozza: Created page with "===From the Scripting Manual=== ''procedure BotChat(ID: byte; Text: string);'' '''Parameter Info:''' ID (Byte): ID of the BOT ( Does (and will not, dont ask) not work on..."

===From the Scripting Manual===
''procedure BotChat(ID: byte; Text: string);''

'''Parameter Info:'''
ID (Byte): ID of the BOT ( Does (and will not, dont ask) not work on human players )
Text (String): Text for the bot to speak.

'''Description:'''
This function will make a bot say something! They are alive!

==Examples==
<source lang="pascal">
begin
BotChat(1,'Oogie boogie I come to you from beyond the grave!');
// Assuming player ID 1 is a bot.
end;
</source>

==External Links==
* [http://enesce.com/help/index.html?Functions/BotChat.html Scripting Manual page for BotChat]

[[Category:Server Scripting]][[Category:Server Scripting Functions]]

ForceWeapon

2012-08-23T17:54:50Z

Shoozza: Created page with "===From the Scripting Manual=== ''procedure ForceWeapon(ID, Primary, Secondary, Ammo: byte);'' '''Parameter Info:''' ID (Byte): Player ID to change weapon. Primary (By..."

===From the Scripting Manual===
''procedure ForceWeapon(ID, Primary, Secondary, Ammo: byte);''

'''Parameter Info:'''
ID (Byte): Player ID to change weapon.
Primary (Byte): Weapon Number to set primary weapon to.
Secondary (Byte): Weapon Number to set secondary weapon to.
Ammo (Byte): Ammo to give the player. 0 for default.

'''Description:'''
This function will force the specified player(ID) to change their Primary and Secondary weapons.
NOTE: Set Ammo to 0 to use the default ammo count for the (Primary) gun.

==Examples==
<source lang="pascal">
begin
ForceWeapon( 0, 3, 0, 0 );
// Forces all players to use AK as primary.
ForceWeapon( ID, 3, 0, 0 );
// Forces player 'ID' to use AK as primary.
end;
</source>

==External Links==
* [http://enesce.com/help/index.html?Functions/ForceWeapon.html Scripting Manual page for ForceWeapon]

[[Category:Server Scripting]][[Category:Server Scripting Functions]]

StartVoteMap

2012-08-23T17:54:08Z

Shoozza: Created page with "===From the Scripting Manual=== ''procedure StartVoteMap(voter: byte; mapname: string);'' '''Parameter Info:''' voter (Byte): Player ID of the player who will appear as ..."

===From the Scripting Manual===
''procedure StartVoteMap(voter: byte; mapname: string);''

'''Parameter Info:'''
voter (Byte): Player ID of the player who will appear as the Vote Starter.
mapname (String): Case sensitive name of the map to be voted, excluding the .PMS file extension.

'''Description:'''
This function will start a map vote for (mapname) and will appear as started by (voter).

==Examples==
<source lang="pascal">StartVoteMap(1,'ctf_Kampf'); //Start a map vote for ctf_Kamf from player 1</source>

==External Links==
* [http://enesce.com/help/index.html?Functions/StartVoteMap.html Scripting Manual page for StartVoteMap]

[[Category:Server Scripting]][[Category:Server Scripting Functions]]

Length

2012-08-23T17:53:15Z

Shoozza: Created page with "===From the Scripting Manual=== ''function Length(Text: string): integer;'' '''Parameter Info:''' Text (String): String to checks the length of. '''Description:''' ..."

===From the Scripting Manual===
''function Length(Text: string): integer;''

'''Parameter Info:'''
Text (String): String to checks the length of.

'''Description:'''
This function will return the length of a string.

==Examples==
<source lang="pascal">var
MyString: string;
begin
MyString := 'Hello World!';
WriteLn('"'+MyString+'" is '+inttostr(length(MyString))+' characters');
end;
</source>

'''Output:'''
"Hello World" is 12 characters

==External Links==
* [http://enesce.com/help/index.html?Functions/Length.html Scripting Manual page for Length]

[[Category:Server Scripting]][[Category:Server Scripting Functions]]

WriteConsole

2012-08-23T17:52:44Z

Shoozza: Created page with "===From the Scripting Manual=== ''procedure WriteConsole(ID: byte; Text: string; Colour: longint);'' '''Parameter Info:''' ID (Byte): Player ID to write text to. Set to ..."

===From the Scripting Manual===
''procedure WriteConsole(ID: byte; Text: string; Colour: longint);''

'''Parameter Info:'''
ID (Byte): Player ID to write text to. Set to 0 to write to all players!
Text (String): Text to be written to the console. Will be prefixed with ' [*] ' to prevent exploiting.
Colour (Longint): Colour the text should be when drawn to the console.

'''Description:'''
This function will add text to the players(ID) console. Note that all message are prefixed with ' [*] ' to prevent scripters from spoofing other console messages.
Set ID to 0 to write the text to ALL Players in the server!

==Examples==
<source lang="pascal">begin
WriteConsole(0,'Pickled Onions are nice!',$EE81FAA1);
// Will draw: " [*] Pickled Onions are nice!" to ALL players consoles.
// $EE81FAA1 is the colour, in AA RR GG BB format. (Alpha, Red, Green,Blue);
end;
</source>

==External Links==
* [http://enesce.com/help/index.html?Functions/WriteConsole.html Scripting Manual page for WriteConsole]

[[Category:Server Scripting]][[Category:Server Scripting Functions]]

Time

2012-08-23T17:51:46Z

Shoozza: Created page with "Using Unix timestamps is the most common and practical way of storing time & date. This consists in and unsigned integer which holds the number of seconds since the Unix Epoch..."

Using Unix timestamps is the most common and practical way of storing time & date. This consists in and unsigned integer which holds the number of seconds since the Unix Epoch (January 1 1970 00:00:00 GMT). Many formatting functions exist almost every programming language: C, C++, PHP, Ruby, Pascal, Python, etc.

[[Category:Misc]]

Index.php

2012-08-23T17:50:15Z

Shoozza: Created page with "===Server General=== *Editing Soldat.ini *Editing Server.ini *Editing Mapslist.txt *[[Ports|About Ports, Protocols and Forwardin..."

MediaWiki:Geshi.css

2012-08-23T16:16:00Z

Shoozza: Changes values to pixel as em wont work

/* CSS placed here will be applied to GeSHi syntax highlighting */

div.mw-geshi {
padding: 1em;
margin: 1em 0;
border: 1px dashed #2f6fab;
background-color: #f9f9f9;
font-size: 12.8px;
line-height: 16.6333em;
}

MediaWiki:Geshi.css

2012-08-23T15:53:31Z

Shoozza: Fixed missing semicolon

MediaWiki:Geshi.css

2012-08-23T15:53:11Z

Shoozza: Set line-height to same as pre tag

MediaWiki:Geshi.css

2012-08-23T15:51:52Z

Shoozza: Set font size to be equal to pre tag font size

/* CSS placed here will be applied to GeSHi syntax highlighting */

div.mw-geshi {
padding: 1em;
margin: 1em 0;
border: 1px dashed #2f6fab;
background-color: #f9f9f9;
font-size: 0.8em
}

EnEsCe

2012-08-15T14:10:43Z

Shoozza: EnEsCe is no longer working on Soldat, his Soldat hosting was stopped.

'''Enesce''', was an active [[Server]] and [[Client]] developer, has put a huge effort into making Soldat awesome. He implemented Pascal scripting support into the server and wrote a comprehensive manual for the API.

==External Links==
* [http://enesce.com/ EnEsCe Corp] - EnEsCe's former popular dedicated server hosting (no longer hosting)
* [http://enesce.com/help/ Official Soldat Scripting Manual]

[[Category:Soldat Developers]]

Main Page

2012-08-14T15:48:23Z

Shoozza: Added old main page and changed the notice to stand out more, fixed a spelling error in the old history page

{| style="color:black; background-color:#ffcccc;" cellpadding="10" class="wikitable"
|The old Soldat Devs wiki has become plagued with spam and other problems. We are working on migrating all content to this new wiki, but you can find the old content at http://devs-old.soldat.pl for now. Please feel free to register and copy pages over! We need all the help we can get.
|}
__NOTOC__
== Welcome to the #Soldat.Devs Reference Wiki! ==

Welcome to the Soldat Developer's Wiki. Here you'll find reference to most of the common topics asked about or discussed in the channel and forums. If you have have bugs or suggestions please contact us on [irc://irc.quakenet.org/#soldat.devs #soldat.devs at QuakeNet]. General information for Soldat can be found and added at the [http://wiki.soldat.nl Official Soldat Community Wiki]. This wiki is intended as a location for the more specific and more technical knowledge that currently exists within the Soldat community.

{| width=100%
| style="width: 50%; vertical-align: top" |

===Server General===
*[[Server|Introduction]]
*[[Commands|Commands Reference]]
*[[Logging|Logging]]
*[[BattlEye|BattlEye Anti-Cheat Engine]]

===Server Configuration===
*[[Soldat.ini|Editing soldat.ini]]
*[[Server.ini|Editing server.ini]]
*[[Mapslist.txt|Editing mapslist.txt]]
*[[Gamestat.txt|Reading gamestat.txt]]
*[[Banned.txt|Bans in banned.txt]]
*[[Remote.txt|Remote admins by IP]]

| style="width: 50%; vertical-align: top" |

===Server Scripting===
*[[Scripting_basics|Introduction]]
*[[Scripting|Reference Manual]]
*[[Scripting Templates]]

===General Technical Information===
*[[Ports|About Ports, Protocols and Forwarding]]
*[[Testing your connectivity|Testing Your Connectivity]]
*[[Refresh|Using the REFRESH Packet]]
*[[Raw_commands|RAW Commands]]
*[[Command line arguments|Command Line Arguments]]
*[[Map|Map File Structure]]
*[[Download_thread|Map/Files Downloading]]
*[[Lobby Protocol]]
*[[Bandwidth|About Bandwidth]]
|}

DoDamage

2012-08-14T15:26:53Z

Shoozza: Created page with "===From the Scripting Manual=== ''procedure DoDamage(ID: byte; Damage: integer);'' '''Parameter Info:''' ID (Byte): Player ID to do damage to. Damage (Integer): Amount..."

===From the Scripting Manual===
''procedure DoDamage(ID: byte; Damage: integer);''

'''Parameter Info:'''
ID (Byte): Player ID to do damage to.
Damage (Integer): Amount of damage to do (4000 to get a definate kill)

'''Description:'''
This function will do damage to the specified player.

NOTE: If you wish to be able to specify a player ID doing damage, use DoDamageBy:
procedure DoDamageBy(ID,Shooter: Byte; Damage: Integer);

==Examples==
<source lang="pascal">begin
DoDamage(1,4000); //Instantly kill player 1 (Will appear as 'You killed yourself')
end;
</source>

==External Links==
* [http://enesce.com/help/index.html?Functions/DoDamage.html Scripting Manual page for DoDamage]

[[Category:Server Scripting]][[Category:Server Scripting Functions]]