ASSS Wiki - User contributions [en]

MERVBot Tutorial

2007-04-28T14:54:11Z

Cyan~Fire: updated links

This tutorial is based on the ever-popular MERVBot Tutorial by Underlord. It has since been updated to reflect new changes with MervBot. To see examples of how to use this instruction, see [[MERVBot Example Code]].

This tutorial also assumes that you have a basic knowledge of C++. If you don't, check out cplusplus.com's great [http://www.cplusplus.com/doc documentation].

==Setting up a MERVBot (plugin)==

[http://catid.sscontinuum.com/ MERVBot download site]

===Obtaining MERVBot===

* Download the [http://catid.sscontinuum.com/files/MERVBot.rar latest build].
* Unrar MERVBot.rar into a new folder. (example c:\program files\continuum\mervbot)
* Unzip src.zip into "src" subfolder of that new folder (example c:\program files\continuum\mervbot\src)

===Preparing to write a plugin===

''Note:'' if you only want to execute someone's premade plugin (.dll), skip to [[MERVBot Tutorial#Run your bot dll|step 4]], otherwise continue to learn how to make your own bot

Download [http://catid.sscontinuum.com/files/Tutorial.rar DLL-plugin Tutorial] and unzip Tutorial.zip (containing spawn.h, spawn.cpp, and command.cpp) into a "tutorial" subfolder of that new folder. (example c:\program files\continuum\mervbot\src\tutorial).

''File descriptions:''
* spawn.h = declare/initialize globals
* command.cpp = code for commands coming into bot (ie /!help, /!play, etc)
* spawn.cpp = code that interacts with bot spawns

===Microsoft Visual c++===

<ol>
<li>Start Visual Studios 6.0.
<li>Click the Drop Down Menu labeled "File" at the top left of your screen.
<li>Click "New".
<li>On the next screen that comes up, choose from the Project tab, then Win32 Dynamic-Link Library
<li>Select the "/src" folder as the base folder (example c:\program files\continuum\mervbot\src)
<li>Name your project "mybot". This will make a "mybot" subfolder in your "src" folder. Click OK. (example creates c:\program files\continuum\mervbot\src\mybot)
<li>Choose to create an "Empty DLL project".
<li>Click "Finish".
<li>Click the Drop Down Menu labbled "Project".
<li>Click "Add To Project Files"
<li>Copy only spawn.h, spawn.cpp, and command.cpp from the "tutorial" folder into the this new folder. (example from c:\program files\continuum\mervbot\src\tutorial to c:\program files\continuum\mervbot\src\mybot)
<li>Click the Drop Down Menu labelled "Build".
<li>Click "Build (dll name)" - where (dll name) is "mybot"
<li>Go into your "mybot" folder and look for a folder named "Debug"
(example c:\program files\continuum\mervbot\src\mybot\debug)
<li>Your new DLL will be in that folder. (example mybot.dll)
<li>Copy mybot.dll to your base folder that has mervbot.exe in it (example c:\program files\continuum\mervbot)
</ol>

===Run your bot dll===

To run your bot you need your DLL (mybot.dll), Commands.txt, MERVBot.exe, MERVBot.ini, Operators.txt, Spawns.txt, and zlib.dll all in one folder (example c:\program files\continuum\mervbot).

<ol>
<li>Edit spawns.txt. '''Read every word of spawns.txt to find out what needs to go in there.'''

 
''Example:''
<pre>2v2-Bot-League : botpw : 2v2a : 2v2league : staffpw</pre>

''Note:'' The bot will attempt to create the name if it doesn't exist already.

<li>Edit MERVBot.ini
 
 
<pre>[Login]
Zone=216.33.98.254:21000 // your zone IP:PORT available from zone.dat in Continuum dir
</pre>

<li>Edit operators.txt. '''Read every word of operators.txt to find out what needs to go in there.''' 

''Example:''
<pre>
4:my_name:
4:another_sysop:
3:other_person:
</pre>

<li>Make sure the bot is on vip.txt or has smod+ access, then run MERVBot.exe.

<li>You can now edit your plugin code by opening "mybot.dsw" (example c:\program files\continuum\mervbot\src\mybot\mybot.dsw) in Microsoft Visual C++. Edit the spawn.h, spawn.cpp, and command.cpp to create your plugin, then build, copy your updated DLL to your MERVBot.exe folder and then execute the bot. Use the tutorial to get ideas on how to implement certain types of features into the bot.

</ol>

==Player Commands - (command.cpp)==

This section describes how to implement player commands into your plugin. Commands are sent to the botInfo::gotCommand function in command.cpp.

Example (makes bot reply to !test with "hi"):
<pre>
void botInfo::gotCommand(Player *p, Command *c) {
switch (p->access)
{
case OP_Moderator:
{
// handle moderator-operator commands here.
}
case OP_Player: //appropriate staff rank here.
{
if (c->check("test")) //replace "test" with whatever command you want
{
//put your command code here
sendPrivate(p,"hi"); //example
}
}
</pre>

===How to have commands with numerical parameters===
Example (!test #):
<pre>
if (c->check("test")) { // reads in test #, default to 1 if invalid number input
int temp = 1;

if (isNumeric(c->final))
temp = atoi(c->final);
</pre>

===How to have player name as input===
Example (!rank player):
<pre>
if (c->check("rank"))
{
String player_name = c->final;

if (player_name.IsEmpty()) // default name to self if invalid name
player_name = p->name;
</pre>

===How to have multi-parameter input===

Use the CRT function sscanf() to scan the string for the values.

Example (!squads squadA vs squadB ''or'' !squads teamA:squadA:teamB:squadB):
<pre>
else if (c->check("squads"))
{
char squadA[20], squadB[20];
int teamA, teamB;

strncpy(squadA, "", 20);
strncpy(squadB, "", 20);

int n_found;

//Note: %[A-Za-z ] is equivalent to %s, but allows an internal space.

//scan the string for the two squads separated by " vs "
n_found = sscanf(c->final, "%[A-Za-z ] vs %[A-Za-z ]", squadA, squadB);

//if that fails, scan the string for freqA:squadA:freqB:squadB
if (n_found < 2)
sscanf(c->final, "%d:%[A-Za-z ]:%d:%[A-Za-z ]", &teamA, squadA, &teamB, squadB);
}
</pre>

===Help Menu===
When a player sends !help to the bot, MERVBot calls botInfo::gotHelp() in each plugin loaded.
<pre>
void botInfo::gotHelp(Player *p, Command *c)
{
if (!*c->final)
{
sendPrivate(p, "4v4 Bot General Commands:");
sendPrivate(p, "------------------------");
sendPrivate(p, "!caps - get captain names");
sendPrivate(p, "!roster <squad> - get roster of a squad");
sendPrivate(p, "!schedule- get current schedule");
sendPrivate(p, "!score - get current score");
</pre>

==Event Calls==

MERVBot is event based, so when making a bot you need to decide what will happen at certain events. Normal plugins need to consider what happens when bot enters arena, player enters arena, player leaves arena, player events like kill, shipchange, teamchange, spec, move then any other relevant events to your bot. Just worry about events that are relevant to the tasks your bot is doing.

MERVBot sends events to botInfo::gotEvent() in spawn.cpp. Each supported event is already present and categorized in gotEvent(), along with the paramters that MERVBot sends with the event. When a plugin wants the bot to do something, it sends tell(event) to the bot.

See dllcore.h for a list of current events and their descriptions. Dllcore.h also contains functions (like makeFollowing) to make events to send back to the bot via tell().

<pre>tell(makeFollowing(false));</pre>

==The Messaging System==

Private message - void sendPrivate(Player *player, char *msg);

''Examples:''

<pre>
sendPrivate(p,"hi");

String s="test";
sendPrivate(p,s);

String s="test";
s += "ing";
sendPrivate(p,s);

char captain1[20];
char captain2[20];
strncpy(captain1,"",20);
strncpy(captain2,"",20);
sendPrivate(p,(String) captain1 + " and " + (String) captain2 + " are the captains.");
</pre>

Team message - void sendTeamPrivate(Uint16 team, char *msg); 
<blockquote>Examples: 
a) sendTeamPrivate(8025,"hi spec freq"); 
b) Uint16 test=0; sendTeamPrivate(test,"hi freq 0"); 
</blockquote>

Public message - void sendPublic(char *msg); 
<blockquote>Example: sendPublic("*arena " + (String) p->name + " is now a captain"); 
</blockquote>
Chat channel message - void sendChannel(char *msg); 
<blockquote>Example: sendChannel("hi chat channel"); 
</blockquote>
Remote private message - void sendRemotePrivate(char *name, char *msg); 
<blockquote>Example: sendRemotePrivate("Player01", "hi"); 
</blockquote>

Note: to have bot print several lines of text fast it needs sysop in the
arena (sysop in arena bot first spawns to also) otherwise it'll print slow to avoid being
kicked for spam

===Output of data in messages===
An example of using normal strings to output data/messages.
<pre>
// does *arena X pilots left in game
// NOTE: variable temp needs to be defined with some value

String s = "*arena ";
s += temp;
s += " pilots left in the game.";

sendPublic(s);
</pre>
Or,
<pre>
//NOTE: this can be considered inefficient.

sendPublic("*arena " + (String)temp + " pilots left in the game");
</pre>

An example using sprintf to align/space data, where output data will be in this approximate format.
<pre>
// output data will be in this approximate format (not lined up perfectly because of html)
// --------------------------------------------------------------------------------------
// Squad: squadname PTS FPTS K D DMG DEALT TAKEN F FK FLT
// --------------------------------------------------------------------------------------
// PlayerA 10000 500 116 101 9999 99999 10 150 980:55
// PlayerB 500 200 7 5 9999 99999 5 3 0:04

char str[255];
sendPublic("*arena--------------------------------------------------------------------------------");

sprintf(str, "*arena Squad: %-20s PTS FPTS K D DMG DEALT TAKEN F FK FLT",
freqs[freq].freqname
);

sendPublic(str);

sendPublic("*arena--------------------------------------------------------------------------------");

// assuming existing freqs struct with data
for (pilot=freqs[freq].playercount-1; pilot>=0; pilot--)
{
// on freq squad so print stats
char outString[255];

sprintf(outString, "*arena %-20s %12d %8d %3d %3d %10d %6d %2d %3d %3d:%02d",
freqs[freq].pilots[pilot].name,
freqs[freq].pilots[pilot].points,
freqs[freq].pilots[pilot].flagpoints,
freqs[freq].pilots[pilot].kills,
freqs[freq].pilots[pilot].deaths,
freqs[freq].pilots[pilot].dmgdealt,
freqs[freq].pilots[pilot].dmgtaken,
freqs[freq].pilots[pilot].flags,
freqs[freq].pilots[pilot].flagkills,
freqs[freq].pilots[pilot].flagtime /60,
freqs[freq].pilots[pilot].flagtime %60
);

sendPublic(outString);
}

// Notes: sprintf format = sprintf(output char string, spacing, variables)
// Notes: s = chars, d = integer, - = left align, right align default
// Notes: doing %02d = put 0 in front if not 2 digits, %3d:%02d makes 0:04 format
</pre>

==Time==

Each time MERVBot sends an EVENT_Tick to a plugin (once a second), the default handler code decrements each value in an array of countdowns. You can modify the number of countdowns and add code to occur at a specific value for one of the countdowns.

Setup number of timers and initialize in spawn.h:
<pre>
class botInfo
{
#define COUNTDOWNS 10 // how many countdowns you want
int countdown[COUNTDOWNS]; // this gives you 10 timers

// unrelated code

public:
botInfo(CALL_HANDLE given)
{
countdown[0] = 0;
countdown[1] = 60; // 60 seconds
//
// initialize values
//
countdown[9] = 5*60; // 5 minutes
</pre>
Using timer functions in spawn.cpp:
<pre>
case EVENT_Tick:
{
for (int i = 0; i < COUNTDOWNS; ++i) //cycles through each countdown you have
--countdown[i]; //note that countdowns will continue decrementing past 0.

if (countdown[1] == 2) // when timer #1 hits two seconds
{
// do stuff here when timer #1 hits 2 seconds
// example: sendPublic("two seconds left, setting timer to 1 minute");
// example: countdown[1] = 60; // change timer #1 value
}
</pre>

You can then have events (such as EVENT_PlayerDeath) change the value of a countdown to make the bot do something a set time after an event occurs.

=== Tracking time not using countdown[n] ===

This is a solution to a common problem of determining the amount of time it takes for something to occur. Using basic math, we record a start-time B, and an end-time E, both in the unit of seconds, we calculate the time elapsed by E-B.

Lucky for us, Windows provides a function called GetTickCount() that is a measurement of time (milliseconds) that we can use for such cases.

So:
<pre>
int begin = GetTickCount();

// do some code here.

int end = GetTickCount();

int delta = (end - begin) / 1000; // elapsed time converted to seconds from milliseconds
</pre>

=== Obtaining the current time ===

''Requirements:'' Include <time.h>.

Use:
<pre>
char u[100];
time_t t=time(NULL);
tm *tmp = localtime(&t);
strftime(u,99,"%c",tmp);
sendPublic("Current date and time: " + u);
</pre>

==Writing Functions==

For this example, we will take the function called closeto, which determines
if a player exists in an specific radius around a point. Now to apply this function to a MervBot plugin, you need to write it into the spawn.cpp - at the top of the file in the //////// DLL "import" //////// setion, as below:
<pre>
//////// DLL "import" ////////

bool closeto(Player *p, int x, int y, int tolerance)
{
// Requires the function abs() to be declared elsewhere.
// Return if player p is in area of square with center x, y
// and radius = tolerance
return (abs((p->tile.x) - x) - tolerance) && (abs((p->tile.y) - y) - tolerance);
}
</pre>

If you want your function to have access to the data from spawn.h botInfo class, you make the function apart of it. To do this, we add the '''botInfo::''' infront of the function name, in spawn.cpp.
<pre>
//////// DLL "import" ////////

bool botInfo::closeto(Player *p, int x, int y, int tolerance)
{
...
}
</pre>
In '''spawn.h''', add your method's prototype without botInfo::, it will look
like this:
<pre>
//...
botInfo(CALL_HANDLE given)
{
// ...
}
bool closeto(Player *p, int x, int y, int tolerance); // Your function prototype.

void clear_objects(); //provided by Catid, and already exists.
void object_target(Player *p); //provided by Catid, and already exists.
// ...
};
</pre>
If you're not familiar with prototypes, notice it is similar to that in your spawn.cpp, but without the botInfo::, and a trailing ;.

===Function notes===

Remember that you can pass variables [http://www.cplusplus.com/doc/tutorial/tut2-3.html by reference]. If variables are passed by reference, any changes a function makes to the variables will remain after the function returns.

From time to time you will need to pass an array to a function. An example illustrating this is:
<pre>
int freqs[5]; // declare our example data.

// call function - notice freqs and not freqs[5] or freqs[].
my_function(freqs); //You're not passing the array itself, just a pointer to the array.

// function - notice freqs[] and not freqs[5] or freqs
void my_function(int freqs[]) {} //You're specifying that the freqs parameter is an array
</pre>

==Cycling through players==

MERVBot stores player-related data in a linked list. A linked list is a datatype that stores its data in a series of structures linked to each other, hence the name.

To search through the players in the arena, just start at the first link, then continue through all the following links until you reach the end:
<pre>
_listnode <Player> *parse = playerlist->head; //set to first link of the player linked list

while (parse) //parse will be NULL when we reach the last link
{
Player *p = parse->item; //item is the actual data stored in the link

// do functionality here
// Example 1: sendPrivate(p,"*watchdamage"); // turns on all pilot's watchdamage
// Example 2: if (p->safety != 0) sendPrivate(p,"*spec"); // spec all pilots in safe zone

parse = parse->next; //set parse to the next link
}
</pre>

For example, assuming our bot has smod+ privilages, the following code will set all non-spectator players to a specific ship. First begin by adding the following function prototype to the spawn.h in the botInfo class:
<pre>
void handleCmdSetShip(enum Ship_Types ship);
</pre>

In spawn.cpp add:
<pre>
void botInfo::handleCmdSetShip(enum Ship_Types ship)
{
//Note that the parameter ship is of the Ship_Types enum,
//so its value is hopefully restricted to the proper types.

_listnode <Player> *parse = playerlist->head;
while (parse)
{
Player *p = parse->item;

if ( p->ship != ship && p->ship != SHIP_Spectator )
sendPrivate(p, "*setship " + (String)ship);

parse = parse->next;
}
}
</pre>

To use, just call the function with the appropriate Ship_Type from the enum in clientprot.h:
<pre>
handleCmdSetShip(SHIP_Warbird);
</pre>

==Random numbers==

===Generating a random number===

To use this method, these two includes must be used:
<pre>
#include "time.h" //provides time() function.
#include "stdlib.h" //provides srand() and rand() functions.
</pre>

Use:
<pre>
srand(time(NULL)); // seed random number generator.

rand(); // randomize.

int temp = (int) (51 * ((float)rand()/RAND_MAX));
// the above line returns a random integer between 0 and 51.
// Note: RAND_MAX is a global constant defined in stdlib.h
</pre>

===Picking a random pilot===

''Note:'' A required user-defined function, getInGame(), must be created for this example to work.

<pre>
int temp = GetTickCount() % getInGame(); // getInGame() = how many pilots in arena

Player *rabbit = NULL;

_listnode <Player> *parse = playerlist->head;
while (parse)
{
Player *p = parse->item;

if (p->ship != SHIP_Spectator) // if player is not a spectator
if ( !(--temp) ) // and if we've hit the randomly-selected pilot
{
rabbit = p;
break;
}
parse = parse->next;
}
</pre>

==Storing data for pilots==

There are several ways to store data for pilots (ie tracking flagtime or kills in a period of time). Note that these methods are all purely internal to the bot, and don't effect anything beyond the plugin in any way.

# Built-in get/setTag: Tracks data until player leaves the arena, then automatically deletes data.
# Modified perm get/setTag: Tracks data until bot leaves arena, then automatically deletes data. (Advantage: easier to sort by player)
# Custom Structs: Tracks data until plugin deletes it. (Advantage: easier to sort by freqs)

''Note:'' 2 and 3 are similar in effect, mostly the difference is in how you are able to search through data you need to decide which method of storing data is best for each bot depending on what it does.

===Built-in get/setTag method===

Player tags simply tag a player with a number. Define the wanted values in '''spawn.h''' at the top:
<pre>
#define DMG_DEALT 0
#define DMG_TAKEN 1
</pre>

In spawn.cpp, initialize the values on ArenaEnter and PlayerEnter:
<pre>
case EVENT_ArenaEnter:
{
// ...

// do for all pilots in arena when bot enters
_listnode <Player> *parse = playerlist->head;
while (parse)
{
Player *p = parse->item; // get pilot

set_tag(p, DMG_DEALT, 0); // initialize to 0
set_tag(p, DMG_TAKEN, 0);
sendPrivate(p, "*watchdamage"); // optionally turn on player *watchdamage

parse = parse->next; // get next pilot
}
}
</pre>
<pre>
case EVENT_PlayerEntering:
{
// ...
set_tag(p, DMG_DEALT, 0); // initialize to 0
set_tag(p, DMG_TAKEN, 0);
sendPrivate(p,"*watchdamage");
}
</pre>

Then somewhere edit the tag values:
<pre>
case EVENT_WatchDamage:
{
// sets tag for k (shooter) to be old value plus damage currently dealt

int old_damage = get_tag(k, DMG_BOMB_DEALT);
set_tag(k, DMG_BOMB_DEALT, old_damage + damage);
}
</pre>

The following demonstrates how to retrieve the tag values as a command in command.cpp:
<pre>
if (c->check("showstats"))
{
int temp = get_tag(p, DMG_TOTAL_DEALT);

String s = "You've done ";
s += temp;
s += " damage so far!";

sendPrivate(p,s);
}
</pre>

===Modified permanent get/setTag method===

This method is the same as get/setTag with some modifications to the tag code to retain them after the player leaves. Beware of using this method if bot is in an arena for long periods of time, linkedlist could get huge.

// spawn.h, add char name[20]; into struct PlayerTag
<pre>
struct PlayerTag
{
Player *p;
char name[20];
int index;
int data;
};
</pre>

In spawn.cpp:
<pre>
case EVENT_PlayerLeaving:
{
Player *p = (Player*)event.p[0];

// killTags(p); // remove so tag not deleted on arena exit

// ...
</pre>

Locate in spawn.cpp and modify accordingly:
<pre>
int botInfo::get_tag(Player *p, int index)
{
_listnode <PlayerTag> *parse = taglist.head;
PlayerTag *tag;

while (parse)
{
tag = parse->item;

// if (tag->p == p)
if (strcmp(tag->name,p->name)==0) // now tracking by player name, not pointer
if (tag->index == index)
return tag->data;

parse = parse->next;
}
return 0;
}

void botInfo::set_tag(Player *p, int index, int data)
{
_listnode <PlayerTag> *parse = taglist.head;
PlayerTag *tag;

while (parse)
{
tag = parse->item;

//if (tag->p == p)
if (strcmp(tag->name,p->name)==0) // now tracking by player name, not pointer
if (tag->index == index)
{
tag->data = data;
return;
}
parse = parse->next;
}

tag = new PlayerTag;
// tag->p = p; // not tracking by pointer anymore
strncpy(tag->name, p->name, 20); // tracking by player name
tag->index = index;
tag->data = data;
taglist.append(tag);
}
</pre>

===Using structs===

In '''spawn.h''':
<pre>
class botInfo
{
struct freqdata
{
int kills, deaths;
};
// ...
};
</pre>

To make use of this structure, implement accordingly:
<pre>
freqdata freqs[100]; // 100 of those structs
</pre>
Access the data in spawn.cpp using
<pre>
freqs[56].kills = 1;
</pre>

See CPlusPlus.com's [http://www.cplusplus.com/doc/tutorial/tut3-5.html Structures] tutorial for a more comprehensive guide. Note that, as shown on the bottom of the page, you can have structures within structures. Thus, for example, you could have a structure for each freq with a structure for each player nested within them.

==Input/Output to files==

For reading and/or writing to files with C++ you must have the required include statement as follows:
<pre>
#include <fstream>
using namespace std;
</pre>

===File stream input===
The following example will show you how to read a file, duel.ini, line by line.

<pre>#include "stdlib.h" // for atoi()</pre>

<pre>
ifstream file("duel.ini");

if (!file.good()) // if there was an error opening the file
sendPublic("*arena Error opening file for reading"); // or add your own error handler
else
{
char line[256];

// read in MaxBoxes=X
while (file.getline(line, 256))
{

if (CMPSTART("MaxBoxes=", line)) //Does the line begin with MaxBoxes= ?
{
MAX_BOXES = atoi(&(line[9])); //If so, read the value into an integer, using atio.
break;
}
}

file.close();
}
</pre>

===File stream output===
The following code example will demonstrate how to append to a file, duelleaguestat.inc.
<pre>
ofstream file("duelleaguestat.inc", ios::app); // app = put all data at end of file

if (!file.good()) // if there was an error opening the file
sendPublic("*arena Error opening file.");
else
{
file << squad1<< endl; // squad1 = char[20]
file << " vs "<< endl;
file << squad2<< endl; // squad2 = char[20]
file.close();
}
</pre>

Similarly, you are able to write an output of a String to a file:
<pre>
// key is converting String to (char*) to file write
String str = freqs[freq].slotname[slot];
str += ", Repels: " + (String)(int) t->repel;
file << endl;
file << (char*) str;
</pre>

===Input with GetPrivateProfileString===

GetPrivateProfileString(), a function provided by Windows for reading INI files, will automatically find an INI key (like "MaxBoxes=") in a file for you. See the [http://msdn.microsoft.com/library MSDN Library] for help on this function. This next example will show how to read input using GetPrivateProfileString() based on the rampage plugin.

The file format for rampage.ini is like this:
<pre>
7=is on a killing spree! (6:0)
10=is opening a can of booya! (9:0)
</pre>

In '''rampageini.cpp''':
<pre>
#include "rampageini.h"
#define WIN32_LEAN_AND_MEAN
#include <windows.h>

#define NUM_RANKS 10
#define BUFFER_LEN 256

struct RampageSettings
{
char quotes[NUM_RANKS][BUFFER_LEN];
};

void LoadSettings(RampageSettings &setts);

static char path[BUFFER_LEN];

char *rank_type[NUM_RANKS] = { "7", "10" };

void LoadSettings(RampageSettings &setts)
{
GetCurrentDirectory(BUFFER_LEN - 64, path);
strcat(path, "\rampage.ini");

for (int i = 0; i < NUM_RANKS; ++i)
{
GetPrivateProfileString("Comments", rank_type[i], "-ERROR-",
setts.quotes[i], BUFFER_LEN, path);
}
}
</pre>

==Player data==

As stated earlier in the tutorial, MervBot stores useful player data internally as Player objects, see player.h for implementation details.

* p->name = player name stored as char[20] (''Note:'' SubSpace protocol allows for usernames to be 19+ in length, do not rely on this for player-name comparisions.)
* p->squad = player squad stored as char[20]
* p->ship = ship (0-9) enumerated as SHIP_Warbird, SHIP_Spectator, etc..
* p->safety = whether ship is in safety zone (boolean)
* p->bounty = player bounty
* p->energy = player energy (have bot with *energy on to get accurate readings)
* p->flagCount = how many flags player is holding
* p->team = player frequency
* p->(burst, repel, thor, brick, decoy, rocket, portal) = how many items of that type player has
* p->(stealth, cloak, xradar, awarp, ufo, flash, safety, shields, supers) = if player has that item on (boolean)
* p->score.killPoints = player kill points
* p->score.flagPoints = player flag points
* p->score.wins = player kills from f2
* p->score.losses = player deaths from f2

Just access the respective member of the Player class to check the player's property.

For example, in spawn.cpp, to check whether a player is in a safety zone:
<pre>
EVENT_PlayerMove:
{
Player *p = (Player*)event.p[0];

if ( p->safety ) // player is in safe zone.
{
// do something.
}

if ( !p->safety ) // player NOT in safe zone.
{
// do something.
}
}
</pre>

=== Obtaining a player pointer using name comparison ===

Since Player pointers are internal to MERVBot, it is necessary to find a way of obtaining a Player pointer from the identifying information given by the game. One of the simpler ways is just to compare the names after converting to lowercase.

''Note'': Using pilot names as vital comparisions should be used with caution. See [http://cypherjf.sscentral.com/articles/bots-as-clients/ Bot-Issues] by CypherJF.

<pre>
// return Player* info (or NULL if not found) from p->name info
Player * botInfo::GetPilot(char *name)
{
// get pilot from a name, return as TempPlayer
_listnode <Player> *parse = playerlist->head;

//convert search name to lowercase
char nname[20], pname[20];
strncpy(nname, name, 20);
tolower(nname);

while (parse)
{
Player *p = parse->item;

// convert to lowercase to compare
strncpy(pname,p->name,20);
tolower(pname);
if (strcmp(pname,nname)==0)
return p;

parse = parse->next;
}

return NULL; //player not found
}
</pre>

==Bot built in functions==

Here are some useful MervBot commands to control what the bot is doing.

Player.cpp:
* Player::move(Sint32 x, Sint32 y) moves a player to the coordinates specified by x and y
* Player::clone(Player *p) clones a player into a player class

Look in Commands.txt , command.cpp (core), or /!help to bot to see all bot external commands (example /!go <arena>).

''LVZ Object toggling commands in plugins are to go here.''

[[Category:Guides]]

LVZ

2007-02-06T18:21:39Z

Cyan~Fire: /* Adding/Replacing Files */ separate files and priority

An LVZ is a file that can customize an arena beyond simply changing the map with a LVL. An LVZ can contain compressed files, map objects, screen objects, or a combination of the three. The server will send the LVZs to a [[Continuum]] client when it enters an arena for storage in the zone's directory (Continuum\Zones\[Zone Name]) along with the LVLs and news.txt for that zone. The primary way of creating an LVZ is the [http://www.shanky.com/cgi-bin/ryan/download.cgi?lvztoolkit.zip LVZ Toolkit] and the [http://forums.minegoboom.com/viewtopic.php?t=3907 Cross Platform Lvz Toolkit] (which includes bug fixes and has better compression).

Continuum only supports 256 different images in all of your lvz files combined. If you exceed this limit, toggling the 257th image will turn on the 1st image. This is often undesired, so be careful.

== Adding/Replacing Files ==

Adding a file to an LVZ with the same filename (extension does not matter) as a default Continuum image or sound file will replace that file for that arena. For example, placing a file called victoryl.wav in an LVZ will override the standard victory music in that arena. Along with the standard BMP (<tt>.bm2</tt>) and WAV (<tt>.wa2</tt>) formats, Continuum supports [http://www.libpng.org/pub/png/ PNG], GIF, and JPEG — MP3 is ''not'' supported.

Adding a file to an LVZ with a different filename from one of the defaults will make that image available to be placed as a map object or screen object.

Note that files included by themselves (not within an LVZ) will take precedence over ones inside an LVZ. This also means that a user can place a file (say, ship1.bm2) in a zone's folder and it will override any custom ship graphics the zone uses.

== Map Objects ==

Map objects are images placed by Continuum at a static location on the [[map]]. They can be animated in the normal way for [[SubSpace]]/Continuum, that is, with horizontal and vertical tiles representing frames. Their display time and display mode (when Continuum will display them) can be customized.

== Screen Objects ==
[[Image:Refpoints.gif|thumb|Click for larger view indicating the locations of the modifiers.]]

Screen objects are images placed by Continuum at a specific point on the screen or a point relative to one of the presets, meaning they will move around with the pilot. Like map objects, they can be animated and their display time and mode can be customized.

== See Also ==
* [[LVZ Format|LVZ File Format]]
* [[LVZ Scripting]]
* [[Continuum Level / Ini Tool]]

[[Category:Definitions]]

Talk:UDP Game Protocol

2006-11-19T21:12:22Z

Cyan~Fire: reply to bak

[[User:Smong|Smong]]: Can you explain how to use the handler offsets. Which versions of Subspace they are valid for with MD5's of the binaries, and possible a link to the latest version.

[[User:D1st0rt|D1st0rt]]:I got [http://d1st0rt.sscentral.com/packets.html this one] from kirk's site, its a bit more in depth and include the directory server protocol

I just realized that this list is totally incomplete. I'll try to update it soon. --[[User:Cyan~Fire|Cyan~Fire]]

For the record, d1st0rt's is a lot better than the one here. [[User:BaK|BaK]] 02:57, Nov 17, 2006 (PST)

[[User:Mine GO BOOM|Mine GO BOOM]] 10:18, Nov 17, 2006 (PST): Any specific parts that are better, or the whole layout?

It would be a pain to put on here because the source has a bunch of MS office junk that should be stripped out. Actually, it doesn't even display properly in Firefox. --[[User:Cyan~Fire|Cyan~Fire]]

Commands.hlp

2006-11-04T16:33:12Z

Cyan~Fire: hmm probably should include cyph's app

Continuum gets the content for its F1 help menu from commands.hlp. As usual, an arena can override it to customize the help menu.

=== Format ===
The commands.hlp file is just a plaintext file with special control characters, '#' and '%'. The # character creates a new page, like so:
<pre># This is the title for the new page</pre>

The '%' character changes the color of the text. Changing the color prints all text that color until another color is specified. These are the possible colors:
* %W = White
* %B = Blue (public chat)
* %Y = Yellow (team chat)
* %G = Green (private messaging)
* %b = Brown (red, chat channels)
* %P = Purple
* %p = Pink

The '%' character also has a special use: dynamic key specifiers. For example, "%KB_BULLET" will print whatever key fires bullets and "%KEsc" will print whatever key brings up the game menu. The best place to look for these key specifiers is the default commands.hlp file that comes with Continuum.

== See also ==
* [http://forums.minegoboom.com/viewtopic.php?t=2295 Continuum F1 Editor] by CypherJF

Commands.hlp

2006-11-04T16:31:38Z

Cyan~Fire:

Misc FAQ

2006-11-04T16:20:32Z

Cyan~Fire: slight reformat, added link to commands.hlp

These are general questions about the game that don't really fit anywhere else.

=== What color is used as transparent in splash.bm2? ===
255, 0, 255, which is a sort of purple.

=== What program should I use to open .bm2 and .wa2 files with? ===
You can just rename these extensions to .bmp and .wav respectively. Then they should open with your favourite viewer/editor automatically.

=== I try to download a map but I am just shown the tileset in my browser ===
You need to right click and save the link to disk. The beginning of the data inside a map is a bitmap.

=== How do I change the F1 help box? ===
Edit [[commands.hlp]].

[[Category: FAQ]]

Directory Game Server Protocol

2006-10-07T15:21:03Z

Cyan~Fire: game server's what?

== Introduction ==
[[Zone|Game Servers]] such as [[subgame2]] and [[ASSS]] register their prescence on [[Directory server|Directory Servers]]. This page describes the portion of the '''directory server protocol''' that game servers use.

This system uses UDP packets, most commonly over port 4991. Maximum length of the packet is only limited to the directory server software itself, so it varies from each application. The specific lengths of most fields are static, with the zone description field being the only value that varies its length.

== Protocol ==
<pre>
g2d

register game server
offset size comment
0 4 ip (leave this set to 0?)
4 2 port
6 2 player count
8 2 saving scores? (boolean)
12 4 version (set this to 134)
14 32 zone name (null terminated)
46 16 password (null terminated)
62 32 reserved (suggested to set this to 0)
92 ? description (must be null terminated)
</pre>

== Notes on Priit's dirserv ==
Descriptions are recorded to the stats file with a max length of 490 bytes. The reserved field can be filled with any random data, as the directory server ignores this field completely.

== Notes on Catid's dirserv ==

=== Validating the packet ===
* The length of the packet must be greater than 95/0×5F bytes. Basically this means the description can be blank but must be null terminated.
* The first 4 bytes (the IP field) must be zeroed.
* The reserved field must be zeroed.
* The name, password and description must be null terminated.
* The "save scores" field must be either 0 or 1.

=== Validating the zone name ===
* Name must be at least one character long.
* First and last characters must cannot be a space.
* No more than one space in a row.
* Only ASCII characters between ‘ ‘ [0x20] and ‘~’ [0x7E], inclusive.

== Notes on zone.dat ==
Due to the format of zone.dat used to store your favourite zones, zone names should not begin with '#' [0x23] or contain any ',' [0x2C].

== See also ==
* [http://cypherjf.sscentral.com/articles/game-server-to-directory-server/ CypherJF's original document]
* [http://web.archive.org/web/*/http://www4.ncsu.edu/~rniyenga/subspace/old/dprotocol.html Hammuravi's page]
* [http://asss.yi.org/asss/ ASSS Source]: src/directory.c
* [[Directory Client Protocol]]

[[Category: Protocol]]

UDP Game Protocol

2006-03-24T15:12:50Z

Cyan~Fire: incomplete

This is a document outlining the UDP protocol used by game clients ([[Continuum]], [[SubSpace]], and all of the [[Bots]] in use today). This is not exhaustive but has been compiled from [[LogicBot|LogicBot++]], [[MERVBot]], and various files from [http://catid.ssihosting.com/ Catid Inside] and [http://snrrrub.sscentral.com/ Snrrrub's Dump]. The posted outline is taken from the FPL at [http://explody.ssihosting.com/ Explody's Loot]. All clients also use the [[core protocol]]. '''It is, as of right now, incomplete. Some packets do not have their contents filled out.'''

<pre>
Full Packet List (Consolidated Subspace and Continuum Packet List)

//====================\\
|| C2S ||
\\====================//

ID CLASS HANDLER PKT DESC
- OFFSET LEN CONTENTS
- [Type Meaning]

----------------------------------------
0x01 Game 0x40B750 Arena Login

- 0 1 Type
- 1 1 Ship type
- 2 2 Allow audio?
- 4 2 X resolution
- 6 2 Y resolution
- 8 2 Main arena number 0xFFFF for random pub, 0xFFFD for sub.
- 10 16 Arena name (optional, if offset 8 is 0xFFFD)

----------------------------------------
0x02 Game 0x40B3C1 Leave arena

- 0 1 Type

----------------------------------------
0x03 Game 0x409BA9 Position

- 0 1 Type
- 1 1 Direction
- 2 4 Timestamp
- 6 2 X velocity
- 8 2 Y pixels
- 10 1 Checksum
- 11 1 Togglables
- 12 2 X pixels
- 14 2 Y velocity
- 16 2 Bounty
- 18 2 Energy
- 20 2 Weapon info
- 22 2 Energy (Optional)
- 24 2 S2C latency (Optional)
- 26 2 Timer (Optional)
- 28 4 Item info (Optional)

----------------------------------------
0x04 Game 0x40CAA1 Packet tampering

- 0 1 Type

----------------------------------------
0x05 Game 0x40A15B Death message

- 0 1 Type

----------------------------------------
0x06 Chat 0x40B67C Chat

- 0 1 Type
- 1 1 Chat type
- 0x00 Arena
- 0x01 Public macro
- 0x02 Public message
- 0x03 Team message
- 0x04 Freq
- 0x05 Private message
- 0x06 Moderator warning
- 0x07 Remote private message
- 0x09 Channel message
- 2 1 Sound code
- 3 2 Target player's player ID
- 5 - Text

----------------------------------------
0x07 Game 0x40AC3B Take green

- 0 1 Type

----------------------------------------
0x08 Game 0x40B26E Spectate request

- 0 1 Type
- 1 2 Player ID

----------------------------------------
0x09 Game 0x40C0E7 Password/Login

- 0 1 Type
- 1 1 Boolean: New user (1 = New, 0 = Not New)
- 2 32 Name
- 34 32 Password
- 66 4 Machine ident (drive serial number - can be random for bots)
- 70 1 ConnectType (0x00 is a good idea)
- 71 2 Timezone bias
- 73 2 Unkown
- 75 2 Client version (0x24 = Ctm, 0x86 = SS)
- 77 4 Unkown, memory checksum, Set to = 444
- 81 4 Unkown, memory checksum, Set to = 555
- 85 4 Permission ident
- 89 12 Unkown

----------------------------------------
0x0A Game 0x40CAA1 Packet tampering

- 0 1 Type

----------------------------------------
0x0B Game 0x409EA9 SSUpdate.EXE request

- 0 1 Type

----------------------------------------
0x0C Game 0x409A6F Map Request

- 0 1 Type

----------------------------------------
0x0D Game 0x409A9F news.txt request

- 0 1 Type

----------------------------------------
0x0E Game 0x40B4D7 Voice message

- 0 1 Type

----------------------------------------
0x0F Game 0x40AEF5 Frequency change

- 0 1 Type

----------------------------------------
0x10 Game 0x40BF47 Attach request

- 0 1 Type

----------------------------------------
0x11 Game 0x40CAA1 Packet tampering

- 0 1 Type

----------------------------------------
0x12 Game 0x40CAA1 Packet tampering

- 0 1 Type

----------------------------------------
0x13 Game 0x40ADDC Flag request

- 0 1 Type

----------------------------------------
0x14 Game 0x40B183 Unknown

- 0 1 Type

----------------------------------------
0x15 Game 0x40B1EB Drop flags

- 0 1 Type

----------------------------------------
0x16 Game 0x40B8C7 File transfer

- 0 1 Type

----------------------------------------
0x17 Game 0x40B645 Registration information response

- 0 1 Type

----------------------------------------
0x18 Game 0x40AF19 Set ship type

- 0 1 Type

----------------------------------------
0x19 Game 0x40B41E Set personal banner

- 0 1 Type

----------------------------------------
0x1A Game 0x4097BA Security checksum

- 0 1 Type Byte 0x1A
- 1 4 Weapon Count
- 5 4 Settings Checksum *2
- 9 4 Subspace.EXE Checksum
- 13 4 Map.LVL Checksum
- 17 4 S2CSlowTotal
- 21 4 S2CFastTotal
- 25 2 S2CSlowCurrent
- 27 2 S2CFastCurrent
- 29 2 S2CRelOut (?Unsure?)
- 31 2 Ping
- 33 2 Ping Average
- 35 2 Ping Low
- 37 2 Ping High
- 39 1 Slow Frame Detected (Boolean)

----------------------------------------
0x1B Game 0x4096C9 Security violation

- 0 1 Type

----------------------------------------
0x1C Game 0x409626 Drop brick

- 0 1 Type

----------------------------------------
0x1D Game 0x40948B ?setsettings

- 0 1 Type

----------------------------------------
0x1E Game KotH Timer drop

- 0 1 Type

----------------------------------------
0x1F Game 0x408EBD Fire a ball

- 0 1 Type

----------------------------------------
0x20 Game 0x409322 Ball request

- 0 1 Type

----------------------------------------
0x21 Game 0x408F95 Soccer goal scored

- 0 1 Type

----------------------------------------
0x22 Game 0x4096E2 ? Task switch ?

- 0 1 Type

----------------------------------------
0x23 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x24 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x25 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x26 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x27 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x28 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x29 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x2A CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x2B CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------

//====================\\
|| S2C ||
\\====================//

ID CLASS Handler DESC
- OFFSET LEN CONTENTS
- [Type Meaning]

----------------------------------------
0x01 Game 0x402A7E UID notification

- 0 1 Type
- 1 4 ID

----------------------------------------
0x02 Game 0x402A24 In game /* We are in the arena */

- 0 1 Type

----------------------------------------
0x03 Game 0x402B43 Player Entering

- 0 1 Type
- 1 1 Ship type
- 2 1 Accepts audio messages
- 3 20 Player name (confirmed ASCIIZ)
- 23 20 Squad name (confirmed ASCIIZ)
- 43 4 Flag points
- 47 4 Kill points
- 51 2 Player ident
- 53 2 Team
- 55 2 Wins
- 57 2 Losses
- 59 2 Turretee ident
- 61 2 Flags carried
- 63 1 Boolean: Has KoTH

----------------------------------------
0x04 Game 0x402C58 Player leaving

- 0 1 Type
- 1 1 Player ID

----------------------------------------
0x05 Game 0x402D34 Player fired a weapon

- 0 1 Type

----------------------------------------
0x06 Game 0x402CFC Player died

- 0 1 Type
- 1 1 Death green
- 2 2 Killer ident
- 4 2 Killed ident
- 6 2 Bounty
- 8 2 ? Flags

----------------------------------------
0x07 Chat 0x40303D Chat

- 0 1 Type
- 1 1 Message Type
- 0x00 Arena
- 0x01 Public macro
- 0x02 Public message
- 0x03 Team message
- 0x04 Freq
- 0x05 Private message
- 0x06 Moderator warning
- 0x07 Remote private message
- 0x08 Red server errors, without a name tag (S2C only)
- 0x09 Channel message
- 2 1 Sound Code
- 3 2 PlayerID
- 5 - Message

----------------------------------------
0x0A Game 0x40306F Password response

- 0 1 Type byte
- 1 1 Accept response meaning
- 0 Login OK.
- 1 Unknown user.
- 2 Bad password.
- 3 Full arena.
- 4 Locked out.
- 5 Perission only.
- 6 Spectate only.
- 7 Too many points.
- 8 Connection too slow.
- 9 Perission only arena.
- 10 Server full.
- 11 Invalid name.
- 12 Offensive name.
- 13 No biller (not saving scores).
- 14 Server busy
- 15 Restricted zone (insufficient usage)
- 16 Demo Version <- If you get this, theres a serious problem.
- 17 Too many Demo Users (Same as above applys)
- 18 No Demo Players Allowed (again same as the above two)
- 255 Mod Access Required (Added by MGB)
- 2 4 Server version
- 6 4 ?
- 10 4 EXE checksum
- 14 4 ? unused
- 18 1 ? boolean
- 19 1 Boolean: Request registration form
- 20 4 ? memory checksum
- 24 4 News checksum (0 = no news file)
- 28 4 ? time/date
- 32 4 ? time/date

----------------------------------------
0x09 Game 0x402C22 Player score changed

- 0 1 Type

----------------------------------------
0x0A Game 0x4033AB Password packet response

- 0 1 Type

----------------------------------------
0x0B Game 0x403386 Soccer goal

- 0 1 Type

----------------------------------------
0x0C Game 0x402BEF Player voice

- 0 1 Type

----------------------------------------
0x0D Game 0x402C7C Set player frequency

- 0 1 Type

----------------------------------------
0x0E Game 0x402BC6 Create turret link

- 0 1 Type byte
- 1 2 Turreter ident (gunner)
- 3 2 Turretee ident (driver)(when -1, detaching)

----------------------------------------
0x0F Game 0x402A43 Arena settings

- 0 1 Type

----------------------------------------
0x10 Game 0x4027CD File transfer

- 0 1 Type

----------------------------------------
0x11 Game 0x4033AB No-op

- 0 1 Type

----------------------------------------
0x12 Game 0x4031D4 Flag position

- 0 1 Type

----------------------------------------
0x13 Game 0x403233 Flag claim

- 0 1 Type

----------------------------------------
0x14 Game 0x4030D5 Flag victory

- 0 1 Type

----------------------------------------
0x15 Game 0x40325C Destroy turret link

- 0 1 Type byte
- 1 2 Player ident

----------------------------------------
0x16 Game 0x403280 Drop flag

- 0 1 Type

----------------------------------------
0x17 Game 0x4033AB No-op

- 0 1 Type

----------------------------------------
0x18 Game 0x4030A6 Synchronization

- 0 1 Type

----------------------------------------
0x19 Game 0x4028FB Request file

- 0 1 Type

----------------------------------------
0x1A Game 0x4032A4 Reset score(s)

- 0 1 Type

----------------------------------------
0x1B Game 0x4032C8 Personal ship reset

- 0 1 Type

----------------------------------------
0x1C Game 0x4032E4 Put player in spectator mode / change extra info flag

- 0 1 Type

----------------------------------------
0x1D Game 0x402CC1 Player team and ship changed

- 0 1 Type byte
- 1 1 Ship type
- 2 2 Player ident
- 4 2 Team

----------------------------------------
0x1E Game 0x4033AB Banner flag

- 0 1 Type

----------------------------------------
0x1F Game 0x403209 Player banner changed

- 0 1 Type

----------------------------------------
0x20 Game 0x402ABF Collected prize

- 0 1 Type

----------------------------------------
0x21 Game 0x403302 Brick dropped

- 0 1 Type
repeated until the end of the message
- 1 2 X1 tiles
- 3 2 Y1 tiles
- 5 2 X2 tiles
- 7 2 Y2 tiles
- 9 2 Team
- 11 2 Brick ident (sent more than once)
- 13 4 Timestamp

----------------------------------------
0x22 Game 0x40316E Turf flag update

- 0 1 Type
repeated until the end of the message
- 1 2 Team for flag X

----------------------------------------
0x23 Game 0x403192 Flag reward granted

- 0 1 Type
repeated until the end of the message
- 1 2 Team
- 3 2 Points

----------------------------------------
0x24 Game 0x402AEA Speed zone statistics

- 0 1 Type

----------------------------------------
0x25 Game 0x402B1F Toggle UFO ship

- 0 1 Type

----------------------------------------
0x26 Game 0x4033AB No-op

- 0 1 Type

----------------------------------------
0x27 Game 0x4033AB Keep-alive

- 0 1 Type

----------------------------------------
0x28 Game 0x402EE3 Player position update

- 0 1 Type

----------------------------------------
0x29 Game 0x4030FD Map information

- 0 1 Type

----------------------------------------
0x2A Game 0x402867 Compressed map file

- 0 1 Type

----------------------------------------
0x2B Game 0x402787 Set personal KoTH timer

- 0 1 Type

----------------------------------------
0x2C Game 0x402762 KoTH game reset

- 0 1 Type

----------------------------------------
0x2D Game 0x4027AA ? Some other timer change ?

- 0 1 Type

----------------------------------------
0x2E Game 0x402741 Power-ball position update

- 0 1 Type

----------------------------------------
0x2F Game 0x403364 Arena directory listing

- 0 1 Type

----------------------------------------
0x30 Game 0x402707 Got zone banner advertisements

- 0 1 Type

----------------------------------------
0x31 Game 0x4033A6 Login Finished

- 0 1 Type

----------------------------------------
0x31 CTMGame You are now past the login sequence

- 0 1 Type

----------------------------------------
0x32 CTMGame Change personal ship coordinates

- 0 1 Type

----------------------------------------
0x33 CTMGame Custom login failure message

- 0 1 Type

----------------------------------------
0x34 CTMGame Continuum version packet

- 0 1 Type

----------------------------------------
0x35 CTMGame Object toggling

- 0 1 Type

----------------------------------------
</pre>
[[Category: Protocol]]

Talk:UDP Game Protocol

2006-03-24T15:12:03Z

Cyan~Fire: incomplete

Talk:This zone is not connected to the central player database

2006-02-18T20:11:47Z

Cyan~Fire: /* A page to itself? */

== A page to itself? ==

It seems odd to me to have a page just for this error. Maybe merge into an FAQ or some kind of "common errors" page? --[[User:Cyan~Fire|Cyan~Fire]]

Zones

2006-02-18T20:08:03Z

Cyan~Fire: merged into Zone

#REDIRECT [[Zone]]

Zone

2006-02-18T20:07:45Z

Cyan~Fire: merged "Zones" content

[[Image:Zone_venn_diagram.png|thumb|Venn Diagram of a Zone]]
A zone is Subspace jargon for a server. Each zone has a public [[Arena|arena]] where the majority of players will play. Subarenas can be open at the same time for duels or special events.

== Popular Zones ==

Here is a list of currently active and popular zones.

===SSC Zones===

*SFSS Ground Warfare (SSC) (http://www.bloodlark.com/rave/)
*SFSS Star Wars (SSC)
*SFSS SuB-iCiDe (SSC)
*SSCC Halo CTF
*[[Metal Gear CTF|SSCC Metal Gear CTF]]
*SSCC Omega Fire (http://www.omega-fire.com/)
*SSCE Hockey Zone (http://rshl.org/)
*SSCI Dragonball Z (http://www.ssdbz.com/)
*SSCI Gundam Wing
*SSCI Super Ships
*[[17th Parallel|SSCU 17th Parallel]]
*SSCU Death Star Battle (http://www.deathstarbattle.com/)
*[[Redstar|SSCU Redstar]]
*SSCU Trench Wars (http://www.trenchwars.org/)
*SSCX A Small Warzone (http://www.aswz.net/)
*SSCX Alpha West SVS (http://www.sscxalpha.com/)
*SSCX Chaos/League Zone SVS (http://www.subspacechaos.com/)
*SSCX Dueling Arizona SVS
*SSCX Extreme-Games (http://www.extreme-games.net/)
*SSCX Powerball (http://www.powerballzone.com/)
*SSCX Star Wars Realm (http://www.swrealm.net/Nuke/)
*SSCX Star Warzone (http://www.starwarzone.com/)
*SSCX Warzone CTF (http://www.wzctf.net/)
*SSCX-A BattleZone
*SSCX-A GTA
*[[Hyperspace|SSCX-A Hyperspace]]
*T3 The Gauntlet! (SSC) (http://www.t3g.org/)

===Non SSC Zones===

*SSI Flagging Turmoil
*SSN Assault
*SSN South Tejas (http://www.southtejas.com/)
*SSN Trust & Betrayal
*SSN Ultima Fire
*SSN Sniper
*SSZ Battle Field 1942 (http://www.battlefieldzone.net/)
*SSZ Counter Strike
*SSZ Desert Storm
*SSZ FLAG HELL
*SSZ Lethal Weapon
*SSZ Mystic Kingdom
*SSZ RPG World
*SSZ Zelda MotW

===League Zones===

*SSCU DSB LEAGUE
*SSCX Star Warzone League

===Development/Test Zones===

*SSCX asss test (powerball arena)
*SSCX asss test zone
*SSCX Hyperspace Test
*SSI TWDev Testing
*SSZ United Development
*[[Caramel Server]]
*[[RedMoonSociety|RMS Test Zone]]

[[Category: Definitions]]

Talk:Zones

2006-02-18T20:04:01Z

Cyan~Fire: /* Category */ type

[[User:Smong|Smong]]: What is going to happen about the virtual zones?

[[User:Akai|Akai]]: uhhh, everybody cool with "NAME OF ZONE (site link)" - and leaving the actual name for wikilinks?

[[User:Akai|Akai]]: Virtual zones?

[[User:Smong|Smong]]: The site link thing sounds good to me. And virtual zones let you spam the directory server with multiple entries for the same zone, like 'Hyperspace Test'.

== Category ==

I'm thinking some day I'm not lazy, I'm going to make pages for each of these zones which can eventually be filled out with screenshots and stuff; then this will be a category. Something that will come up is newbie zones that last for no time so I'm thinking something like one month uptime before we actually create a page for it? --[[User:Cyan~Fire|Cyan~Fire]]

How about just removing this list altogether, as it gets out of date very easily. All information here (and then some) is readily available on the directory server. --[[User:Cyan~Fire|Cyan~Fire]]

[[User:Smong|Smong]]: I suggest making this page redirect to [[Zone]] and fix Zone so it doesn't link back to Zones.

Good idea. I think I'll merge this page into [[Zone]], actually, as it doesn't have much content. --[[User:Cyan~Fire|Cyan~Fire]]

Talk:Zones

2006-02-18T20:03:48Z

Cyan~Fire: /* Category */

[[User:Smong|Smong]]: What is going to happen about the virtual zones?

[[User:Akai|Akai]]: uhhh, everybody cool with "NAME OF ZONE (site link)" - and leaving the actual name for wikilinks?

[[User:Akai|Akai]]: Virtual zones?

[[User:Smong|Smong]]: The site link thing sounds good to me. And virtual zones let you spam the directory server with multiple entries for the same zone, like 'Hyperspace Test'.

== Category ==

I'm thinking some day I'm not lazy, I'm going to make pages for each of these zones which can eventually be filled out with screenshots and stuff; then this will be a category. Something that will come up is newbie zones that last for no time so I'm thinking something like one month uptime before we actually create a page for it? --[[User:Cyan~Fire|Cyan~Fire]]

How about just removing this list altogether, as it gets out of date very easily. All information here (and then some) is readily available on the directory server. --[[User:Cyan~Fire|Cyan~Fire]]

[[User:Smong|Smong]]: I suggest making this page redirect to [[Zone]] and fix Zone so it doesn't link back to Zones.

Good idea. I think I'll merge this page into [[Zone], actually, as it doesn't have much content. --[[User:Cyan~Fire|Cyan~Fire]]

Hosts

2006-02-16T21:27:33Z

Cyan~Fire: general cleanups and separation into current and historical

Hosts, as the name implies, host [[SubSpace]] [[zone]]s (see [[zones|active zones]]). Most of the larger servers have adopted prefix tags, most notably a four letter tag beginning with [[SSC]] is most likely on the SSC billing network.

== Current Hosts ==

=== N734 ===
Owner: '''Dymolex''' 
email: dymolex yahoo.com

This network although active appears to be run from a dial-up modem.

=== SFSS ===
SFSS is run by '''Awestrike'''. Despite missing the SSC in the server prefix, all active zones are connected to the SSC [[biller]], as shown by a suffix.

=== SSCC ===
SSCC is run by [[Testtube]], who also is the [[sysop]] of [[Metal Gear CTF]].

=== SSCU SubSpace Europe ===
SSCU, hosted by [[PriitK]] was located in Europe and has been around for quite some time. Currently there are few zones remaining on the server, including [[17th Parallel]] (which has moved to a new server in northern Virginia) and [[Trench Wars]] (located in Atlanta), Georgia. Both are maintained by PriitK.

=== SSCX SubSpace Exodus ===
[http://www.sscx.net/ SSCX] is run by both '''Yarekim''' and '''Xalimar'''. Zones on this powerful server located in the western US, with the privilege of being on the SSC Network, thus the absence of any SSX prefix. All zones on the SSCX prefix are offered [[Powerbot]] for their own use.

SSCX also hosts ASSS zones under the prefix "SSCX-A".

=== SSM3 ===
Owner: '''EAGLE II''' 
aim: xxssm3xx 
email: ihod2005 msn.com

=== T3 ===
The T3 server is run by '''Mecbot+''' and hosts only one zone, T3 The Gauntlet, which is on the SSC biller network.

== Shut-down hosts ==

=== NTC ===
Owned by '''dark_mistress''' and '''TheBest999'''. Both changed their names, dark_mistress became Night_Fox and TheBest999 is also known as MS-DOS. TheBest999 supposedly created a new biller for the NTC network.

The network has also been known under the following tags, SSDM, SSN and TNT. It also once had control of www.subspacenetwork.com.

The owners left the scene after sustaining large amounts of abuse from the community and passed on administrative powers to '''SpeedUP!''' (not to be confused with StepUP) and '''SpeedDOWN!''' under yet another tag, SSU SubSpace University.

=== SSCI SubSpace International ===
SSI and SSCI, hosted in Texas and New Jersey, is run by [[1stStrike]], '''Argyle''', and [[User:ExplodyThingy|ExplodyThingy]].

In addition to zone hosting, SSI provides a biller for access to all willing zones on dedicated hosts. It is a public atmosphere operated for the sole purpose of uniting the non-SSC community. The new biller software was written by [[User:2dragons|2dragons]] in Java and is modular just like [[ASSS]] is modular. The backend is MySQL and allows for web-intergrated features such as remote management and stats displays. It will be maintained by 2dragons and ExplodyThingy.

=== SSDT ===
[http://www.digitization.org/ssdt/ SubSpace David Tombs] is a development zone server hosted by [[User:Cyan~Fire|Cyan~Fire]]. It is by no means a powerful server, but is one of the few servers that will accept any zone with at least some good plans for development.

=== SSI ===
[[#SSCI_SubSpace_International|SSCI]] also hosts zones on their own biller and server under this tag.

=== SSN SubSpace Network ===
SSN, located in Britain, was run by '''L. Chance''', but the host has since closed down. The server's complete history is unknown.

After L. Chance, the host formerly known as NTC changed names to SSN. It has since changed names again to SSU.

=== SSQ ===
Owner: '''Purge''' 
AIM: Purgifiy 
MSN: purge@hotmail.com 
Billing: SSI

This host also provides Windows ASSS support under the tag "SSQ-A".

=== SSZ SubSpace Network ===
SSZ, run by '''Jericho24.''' and '''Lord Assassin''', was a non-SSC network that hosted developing and startup zones hoping to succeed in the [[SubSpace]] world. It had its own biller programmed by tehsu.

It shut down with this message posted by Lord Assassin:

<blockquote>
Ok guys listen.
 
 After 12 months hard work to get a stable and professional server online and hosted several very good zones the time is arrived to think about the future of the SSZ Network.
 
 Jericho24. and myself spent more then $4000 in this project. We where also prommised to get the SSC billing if we could bring a stable server. Well at that point we did a very good job. The server had never any downtime because off server faillures. Only 1 or 2 times we went offline because some stupid human beings tryed to hack or flood the server.
 
 It is sad to announce but i think SSZ or any other good server never will get the SSC biller because SCC is controlled by several kids that dont know what responsibility is. Its a shame Prittk dont care about this, its a shame for the Subspace community SSZ will not receive SSC.
 
 Jericho24 and me are sad to announce we will shutdown SSZ by the end of this month unless we will receive several donations to keep SSZ alive.
 If you are interested to donate and keep SSZ alive, reply on this topic or send us a personal message.
 
 When we do not receive enough donations at the end of this year, we will give the hosted zones the chance to find another host. The server will be owned untill the end off January 2005. Contact SSZ staff for more details.
 
 SSZ Staff:
 LorD AsSasSiN - Admin
 Jericho24. -Admin
 Boba -Admin
 Zutshi -Admin
 Slicer -Netop
 LtNirvana -Netop
 Angelissa - Netop
 Dav1 - Netop
</blockquote>

Talk:Zones

2006-02-16T21:27:18Z

Cyan~Fire: /* Category */ destroy?

Talk:Servers

2006-02-16T21:15:35Z

Cyan~Fire: Talk:Servers moved to Talk:Hosts

#REDIRECT [[Talk:Hosts]]

Servers

2006-02-16T21:15:35Z

Cyan~Fire: Servers moved to Hosts

#REDIRECT [[Hosts]]

Talk:Hosts

2006-02-16T21:15:00Z

Cyan~Fire: /* Cleanup */ agreed

[[User:CypherJF|CypherJF]]: Actually I don't think SSN is run by L Chance anymore. I'm not sure the history of it but the latest back I can remember was Altec . running it with Sideburn? Spring/Summer of 2004, Altec . and L Chance brought back SSN using Lord Maucaub's biller system. They shut it back down after HALO switched back to SSZ; and now I believe Dark Mistress / TheBest999 / Cospar / MS-DOS; someone is running it.

[[User:Smong|Smong]]: I think NTC has it now. They keep changing tags which is annoying. For the record I remember them with SSDM and TNT too if you want to stick that in a 'most annoying network decisions ever' page.

[[User:CypherJF|CypherJF]]: Yeah NTC is the Dark Mistress / TheBest999 / Cospar / MS-DOS network.

[[User:Smong|Smong]]:Someone add NTC and SSDT at least. Also I think this page should be called Networks, but that is more jargon I guess and could easily be confused.

[[User:D1st0rt|D1st0rt]]:Whoa 17th is near me? Trench still has a lower ping

== Category? ==

There's already a category called ''Servers'', don't you think this should belong there? I know you couldn't have the short descriptions, but they're kinda hard to keep track of and not that useful. --[[User:Cyan~Fire|Cyan~Fire]]

Well, hmm. We could always make each server its own category, the short desc goes on the category desc, and each zone is added to the specific server category they are on. [[User:Pests|Pests]]

[[User:Smong|Smong]]: I don't think search looks at categories (I feel like I am typing that several times a day).

I wasn't saying remove the page, just saying get rid of the server list, since it'll soon become outdated and is redundant. But, whatever, no biggie. --[[User:Cyan~Fire|Cyan~Fire]]

== Combine Pages? ==

Since there's actually not all that much info to put about each of these servers, how would you feel about me merging all of the individual server pages here? This page could be divided up into Active and Inactive servers, if that's a problem. --[[User:Cyan~Fire|Cyan~Fire]]

[[User:Smong|Smong]]: SSZ Subspace Network? I think that needs changing. SSN is still run by L. Chance? Also who nicked the css for the wiki?

== Cleanup ==

[[User:Smong|Smong]]:
I don't like the look of this page. First Servers, I would prefer a page called Hosts or Networks.

Next a table of active networks, columns are: tag, owners + contact, website, billing (yes, own billing/yes, tag of other biller/no biller) and location. A network is considered active if it has its own menu on [http://stats.17thparallel.com stats.17thparallel.com].

<table border=1>
<tr><th>Tag</th><th>Operators</th><th>Website</th><th>Billing</th><th>Location</th></tr>
<tr><td>SSCC</td><td>Testtube</td><td>N/A</td><td>SSC</td><td>USA, East</td></tr>
<tr><td>SSCX</td><td>Xalimar, Yarekim</td><td>[http://www.sscx.net sscx.net]</td><td>SSC</td><td>USA, Multiple</td></tr>
<tr><td>SST</td><td>Confess <confess321@yahoo.com>(?), Top Gun(?)</td><td>[http://www.ssthosting.net www.ssthosting.net]</td><td>SST</td><td>USA, Central</td></tr>
</table>

The purpose of this table is to serve as a summary of active hosts and so people can quickly find contact details of who is operating them.

Next, a seperate section (or possibly page) containing a history of the networks, start/end dates, ownership, comments (reason for creation/closure, generally accepted reputation).

[[User:I88gerbils|i88gerbils]]: Why not give a brief 1-line summary of TAG, host, web site making the tag a wiki link to description + contact information? Kind of like the corporation info bar on wikipedia.

{{server}}? {{zone}}?

Agreed with basically all of this. I'll change the name now, and probably separate this at least into current and historical. --[[User:Cyan~Fire|Cyan~Fire]]

Talk:Bomb Settings

2005-09-22T20:25:01Z

Cyan~Fire: /* Lots of bombs */

[[User:Smong|Smong]]: Can anyone confirm that a bouncing bomb loses it's bbombdamagepercent damage modifier when it has used its last bounce? After the last bounce the graphic changes to a non-bouncing bomb.

[[User:Smong|Smong]]: After brief testing I think the bbombdamagepercent is retained even when the bouncing bomb's image becomes like a normal bomb. Also when you close bomb, or point blank shoot, you take normal damage, nothing extra.

== New Format ==
Requesting comments on the datatype thingy I did. --[[User:Cyan~Fire|Cyan~Fire]]

[[User:Smong|Smong]]: I think it does help passers by. Maybe just use Type instead of Datatype. (Also a minor nitpick, I would put a fullstop outside of a pair of brackets).

[[User:Pests|Pests]]: Wish I could help but that kind of info isnt parsable :)

[[User:Smong|Smong]]: You can do a best guess type. Some types you will just have to put 'undocumented', but the keys containing these words belong to certain types:
*pixel - pixels
*time, delay - 1/100th second
*percent - 1/10th percent
*energy, damage - energy
*speed - pixels per 10 seconds
*disable, reliable, allow - boolean
*radius - map tiles
*message - string
You will have to give priorities, like percent must be searched for before damage. Also there will be some errors, like the Continuum only setting All:Radius is in pixels not tiles. When it comes into pasting the output into the edit box you can then change any errors or types marked as undocumented. Some won't have types, like kill points multipliers.

I think it'll be easier and less error-prone just to do it manually. That way, SS oldies like me (haha) can use their knowledge. Oh, and I don't think "type" is quite as good a word as "datatype", personally. --[[User:Cyan~Fire|Cyan~Fire]]

[[User:Smong|Smong]]: Now I think 'Unit' is a more appropriate word. At least use 'Setting type', you don't need to be as vague and posh as 'Datatype'.

== JitterTime ==

[[User:Smong|Smong]]: Anyone have a formula for this? Seems the larger it is the bigger the amplitude of the jitter is. Also bombs that explode further away have a smaller jitter.

== Lots of bombs ==

"If your settings allow a lot of bombs to be flying around at once, lowering the value of this setting can improve frame rates."

But didn't Snrrrub show that SS limits the amount of weapons processed? I'm assuming Continuum emulates this? --[[User:Cyan~Fire|Cyan~Fire]]

:That is true, however common sense is also needed. I've found that graphical operations can be expensive. 200 bombs all on screen at the same time may have some effect on lower end machines. Also as a side note, if there's loads of bombs flying around then it might be a super zone which will use a lot of bandwidth. Even if the bomb fire delay is the same as send position delay, analysis of a connection shows the client sends plain position and weapon packets, where weapon packets only are needed since they also contain a position. --[[User:Smong|Smong]]

* Just want to throw this in here. I know people are often confused when there are a massive amount of weapon graphics (ie: bullets, bombs, bursts, etc.) that the stop showing up. The reason for this is that all the slots of available graphics are currently in-use and are not drawn. [[User:CypherJF|CypherJF]]

You serious? I'd think it would rather draw ships than bombs. And I see your logic, Smong, but I really don't think it's necessary these days, especially since Snrrrub found it took longer to calculate weapon positions than to draw them. I'd say the main reason for this setting would be for the MERC Samurai close-range bomb effect, but leaving that comment there is no big deal, I just wanted to point that out. :-P --[[User:Cyan~Fire|Cyan~Fire]]

Random Numbers

2005-09-22T20:05:03Z

Cyan~Fire: I supposed we should specify our constants...

[[SubSpace]] uses random numbers primarily in its encryption, generating [[prize]]s, and controlling [[door]]s.

The following code is used in generating the encrypted keystream, prizes, and doors:
<pre>
#define MULT_C 0x834E0B5F
#define DIV_C 0x1F31D

DWORD SS_RNG(DWORD seed)
{
DWORD nseed, temp;

temp = (MULT_C * (unsigned __int64)seed) >> 32;
temp = (temp >> 16) + (temp >> 31); //aka the sign bit

nseed = (seed % DIV_C) * 16807;
nseed -= (temp * 2836);
nseed += 123;

if (!nseed || nseed > 0x7FFFFFFF)
nseed += 0x7FFFFFFF;

return nseed;
}
</pre>

[[Category:Game Intricacies]]

Talk:Bomb Settings

2005-09-20T03:11:01Z

Cyan~Fire: /* Lots of bombs */ sig, sorry

Talk:Bomb Settings

2005-09-20T03:10:48Z

Cyan~Fire: Lots of bombs

Category:Protocol

2005-09-18T21:02:29Z

Cyan~Fire: capitalization, tense

These are various protocols in [[Subspace]]/[[Continuum]]. They define how to communicate with servers at the network layer.

The original protocols are UDP and exist on top of the [[core protocol]]. Some of the newer protocols are TCP.

Directory Client Protocol

2005-09-18T21:01:34Z

Cyan~Fire: capitalization

[[Core protocol]] is used as usual. Dirserv specific c2s/s2c protocol.

Continuum sends a sync request and SubSpace doesn't.
The list request is sent as reliable.

<pre>
c2s

0x01 list request
offset size comment
0 1 type 0x01
1 4 minimum players

s2c

0x01 list data
offset size comment
0 1 type 0x01
1 4 ip
5 2 port
7 2 player count
9 2 billing (on 0x01 0x00)
11 4 version (0x86 0x00 0x00 0x00)
15 64 name
79 ? description
packet repeats from offset 1 until end
</pre>

[[Category: Protocol]]

UDP Game Protocol

2005-09-18T21:00:16Z

Cyan~Fire: removed redundant core protocol

This is a document outlining the UDP protocol used by game clients ([[Continuum]], [[SubSpace]], and all of the [[Bots]] in use today). This is not exhaustive but has been compiled from [[LogicBot|LogicBot++]], [[MERVBot]], and various files from [http://catid.ssihosting.com/ Catid Inside] and [http://snrrrub.sscentral.com/ Snrrrub's Dump]. The posted outline is taken from the FPL at [http://explody.ssihosting.com/ Explody's Loot]. All clients also use the [[core protocol]].

<pre>
Full Packet List (Consolidated Subspace and Continuum Packet List)

//====================\\
|| C2S ||
\\====================//

ID CLASS HANDLER PKT DESC
- OFFSET LEN CONTENTS
- [Type Meaning]

----------------------------------------
0x01 Game 0x40B750 Arena Login

- 0 1 Type
- 1 1 Ship type
- 2 2 Allow audio?
- 4 2 X resolution
- 6 2 Y resolution
- 8 2 Main arena number 0xFFFF for random pub, 0xFFFD for sub.
- 10 16 Arena name (optional, if offset 8 is 0xFFFD)

----------------------------------------
0x02 Game 0x40B3C1 Leave arena

- 0 1 Type

----------------------------------------
0x03 Game 0x409BA9 Position

- 0 1 Type
- 1 1 Direction
- 2 4 Timestamp
- 6 2 X velocity
- 8 2 Y pixels
- 10 1 Checksum
- 11 1 Togglables
- 12 2 X pixels
- 14 2 Y velocity
- 16 2 Bounty
- 18 2 Energy
- 20 2 Weapon info
- 22 2 Energy (Optional)
- 24 2 S2C latency (Optional)
- 26 2 Timer (Optional)
- 28 4 Item info (Optional)

----------------------------------------
0x04 Game 0x40CAA1 Packet tampering

- 0 1 Type

----------------------------------------
0x05 Game 0x40A15B Death message

- 0 1 Type

----------------------------------------
0x06 Chat 0x40B67C Chat

- 0 1 Type
- 1 1 Chat type
- 0x00 Arena
- 0x01 Public macro
- 0x02 Public message
- 0x03 Team message
- 0x04 Freq
- 0x05 Private message
- 0x06 Moderator warning
- 0x07 Remote private message
- 0x09 Channel message
- 2 1 Sound code
- 3 2 Target player's player ID
- 5 - Text

----------------------------------------
0x07 Game 0x40AC3B Take green

- 0 1 Type

----------------------------------------
0x08 Game 0x40B26E Spectate request

- 0 1 Type
- 1 2 Player ID

----------------------------------------
0x09 Game 0x40C0E7 Password/Login

- 0 1 Type
- 1 1 Boolean: New user (1 = New, 0 = Not New)
- 2 32 Name
- 34 32 Password
- 66 4 Machine ident (drive serial number - can be random for bots)
- 70 1 ConnectType (0x00 is a good idea)
- 71 2 Timezone bias
- 73 2 Unkown
- 75 2 Client version (0x24 = Ctm, 0x86 = SS)
- 77 4 Unkown, memory checksum, Set to = 444
- 81 4 Unkown, memory checksum, Set to = 555
- 85 4 Permission ident
- 89 12 Unkown

----------------------------------------
0x0A Game 0x40CAA1 Packet tampering

- 0 1 Type

----------------------------------------
0x0B Game 0x409EA9 SSUpdate.EXE request

- 0 1 Type

----------------------------------------
0x0C Game 0x409A6F Map Request

- 0 1 Type

----------------------------------------
0x0D Game 0x409A9F news.txt request

- 0 1 Type

----------------------------------------
0x0E Game 0x40B4D7 Voice message

- 0 1 Type

----------------------------------------
0x0F Game 0x40AEF5 Frequency change

- 0 1 Type

----------------------------------------
0x10 Game 0x40BF47 Attach request

- 0 1 Type

----------------------------------------
0x11 Game 0x40CAA1 Packet tampering

- 0 1 Type

----------------------------------------
0x12 Game 0x40CAA1 Packet tampering

- 0 1 Type

----------------------------------------
0x13 Game 0x40ADDC Flag request

- 0 1 Type

----------------------------------------
0x14 Game 0x40B183 Unknown

- 0 1 Type

----------------------------------------
0x15 Game 0x40B1EB Drop flags

- 0 1 Type

----------------------------------------
0x16 Game 0x40B8C7 File transfer

- 0 1 Type

----------------------------------------
0x17 Game 0x40B645 Registration information response

- 0 1 Type

----------------------------------------
0x18 Game 0x40AF19 Set ship type

- 0 1 Type

----------------------------------------
0x19 Game 0x40B41E Set personal banner

- 0 1 Type

----------------------------------------
0x1A Game 0x4097BA Security checksum

- 0 1 Type Byte 0x1A
- 1 4 Weapon Count
- 5 4 Settings Checksum *2
- 9 4 Subspace.EXE Checksum
- 13 4 Map.LVL Checksum
- 17 4 S2CSlowTotal
- 21 4 S2CFastTotal
- 25 2 S2CSlowCurrent
- 27 2 S2CFastCurrent
- 29 2 S2CRelOut (?Unsure?)
- 31 2 Ping
- 33 2 Ping Average
- 35 2 Ping Low
- 37 2 Ping High
- 39 1 Slow Frame Detected (Boolean)

----------------------------------------
0x1B Game 0x4096C9 Security violation

- 0 1 Type

----------------------------------------
0x1C Game 0x409626 Drop brick

- 0 1 Type

----------------------------------------
0x1D Game 0x40948B ?setsettings

- 0 1 Type

----------------------------------------
0x1E Game KotH Timer drop

- 0 1 Type

----------------------------------------
0x1F Game 0x408EBD Fire a ball

- 0 1 Type

----------------------------------------
0x20 Game 0x409322 Ball request

- 0 1 Type

----------------------------------------
0x21 Game 0x408F95 Soccer goal scored

- 0 1 Type

----------------------------------------
0x22 Game 0x4096E2 ? Task switch ?

- 0 1 Type

----------------------------------------
0x23 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x24 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x25 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x26 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x27 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x28 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x29 CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x2A CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------
0x2B CTMGame 0x40C0E7 Continuum login

- 0 1 Type

----------------------------------------

//====================\\
|| S2C ||
\\====================//

ID CLASS Handler DESC
- OFFSET LEN CONTENTS
- [Type Meaning]

----------------------------------------
0x01 Game 0x402A7E UID notification

- 0 1 Type
- 1 4 ID

----------------------------------------
0x02 Game 0x402A24 In game /* We are in the arena */

- 0 1 Type

----------------------------------------
0x03 Game 0x402B43 Player Entering

- 0 1 Type
- 1 1 Ship type
- 2 1 Accepts audio messages
- 3 20 Player name (confirmed ASCIIZ)
- 23 20 Squad name (confirmed ASCIIZ)
- 43 4 Flag points
- 47 4 Kill points
- 51 2 Player ident
- 53 2 Team
- 55 2 Wins
- 57 2 Losses
- 59 2 Turretee ident
- 61 2 Flags carried
- 63 1 Boolean: Has KoTH

----------------------------------------
0x04 Game 0x402C58 Player leaving

- 0 1 Type
- 1 1 Player ID

----------------------------------------
0x05 Game 0x402D34 Player fired a weapon

- 0 1 Type

----------------------------------------
0x06 Game 0x402CFC Player died

- 0 1 Type
- 1 1 Death green
- 2 2 Killer ident
- 4 2 Killed ident
- 6 2 Bounty
- 8 2 ? Flags

----------------------------------------
0x07 Chat 0x40303D Chat

- 0 1 Type
- 1 1 Message Type
- 0x00 Arena
- 0x01 Public macro
- 0x02 Public message
- 0x03 Team message
- 0x04 Freq
- 0x05 Private message
- 0x06 Moderator warning
- 0x07 Remote private message
- 0x08 Red server errors, without a name tag (S2C only)
- 0x09 Channel message
- 2 1 Sound Code
- 3 2 PlayerID
- 5 - Message

----------------------------------------
0x0A Game 0x40306F Password response

- 0 1 Type byte
- 1 1 Accept response meaning
- 0 Login OK.
- 1 Unknown user.
- 2 Bad password.
- 3 Full arena.
- 4 Locked out.
- 5 Perission only.
- 6 Spectate only.
- 7 Too many points.
- 8 Connection too slow.
- 9 Perission only arena.
- 10 Server full.
- 11 Invalid name.
- 12 Offensive name.
- 13 No biller (not saving scores).
- 14 Server busy
- 15 Restricted zone (insufficient usage)
- 16 Demo Version <- If you get this, theres a serious problem.
- 17 Too many Demo Users (Same as above applys)
- 18 No Demo Players Allowed (again same as the above two)
- 255 Mod Access Required (Added by MGB)
- 2 4 Server version
- 6 4 ?
- 10 4 EXE checksum
- 14 4 ? unused
- 18 1 ? boolean
- 19 1 Boolean: Request registration form
- 20 4 ? memory checksum
- 24 4 News checksum (0 = no news file)
- 28 4 ? time/date
- 32 4 ? time/date

----------------------------------------
0x09 Game 0x402C22 Player score changed

- 0 1 Type

----------------------------------------
0x0A Game 0x4033AB Password packet response

- 0 1 Type

----------------------------------------
0x0B Game 0x403386 Soccer goal

- 0 1 Type

----------------------------------------
0x0C Game 0x402BEF Player voice

- 0 1 Type

----------------------------------------
0x0D Game 0x402C7C Set player frequency

- 0 1 Type

----------------------------------------
0x0E Game 0x402BC6 Create turret link

- 0 1 Type byte
- 1 2 Turreter ident (gunner)
- 3 2 Turretee ident (driver)(when -1, detaching)

----------------------------------------
0x0F Game 0x402A43 Arena settings

- 0 1 Type

----------------------------------------
0x10 Game 0x4027CD File transfer

- 0 1 Type

----------------------------------------
0x11 Game 0x4033AB No-op

- 0 1 Type

----------------------------------------
0x12 Game 0x4031D4 Flag position

- 0 1 Type

----------------------------------------
0x13 Game 0x403233 Flag claim

- 0 1 Type

----------------------------------------
0x14 Game 0x4030D5 Flag victory

- 0 1 Type

----------------------------------------
0x15 Game 0x40325C Destroy turret link

- 0 1 Type byte
- 1 2 Player ident

----------------------------------------
0x16 Game 0x403280 Drop flag

- 0 1 Type

----------------------------------------
0x17 Game 0x4033AB No-op

- 0 1 Type

----------------------------------------
0x18 Game 0x4030A6 Synchronization

- 0 1 Type

----------------------------------------
0x19 Game 0x4028FB Request file

- 0 1 Type

----------------------------------------
0x1A Game 0x4032A4 Reset score(s)

- 0 1 Type

----------------------------------------
0x1B Game 0x4032C8 Personal ship reset

- 0 1 Type

----------------------------------------
0x1C Game 0x4032E4 Put player in spectator mode / change extra info flag

- 0 1 Type

----------------------------------------
0x1D Game 0x402CC1 Player team and ship changed

- 0 1 Type byte
- 1 1 Ship type
- 2 2 Player ident
- 4 2 Team

----------------------------------------
0x1E Game 0x4033AB Banner flag

- 0 1 Type

----------------------------------------
0x1F Game 0x403209 Player banner changed

- 0 1 Type

----------------------------------------
0x20 Game 0x402ABF Collected prize

- 0 1 Type

----------------------------------------
0x21 Game 0x403302 Brick dropped

- 0 1 Type
repeated until the end of the message
- 1 2 X1 tiles
- 3 2 Y1 tiles
- 5 2 X2 tiles
- 7 2 Y2 tiles
- 9 2 Team
- 11 2 Brick ident (sent more than once)
- 13 4 Timestamp

----------------------------------------
0x22 Game 0x40316E Turf flag update

- 0 1 Type
repeated until the end of the message
- 1 2 Team for flag X

----------------------------------------
0x23 Game 0x403192 Flag reward granted

- 0 1 Type
repeated until the end of the message
- 1 2 Team
- 3 2 Points

----------------------------------------
0x24 Game 0x402AEA Speed zone statistics

- 0 1 Type

----------------------------------------
0x25 Game 0x402B1F Toggle UFO ship

- 0 1 Type

----------------------------------------
0x26 Game 0x4033AB No-op

- 0 1 Type

----------------------------------------
0x27 Game 0x4033AB Keep-alive

- 0 1 Type

----------------------------------------
0x28 Game 0x402EE3 Player position update

- 0 1 Type

----------------------------------------
0x29 Game 0x4030FD Map information

- 0 1 Type

----------------------------------------
0x2A Game 0x402867 Compressed map file

- 0 1 Type

----------------------------------------
0x2B Game 0x402787 Set personal KoTH timer

- 0 1 Type

----------------------------------------
0x2C Game 0x402762 KoTH game reset

- 0 1 Type

----------------------------------------
0x2D Game 0x4027AA ? Some other timer change ?

- 0 1 Type

----------------------------------------
0x2E Game 0x402741 Power-ball position update

- 0 1 Type

----------------------------------------
0x2F Game 0x403364 Arena directory listing

- 0 1 Type

----------------------------------------
0x30 Game 0x402707 Got zone banner advertisements

- 0 1 Type

----------------------------------------
0x31 Game 0x4033A6 Login Finished

- 0 1 Type

----------------------------------------
0x31 CTMGame You are now past the login sequence

- 0 1 Type

----------------------------------------
0x32 CTMGame Change personal ship coordinates

- 0 1 Type

----------------------------------------
0x33 CTMGame Custom login failure message

- 0 1 Type

----------------------------------------
0x34 CTMGame Continuum version packet

- 0 1 Type

----------------------------------------
0x35 CTMGame Object toggling

- 0 1 Type

----------------------------------------
</pre>
[[Category: Protocol]]

Cfg file

2005-09-18T20:50:57Z

Cyan~Fire: template.sss + server.cfg

[[Subgame]] stores all the settings for an arena in a .cfg file, with the filename matching the arena name. It stores the [[Bomb Settings]], [[Brick Settings]], [[Bullet Settings]], [[Burst Settings]], [[Cost Settings]], [[Custom Settings]], [[Door Settings]], [[Flag Settings]], [[Kill Settings]], [[King Settings]], [[Latency Settings]], [[Message Settings]], [[Mine Settings]], [[Misc Settings]], [[Owner Settings]], [[Packetloss Settings]], [[Periodic Settings]], [[Prize Settings]], [[Prizeweight Settings]], [[Radar Settings]], [[Repel Settings]], [[Rocket Settings]], [[Routing Settings]], [[Security Settings]], [[Shrapnel Settings]], [[Spawn Settings]], [[Soccer Settings]], [[Team Settings]], [[Territory Settings]], [[Toggle Settings]], [[Wormhole Settings]], and [[Ship Settings]].

These settings can be modified by editing the .cfg file itself (directly, using FTP, putfile, etc.), using the ?set [[commands|command]], or using the ?setsettings command. [[Subgame]] uses the template.sss file to format settings for in-game modification using ?setsettings. It also stores the settings for public (default) arenas in server.cfg.

[[Category:Subgame Settings]]

Talk:Subgame

2005-09-18T20:48:10Z

Cyan~Fire: test it?

Regarding the comment in .scr files; I thought also players need to be non-spec, but also, not in a safety zone either? [[User:CypherJF|CypherJF]]

You're welcome to test. --[[User:Cyan~Fire|Cyan~Fire]]

Subgame

2005-09-18T17:04:54Z

Cyan~Fire: .scr file information. couldn't think of a better place

Based on [[VIE]]'s special subgame, [[subgame]] (or subgame2) is the alternate server to [[ASSS]]. It was originally made by [[VIE]], but was edited by [[PriitK]] to support [[Continuum]]. It uses more memory than ASSS, lacks nearly all the features that ASSS has, and is not open source. subgame works in connection with a [[Billing Server]] to allow users to enter a zone. Old and stable, subgame is used by most zones today.

== .scr files ==
Subgame saves private arena scores in .scr files, one for each arena. These files are composed of repeating structures that hold score information for one player as follows:
<pre>struct PlayerScore
{
unsigned long userid; //given by ?userid command
unsigned short kills, deaths;
unsigned short victories; //incremented on a team victory, player must be in a ship, not spec.
long killpoints, flagpoints;
};</pre>
[http://www.shanky.com/cgi-bin/ryan/download.cgi?scrfiles.zip Here] are two tools to manipulate .scr files.

== Change Log ==
<pre>
----------------------------- version 1.34.14bs2 ------------------------------
Small update to disable "Unknown Integrity Violation" alerts caused by a yet
unsupported packet.

----------------------------- version 1.34.14bs -------------------------------
Removed handler for 'Process debugger' security warnings, as Cont039pr3 sends
them (as well as your process list) erroneously.

----------------------------- version 1.34.14b --------------------------------
Added new security checks for Continuum 0.39pr2

Fixed rare crash on certain invalid packet sequence

New server.ini variable: Misc:BindIP - local IP address to bind server ports
to. Useful in multihomed systems only.

----------------------------- version 1.34.14a --------------------------------
New server.ini variable: Misc:BotsIP - clients with that IP are allowed to
exceed packet flood limits

----------------------------- version 1.34.14 ---------------------------------
New server.ini variable: Misc:AllowPrerelease - default 1, when set, users with
new prerelease versions are allowed to play

New cfg variable: Misc:SaveSpawnScore - default 0, when set, server will save
arena score to arenaname.scr file. NB! default setting changes differs from
older subgame versions, where spawn scores were always saved to .scr file and
there was no option to disable it. Disabling .scr file save will make server
run smoother and will prevent server directory filling up with useless files.

Fixed false connection flood alerts

Fixed player not taking damage after macroing ?go arena several times

----------------------------- version 1.34.13c --------------------------------
Added client timer drift percentage to /*einfo

----------------------------- version 1.34.13b --------------------------------
Added support for position packet queueing and smart clustering to save
bandwidth. To enable it, set in server.ini Routing:QueuePositions:1. Following
variables can be used to control clustering process:
Routing:PosSendRadar - how long radar packets are queued, default 100 ms
Routing:PosSendEdge - how long packets on screen edge are queued, default 30 ms
Routing:PosSendClose - how long close packets are queue, default 20 ms
Routing:ClosePosPixels - how near are packets considered close, default 250
pixels

New cfg variable: Misc:MaxTimerDrift - percentage how much client timer is
allowed to differ from server timer [Continuum 0.38+]

Added support for chat channel multicast to prevent zone<>biller connection
overload on very popular chats like Hockey zone's ?chat=zilla

New cfg variable: Latency:NegativeClientSlowPacketTime - packets with future
timestamp farther in future than this variable are considered as slow packets.
Default value: 0 - feature is disabled. Feature is still experimental.
[Continuum 0.38+]

New cfg variable: Soccer:DisableWallPass - default 0, when set, passing ball
through walls is diabled. There must be clear line between ball and ship
center to pick up ball [Continuum 0.38+]

New cfg variable: Soccer:DisableBallKilling - default 0, when set, ships with
0 velocity in safezone don't catch ball [Continuum 0.38+]

----------------------------- version 1.34.13a --------------------------------
Fixed extreme lagging bug when subgame was stated when GetTickCount() returned
negative values (Windows has been running without rebooting 25 days)

----------------------------- version 1.34.13 ---------------------------------
Removed incoming bandwidth limit from localhost connections

New cfg variable: Misc:AntiWarpSettleDelay - time in 1/100th seconds after
warping/portaling/attaching during which artificial antiwarp is activated
[Continuum 0.38+]

New cfg variables: Spawn:Team0-X, Spawn:Team0-Y, Spawn:Team0-Radius - allows
specify spawn location and radius per team. If only Team0 variables are set,
all teams use them, if Team0 and Team1 variables are set, even teams use Team0
ones and odd team Team1 ones. It is possible to set spawn positions upto 4
teams (Team0-Team3) [Continuum 0.38+]

New cfg variable: Misc:DisableScreenshot - disables Continuum's screenshot
functionality for non-spectators if set to 1 [Continuum 0.37+]

New server.ini variable: Comms:FlushTime - time in millseconds how long server
will collect position packets before sending them to clients. Recommended
setting: 10 - 20

Fixed unauthenticated users (name starting with ^) getting moderator powers
when using billing server proxy and billing server is down

New server.ini variable: Comms:BandwithIdleTime - time in seconds when server
stops sending position packets to idle spectators. Useful to save bandwidth.
Idle time is also shown in /*einfo now

Fixed server crash when client requested to go to negative frequency

New server.ini variable: Comms:SelectTime - time in millseconds how long server
should wait incoming packet using select() function. This is replacement for
CPU:SleepTime, which sleeps constant time, regardless if there are incoming
packets waiting processing or not. Recommended settings: Comms:SelectTime:10,
CPU:SleepTime:0 and CPU:SleepPerIteration:0

Fixed bug in Continuum's protocol. NB! Continuum 0.38 will require 1.34.13

----------------------------- version 1.34.12a --------------------------------
Added proxy detection to /*einfo. Proxy is detected for Continuum 0.37 and
later clients. You need to set server IP address in server.ini [Misc] ServerIP
for it to work.
* Undetermined - SS 1.3x or Continuum 0.36 clients
* SOCKS5 proxy - User is using Continuum's built in SOCKS5 proxy
* Using proxy at localhost - player is using proxy ran in same machine as
Continuum client. There is no other reason to do so than monitoring or
tampering with packet stream
* Using custom proxy - player is using custom proxy. Suspect cheating.
* Using NAT - player is using router or firewall doing NAT translation
* Not using proxy - no proxy was detected between client and server

Fixed timer desync and slow FPS sysop messages. Before "Unknown interity
violation" was displayed

New cfg variable: Misc:StartInSpec - if set, players entering arena are always
put to spectator mode

New server.ini variable: Misc:ForceContinuumOnly - if set server will ignore
ContinuumOnly variable is all cfg files and require Continuum in all arenas

New command: *objset +/-<object id>,+/-<object id>,... - sets state of listed
map/screen objects. +<object id> shows object and -<object id> hides it. For
example "*objset +1,-20,+13" shows objects 1 and 13 and hides object 20.
Command is meant to replace *objon and *objoff commands and it can be sent
to player privately or to whole arena. Command is meant for humans to use, for
bots there is special packet for toggling objects states which is much more
efficient. See BuildLevel documentation for more info about the objects.
[Continuum 0.38+]

----------------------------- version 1.34.12 release -------------------------
Added support for zone staff chats. To use local chats set Misc:StaffChat in
server.ini to comma separated chat name list. Only players with moderator and
higher powers can enter these chats and in ?chat these chats are listed as
(staff) chatname

Disabled non-public chat ? commands (ie /?password or '?squadleave) as there
has beed a lot of accidents where players trying to help others will do the
command without intention

Bugfix in Continuum 0.37 user handling

----------------------------- version 1.34.12pr4 ------------------------------
Fixed a crash bug introduced in 1.34.12pr3 in user sound checking

New command: /*watchdamage - Toggles player damage reporting on/off for
selected player. When turned on moderator will see something like that:
PriitK took 500 damage from l33t L2 bomb having 1400 nrg [Continuum 0.37+]

----------------------------- version 1.34.12pr3 ------------------------------
Added support for team sounds. Regular users can play sounds %150 - %255 in
team chat, zone sysops can upload these sounds in lvz file

New cfg variable: Misc:MinUsage. Specifies amount of usage in hours for players
to play in arena.

Adding + in front of level files specified by Misc:LevelFiles will make
downloading them optional for users

----------------------------- version 1.34.12pr2 ------------------------------
Fixed crash when lvz file is specified in cfg, but file is not present

Fixed /*tinfo to display invalid last line

Fixed vip functionality to bypass code checksums

----------------------------- version 1.34.12pr1 ------------------------------
Added collecting of server<-> client clock synchronization info and commad
/*tinfo to view it.

Removed printing of XXX killed by YYY to server console

Removed updating of LastUsedStamp for spawn cfg files

New cfg variable: <ship>:Radius. It specifies ship radius in pixels. In old
Subspace all ships have fixed radius 14 pixels. This means that ships will fit
through 2 tile holes, will take damage from weapons 14 pixels away from ship
center etc. Changing the radius will make ships smaller or bigger from game
play aspect, you can also change visual aspect to players by specifying custom
level graphics and also sounds [Continuum 0.37+]

New command: *objon <object id> - shows objects on map/screen with specified
id. Can be sent to player privately or to whole arena. See BuildLevel
documentation for more info. [Continuum 0.37+]

New command: *objoff <object id> - hides objects on map/screen with specified
id. Can be sent to player privately or to whole arena. [Continuum 0.37+]

New cfg variable: Misc:LevelFiles. Comma separated list of level files built
with BuildLevel.exe (lvz files). These files contain screen and map object
definitions and graphics, custom shipsets, sounds, help texts, etc. See
BuildLevel documentation for more info. [Continuum 0.37+]

New server.ini variable: Misc:AllowVIEClients. When set to 0 Subspace client
users are not allowed to enter zone. (It was actually added a while ago but
I forgot to document it)

Added vip.txt. Players listed in vip.txt can enter zone with old Subspace
client when zone is set to Misc:AllowVIEClients:0 and can play in arenas that
have Misc:ContinuumOnly set to 1 in config. Also players listed can enter zone
with Continuum 0.37 pre-release versions. When billing server is down vip.txt
is ignored, naturally

----------------------------- version 1.34.11 ---------------------------------
New command: /*warpto xcoord ycoord - privately sent to player will warp player
to given position. Coordinates are given in tiles (1-1023), when there is wall
at specified location, random position is chosen. [Continuum 0.35+]

Modified /*watchgreen to show negative prizes

New cfg variable: Spectator:HideFlags. When set dropped flags are not shown to
spectators. [Continuum 0.36+]

New cfg variable: Spectator:NoXRadar. When set spectators won't have X-Radar
[Continuum 0.36+]

New cfg variable: Bullet:ExactDamage. When set bullet damage is exact, not
random [Continuum 0.36+]

New cfg variable: Misc:SlowFrameRate. Specifies minimum frame rate for client.
When frame rate falls below specified rate for 10 seconds, client is
disconnected. 0 - disable check, maximum is 35 [Continuum 0.36+]

New cfg variable: <ship>:SeeBombLevel. 1=see all bombs on radar, 2=see bombs
greater than level 1 on radar, 3=see bombs greater than level 2 on radar,
0 = no bombs are shown on radar [Continuum 0.36+]

New cfg variable: <ship>:DisableFastShooting. When set firing bullets, bombs
and thors is disabled when using afterburner [Continuum 0.36+]

Fixed a bug in Continuum communcation protocol that caused connection to get
stuck infrequently

Added confirmation message to /*warn command

New server.ini variable: Misc:NoFlagRewardLimit. If set non-zero reward
multiplier limit is removed in FlagRewardMode 1. Multiplier is
(maximumAllowedPerTeam / numberOfTeamMembers), if NoFlagRewardLimit is set 0
multiplier is limited by 2.

Fixed bug causing infrequent server crashes (Access violation at
address 41d006)

Fixed another crash bug (Access violation at address 428e20)

Fixed security hole that allows anybody to upload moderate.txt and permit.txt

Fixed 'shadow KOTH' bug. When entering arena other players sometimes see that
entered player has KOTH, while he doesn't. Happends very seldom, but when it is
triggered all players entering had KOTH and only server shutdown/start would
fix that

Fixed problem of public teams becoming uneven when there are private teams in
arena.

New cfg variable: Misc:ContinuumOnly. When set to 1 non-Continuum players are
locked to spec and get message to use Continuum to play

New cfg variables: Latency:C2SNoDataAction and Latency:C2SNoDataTime. If
C2SNoDataAction is set to non-zero and there is no data coming from player for
C2SNoDataTime (in 1/100th seconds) follwing action is performed:
C2SNoDataAction=1: Report it using sysop message
C2SNoDataAction=2: Put player to spec mode
C2SNoDataAction=4; Kick player.
C2SNoDataAction can be combination (sum) of above actions.

Added new ArenaMode 5 (Custom:ArenaMode in server.ini). In arena mode 1-4
arenaname.cfg is created (copied from server.cfg) every time a user enters a
spawn. This means that over time cfg files are piling up in server directory
and changes in server.cfg are not reflected in spawns, makeing maintenance of
settings pain in the ass. In ArenaMode 5 if arenaname.cfg is not found, server
will use spawn.cfg.

Fixed bug in server that allowed sending cross-arena private messages so that
they appear to come from user without name.

New command: *relkills <0 or 1> - toggles sending kills reliably on and off.
Normally server sends kill messages as non-reliable messages if killed player's
bounty is less than 200 (teamkills are always non-reliable). Setting
*relkills 1 will make server send kill messages reliably,

New command: /*bandwidth <bandwidth> - allow to set cutback watermark per
player, overriding arena's Latency:CutbackWatermark setting

----------------------------- version 1.34.10 ---------------------------------
New command: *warn <text> - privately sent to player will display moderator
warning using red font to player

Fixed problem with keepalive. After sending large amouts of data, such as
voice messages, settings, etc players got often kicked with low keepalive
values.

Added client version display to /*einfo

Fixed 3 buffer length checking/overflow bugs in lowlevel protocol

Added ability to disable *shutdown command as sysops can execute arbitrary
commands with it and it is potential threat to host security. To disable
*shutdown create noshutdown directory to server directory. Don't forget to
set file permissions of that directory if sysops have FTP access

Tons of continuum client releated changes

----------------------------- version 1.34.9 ----------------------------------
Fixed protection against IP spoofed packet floods. Made a simple mistake and
left it open to smart flooders. Smack me

New command: *flags - displays locations of uncarried flags

New command: /*greeninfo - displays how many particular prizes player has
picked up and it's difference from normal distribution

Added displaying of client type to /*einfo to distinquish between VIE and
Continuum clients

----------------------------- version 1.34.8 ----------------------------------
Added protection against IP spoofed packet floods

Fix against another DoS attack (voice sending with incomplete packet)

New sysop command: *lag: shows average lag of all players in zone

?getnews is now available only in spectator mode

----------------------------- version 1.34.7 ----------------------------------
Added fix against Catid's zone flooder. When flood is detected IP address is
added to blacklist and all traffic from that IP is ignored for time relative
to amount of flood received. Flooder's IP is reported once using sysop alert

Added fastbombing detection. To enable it set Misc:CheckFastBombing in
server.ini as combination (sum) of following values:
1 - Send sysop alert when fastbombing is detected
2 - Filter out fastbombs
4 - Kick fastbombing player off
There is Misc:FastBombingThreshold variable in server.ini to tune detection.
Default and recommended value for that variable is 30. Bomb/mine is considered
for fastbombing if delay between 2 bombs/mines is less than
ship:BombFireDelay - Misc:FastBombingThreshold

Added support for multiple alert commands. Misc:AlertCommand is now comma
separated list of player alert commands (f.ex. cheater,help,illegal)

Alert commands are now logged to server log

Added support for zone local chats. To use local chats set Misc:LocalChat in
server.ini to comma separated chat name list

Added ability to force obscene checking on for all clients. To enable it set
Misc:ForceObsceneCheck in server.ini to 1. Users can toggle obscenity blocking
by ?obscene command

Added new player command: ?find <player name>. Tells in what arena specified
player is if not in private arena (starting with #). Moderators can find
players in private arenas too

Players with name ^Banned are silenced and locked to spec

Added feature to limit player's screen resolution. To enable set in an arena
cfg file Misc:MaxXRes and Misc:MaxYRes variables. 0 = no limit

Added scorereset support without need to recycle zone (needs same functionality
to be added to billing server before it can be used)

----------------------------- version 1.34.6 ----------------------------------
Fix against Sage386's DoS attack (At least one that crashed Trench Wars and
I have crash dump about). It is a simple buffer overflow bug in login code

New sysop command *version. Tells version for the server

Added weapons server to client packetloss to /*lag command

----------------------------- version 1.34.5 ----------------------------------
Added weapons checking. To enable it set in server.ini Misc:CheckWeapons:1
If enabled follwing checks are preformed:
* Bullet fired with level > [ship]MaxGuns + [Flag]FlaggerGunUpgrade
* Boucning bullet fired and [PrizeWeight]BouncingBullets is 0 and [Cost]Bounce
is 0
* Bomb fired with level > [ship]MaxBombs + [Flag]FlaggerBombUpgrade
* Prox bomb fired and [PrizeWeight]Proximity is 0 and [Cost]Prox is 0
* Bomb fired with shrap > [ship]ShrapnelMax
* Bomb fired with bouncing shrap and [PrizeWeight]BouncingBullets is 0 and
[Cost]Bounce is 0
* Mine is fired and [ship]MaxMines is 0
* A prize is picked up and [PrizeWeight] of that prize is 0
* Stealth is turned on and [ship]StealthStatus is 0
* Cloak is turned on and [ship]CloakStatus is 0
* XRadar is turned on and [ship]XRadarStatus is 0
* Anti-Warp is turned on and [ship]AntiWarpStatus is 0
* Player uses ufo

If one of the above conditions is true red sysop alert message is triggered and
that weapon packet is ignored. If [security]SecurityKickoff is 1 in server.cfg
file player is kicked out too. Check is deactiveded for smod+

Added functinality to enable mod/smod/sysop commands only in certain arenas.
Access is controlled via moderate.txt/smod.txt/sysop.txt. To restrict access
append to moderate.txt/smod.txt/sysop.txt:
+playername:arenaname
If arenaname is empty access is granted in main (public) arenas. If arenaname
is @ access is granted in all private (not main) arenas. Here is an example of
smod.txt to grant smod access to PriitK in all arenas, to Foobar in public
arenas only, to Poophead in all private arenas and to Lagger in elim and super
arena
------smod.txt------
PriitK
Foobar
Poophead
Lagger
+Foobar:
+Poophead:@
+Lagger:elim
+Lagger:super

New cfg variable: Misc:MaxPlayers. Overrides server.ini's Arena:ArenaMaxPlayers
variable for a spawn

New server.ini variable: Misc:ShipTypeSwitchResetPeriod. If set non-zero player
shipchange counters are reset in given period. It allows to set
Security:MaxShipTypeSwitchCount low to kick out players that use ship changes
to get good configuration or spawning spot

New cfg variable: Misc:GreetMessage. It is sent to player when s/he enters
spawn

New cfg variables: Misc:PeriodicMessage0-PeriodicMessage4. Value must have
following syntax: <period> <delay> [*]<text>
If set and players are in spawn <text>s starting with * are sent out as zone
messages and without * as arena messages. <period> <delay> are in minutes,
<delay> indicates when first message is sent after arena creation.

New command: /*watchgreen. Toggles player green pickup logging on/off for
selected player. Then turned on, moderator who did it will receive notification
message every time when that player picks up green

New command: /*einfo. Displays player billing user id and screen resolution

New command: /*lag. Displays player ping and packetloss

New command: ?lag. Displays ping and packetloss

New commads: *getfile, *putfile and *delfile. Allow sysop to get/put/delete
files from server directory. exe, com, dll, bat and cmd files are offlimits.
Following commands were removed: get/putsysoplist, get/putsmodlist,
get/putnews, get/putobscene

New command: *listban. Lists all active /*kill <minutes> bans with machine id,
time in seconds since ban was made, ban length in seconds

New command: *removeban <machineid>. Removes a /*kill <minutes> ban

----------------------------- version 1.34.4 ----------------------------------
New command: /*ufo

New command: /*super. If player isn't smod+ server will give data checksum
warnings

New command: ?scorereset and 2 server.ini settings: Misc:AllowPubScorereset and
Misc:AllowPvtScorereset

New command: *listmod - lists all mods+ in zone. SMod+ access is required for
this commad

Fixed flag neuting: New server.ini setting Misc:TimerDropFlagTerritoryRadius
same as Flag:FlagTerritoryRadius, but will used only if flags are dropped when
timer expires. So, if you set Flag:FlagTerritoryRadius to 0 and
Misc:TimerDropFlagTerritoryRadius to 8 flags will be respawned on freq/ship
change

Removed /*setfreq restrictions

Fixed bug that caused occasional zone crashes

----------------------------- version 1.34.3 ----------------------------------
? commands flooding protection (?chat macro)

freq change flooding protection (=%freq macro in spec)

New command: *specall - puts all players in arena to spec, but doesn't lock
them. Usual access restrictions apply: mods and smods cant spec sysops and mods

New server.ini variable: Misc:NoAntiInSafe. If set to non-zero antiwarp is
disabled in safe zones

New server.ini variable: Misc:LockFreqs. If set to non-zero freq changing when
arena is locked is disabled

New server.ini variable: Misc:PositionDataAccess. Extra position data is really
information about the player ship. It is displayed to spectators in the top of
screen (energy, rockets, walls, portals, etc). Normally only sysops see it, but
it can be configured in server.cfg via Misc:ExtraPositionData so, that all
players see it. It is not recommended, because it increases bandwidth players
use about 50% thus increasing ping/packetloss. This variable controls, who see
extra data. 0 - only sysops, 1 - smod+, 2 - mod+. It is meaningful only if
Misc:ExtraPositionData is 0 in server.cfg

New server.ini variable: Misc:AlertCommand. Replacement to BanG ?cheater
command. Players can type ?<Misc:AlertCommand> <text>, that <text> is sent to
all mods+ who are in the zone. Command is disabled, if value of this variable
is empty.

Negative bounty fix. Negative bounty is ignored and will trigger red sysop
messages
</pre>

[[Category: Subgame]]
[[Category: Servers]]

Arena.conf

2005-09-17T16:12:19Z

Cyan~Fire: in

The arena.conf file specifies all arena-specific [[:Category:Settings|settings]] for an arena. It resides in an arena's directory under /arenas, and usually includes other files, such as conf/svs/svs.conf using the #include directive. It is asss's equivalent of [[subgame]]'s [[server.cfg]].

Fg wz Module

2005-09-17T16:08:26Z

Cyan~Fire: initial content. good format?

The fg_wz module creates a warzone-style flag game for asss, in which one team must own all flags to win. This is the equivalent of FlagMode 1 for [[subgame]]. It uses the [[Flag Settings]].

Required modules:
*flagcore
*mapdata
*config
*logman
*prng

[[Category:Standard Modules]]

Bullet

2005-09-17T15:01:20Z

Cyan~Fire: damage info

A '''bullet''' is a projectile fired by a ship's guns, one of the two standard weapons. (The bomb is the other.) Bullets normally disappear when they hit a tile or a ship, but they can be bouncing, which means that they will bounce off of tiles and only disappear when they damage a ship. Any type of bullets will disappear after a delay, specified in the arena's settings.

Bullets are animated using bullets.bm2, which can be changed with an [[LVZ]]. The first four rows are for standard bullets, the next row is "inactive" [[Burst]] bullets, the next four are for bouncing, and the last is for bouncing [[Burst]] bullets.

Bullets can either do constant or random damage as specified in the [[Bullet Settings]]. If set to random, then the damages specified there are only maximums and the client uses following formula to calculate damage: sqrt(rand() * (maxdamage2+1)). This makes the average bullet damage 2/3 * sqrt(maxdamage2+1).

[[Category:Weapons]]

Server Troubleshooting

2005-09-17T14:50:18Z

Cyan~Fire: level file close

Here are the solutions to various problems that can occur with ASSS, Subgame, or both. If you are unfamiliar with INIs (INItialization files), please read the [[INI]] guide. Also, please use catid's [[SSBilling2]] instead of the usual [[subbill]] as the former uses less system resources and reports errors far more clearly.

See also: [http://forums.minegoboom.com/viewtopic.php?p=22619 Solutions for Server/Biller Problems].

== My Zone is Red ==

The first step to take when your zone is red is to make sure you can use it through a custom zone. To do this, open the Zones dialog in Continuum, and click the "Add Custom Zone..." button. In the dialog that pops up, type in your zone's name, the port from Misc:Port, and 127.0.0.1 for the IP. (This will only work if you are playing on the same computer that is running subgame.) Then click ok to both dialogs, and find the manually added zone on the zones list and try entering. If you still cannot enter the zone, post on the [http://forums.minegoboom.com/ Server Help Forums] for more specific help.

If you can get into the zone with the custom zone setup, now follow the instructions [http://forums.minegoboom.com/viewtopic.php?t=2443 here].

== Billing/subgame communication issues. ==
The following are solutions to the common miscommunication problems between [[subgame]] and your [[Biller]]. '''It is assumed that you are hosting both the biller and subgame yourself.''' If you are not, the following advice ''may not be valid''.

=== The subgame2 console says 'Client connection request from billing server ignored' ===
You need to change the Billing:IP in server.ini to <tt>localhost</tt> instead of <tt>127.0.0.1</tt>.

=== The subbill console says ': Unknown packet type: 36' ===
You need to run the server and biller on different ports.

subbill.ini:
<pre>
[Misc]
Port=900
</pre>
server.ini:
<pre>
[Misc]
Port=382

[Billing]
Port=900
</pre>

=== The Continuum window says "Not accepting new connections" ===
Set subbill.ini's Misc:AllowNewUsers to <tt>1</tt>.

=== The subgame2 console repeats "Attempting to..." ===
You need to specify the correct IP and Port in the [Billing] section of server.ini. Make sure Billing:Port matches up with subbill.ini's Misc:Port (and both should be different from the server.ini's Misc:Port). If you are running your Biller on the same machine as subgame, set server.ini's Billing:IP to <tt>localhost</tt>.

=== The biller window says something about a "Bad Password" ===
Make sure server.ini's Billing:Password contains the same value as subbill.ini's Misc:Password.

=== The biller window displays "Invalid Login" ===
Make sure server.ini's Billing:GroupID is greater than 0. Unless you know how to setup billing GroupOps, it is recommended to leave this set to <tt>1</tt>. Also, make sure Billing:ScoreID and Billing:ServerID are set to the same value as Misc:Port.

== No permission to play in zone ==
If Continuum reports "You do not have permission to play in this zone." and subgame shows "Invalid login packet received", then subgame is not reading your continuum executable correctly. Make sure you have a "version1" folder in the same folder as subgame with a copy of continuum.exe ''renamed as subspace.exe'' inside.

== Subgame closes almost immediately after execution ==
Most likely the file specified in Misc:DefaultLevelFile in [[server.ini]] is not present in the server directory. Make sure it is spelled correctly.

[[Category:Guides]]

Latency Settings

2005-09-17T14:42:04Z

Cyan~Fire: /* S2CNoDataKickoutDelay */

[Latency] These settings determine how the server and clients treat latency (delay between packet sends and receives).

=== SendRoutePercent ===
''Datatype:'' Tenths of a percent (300 to 800).

Percentage of the ping time that is spent on the ClientToServer portion of the ping. (Used in more accurately syncronizing clocks.)

=== KickOutDelay ===
''Datatype:'' Hundredths of seconds (100 to 2000).

Time the server can receive no data from a client before it kicks it.

=== S2CNoDataKickoutDelay ===
''Datatype:'' Hundredths of seconds (100 to 32000).

Time a client can receive no data from server before it automatically disconnects. This must be higher than the KeepAliveDelay specified in [[server.ini]].

=== NoFlagDelay ===
''Datatype:'' Hundredths of seconds (100 to 1000).

If the server does not receive packets from a client for this amount of time, it denies them the ability to pick up flags. Use this setting to prevent players from taking advantage of lag to grab flags.

=== NoFlagPenalty ===
''Datatype:'' Hundredths of seconds (300 to 32000).

If a user triggers the above NoFlagDelay, the server will continue denying flag pickups for this long after it starts receiving packets again.

=== SlowPacketTime ===
''Datatype:'' Hundredths of seconds (20 to 200).

The server will consider a C2S packet slow if it takes this long or longer to receive.

=== SlowPacketKickoutPercent ===
''Datatype:'' Tenths of a percent (0 to 1000).

The server will kick a client if this percentage of its C2S packets are slow. (See above setting.)

=== SlowPacketSampleSize ===
''Datatype:'' Count (50 to 1000).

Number of packets to sample C2S latency before checking for kickout. (See above setting.) Only in very rare cases will this need to be altered, so just leave it at its default.

=== ClientSlowPacketTime ===
''Datatype:'' Hundredths of seconds (20 to 200).

The client will consider an S2C packet slow if it takes this long or longer to receive.

=== ClientSlowPacketKickoutPercent ===
''Datatype:'' Tenths of a percent (0 to 1000).

The client will automatically disconnect if this percentage of its S2C packets are slow. (See above setting.)

=== ClientSlowPacketSampleSize ===
''Datatype:'' Count (50 to 1000).

Number of packets to sample S2C latency before checking for kickout. (See above setting.) Only in very rare cases will this need to be altered, so just leave it at its default.

=== MaxLatencyForWeapons ===
''Datatype:'' Hundredths of seconds (20 to 200).

Maximum C2S latency to allow before server disables a player's weapons.

=== MaxLatencyForPrizes ===
''Datatype:'' Hundredths of seconds (50 to 800).

Maximum latency allowed before a shared prize packet is ignored.

=== MaxLatencyForKickOut ===
''Datatype:'' Hundredths of seconds (40 to 200).

The server will consider a client lagging if its packet latency meets or exceeds this time. (See below setting.)

=== LatencyKickOutTime ===
''Datatype:'' Hundredths of seconds (300 to 3000).

Time a client can lag before the server will kick it from the game. (See above setting.)

=== CutbackWatermark ===
''Datatype:'' Count (500 to 32000).

The server will cut back on packet sending by skipping non-critical packets if it sends this much data per second to a client.

=== C2SNoDataAction ===
''Datatype:'' Sum (bitfield).

Determines action(s) to take if above value is exceeded.
* 1=Display Sysop Warning
* 2=Spec Player
* 4=Kick

=== C2SNoDataTime ===
''Datatype:'' Hundredths of a second.

If above setting (C2SNoDataAction) is set, this is the delay that a player's ping can be maxed at during a position packet before server takes the action.

=== NegativeClientSlowPacketTime ===
''Datatype:'' Hundredths of a second.

If a packet has a timestamp farther in the future than this, the server will consider it a slow packet. Feature is still experimental. ''Special Value:'' 0 = check disabled.

[[Category: Settings]]

Server.ini

2005-09-17T14:41:24Z

Cyan~Fire: /* KeepAliveDelay */ typo

server.ini is the initialization file for [[subgame]] that controls all of the global settings. Individual arena's settings are stored in arenaname.cfg. The following are the various sections in the server.ini.

<div style="float: right; margin-left: 20px">
__TOC__
</div>

== Validation ==

See [[Validation]].

== Custom ==
These settings configure custom arenas. (I think?)

=== ArenaMode ===
''Datatype:'' Enumeration.

This controls the ownership of private arenas. By "own a new subarena", it means that if the selected level of player creates a new subarena with ?go, and the arena does not have settings associated yet, subgame will create settings for that arena and assign [[arena ownership|ownership]] to the creating player. If the player creating the arena is below the selected level, subgame will still create settings for the arena, but will not grant ownership.
#Any player can own a new subarena.
#Mods+ can own a new subarena.
#Smods+ can own a new subarena.
#Sysops can own a new subarena.
#''Special:'' New subarenas will just use spawn.cfg. (That is, a new cfg must be placed in the server directory manually to give an arena its own settings.)

== Arena ==
These settings configure default arena settings.

=== ArenaMaxPlayers ===
''Datatype:'' Count.

Number of players allowed in any arena. (This can be overridden in the [[Misc Settings]] for an arena.)

=== ArenaDesiredPlayers ===
''Datatype:'' Count.

Subgame will create a new arena for entering players once an arena hits this population. This is different from the above setting in that users can still manually enter an arena with this population.

=== ArenaMinimumPlayers ===
''Datatype:'' Count.

Minimum number of players in a public arena before subgame automatically sends a message advising players to move on.

=== SpawnKeepScores ===
''Datatype:'' Boolean (1=yes,0=no).

Whether player-spawned arenas keep track of scores.

=== MaxArenas ===
''Datatype:'' Count.

The maximum number of arenas subgame will allow.

=== MaxArenasMemory ===
''Datatype:'' Bytes.

The maximum amount of memory subgame will allocate for arena data. Normally the default should suffice.

== Comms ==
Communication (networking) settings.

=== MaxQueueToLogin ===
''Datatype:'' Count.

Maximum number of clients waiting to login. Any that try when this limit is exceeded will receive the message "The server is busy handling other login requests. Please try again in a few moments. If problem persists, seek help at the Tech Support Forums found at www.subspacehq.com".

=== PacketHistoryMax ===

=== IncomingBufferSize ===

=== OutgoingBufferSize ===

=== EncryptMode ===

=== UnreliableBufferSize ===

=== TransportBufferSize ===

=== FlushTime ===
''Datatype:'' Milliseconds.

Subgame will queue position packets for this amount of time before sending them. ''Setting this too high will severly lag your zone.''

=== BandwithIdleTime ===
''Datatype:'' Seconds.

Subgame will stop sending position packets to a spectator after this time of inactivity. Useful for saving bandwidth.

=== SelectTime ===
''Datatype:'' Milliseconds.

Time delay subgame should wait for incoming packets before continuing on. This is recommended over CPU:SleepTime.

== Misc ==
Miscellaneous settings. (Some of these should really go elsewhere.)

=== DisableShareware ===

=== RegisterKickShareware ===
''Datatype:'' Boolean.

Should subgame kick shareware users in favor of registered users when server is full? (Leave set to 0.)

=== MaxSharewarePlayers ===
''Datatype:'' Count.

Maximum number of shareware players allowed on server. ''Special Value:'' -1 = unlimited.

=== MaxPlayers ===
''Datatype:'' Count.

Maximum total players allowed in zone.

=== MaxSharewareTime ===

=== DisableSharewareNames ===
''Datatype:'' Boolean.

Disables the ability for demo players to have customized names. The default displayed name will just be "~Demo".

=== DisableSharewareShips ===
''Datatype:'' Boolean.

Disables the ability for demo players to use ships 5-8.

=== DisableSharewareScores ===
''Datatype:'' Boolean.

Disables the ability for demo players to retain their scores between sessions. ''Note:'' Scores will always be disabled if the players do not have a name.

=== MenuKickOutDelay ===
''Datatype:'' Hundredths of seconds.

Amount of time a player may take logging in before server disconnects client.

=== NoAntiInSafe ===
''Datatype:'' Boolean.

If enabled, subgame will ignore [[AntiWarp]] of a player in a safe zone.

=== LockFreqs ===
''Datatype:'' Boolean.

Determines whether [[Commands#Arena Management|locking]] an arena locks freqs as well as ships. (1.34.3+)

=== PositionDataAccess ===
''Datatype:'' Enumeration.

Determines staff level that will receive extra position data when speccing. Useful if [[Misc Settings#ExtraPositionData]] is disabled.
*0=Sysop (default)
*1=SMod+
*2=Mod+

=== AlertCommand ===
''Datatype:'' Comma-delimited list.

If a player types any of these commands preceeded by a '?' followed by a message, subgame will send the message to all online staff. This is a replacement to the BanG ?cheater command. (1.34.3+)

=== AllowPubScorereset ===
''Datatype:'' Boolean.

If enabled, players in public arenas may use the ?scorereset command.

=== AllowPvtScorereset ===
''Datatype:'' Boolean.

If enabled, players in private arenas may use the ?scorereset command.

=== TimerDropFlagTerritoryRadius ===
''Datatype:'' Tiles.

All flags dropped when timer expires (non-neutral) will drop this radius from the ship, overriding [[Flag Settings#FlagTerritoryRadius]]. This is useful for respawning neuted flags (set FlagTerritoryRadius to 0). ''Special value:'' 0 = always use FlagTerritoryRadius.

=== ShipTypeSwitchResetPeriod ===
''Datatype:'' Milliseconds (?).

Determines length of time for [[Security Settings#MaxShipTypeSwitchCount]]. ''Special Value:'' 0 = disabled.

=== CheckWeapons ===
''Datatype:'' Boolean.

If enabled, any of the following conditions will trigger a security violation. The checks do not apply to SMod+.
* Bullet fired with level > [ship]MaxGuns + [Flag]FlaggerGunUpgrade
* Bouncing bullet fired and [PrizeWeight]BouncingBullets is 0 and [Cost]Bounce is 0
* Bomb fired with level > [ship]MaxBombs + [Flag]FlaggerBombUpgrade
* Prox bomb fired and [PrizeWeight]Proximity is 0 and [Cost]Prox is 0
* Bomb fired with shrap > [ship]ShrapnelMax
* Bomb fired with bouncing shrap and [PrizeWeight]BouncingBullets is 0 and [Cost]Bounce is 0
* Mine is fired and [ship]MaxMines is 0
* A prize is picked up and [PrizeWeight] of that prize is 0
* Stealth is turned on and [ship]StealthStatus is 0
* Cloak is turned on and [ship]CloakStatus is 0
* XRadar is turned on and [ship]XRadarStatus is 0
* Anti-Warp is turned on and [ship]AntiWarpStatus is 0
* Player uses UFO

=== CheckFastBombing ===
''Datatype:'' Bitfield.

*1 - Send sysop alert when fastbombing is detected
*2 - Filter out fastbombs
*4 - Kick fastbombing player off

=== FastBombingThreshold ===
See above.

=== LocalChat ===
''Datatype:'' Comma-delimited list.

Listed chat channels are local to the zone.

=== ForceObsceneCheck ===
''Datatype:'' Boolean.

Forces players to have obscene checking on.

=== NoFlagRewardLimit ===
''Datatype:'' Boolean.

Disables the default reward multiplier limit of 2 for [[Flag Settings#FlagRewardMode]].

=== LogPoints ===
=== PointUpdateDiff ===
''Datatype:'' Points.

Number of points that will trigger a score update sent to clients.

=== JackpotBroadcastPoints ===
''Datatype:'' Boolean.

If enabled, subgame will broadcast the jackpot points to all zones on the [[billing server]]. Not recommended.

=== ServerLog ===
''Datatype:'' Boolean.

If enabled, server will keep a text file log of events.

=== KeepAliveDelay ===
''Datatype:'' Milliseconds.

Delay between keepalive packets sent to clients. Should not be changed.

=== DefaultLevelFile ===
''Datatype:'' String.

Level file (such as _bzw.lvl) that zone will use for public arenas.

=== Port ===
''Datatype:'' Short.

Game port that subgame will user. Keep it above 1000 to avoid interference with other networking applications. This needs to be different for every zone running on the same server.

=== AllowVIEClients ===
''Datatype:'' Boolean.

Determines whether VIE [[SubSpace]] users are allowed to enter zone at all.

=== StaffChat ===
''Datatype:'' Comma-delimited list.

These chat channels are only joinable by Mods+.

=== ForceContinuumOnly ===
''Datatype:'' Boolean.

Determines whether only [[Continuum]] users are allowed to play.

=== ServerIP ===
''Datatype:'' IP Address.

WAN IP address of server computer. This can be found using http://www.whatismyip.com/ (easiest), ipconfig, or a router's status page.

== CPU ==
These settings determine subgame's CPU usage. Usually it performs well, so these should not be changed.

=== LoopDelay ===
=== ProcessMaxTime ===
=== SleepPerIteration ===
=== SlowIterationWarningLevel ===
=== SleepTime ===

== Permission ==
These settings restrict which clients may connect to your zone.

=== AllowBadMachineId ===
=== AllowLowBandwidth ===
=== MinimumSecondsToLogin ===
=== PermissionMaxPoints ===
=== PermissionMode ===
''Datatype:'' Boolean.

If enabled, only allows player names listed in permit.txt.

=== AutoPermissionPoints ===
=== AutoPermissionIDList ===
=== AutoPermissionMessage ===

== Password ==
Passwords for various player levels. Change to your heart's content.

=== SysopPassword ===
=== EnergyPassword ===
=== ModeratorPassword ===
=== SuperModeratorPassword ===
=== VIPPassword ===

== Billing ==
Configures subgame's interaction with the [[biller]].

=== LogMessages ===
''Datatype:'' Boolean.

Enables "logging" of commands to the biller. It is recommended to turn this off, as it normally just wastes bandwidth.

=== IP ===
''Datatype:'' IP/DNS address.

The address of the biller. If you are running the biller on the same computer as subgame, set this to <tt>localhost</tt>.

=== Password ===
''Datatype:'' String.

The password to connect to the biller. Normally, this should be the same as subbill.ini's Misc:Password.

=== ServerName ===
''Datatype:'' String.

The name of the zone that will be sent to the biller upon connection. This will also be sent to the directory server.

=== Port ===
''Datatype:'' Integer.

The port to connect to the biller, which should be equal to subbill.ini's Misc:Port.

=== ServerId ===
''Datatype:'' Integer.

The ServerID sent to the biller. This is not often used and should be equal to Misc:Port.

=== GroupId ===
''Datatype:'' Integer.

The group this server will join on the biller. This has to do with group operators, and is recommended to leave set to <tt>1</tt>

=== ScoreId ===
''Datatype:'' Integer.

The ScoreID of the server which the biller will use to identify your server between connections. This should normally be the same as Misc:Port.

=== ReconnectTime ===
Seems to have no effect.

=== AttemptTime ===
''Datatype:'' Hundredths of seconds.

How long subgame will attempt unsuccessfully to connect to the biller before it gives up.

== Advertise ==
These settings control subgame's built-in advertisement capability. To use advertisements, just create bitmaps in the SS Palette and save them in the subgame directory as ad0.bmp,ad1.bmp, etc. Prefix the name with "s_" to send to shareware players, with "r_" to send to registered players, and "b_" to send to both. For example, "b_ad0.bmp". Subgame will then randomly pick advertisements to display to players.

=== SendMode ===
''Datatype:'' Sum (bitfield).

Determines when advertisements are sent.
*1 = send them when the player enters the zone.
*2 = send them when player dies.

=== DisplayMode ===
''Datatype:'' Enumeration.

*0 = at top of screen behind all other graphics.
*1 = at top of screen on top of all other graphics.
*2 = floating around like a backdrop.

=== Duration ===
''Datatype:'' Milliseconds.

Length of time an advertisement is displayed. ''Special Value:'' 0 = always on.

== Directory ==
These settings configure subgame's interaction with the [[directory server]].

=== IP ===
''Datatype:'' IP/DNS list.

List of directory servers subgame will send its entry to. As of 24 May 2005, the following list is recommended:
<pre>sscentral.ds98.com,sscentral.subspace.inet.fi,sscentral.subspacehq.com</pre>

=== Description ===
''Datatype:'' String.

This description will be sent to the directory server to be associated with your zone. Include an ss:// DNS address to have Continuum keep your IP up to date.

=== NamePassword ===
''Datatype:'' String.

The password associated with the zone's server prefix. All zones with the same prefix must have the same NamePassword or the Directory server will not list them.

=== Port ===
''Datatype:'' Integer.

Leave this set to <tt>4991</tt>.

[[Category:Settings]]

Door

2005-09-17T14:39:11Z

Cyan~Fire: and asss

A [[door]] is an instance of any of eight special tiles on a map. The tiles will either stay in one state or switch randomly, depending on the settings. Door tiles on the right switch less often than those on the left if the doors are in weighted random mode. See [[Door Sync]] for detailed information on the state switching.

To configure doors in both [[Subgame]] and [[ASSS]], see [[Door Settings]].

[[Category:Map]]

Super

2005-09-17T04:10:27Z

Cyan~Fire: initial content

Super is different from the prize displayed as "Temporary Superpower". Super upgrades a ship's weapons to L3, upgrades thrust, speed, and recharge, and gives it max energy. The following exact setting changes occur (for the one ship only):
*Bullet and Bomb fire delays = 10
*Bomb thrust = 0
*Bullet and Bomb fire energies = 0
*Maximum Burst, Repel, Decoy, Thor, Brick, Rocket, and Portal = 255
*99% of damage is cancelled.

Super continues its effects until the player leaves the arena. A supered, non-sysop player will most likely be kicked for security violations.

Shipinfo.dat

2005-09-17T04:04:33Z

Cyan~Fire: initial content

Shipinfo.dat is a file that can be included in an arena's levelfiles to customize the ships. Ship images can be replaced on the menu with ships.bm2. A user can enable this with the "Zone-Specific Ships" option on the "Menu" tab.

== Format of shipinfo.dat ==

*Blank lines and those starting with semicolons are ignored.
*Leading and trailing spaces are removed.
*All lines must appear in the order stated below.
*Use * by itself as a placeholder for the default text.

<pre>
; 8 ship names in normal order (max 16 chars).

Warbird
Javelin
Spider
Leviathan
Terrier
Weasel
Lancaster
Shark

; 8 ship descriptions for menu mouse-over.
; Max is 255 chars, but may be clipped by skin.
; Use * by itself here will use the ship name(s)
; defined above as "Select ship: ."

Select ship: Warbird.
Select ship: Javelin.
Select ship: Spider.
Select ship: Leviathan.
Select ship: Terrier.
Select ship: Weasel.
Select ship: Lancaster.
Select ship: Shark.

; Spectator description for menu mouse-over.
; Max is 255 chars, but may be clipped by skin.

Spectate (watch the game).

; Ship box description for menu mouse-over.
; Max is 255 chars, but may be clipped by skin.

Select one of eight ships to fly, or be a spectator. You can always change your mind while in the game
</pre>

Door

2005-09-17T03:52:36Z

Cyan~Fire: door sync

A '''door''' is an instance of any of 8 special tiles on a map. The tiles will either stay in one state or switch randomly, depending on the settings. Door tiles on the right switch less often than those on the left if the doors are in weighted random mode. See [[Door Sync]] for detailed information on the state switching.

To configure doors in [[Subgame]], see [[Door Settings]].

[[Category:Map]]

Door Settings

2005-09-17T03:51:35Z

Cyan~Fire: wikilink

[Door] Settings for [[door]]s in an arena.

=== DoorDelay ===

''Datatype:'' Hundredths of seconds.

How often doors attempt to switch their state.

=== DoorMode ===

''Datatype:'' Bitfield.

Each bit of this field determines whether its represented door is open or not. The 8 bits, from left to right, represent the 8 door tiles in the tileset, from left to right.

Special values:
*-1=weighted random (doors place with
*-2=completely random

[[Category: Settings]]

Core Protocol

2005-09-13T03:22:26Z

Cyan~Fire: capitalization

This protocol is UDP and bi-directional. It can be thought of as another layer within an application's network layer. [[Subgame]], [[ASSS]], [[Continuum]], VIE's [[SubSpace]] client, the [[Directory server]], and the [[Billing Server]] utilize this protocol, though [[Grelminar]] has designed a TCP Billing Server protocol.

There is support for reliable ordered packets, large packets and cluster packets.

*The maximum packet size is 520 bytes
*All integers are little endian
*All core packets begin with the type byte 0x00

<pre>
0x01 login
offset size comment
0 1 type 0x00
1 1 type 0x01
2 4 client key
6 2 protocol version (vie = 0x01, ctm = 0x11)

0x02 login response
offset size comment
0 1 type 0x00
1 1 type 0x02
2 4 ~client key (negative)

0x03 reliable header
offset size comment
0 1 type 0x00
1 1 type 0x03
2 4 packet id
6 ? payload (514 max)

0x04 reliable acknowledge
offset size comment
0 1 type 0x00
1 1 type 0x04
2 4 packet id

0x05 sync
offset size comment
0 1 type 0x00
1 1 type 0x05
2 4 local time
6 4 packets sent
10 4 packets received

0x06 sync response
offset size comment
0 1 type 0x00
1 1 type 0x06
2 4 time from last received 0x05 packet
6 4 server time

0x07 disconnect
offset size comment
0 1 type 0x00
1 1 type 0x07

0x08 small chunk
offset size comment
0 1 type 0x00
1 1 type 0x08
2 ? payload (expect 472 max)
keep appending payloads until 0x09 chunk tail is received

0x09 chunk tail
offset size comment
0 1 type 0x00
1 1 type 0x09
2 ? payload (expect 472 or less)
append this payload then process contents as a non-core packet

0x0A stream
offset size comment
0 1 type 0x00
1 1 type 0x0A
2 4 total length of all segments
6 ? payload (expect 468 max)
keep appending payloads until total length is reached then process contents as
a non-core packet.

0x0B cancel stream request
offset size comment
0 1 type 0x00
1 1 type 0x0B

0x0C cancel stream acknowledge
offset size comment
0 1 type 0x00
1 1 type 0x0C

0x0E cluster
offset size comment
0 1 type 0x00
1 1 type 0x0E
2 1 length
3 ? payload with length as above
packet repeats from offset 2 until end, process contents as arbitrary packet
</pre>

[[Category: Protocol]]

Ship Settings

2005-09-13T03:14:44Z

Cyan~Fire: shipinfo.dat link

'''[Warbird] [Javelin] [Spider] [Leviathan] [Terrier] [Weasel] [Lancaster] [Shark]''' 
These settings determine the properties of each of the eight ships. These go in an arena's .[[cfg file]] for [[subgame]] and in [[arena.conf]] for [[ASSS]]. Ship names themselves can be changed with [[shipinfo.dat]].

<div style="float: right; margin-left: 20px; margin-bottom: 20px">__TOC__</div>

=== InitialRotation ===
''Datatype:'' 90°/ second / 100 (That is, 400 for a full rotation in 1s).

Initial rotation rate of the ship.

=== InitialThrust ===
''Datatype:'' Unknown.

Initial thrust of ship.

=== InitialSpeed ===
''Datatype:'' Pixels / second / 10.

Initial speed of ship. Note that 0 will prevent the ship from moving without afterburners or a speed upgrade.

=== InitialRecharge ===
''Datatype:'' Energy / second / 10.

Initial recharge rate.

=== InitialEnergy ===
''Datatype:'' Energy.

Initial amount of energy that the ship can have.

=== MaximumRotation ===
''Datatype:'' 90°/(seconds / 100) (That is, 400 for a full rotation in 1s).

Maximum (with upgrades) rotation rate of the ship.

=== MaximumThrust ===
''Datatype:'' Unknown.

Maximum (with upgrades) thrust of ship.

=== MaximumSpeed ===
''Datatype:'' Pixels / seconds / 10.

Maximum (with upgrades) speed of ship.

=== MaximumRecharge ===
''Datatype:'' Energy / seconds / 10. (That is, 10 means 1 energy per second.)

Maximum (with upgrades) recharge rate, or how quickly this ship recharges its energy.

=== MaximumEnergy ===
''Datatype:'' Unknown.

Maximum (with upgrades) amount of energy that the ship can have.

=== UpgradeRotation ===
''Datatype:'' 90°/(seconds / 100) (That is, 400 for a full rotation in 1s).

Amount added per Rotation Upgrade Prize.

=== UpgradeThrust ===
''Datatype:'' Unknown.

Amount added per Thruster Upgrade Prize.

=== UpgradeSpeed ===
''Datatype:'' Pixels / seconds / 10.

Amount added per Speed Upgrade Prize.

=== UpgradeRecharge ===
''Datatype:''Energy / seconds / 10..

Amount added per Recharge Upgrade Prize.

=== UpgradeEnergy ===
''Datatype:'' Energy.

Amount added per Energy Upgrade Prize.

=== CloakStatus ===
''Datatype:'' Enumeration.

Whether ships can to receive [[Cloak]].
* 0 = no
* 1 = yes
* 2 = yes & starts with prize

=== StealthStatus ===
''Datatype:'' Enumeration.

Whether ships can to receive [[Stealth]].
* 0 = no
* 1 = yes
* 2 = yes & starts with prize

=== XRadarStatus ===
''Datatype:'' Enumeration.

Whether ships can to receive [[X-Radar]].
* 0 = no
* 1 = yes
* 2 = yes & starts with prize

=== AntiWarpStatus ===
''Datatype:'' Enumeration.

Whether ships can receive [[AntiWarp]].
* 0 = no
* 1 = yes
* 2 = yes & starts with prize

=== CloakEnergy ===
''Datatype:'' Energy / second / 10 (0 to 32000).

Amount of energy required to have '''Cloak''' activated.

=== StealthEnergy ===
''Datatype:'' Energy / second / 10 (0 to 32000).

Amount of energy required to have '''Stealth''' activated.

=== XRadarEnergy ===
''Datatype:'' Energy / second / 10 (0 to 32000).

Amount of energy required to have '''X-Radar''' activated.

=== AntiWarpEnergy ===
''Datatype:'' Energy / second / 10 (0 to 32000).

Amount of energy required to have '''Anti-Warp''' activated.

=== InitialRepel ===
''Datatype:'' Count.

[[Repel]]s given to ships when they spawn.

=== InitialBurst ===
''Datatype:'' Count.

[[Burst]]s given to ships when they spawn.

=== InitialBrick ===
''Datatype:'' Count.

[[Brick]]s given to ships when they spawn.

=== InitialRocket ===
''Datatype:'' Count.

[[Rocket]]s given to ships when they spawn.

=== InitialThor ===
''Datatype:'' Count.

[[Thor's Hammer]]s given to ships when they spawn.

=== InitialDecoy ===
''Datatype:'' Count.

[[Decoy]]s given to ships when they spawn.

=== InitialPortal ===
''Datatype:'' Count.

[[Portal]]s given to ships when they spawn.

=== InitialGuns ===
''Datatype:'' Weapon level (0 to 3).

[[Bullet|Gun]] level given to ships at respawn. Note that a ship cannot start with L4 guns.

=== InitialBombs ===
''Datatype:'' Weapon level (0 to 3).

[[Bomb]] level given to ships at respawn. Note that a ship cannot start with L4 bombs.

=== RepelMax ===
''Datatype:'' Count.

Maximum '''Repels''' a ship can store. Any Repel prizes after this will be ignored.

=== BurstMax ===
''Datatype:'' Count.

Maximum '''Bursts''' a ship can store. Any Repel prizes after this will be ignored.

=== DecoyMax ===
''Datatype:'' Count.

Maximum '''Decoys''' a ship can store. Any Repel prizes after this will be ignored.

=== RocketMax ===
''Datatype:'' Count.

Maximum '''Rockets''' a ship can store. Any Repel prizes after this will be ignored.

=== ThorMax ===
''Datatype:'' Count.

Maximum '''Thor's Hammers''' a ship can store. Any Repel prizes after this will be ignored.

=== BrickMax ===
''Datatype:'' Count.

Maximum '''Bricks''' a ship can store. Any Repel prizes after this will be ignored.

=== PortalMax ===
''Datatype:'' Count.

Maximum '''Portals''' a ship can store. Any Repel prizes after this will be ignored.

=== MaxGuns ===
''Datatype:'' Weapon level (0 to 3).

Maximum '''gun''' level a ship can have. Note that a ship cannot have L4 guns without a flag upgrade.

=== MaxBombs ===
''Datatype:'' Weapon level (0 to 3).

Maximum '''bomb''' level a ship can have. Note that a ship cannot have L4 bombs without a flag upgrade.

=== BulletFireEnergy ===
''Datatype:'' Energy.

Base energy it takes a ship to fire a bullet. ''Formula:'' EnergyUsed = GunLevel * BulletFireEnergy. So this setting is for an L1 bullet, and is doubled for L2, and so on.

=== BulletSpeed ===
''Datatype:'' Pixels / second / 10.

How fast bullets travel.

=== BulletFireDelay ===
''Datatype:'' Seconds / 100.

Delay before a ship can fire another weapon after it fires a bullet.

=== MultiFireEnergy ===
''Datatype:'' Energy.

Energy it takes a ship to fire a set of multifire bullets. ''Formula:'' EnergyUsed = GunLevel * MultiFireEnergy.

=== MultiFireDelay ===
''Datatype:'' Seconds / 100.

Delay before a ship can fire another weapon after it fires a set of multifire bullets.

=== MultiFireAngle ===
''Datatype:'' Rotation Points / 1000. (''Note:'' One rotation point equals approximately 9°.)

Angle spread between multi-fire bullets and standard forward-firing bullets.

=== DoubleBarrel ===
''Datatype:'' Boolean (1=yes, 0=no).

Whether ships fire double-barrel bullets.

=== BombFireEnergy ===
''Datatype:'' Energy.

Amount of energy it takes a ship to fire a bomb.

=== BombFireEnergyUpgrade ===
''Datatype:'' Energy.

Extra energy it takes a ship to fire an upgraded bomb. ''Formula:'' EnergyUsed = BombFireEnergy + (BombLevel - 1) * BombFireEnergyUpgrade.

=== BombThrust ===
''Datatype:'' Unknown.

Amount of back-thrust (recoil) this ship receives when firing a bomb.

=== BombBounceCount ===
''Datatype:'' Count.

Times a bomb fired by this ship can bounce before it explodes on impact

=== BombSpeed ===
''Datatype:'' Pixels / seconds / 10.

How fast bombs fired by this ship travel.

=== BombFireDelay ===
''Datatype:'' Seconds / 100.

Delay before this ship can fire another weapon after it fires a bomb.

=== EmpBomb ===
''Datatype:'' Boolean (1=yes, 0=no).

Whether this ship fires EMP bombs.

=== SeeBombLevel ===
''Datatype:'' Weapon Level (0 to 4).

Lowest level of bombs this ship can see on radar. ''Special Value:'' 0 = no bombs on radar. (Continuum .36+)

=== MaxMines ===
''Datatype:'' Count.

Maximum number of mines this ship can place.

=== SeeMines ===
''Datatype:'' Boolean (1=yes, 0=no).

Whether ships see mines on radar.

=== LandmineFireEnergy ===
''Datatype:'' Energy.

Energy it takes this ship to place an L1 mine.

=== LandmineFireEnergyUpgrade ===
''Datatype:'' Energy.

Extra energy it takes to place an upgraded landmine. ''Formula:'' EnergyUsed = LandmineFireEnergy + (BombLevel - 1) * LandmineFireEnergyUpgrade.

=== LandmineFireDelay ===
''Datatype:'' Seconds / 100.

Delay before a ship can fire another weapon after it drops a landmine.

=== ShrapnelMax ===
''Datatype:'' Count (0 to 31).

Maximum shrapnel pieces released from this ship's bombs.

=== ShrapnelRate ===
''Datatype:'' Count (0 to 31).

Additional shrapnel pieces gained by a 'Shrapnel Upgrade' prize.

=== BurstSpeed ===
''Datatype:'' Pixels / seconds / 10.

How fast the burst "shrapnel" move for this ship.

=== BurstShrapnel ===
''Datatype:'' Count.

Burst shrapnel released when this ship fires a [[Burst]].

=== TurretThrustPenalty ===
''Datatype:'' Unknown.

This ship's thrust is decreased this much when a turret it riding.

=== TurretSpeedPenalty ===
''Datatype:'' Pixels / second / 10.

This ship's speed is decreased this much when a turret it riding.

=== TurretLimit ===
''Datatype:'' Count.

Number of turrets allowed on this ship.

=== RocketTime ===
''Datatype:'' Seconds / 100.

How long a [[Rocket]] lasts.

=== InitialBounty ===
''Datatype:'' Count.

Number of prizes given to this ship when it spawns.

=== AttachBounty ===
''Datatype:'' Points.

Bounty required by ships to attach to another ship to form a turret.

=== AfterburnerEnergy ===
''Datatype:'' Energy.

Energy required to have 'Afterburners' activated.

=== DisableFastShooting ===
''Datatype:'' Boolean (1=yes, 0=no).

Whether firing bullets, bombs, or thors is disabled after using afterburners. (Continuum .36+)

=== Radius ===
''Datatype:'' Pixels.

The ship's radius from center to outside. ''Special Value:'' 0 = 14 pixels. (Continuum .37+)

=== DamageFactor ===
''Datatype:'' Factor (0 to 5000).

How likely a the ship is to lose a prize when damaged. (1 is extremely likely, 5000 is almost never.) ''Special Value:'' 0 = never.

=== PrizeShareLimit ===
''Datatype:'' Points.

Maximum bounty that this ship can receive by Team Prizes.

=== SuperTime ===
''Datatype:'' Seconds / 100.

How long [[Superpower]] lasts for this ship. The actual time is random up to this value.

=== ShieldsTime ===
''Datatype:'' Seconds / 100.

How long [[Shields]] last for this ship.

=== Gravity ===
''Datatype:'' Factor.

Modifies radius over which a [[wormhole]]'s gravity has an effect.

''Formula:'' EffectRadius = 1.325 * Gravity ^ 0.507. That is, a wormhole will have an effect over 31 tiles if this is set to 500.

The setting for Warbird also controls how far out bombs/mines are effected by wormholes.

=== GravityTopSpeed ===
''Datatype:'' Pixels / seconds / 10.

How much this ship's maximum speed is increased when under the influence of a wormhole's gravity. Note that '''this does not replace the previous speed'''.

=== SoccerBallFriction ===
''Datatype:'' Unknown.

Amount of friction on the [[soccer]] ball when it is not carried by a ship.

=== SoccerBallProximity ===
''Datatype:'' Pixels.

How close the ship must be in order to pick up a ball. Set this to 0 to disallow the ship from picking up a ball.

=== SoccerBallSpeed ===
''Datatype:'' Pixels / seconds / 10.

Initial speed given to the ball when fired by this ship.

=== SoccerThrowTime ===
''Datatype:'' Seconds / 100.

Time player has to carry soccer ball before it automatically fires (out the back of the ship).

If this is 0 or 32768 or greater then carry time is unlimited and no timer is shown on the players screen.

[[Category: Settings]]

Server Troubleshooting

2005-09-13T03:13:47Z

Cyan~Fire: version1

Settings Structure

2005-09-13T02:58:40Z

Cyan~Fire: /* struct ArenaSettings */ packet type, not version

The server sends most settings to its clients through the following structures.

== struct ArenaSettings ==
Each client is sent this 1428-byte structure with the settings for its current arena. Note that it contains the ship and prizeweight structures.

; unsigned PacketType (8 bits)
: 0000 15
; unsigned ExactDamage (1 bits)
: 0001 [[Bullet Settings#ExactDamage|Bullet:ExactDamage]] (Continuum .36+)
; unsigned HideFlags (1 bits)
: 0001 [[Spectator Settings#HideFlags|Spectator:HideFlags]] (Continuum .36+)
; unsigned NoXRadar (1 bits)
: 0001 [[Spectator Settings#NoXRadar|Spectator:NoXRadar]] (Continuum .36+)
; unsigned pack0 (21 bits)
: 0001 (14)

; shipSettings ships[8]
: 0004 See shipSettings declaration...

; Uint32 BulletDamageLevel
: 1156 [[Bullet Settings#BulletDamageLevel|Bullet:BulletDamageLevel]] * 1000
; Uint32 BombDamageLevel
: 1160 [[Bomb Settings#BombDamageLevel|Bomb:BombDamageLevel]] * 1000
; Uint32 BulletAliveTime
: 1164 [[Bullet Settings#BulletAliveTime|Bullet:BulletAliveTime]]
; Uint32 BombAliveTime
: 1168 [[Bomb Settings#BombAliveTime|Bomb:BombAliveTime]]
; Uint32 DecoyAliveTime
: 1172 [[Misc Settings#DecoyAliveTime|Misc:DecoyAliveTime]]
; Uint32 SafetyLimit
: 1176 [[Misc Settings#SafetyLimit|Misc:SafetyLimit]]
; Uint32 FrequencyShift
: 1180 [[Misc Settings#FrequencyShift|Misc:FrequencyShift]]
; Uint32 MaxFrequency
: 1184 [[Team Settings#MaxFrequency|Team:MaxFrequency]]
; Uint32 RepelSpeed
: 1188 [[Repel Settings#RepelSpeed|Repel:RepelSpeed]]
; Uint32 MineAliveTime
: 1192 [[Mine Settings#MineAliveTime|Mine:MineAliveTime]]
; Uint32 BurstDamageLevel
: 1196 [[Burst Settings#BurstDamageLevel|Burst:BurstDamageLevel]] * 1000
; Uint32 BulletDamageUpgrade
: 1200 [[Bullet Settings#BulletDamageUpgrade|Bullet:BulletDamageUpgrade]] * 1000
; Uint32 FlagDropDelay
: 1204 [[Flag Settings#FlagDropDelay|Flag:FlagDropDelay]]
; Uint32 EnterGameFlaggingDelay
: 1208 [[Flag Settings#EnterGameFlaggingDelay|Flag:EnterGameFlaggingDelay]]
; Uint32 RocketThrust
: 1212 [[Rocket Settings#RocketThrust|Rocket:RocketThrust]]
; Uint32 RocketSpeed
: 1216 [[Rocket Settings#RocketSpeed|Rocket:RocketSpeed]]
; Uint32 InactiveShrapnelDamage
: 1220 [[Shrapnel Settings#InactiveShrapDamage|Shrapnel:InactiveShrapDamage]] * 1000
; Uint32 WormholeSwitchTime
: 1224 [[Wormhole Settings#SwitchTime|Wormhole:SwitchTime]]
; Uint32 ActivateAppShutdownTime
: 1228 [[Misc Settings#ActivateAppShutdownTime|Misc:ActivateAppShutdownTime]]
; Uint32 ShrapnelSpeed
: 1232 [[Shrapnel Settings#ShrapnelSpeed|Shrapnel:ShrapnelSpeed]]

; BYTE UNKNOWN0[16]
: 1236 ?

; Uint16 SendRoutePercent
: 1252 [[Latency Settings#SendRoutePercent|Latency:SendRoutePercent]]
; Uint16 BombExplodeDelay
: 1254 [[Bomb Settings#BombExplodeDelay|Bomb:BombExplodeDelay]]
; Uint16 SendPositionDelay
: 1256 [[Misc Settings#SendPositionDelay|Misc:SendPositionDelay]]
; Uint16 BombExplodePixels
: 1258 [[Bomb Settings#BombExplodePixels|Bomb:BombExplodePixels]]
; Uint16 DeathPrizeTime
: 1260 [[Prize Settings#DeathPrizeTime|Prize:DeathPrizeTime]]
; Uint16 JitterTime
: 1262 [[Bomb Settings#JitterTime|Bomb:JitterTime]]
; Uint16 EnterDelay
: 1264 [[Kill Settings#EnterDelay|Kill:EnterDelay]]
; Uint16 EngineShutdownTime
: 1266 [[Prize Settings#EngineShutdownTime|Prize:EngineShutdownTime]]
; Uint16 ProximityDistance
: 1268 [[Bomb Settings#ProximityDistance|Bomb:ProximityDistance]]
; Uint16 BountyIncreaseForKill
: 1270 [[Kill Settings#BountyIncreaseForKill|Kill:BountyIncreaseForKill]]
; Uint16 BounceFactor
: 1272 [[Misc Settings#BounceFactor|Misc:BounceFactor]]
; Uint16 MapZoomFactor
: 1274 [[Radar Settings#MapZoomFactor|Radar:MapZoomFactor]]
; Uint16 MaxBonus
: 1276 [[Kill Settings#MaxBonus|Kill:MaxBonus]]
; Uint16 MaxPenalty
: 1278 [[Kill Settings#MaxPenalty|Kill:MaxPenalty]]
; Uint16 RewardBase
: 1280 [[Kill Settings#RewardBase|Kill:RewardBase]]
; Uint16 RepelTime
: 1282 [[Repel Settings#RepelTime|Repel:RepelTime]]
; Uint16 RepelDistance
: 1284 [[Repel Settings#RepelDistance|Repel:RepelDistance]]
; Uint16 HelpTickerDelay
: 1286 [[Misc Settings#TickerDelay|Misc:TickerDelay]]
; Uint16 FlaggerOnRadar
: 1288 [[Flag Settings#FlaggerOnRadar|Flag:FlaggerOnRadar]]
; Uint16 FlaggerKillMultiplier
: 1290 [[Flag Settings#FlaggerKillMultiplier|Flag:FlaggerKillMultiplier]]
; Uint16 PrizeFactor
: 1292 [[Prize Settings#PrizeFactor|Prize:PrizeFactor]]
; Uint16 PrizeDelay
: 1294 [[Prize Settings#PrizeDelay|Prize:PrizeDelay]]
; Uint16 PrizeMinimumVirtual
: 1296 [[Prize Settings#MinimumVirtual|Prize:MinimumVirtual]]
; Uint16 PrizeUpgradeVirtual
: 1298 [[Prize Settings#UpgradeVirtual|Prize:UpgradeVirtual]]
; Uint16 PrizeMaxExist
: 1300 [[Prize Settings#PrizeMaxExist|Prize:PrizeMaxExist]]
; Uint16 PrizeMinExist
: 1302 [[Prize Settings#PrizeMinExist|Prize:PrizeMinExist]]
; Uint16 PrizeNegativeFactor
: 1304 [[Prize Settings#PrizeNegativeFactor|Prize:PrizeNegativeFactor]]
; Uint16 DoorDelay
: 1306 [[Door Settings#DoorDelay|Door:DoorDelay]]
; Uint16 AntiwarpPixels
: 1308 [[Toggle Settings#AntiWarpPixels|Toggle:AntiWarpPixels]]
; Sint16 DoorMode
: 1310 [[Door Settings#DoorMode|Door:DoorMode]]
; Uint16 FlagBlankDelay
: 1312 [[Flag Settings#FlagBlankDelay|Flag:FlagBlankDelay]]
; Uint16 NoDataFlagDropDelay
: 1314 [[Flag Settings#NoDataFlagDropDelay|Flag:NoDataFlagDropDelay]]
; Uint16 MultiPrizeCount
: 1316 [[Prize Settings#MultiPrizeCount|Prize:MultiPrizeCount]]
; Uint16 BrickTime
: 1318 [[Brick Settings#BrickTime|Brick:BrickTime]]
; Uint16 WarpRadiusLimit
: 1320 [[Misc Settings#WarpRadiusLimit|Misc:WarpRadiusLimit]]
; Uint16 EBombShutdownTime
: 1322 [[Bomb Settings#EBombShutdownTime|Bomb:EBombShutdownTime]]
; Uint16 EBombDamagePercent
: 1324 [[Bomb Settings#EBombDamagePercent|Bomb:EBombDamagePercent]]
; Uint16 RadarNeutralSize
: 1326 [[Radar Settings#RadarNeutralSize|Radar:RadarNeutralSize]]
; Uint16 WarpPointDelay
: 1328 [[Misc Settings#WarpPointDelay|Misc:WarpPointDelay]]
; Uint16 NearDeathLevel
: 1330 [[Misc Settings#NearDeathLevel|Misc:NearDeathLevel]]
; Uint16 BBombDamagePercent
: 1332 [[Bomb Settings#BBombDamagePercent|Bomb:BBombDamagePercent]]
; Uint16 ShrapnelDamagePercent
: 1334 [[Shrapnel Settings#ShrapnelDamagePercent|Shrapnel:ShrapnelDamagePercent]]
; Uint16 ClientSlowPacketTime
: 1336 [[Latency Settings#ClientSlowPacketTime|Latency:ClientSlowPacketTime]]
; Uint16 FlagDropResetReward
: 1338 [[Flag Settings#FlagDropResetReward|Flag:FlagDropResetReward]]
; Uint16 FlaggerFireCostPercent
: 1340 [[Flag Settings#FlaggerFireCostPercent|Flag:FlaggerFireCostPercent]]
; Uint16 FlaggerDamagePercent
: 1342 [[Flag Settings#FlaggerDamagePercent|Flag:FlaggerDamagePercent]]
; Uint16 FlaggerBombFireDelay
: 1344 [[Flag Settings#FlaggerBombFireDelay|Flag:FlaggerBombFireDelay]]
; Uint16 SoccerPassDelay
: 1346 [[Soccer Settings#PassDelay|Soccer:PassDelay]]
; Uint16 SoccerBallBlankDelay
: 1348 [[Soccer Settings#BallBlankDelay|Soccer:BallBlankDelay]]
; Uint16 S2CNoDataKickoutDelay
: 1350 [[Latency Settings#S2CNoDataKickoutDelay|Latency:S2CNoDataKickoutDelay]]
; Uint16 FlaggerThrustAdjustment
: 1352 [[Flag Settings#FlaggerThrustAdjustment|Flag:FlaggerThrustAdjustment]]
; Uint16 FlaggerSpeedAdjustment
: 1354 [[Flag Settings#FlaggerSpeedAdjustment|Flag:FlaggerSpeedAdjustment]]
; Uint16 CliSlowPacketSampleSize
: 1356 [[Latency Settings#ClientSlowPacketSampleSize|Latency:ClientSlowPacketSampleSize]]

; BYTE UNKNOWN1[10]
: 1358 ?

; BYTE RandomShrapnel
: 1368 [[Shrapnel Settings#Random|Shrapnel:Random]]
; BYTE SoccerBallBounce
: 1369 [[Soccer Settings#BallBounce|Soccer:BallBounce]]
; BYTE SoccerAllowBombs
: 1370 [[Soccer Settings#AllowBombs|Soccer:AllowBombs]]
; BYTE SoccerAllowGuns
: 1371 [[Soccer Settings#AllowGuns|Soccer:AllowGuns]]
; BYTE SoccerMode
: 1372 [[Soccer Settings#Mode|Soccer:Mode]]
; BYTE MaxPerTeam
: 1373 [[Team Settings#MaxPerTeam|Team:MaxPerTeam]]
; BYTE MaxPerPrivateTeam
: 1374 [[Team Settings#MaxPerPrivateTeam|Team:MaxPerPrivateTeam]]
; BYTE TeamMaxMines
: 1375 [[Mine Settings#TeamMaxMines|Mine:TeamMaxMines]]
; BYTE WormholeGravityBombs
: 1376 [[Wormhole Settings#GravityBombs|Wormhole:GravityBombs]]
; BYTE BombSafety
: 1377 [[Bomb Settings#BombSafety|Bomb:BombSafety]]
; BYTE MessageReliable
: 1378 [[Message Settings#MessageReliable|Message:MessageReliable]]
; BYTE TakePrizeReliable
: 1379 [[Prize Settings#TakePrizeReliable|Prize:TakePrizeReliable]]
; BYTE AllowAudioMessages
: 1380 [[Message Settings#AllowAudioMessages|Message:AllowAudioMessages]]
; BYTE PrizeHideCount
: 1381 [[Prize Settings#PrizeHideCount|Prize:PrizeHideCount]]
; BYTE ExtraPositionData
: 1382 [[Misc Settings#ExtraPositionData|Misc:ExtraPositionData]]
; BYTE SlowFrameCheck
: 1383 [[Misc Settings#SlowFrameCheck|Misc:SlowFrameCheck]]
; BYTE CarryFlags
: 1384 [[Flag Settings#CarryFlags|Flag:CarryFlags]]
; BYTE AllowSavedShip
: 1385 [[Misc Settings#AllowSavedShips|Misc:AllowSavedShips]]
; BYTE RadarMode
: 1386 [[Radar Settings#RadarMode|Radar:RadarMode]]
; BYTE VictoryMusic
: 1387 [[Misc Settings#VictoryMusic|Misc:VictoryMusic]]
; BYTE FlaggerGunUpgrade
: 1388 [[Flag Settings#FlaggerGunUpgrade|Flag:FlaggerGunUpgrade]]
; BYTE FlaggerBombUpgrade
: 1389 [[Flag Settings#FlaggerBombUpgrade|Flag:FlaggerBombUpgrade]]
; BYTE SoccerUseFlagger
: 1390 [[Soccer Settings#UseFlagger|Soccer:UseFlagger]]
; BYTE SoccerBallLocation
: 1391 [[Soccer Settings#BallLocation|Soccer:BallLocation]]

; BYTE UNKNOWN2[8]
: 1392 ?

; prizeSettings pw
: 1400 See below prizeweight structure.

== struct ShipSettings ==
Each ship's settings are sent in a copy of this 144-byte structure (offsets are for warbird):

; Uint16 SuperTime
: 0004 [[Ship Settings#SuperTime|All:SuperTime]]
; Uint16 UNKNOWN0
: 0006 (100) Salt for actual super time?
; Uint16 ShieldsTime
: 0008 [[Ship Settings#ShieldsTime|All:ShieldsTime]]
; Uint16 UNKNOWN1
: 0010 (30) Salt for actual shields time?
; Uint16 Gravity
: 0012 [[Ship Settings#Gravity|All:Gravity]]
; Uint16 GravityTopSpeed
: 0014 [[Ship Settings#GravityTopSpeed|All:GravityTopSpeed]]
; Uint16 BulletFireEnergy
: 0016 [[Ship Settings#BulletFireEnergy|All:BulletFireEnergy]]
; Uint16 MultiFireEnergy
: 0018 [[Ship Settings#MultiFireEnergy|All:MultiFireEnergy]]
; Uint16 BombFireEnergy
: 0020 [[Ship Settings#BombFireEnergy|All:BombFireEnergy]]
; Uint16 BombFireEnergyUpgrade
: 0022 [[Ship Settings#BombFireEnergyUpgrade|All:BombFireEnergyUpgrade]]
; Uint16 MineFireEnergy
: 0024 [[Ship Settings#LandmineFireEnergy|All:LandmineFireEnergy]]
; Uint16 MineFireEnergyUpgrade
: 0026 [[Ship Settings#LandmineFireEnergyUpgrade|All:LandmineFireEnergyUpgrade]]
; Uint16 BulletSpeed
: 0028 [[Ship Settings#BulletSpeed|All:BulletSpeed]]
; Uint16 BombSpeed
: 0030 [[Ship Settings#BombSpeed|All:BombSpeed]]

; unsigned SeeBombLevel (2 bits)
: 0032 [[Ship Settings#SeeBombLevel|All:SeeBombLevel]] (Continuum .36+)
; unsigned DisableFastBombs (1 bits)
: 0032 [[Ship Settings#DisableFastShooting|All:DisableFastShooting]] (Continuum .36+)
; unsigned Radius (7 bits)
: 0032 [[Ship Settings#Radius|All:Radius]] (Continuum .37+)
; unsigned pack0 (6 bits)
: 0033 Unused
; unsigned MultiFireAngle (16 bits)
: 0034 [[Ship Settings#MultiFireAngle|All:MultiFireAngle]]

; Uint16 CloakEnergy
: 0036 [[Ship Settings#CloakEnergy|All:CloakEnergy]]
; Uint16 StealthEnergy
: 0038 [[Ship Settings#StealthEnergy|All:StealthEnergy]]
; Uint16 AntiWarpEnergy
: 0040 [[Ship Settings#AntiWarpEnergy|All:AntiWarpEnergy]]
; Uint16 XRadarEnergy
: 0042 [[Ship Settings#XRadarEnergy|All:XRadarEnergy]]
; Uint16 MaximumRotation
: 0044 [[Ship Settings#MaximumRotation|All:MaximumRotation]]
; Uint16 MaximumThrust
: 0046 [[Ship Settings#MaximumThrust|All:MaximumThrust]]
; Uint16 MaximumSpeed
: 0048 [[Ship Settings#MaximumSpeed|All:MaximumSpeed]]
; Uint16 MaximumRecharge
: 0050 [[Ship Settings#MaximumRecharge|All:MaximumRecharge]]
; Uint16 MaximumEnergy
: 0052 [[Ship Settings#MaximumEnergy|All:MaximumEnergy]]
; Uint16 InitialRotation
: 0054 [[Ship Settings#InitialRotation|All:InitialRotation]]
; Uint16 InitialThrust
: 0056 [[Ship Settings#InitialThrust|All:InitialThrust]]
; Uint16 InitialSpeed
: 0058 [[Ship Settings#InitialSpeed|All:InitialSpeed]]
; Uint16 InitialRecharge
: 0060 [[Ship Settings#InitialRecharge|All:InitialRecharge]]
; Uint16 InitialEnergy
: 0062 [[Ship Settings#InitialEnergy|All:InitialEnergy]]
; Uint16 UpgradeRotation
: 0064 [[Ship Settings#UpgradeRotation|All:UpgradeRotation]]
; Uint16 UpgradeThrust
: 0066 [[Ship Settings#UpgradeThrust|All:UpgradeThrust]]
; Uint16 UpgradeSpeed
: 0068 [[Ship Settings#UpgradeSpeed|All:UpgradeSpeed]]
; Uint16 UpgradeRecharge
: 0070 [[Ship Settings#UpgradeRecharge|All:UpgradeRecharge]]
; Uint16 UpgradeEnergy
: 0072 [[Ship Settings#UpgradeEnergy|All:UpgradeEnergy]]
; Uint16 AfterburnerEnergy
: 0074 [[Ship Settings#AfterburnerEnergy|All:AfterburnerEnergy]]
; Uint16 BombThrust
: 0076 [[Ship Settings#BombThrust|All:BombThrust]]
; Uint16 BurstSpeed
: 0078 [[Ship Settings#BurstSpeed|All:BurstSpeed]]
; Uint16 TurretThrustPenalty
: 0080 [[Ship Settings#TurretThrustPenalty|All:TurretThrustPenalty]]
; Uint16 TurretSpeedPenalty
: 0082 [[Ship Settings#TurretSpeedPenalty|All:TurretSpeedPenalty]]
; Uint16 BulletFireDelay
: 0084 [[Ship Settings#BulletFireDelay|All:BulletFireDelay]]
; Uint16 MultiFireDelay
: 0086 [[Ship Settings#MultiFireDelay|All:MultiFireDelay]]
; Uint16 BombFireDelay
: 0088 [[Ship Settings#BombFireDelay|All:BombFireDelay]]
; Uint16 LandmineFireDelay
: 0090 [[Ship Settings#LandmineFireDelay|All:LandmineFireDelay]]
; Uint16 RocketTime
: 0092 [[Ship Settings#RocketTime|All:RocketTime]]
; Uint16 InitialBounty
: 0094 [[Ship Settings#InitialBounty|All:InitialBounty]]
; Uint16 DamageFactor
: 0096 [[Ship Settings#DamageFactor|All:DamageFactor]]
; Uint16 PrizeShareLimit
: 0098 [[Ship Settings#PrizeShareLimit|All:PrizeShareLimit]]
; Uint16 AttachBounty
: 0100 [[Ship Settings#AttachBounty|All:AttachBounty]]
; Uint16 SoccerThrowTime
: 0102 [[Ship Settings#SoccerThrowTime|All:SoccerThrowTime]]
; Uint16 SoccerBallFriction
: 0104 [[Ship Settings#SoccerBallFriction|All:SoccerBallFriction]]
; Uint16 SoccerBallProximity
: 0106 [[Ship Settings#SoccerBallProximity|All:SoccerBallProximity]]
; Uint16 SoccerBallSpeed
: 0108 [[Ship Settings#SoccerBallSpeed|All:SoccerBallSpeed]]

; BYTE TurretLimit
: 0110 [[Ship Settings#TurretLimit|All:TurretLimit]]
; BYTE BurstShrapnel
: 0111 [[Ship Settings#BurstShrapnel|All:BurstShrapnel]]
; BYTE MaxMines
: 0112 [[Ship Settings#MaxMines|All:MaxMines]]
; BYTE RepelMax
: 0113 [[Ship Settings#RepelMax|All:RepelMax]]
; BYTE BurstMax
: 0114 [[Ship Settings#BurstMax|All:BurstMax]]
; BYTE DecoyMax
: 0115 [[Ship Settings#DecoyMax|All:DecoyMax]]
; BYTE ThorMax
: 0116 [[Ship Settings#ThorMax|All:ThorMax]]
; BYTE BrickMax
: 0117 [[Ship Settings#BrickMax|All:BrickMax]]
; BYTE RocketMax
: 0118 [[Ship Settings#RocketMax|All:RocketMax]]
; BYTE PortalMax
: 0119 [[Ship Settings#PortalMax|All:PortalMax]]
; BYTE InitialRepel
: 0120 [[Ship Settings#InitialRepel|All:InitialRepel]]
; BYTE InitialBurst
: 0121 [[Ship Settings#InitialBurst|All:InitialBurst]]
; BYTE InitialBrick
: 0122 [[Ship Settings#InitialBrick|All:InitialBrick]]
; BYTE InitialRocket
: 0123 [[Ship Settings#InitialRocket|All:InitialRocket]]
; BYTE InitialThor
: 0124 [[Ship Settings#InitialThor|All:InitialThor]]
; BYTE InitialDecoy
: 0125 [[Ship Settings#InitialDecoy|All:InitialDecoy]]
; BYTE InitialPortal
: 0126 [[Ship Settings#InitialPortal|All:InitialPortal]]
; BYTE BombBounceCount
: 0127 [[Ship Settings#BombBounceCount|All:BombBounceCount]]

; unsigned ShrapnelMax (5 bits)
: 0128 [[Ship Settings#ShrapnelMax|All:ShrapnelMax]]
; unsigned ShrapnelRate (5 bits)
: 0128 [[Ship Settings#ShrapnelRate|All:ShrapnelRate]]

; unsigned CloakStatus (2 bits)
: 0129 [[Ship Settings#CloakStatus|All:CloakStatus]]
; unsigned StealthStatus (2 bits)
: 0129 [[Ship Settings#StealthStatus|All:StealthStatus]]
; unsigned XRadarStatus (2 bits)
: 0129 [[Ship Settings#XRadarStatus|All:XRadarStatus]]
; unsigned AntiwarpStatus (2 bits)
: 0130 [[Ship Settings#AntiWarpStatus|All:AntiWarpStatus]]

; unsigned InitialGuns (2 bits)
: 0130 [[Ship Settings#InitialGuns|All:InitialGuns]]
; unsigned MaxGuns (2 bits)
: 0130 [[Ship Settings#MaxGuns|All:MaxGuns]]
; unsigned InitialBombs (2 bits)
: 0130 [[Ship Settings#InitialBombs|All:InitialBombs]]
; unsigned MaxBombs (2 bits)
: 0131 [[Ship Settings#MaxBombs|All:MaxBombs]]

; unsigned DoubleBarrel (1 bits)
: 0131 [[Ship Settings#DoubleBarrel|All:DoubleBarrel]]
; unsigned EmpBomb (1 bits)
: 0131 [[Ship Settings#EmpBomb|All:EmpBomb]]
; unsigned SeeMines (1 bits)
: 0131 [[Ship Settings#SeeMines|All:SeeMines]]
; unsigned UNKNOWN2 (3 bits)
: 0131 ?

; BYTE UNKNOWN3[16]
: 0132 ?

== struct PrizeSettings ==
Prizeweights are actually handled as an array by SubSpace/Subgame, but the following 28-byte structure represents an, in some respects, better way:

; BYTE Recharge
: 1400 [[PrizeWeight Settings#QuickCharge|PrizeWeight:QuickCharge]]
; BYTE Energy
: 1401 [[PrizeWeight Settings#Energy|PrizeWeight:Energy]]
; BYTE Rotation
: 1402 [[PrizeWeight Settings#Rotation|PrizeWeight:Rotation]]
; BYTE Stealth
: 1403 [[PrizeWeight Settings#Stealth|PrizeWeight:Stealth]]
; BYTE Cloak
: 1404 [[PrizeWeight Settings#Cloak|PrizeWeight:Cloak]]
; BYTE XRadar
: 1405 [[PrizeWeight Settings#XRadar|PrizeWeight:XRadar]]
; BYTE Warp
: 1406 [[PrizeWeight Settings#Warp|PrizeWeight:Warp]]
; BYTE Gun
: 1407 [[PrizeWeight Settings#Gun|PrizeWeight:Gun]]
; BYTE Bomb
: 1408 [[PrizeWeight Settings#Bomb|PrizeWeight:Bomb]]
; BYTE BouncingBullets
: 1409 [[PrizeWeight Settings#BouncingBullets|PrizeWeight:BouncingBullets]]
; BYTE Thruster
: 1410 [[PrizeWeight Settings#Thruster|PrizeWeight:Thruster]]
; BYTE TopSpeed
: 1411 [[PrizeWeight Settings#TopSpeed|PrizeWeight:TopSpeed]]
; BYTE QuickCharge
: 1412 [[PrizeWeight Settings#Recharge|PrizeWeight:Recharge]]
; BYTE Glue
: 1413 [[PrizeWeight Settings#Glue|PrizeWeight:Glue]]
; BYTE MultiFire
: 1414 [[PrizeWeight Settings#MultiFire|PrizeWeight:MultiFire]]
; BYTE Proximity
: 1415 [[PrizeWeight Settings#Proximity|PrizeWeight:Proximity]]
; BYTE AllWeapons
: 1416 [[PrizeWeight Settings#AllWeapons|PrizeWeight:AllWeapons]]
; BYTE Shields
: 1417 [[PrizeWeight Settings#Shields|PrizeWeight:Shields]]
; BYTE Shrapnel
: 1418 [[PrizeWeight Settings#Shrapnel|PrizeWeight:Shrapnel]]
; BYTE AntiWarp
: 1419 [[PrizeWeight Settings#AntiWarp|PrizeWeight:AntiWarp]]
; BYTE Repel
: 1420 [[PrizeWeight Settings#Repel|PrizeWeight:Repel]]
; BYTE Burst
: 1421 [[PrizeWeight Settings#Burst|PrizeWeight:Burst]]
; BYTE Decoy
: 1422 [[PrizeWeight Settings#Decoy|PrizeWeight:Decoy]]
; BYTE Thor
: 1423 [[PrizeWeight Settings#Thor|PrizeWeight:Thor]]
; BYTE MultiPrize
: 1424 [[PrizeWeight Settings#MultiPrize|PrizeWeight:MultiPrize]]
; BYTE Brick
: 1425 [[PrizeWeight Settings#Brick|PrizeWeight:Brick]]
; BYTE Rocket
: 1426 [[PrizeWeight Settings#Rocket|PrizeWeight:Rocket]]
; BYTE Portal
: 1427 [[PrizeWeight Settings#Portal|PrizeWeight:Portal]]

[[Category:Game Intricacies]]

Bomb Settings

2005-09-13T02:57:46Z

Cyan~Fire: minor revisions

[Bomb] These are [[subgame]] and [[ASSS]] settings for bombs in an arena. They are all sent to and handled by the client in the [[Settings Structure]]. Note that all bomb levels share the same damage level, but differ in their blast radius. If you'd like to experiment with the above settings, you can do so with the [http://www.shanky.com/cgi-bin/ryan/bomb.cgi Bomb Calculator].

=== BombDamageLevel ===

''Datatype:'' Energy.

Amount of damage a bomb causes at its center point (for all bomb levels).

=== BombAliveTime ===

''Datatype:'' Hundredths of seconds.

Time a bomb can fly before is disappears. This is really a networking setting and not a weapon setting, so the default should be sufficient.

=== BombExplodeDelay ===

''Datatype:'' Hundredths of seconds.

How long after the proximity sensor is triggered before bomb explodes. (''Note:'' it explodes immediately if ship moves away from it after triggering it.)

=== BombExplodePixels ===

''Datatype:'' Pixels.

Initial blast radius for a bomb, then multiplied by bomb level (so L1 gets this, L2 gets double, etc.). Note that this is purely the damage radius, not affected by prox.

=== ProximityDistance ===

''Datatype:'' Tiles.

Radius of proximity trigger of an L1 bomb. Each bomb level adds 1 to this amount.

=== JitterTime ===

''Datatype:'' Hundredths of seconds.

How long the screen jitters from a bomb hit.

=== BombSafety ===

''Datatype:'' Boolean (0=no, 1=yes).

Enables a firing safety for proximity bombs. If an enemy ship is within proximity radius, the firing safety will not let the user fire.

=== EBombShutdownTime ===

''Datatype:'' Hundredths of seconds.

Maximum time an EMP bomb suspends recharge. When the EMP hits the player indirectly (through the blast radius), this time is reduced.

=== EBombDamagePercent ===

''Datatype:'' Tenths of a percent. (1000 = 100%, 2000 = 200%.)

Percentage of normal damage applied to an EMP bomb.

=== BBombDamagePercent ===

''Datatype:'' Tenths of a percent. (1000 = 100%, 2000 = 200%.)

Percentage of normal damage applied to a bouncing bomb. Note that even though a bouncing bomb loses its bouncing picture after the last bounce, it retains this percentage modifier.

[[Category: Settings]]

MySQL Database Setup

2005-09-13T01:34:22Z

Cyan~Fire: personal messages are inappropriate in this context IMO

===Installing MySQL===
Detailed MySQL instructions can be found at http://dev.mysql.com/doc/mysql/en/Installing.html.

===Getting ASSS and MySQL talking===
#In modules.conf, enable database:mysql and database:aliasdb.
#After getting MySQL installed (and functioning), install the MySQL administrator (NT based Windows, Linux, and OS X are supported) which is also found on the MySQL download page.
#Create a user, a password for this user, and a database in MySQL. The default is "asss" for the user name and database name, and your choice on the password.
#Assign permissions between the user and the database.
#In global.conf in the [mysql] section change the user name, password, and the table name to what you have chosen above. The hostname should be localhost if MySQL is running on the same computer the server is. Otherwise you can use an IP address.

A sample would look like:
<pre>[mysql]
hostname=localhost
user=asss
password=whatever you selected for a password
database=asss</pre>

Good Luck!

[[Category:ASSS]]
[[Category:Guides]]

Bomb

2005-09-06T03:18:59Z

Cyan~Fire: exponential decay

A bomb is the second of the two standard weapons in [[SubSpace]]. Bombs, unlike [[bullet]]s, have a configurable blast radius, along with other properties, in the [[Bomb Settings]]. All bombs have the same damage level at the center point but damage decreases exponentially in the blast radius.

[[Continuum]] draws bombs using bombs.bm2 of the [[graphics files]].

[[Category:Weapons]]

Server.ini

2005-09-06T03:15:49Z

Cyan~Fire: specified more settings

server.ini is the initialization file for [[subgame]] that controls all of the global settings. Individual arena's settings are stored in arenaname.cfg. The following are the various sections in the server.ini.

<div style="float: right; margin-left: 20px">
__TOC__
</div>

== Validation ==

See [[Validation]].

== Custom ==
These settings configure custom arenas. (I think?)

=== ArenaMode ===
''Datatype:'' Enumeration.

This controls the ownership of private arenas. By "own a new subarena", it means that if the selected level of player creates a new subarena with ?go, and the arena does not have settings associated yet, subgame will create settings for that arena and assign [[arena ownership|ownership]] to the creating player. If the player creating the arena is below the selected level, subgame will still create settings for the arena, but will not grant ownership.
#Any player can own a new subarena.
#Mods+ can own a new subarena.
#Smods+ can own a new subarena.
#Sysops can own a new subarena.
#''Special:'' New subarenas will just use spawn.cfg. (That is, a new cfg must be placed in the server directory manually to give an arena its own settings.)

== Arena ==
These settings configure default arena settings.

=== ArenaMaxPlayers ===
''Datatype:'' Count.

Number of players allowed in any arena. (This can be overridden in the [[Misc Settings]] for an arena.)

=== ArenaDesiredPlayers ===
''Datatype:'' Count.

Subgame will create a new arena for entering players once an arena hits this population. This is different from the above setting in that users can still manually enter an arena with this population.

=== ArenaMinimumPlayers ===
''Datatype:'' Count.

Minimum number of players in a public arena before subgame automatically sends a message advising players to move on.

=== SpawnKeepScores ===
''Datatype:'' Boolean (1=yes,0=no).

Whether player-spawned arenas keep track of scores.

=== MaxArenas ===
''Datatype:'' Count.

The maximum number of arenas subgame will allow.

=== MaxArenasMemory ===
''Datatype:'' Bytes.

The maximum amount of memory subgame will allocate for arena data. Normally the default should suffice.

== Comms ==
Communication (networking) settings.

=== MaxQueueToLogin ===
''Datatype:'' Count.

Maximum number of clients waiting to login. Any that try when this limit is exceeded will receive the message "The server is busy handling other login requests. Please try again in a few moments. If problem persists, seek help at the Tech Support Forums found at www.subspacehq.com".

=== PacketHistoryMax ===

=== IncomingBufferSize ===

=== OutgoingBufferSize ===

=== EncryptMode ===

=== UnreliableBufferSize ===

=== TransportBufferSize ===

=== FlushTime ===
''Datatype:'' Milliseconds.

Subgame will queue position packets for this amount of time before sending them. ''Setting this too high will severly lag your zone.''

=== BandwithIdleTime ===
''Datatype:'' Seconds.

Subgame will stop sending position packets to a spectator after this time of inactivity. Useful for saving bandwidth.

=== SelectTime ===
''Datatype:'' Milliseconds.

Time delay subgame should wait for incoming packets before continuing on. This is recommended over CPU:SleepTime.

== Misc ==
Miscellaneous settings. (Some of these should really go elsewhere.)

=== DisableShareware ===

=== RegisterKickShareware ===
''Datatype:'' Boolean.

Should subgame kick shareware users in favor of registered users when server is full? (Leave set to 0.)

=== MaxSharewarePlayers ===
''Datatype:'' Count.

Maximum number of shareware players allowed on server. ''Special Value:'' -1 = unlimited.

=== MaxPlayers ===
''Datatype:'' Count.

Maximum total players allowed in zone.

=== MaxSharewareTime ===

=== DisableSharewareNames ===
''Datatype:'' Boolean.

Disables the ability for demo players to have customized names. The default displayed name will just be "~Demo".

=== DisableSharewareShips ===
''Datatype:'' Boolean.

Disables the ability for demo players to use ships 5-8.

=== DisableSharewareScores ===
''Datatype:'' Boolean.

Disables the ability for demo players to retain their scores between sessions. ''Note:'' Scores will always be disabled if the players do not have a name.

=== MenuKickOutDelay ===
''Datatype:'' Hundredths of seconds.

Amount of time a player may take logging in before server disconnects client.

=== NoAntiInSafe ===
''Datatype:'' Boolean.

If enabled, subgame will ignore [[AntiWarp]] of a player in a safe zone.

=== LockFreqs ===
''Datatype:'' Boolean.

Determines whether [[Commands#Arena Management|locking]] an arena locks freqs as well as ships. (1.34.3+)

=== PositionDataAccess ===
''Datatype:'' Enumeration.

Determines staff level that will receive extra position data when speccing. Useful if [[Misc Settings#ExtraPositionData]] is disabled.
*0=Sysop (default)
*1=SMod+
*2=Mod+

=== AlertCommand ===
''Datatype:'' Comma-delimited list.

If a player types any of these commands preceeded by a '?' followed by a message, subgame will send the message to all online staff. This is a replacement to the BanG ?cheater command. (1.34.3+)

=== AllowPubScorereset ===
''Datatype:'' Boolean.

If enabled, players in public arenas may use the ?scorereset command.

=== AllowPvtScorereset ===
''Datatype:'' Boolean.

If enabled, players in private arenas may use the ?scorereset command.

=== TimerDropFlagTerritoryRadius ===
''Datatype:'' Tiles.

All flags dropped when timer expires (non-neutral) will drop this radius from the ship, overriding [[Flag Settings#FlagTerritoryRadius]]. This is useful for respawning neuted flags (set FlagTerritoryRadius to 0). ''Special value:'' 0 = always use FlagTerritoryRadius.

=== ShipTypeSwitchResetPeriod ===
''Datatype:'' Milliseconds (?).

Determines length of time for [[Security Settings#MaxShipTypeSwitchCount]]. ''Special Value:'' 0 = disabled.

=== CheckWeapons ===
''Datatype:'' Boolean.

If enabled, any of the following conditions will trigger a security violation. The checks do not apply to SMod+.
* Bullet fired with level > [ship]MaxGuns + [Flag]FlaggerGunUpgrade
* Bouncing bullet fired and [PrizeWeight]BouncingBullets is 0 and [Cost]Bounce is 0
* Bomb fired with level > [ship]MaxBombs + [Flag]FlaggerBombUpgrade
* Prox bomb fired and [PrizeWeight]Proximity is 0 and [Cost]Prox is 0
* Bomb fired with shrap > [ship]ShrapnelMax
* Bomb fired with bouncing shrap and [PrizeWeight]BouncingBullets is 0 and [Cost]Bounce is 0
* Mine is fired and [ship]MaxMines is 0
* A prize is picked up and [PrizeWeight] of that prize is 0
* Stealth is turned on and [ship]StealthStatus is 0
* Cloak is turned on and [ship]CloakStatus is 0
* XRadar is turned on and [ship]XRadarStatus is 0
* Anti-Warp is turned on and [ship]AntiWarpStatus is 0
* Player uses UFO

=== CheckFastBombing ===
''Datatype:'' Bitfield.

*1 - Send sysop alert when fastbombing is detected
*2 - Filter out fastbombs
*4 - Kick fastbombing player off

=== FastBombingThreshold ===
See above.

=== LocalChat ===
''Datatype:'' Comma-delimited list.

Listed chat channels are local to the zone.

=== ForceObsceneCheck ===
''Datatype:'' Boolean.

Forces players to have obscene checking on.

=== NoFlagRewardLimit ===
''Datatype:'' Boolean.

Disables the default reward multiplier limit of 2 for [[Flag Settings#FlagRewardMode]].

=== LogPoints ===
=== PointUpdateDiff ===
''Datatype:'' Points.

Number of points that will trigger a score update sent to clients.

=== JackpotBroadcastPoints ===
''Datatype:'' Boolean.

If enabled, subgame will broadcast the jackpot points to all zones on the [[billing server]]. Not recommended.

=== ServerLog ===
''Datatype:'' Boolean.

If enabled, server will keep a text file log of events.

=== KeepAliveDelay ===
''Datatype:'' Milliseconds.

Delay between keepalive packets sent to packets. Should not be changed.

=== DefaultLevelFile ===
''Datatype:'' String.

Level file (such as _bzw.lvl) that zone will use for public arenas.

=== Port ===
''Datatype:'' Short.

Game port that subgame will user. Keep it above 1000 to avoid interference with other networking applications. This needs to be different for every zone running on the same server.

=== AllowVIEClients ===
''Datatype:'' Boolean.

Determines whether VIE [[SubSpace]] users are allowed to enter zone at all.

=== StaffChat ===
''Datatype:'' Comma-delimited list.

These chat channels are only joinable by Mods+.

=== ForceContinuumOnly ===
''Datatype:'' Boolean.

Determines whether only [[Continuum]] users are allowed to play.

=== ServerIP ===
''Datatype:'' IP Address.

WAN IP address of server computer. This can be found using http://www.whatismyip.com/ (easiest), ipconfig, or a router's status page.

== CPU ==
These settings determine subgame's CPU usage. Usually it performs well, so these should not be changed.

=== LoopDelay ===
=== ProcessMaxTime ===
=== SleepPerIteration ===
=== SlowIterationWarningLevel ===
=== SleepTime ===

== Permission ==
These settings restrict which clients may connect to your zone.

=== AllowBadMachineId ===
=== AllowLowBandwidth ===
=== MinimumSecondsToLogin ===
=== PermissionMaxPoints ===
=== PermissionMode ===
''Datatype:'' Boolean.

If enabled, only allows player names listed in permit.txt.

=== AutoPermissionPoints ===
=== AutoPermissionIDList ===
=== AutoPermissionMessage ===

== Password ==
Passwords for various player levels. Change to your heart's content.

=== SysopPassword ===
=== EnergyPassword ===
=== ModeratorPassword ===
=== SuperModeratorPassword ===
=== VIPPassword ===

== Billing ==
Configures subgame's interaction with the [[biller]].

=== LogMessages ===
''Datatype:'' Boolean.

Enables "logging" of commands to the biller. It is recommended to turn this off, as it normally just wastes bandwidth.

=== IP ===
''Datatype:'' IP/DNS address.

The address of the biller. If you are running the biller on the same computer as subgame, set this to <tt>localhost</tt>.

=== Password ===
''Datatype:'' String.

The password to connect to the biller. Normally, this should be the same as subbill.ini's Misc:Password.

=== ServerName ===
''Datatype:'' String.

The name of the zone that will be sent to the biller upon connection. This will also be sent to the directory server.

=== Port ===
''Datatype:'' Integer.

The port to connect to the biller, which should be equal to subbill.ini's Misc:Port.

=== ServerId ===
''Datatype:'' Integer.

The ServerID sent to the biller. This is not often used and should be equal to Misc:Port.

=== GroupId ===
''Datatype:'' Integer.

The group this server will join on the biller. This has to do with group operators, and is recommended to leave set to <tt>1</tt>

=== ScoreId ===
''Datatype:'' Integer.

The ScoreID of the server which the biller will use to identify your server between connections. This should normally be the same as Misc:Port.

=== ReconnectTime ===
Seems to have no effect.

=== AttemptTime ===
''Datatype:'' Hundredths of seconds.

How long subgame will attempt unsuccessfully to connect to the biller before it gives up.

== Advertise ==
These settings control subgame's built-in advertisement capability. To use advertisements, just create bitmaps in the SS Palette and save them in the subgame directory as ad0.bmp,ad1.bmp, etc. Prefix the name with "s_" to send to shareware players, with "r_" to send to registered players, and "b_" to send to both. For example, "b_ad0.bmp". Subgame will then randomly pick advertisements to display to players.

=== SendMode ===
''Datatype:'' Sum (bitfield).

Determines when advertisements are sent.
*1 = send them when the player enters the zone.
*2 = send them when player dies.

=== DisplayMode ===
''Datatype:'' Enumeration.

*0 = at top of screen behind all other graphics.
*1 = at top of screen on top of all other graphics.
*2 = floating around like a backdrop.

=== Duration ===
''Datatype:'' Milliseconds.

Length of time an advertisement is displayed. ''Special Value:'' 0 = always on.

== Directory ==
These settings configure subgame's interaction with the [[directory server]].

=== IP ===
''Datatype:'' IP/DNS list.

List of directory servers subgame will send its entry to. As of 24 May 2005, the following list is recommended:
<pre>sscentral.ds98.com,sscentral.subspace.inet.fi,sscentral.subspacehq.com</pre>

=== Description ===
''Datatype:'' String.

This description will be sent to the directory server to be associated with your zone. Include an ss:// DNS address to have Continuum keep your IP up to date.

=== NamePassword ===
''Datatype:'' String.

The password associated with the zone's server prefix. All zones with the same prefix must have the same NamePassword or the Directory server will not list them.

=== Port ===
''Datatype:'' Integer.

Leave this set to <tt>4991</tt>.

[[Category:Settings]]

Server.ini

2005-09-04T17:07:31Z

Cyan~Fire: /* NoFlagRewardLimit */ specify limit

server.ini is the initialization file for [[subgame]] that controls all of the global settings. Individual arena's settings are stored in arenaname.cfg. The following are the various sections in the server.ini.

<div style="float: right; margin-left: 20px">
__TOC__
</div>

== Validation ==

See [[Validation]].

== Custom ==
These settings configure custom arenas. (I think?)

=== ArenaMode ===
''Datatype:'' Enumeration.

This controls the ownership of private arenas. By "own a new subarena", it means that if the selected level of player creates a new subarena with ?go, and the arena does not have settings associated yet, subgame will create settings for that arena and assign [[arena ownership|ownership]] to the creating player. If the player creating the arena is below the selected level, subgame will still create settings for the arena, but will not grant ownership.
#Any player can own a new subarena.
#Mods+ can own a new subarena.
#Smods+ can own a new subarena.
#Sysops can own a new subarena.
#''Special:'' New subarenas will just use spawn.cfg. (That is, a new cfg must be placed in the server directory manually to give an arena its own settings.)

== Arena ==
These settings configure default arena settings.

=== ArenaMaxPlayers ===
''Datatype:'' Count.

Number of players allowed in any arena. (This can be overridden in the [[Misc Settings]] for an arena.)

=== ArenaDesiredPlayers ===
''Datatype:'' Count.

Number of players subgame will try to put in each public arena.

=== ArenaMinimumPlayers ===
''Datatype:'' Count.

Minimum number of players in a public arena before subgame starts closing it down.

=== SpawnKeepScores ===
''Datatype:'' Boolean (1=yes,0=no).

=== MaxArenas ===
''Datatype:'' Count.

=== MaxArenasMemory ===

== Comms ==
Communication (networking) settings.

=== MaxQueueToLogin ===
''Datatype:'' Count.

Maximum number of clients waiting to login. Any that try when this limit is exceeded will receive the message "The server is busy handling other login requests. Please try again in a few moments. If problem persists, seek help at the Tech Support Forums found at www.subspacehq.com".

=== PacketHistoryMax ===

=== IncomingBufferSize ===

=== OutgoingBufferSize ===

=== EncryptMode ===

=== UnreliableBufferSize ===

=== TransportBufferSize ===

=== FlushTime ===
''Datatype:'' Milliseconds.

Subgame will queue position packets for this amount of time before sending them. ''Setting this too high will severly lag your zone.''

=== BandwithIdleTime ===
''Datatype:'' Seconds.

Subgame will stop sending position packets to a spectator after this time of inactivity. Useful for saving bandwidth.

=== SelectTime ===
''Datatype:'' Milliseconds.

Time delay subgame should wait for incoming packets before continuing on. This is recommended over CPU:SleepTime.

== Misc ==
Miscellaneous settings. (Some of these should really go elsewhere.)

=== DisableShareware ===

=== RegisterKickShareware ===

=== MaxSharewarePlayers ===

=== MaxPlayers ===

=== MaxSharewareTime ===

=== DisableSharewareNames ===
''Datatype:'' Boolean.

Disables the ability for demo players to have customized names. The default displayed name will just be "~Demo".

=== DisableSharewareShips ===
''Datatype:'' Boolean.

Disables the ability for demo players to use ships 5-8.

=== DisableSharewareScores ===
''Datatype:'' Boolean.

Disables the ability for demo players to retain their scores between sessions. ''Note:'' Scores will always be disabled if the players do not have a name.

=== MenuKickOutDelay ===

=== NoAntiInSafe ===
''Datatype:'' Boolean.

If enabled, subgame will ignore [[AntiWarp]] of a player in a safe zone.

=== LockFreqs ===
''Datatype:'' Boolean.

Determines whether [[Commands#Arena Management|locking]] an arena locks freqs as well as ships. (1.34.3+)

=== PositionDataAccess ===
''Datatype:'' Enumeration.

Determines staff level that will receive extra position data when speccing. Useful if [[Misc Settings#ExtraPositionData]] is disabled.
*0=Sysop (default)
*1=SMod+
*2=Mod+

=== AlertCommand ===
''Datatype:'' Comma-delimited list.

If a player types any of these commands preceeded by a '?' followed by a message, subgame will send the message to all online staff. This is a replacement to the BanG ?cheater command. (1.34.3+)

=== AllowPubScorereset ===
''Datatype:'' Boolean.

If enabled, players in public arenas may use the ?scorereset command.

=== AllowPvtScorereset ===
''Datatype:'' Boolean.

If enabled, players in private arenas may use the ?scorereset command.

=== TimerDropFlagTerritoryRadius ===
''Datatype:'' Tiles.

All flags dropped when timer expires (non-neutral) will drop this radius from the ship, overriding [[Flag Settings#FlagTerritoryRadius]]. This is useful for respawning neuted flags (set FlagTerritoryRadius to 0). ''Special value:'' 0 = always use FlagTerritoryRadius.

=== ShipTypeSwitchResetPeriod ===
''Datatype:'' Milliseconds (?).

Determines length of time for [[Security Settings#MaxShipTypeSwitchCount]]. ''Special Value:'' 0 = disabled.

=== CheckWeapons ===
''Datatype:'' Boolean.

If enabled, any of the following conditions will trigger a security violation. The checks do not apply to SMod+.
* Bullet fired with level > [ship]MaxGuns + [Flag]FlaggerGunUpgrade
* Bouncing bullet fired and [PrizeWeight]BouncingBullets is 0 and [Cost]Bounce is 0
* Bomb fired with level > [ship]MaxBombs + [Flag]FlaggerBombUpgrade
* Prox bomb fired and [PrizeWeight]Proximity is 0 and [Cost]Prox is 0
* Bomb fired with shrap > [ship]ShrapnelMax
* Bomb fired with bouncing shrap and [PrizeWeight]BouncingBullets is 0 and [Cost]Bounce is 0
* Mine is fired and [ship]MaxMines is 0
* A prize is picked up and [PrizeWeight] of that prize is 0
* Stealth is turned on and [ship]StealthStatus is 0
* Cloak is turned on and [ship]CloakStatus is 0
* XRadar is turned on and [ship]XRadarStatus is 0
* Anti-Warp is turned on and [ship]AntiWarpStatus is 0
* Player uses UFO

=== CheckFastBombing ===
''Datatype:'' Bitfield.

*1 - Send sysop alert when fastbombing is detected
*2 - Filter out fastbombs
*4 - Kick fastbombing player off

=== FastBombingThreshold ===
See above.

=== LocalChat ===
''Datatype:'' Comma-delimited list.

Listed chat channels are local to the zone.

=== ForceObsceneCheck ===
''Datatype:'' Boolean.

Forces players to have obscene checking on.

=== NoFlagRewardLimit ===
''Datatype:'' Boolean.

Disables the default reward multiplier limit of 2 for [[Flag Settings#FlagRewardMode]].

=== LogPoints ===
=== PointUpdateDiff ===
=== JackpotBroadcastPoints ===
=== ServerLog ===
=== KeepAliveDelay ===
=== DefaultLevelFile ===
=== Port ===
=== AllowVIEClients ===
''Datatype:'' Boolean.

Determines whether VIE [[SubSpace]] users are allowed to enter zone at all.

=== StaffChat ===
''Datatype:'' Comma-delimited list.

These chat channels are only joinable by Mods+.

=== ForceContinuumOnly ===
=== ServerIP ===

== CPU ==
=== LoopDelay ===
=== ProcessMaxTime ===
=== SleepPerIteration ===
=== SlowIterationWarningLevel ===
=== SleepTime ===

== Permission ==
=== AllowBadMachineId ===
=== AllowLowBandwidth ===
=== MinimumSecondsToLogin ===
=== PermissionMaxPoints ===
=== PermissionMode ===
=== AutoPermissionPoints ===
=== AutoPermissionIDList ===
=== AutoPermissionMessage ===

== Password ==
=== SysopPassword ===
EnergyPassword=
=== ModeratorPassword ===
=== SuperModeratorPassword ===
VIPPassword=
//Change all to what you want

== Billing ==
Configures subgame's interaction with the [[biller]].

=== LogMessages ===
''Datatype:'' Boolean.

Enables "logging" of commands to the biller. It is recommended to turn this off, as it normally just wastes bandwidth.

=== IP ===
''Datatype:'' IP/DNS address.

The address of the biller. If you are running the biller on the same computer as subgame, set this to <tt>localhost</tt>.

=== Password ===
''Datatype:'' String.

The password to connect to the biller. Normally, this should be the same as subbill.ini's Misc:Password.

=== ServerName ===
''Datatype:'' String.

The name of the zone that will be sent to the biller upon connection. This will also be sent to the directory server.

=== Port ===
''Datatype:'' Integer.

The port to connect to the biller, which should be equal to subbill.ini's Misc:Port.

=== ServerId ===
''Datatype:'' Integer.

The ServerID sent to the biller. This is not often used and should be equal to Misc:Port.

=== GroupId ===
''Datatype:'' Integer.

The group this server will join on the biller. This has to do with group operators, and is recommended to leave set to <tt>1</tt>

=== ScoreId ===
''Datatype:'' Integer.

The ScoreID of the server which the biller will use to identify your server between connections. This should normally be the same as Misc:Port.

=== ReconnectTime ===

=== AttemptTime ===

== Advertise ==
These settings control subgame's built-in advertisement capability. To use advertisements, just create bitmaps in the SS Palette and save them in the subgame directory as ad0.bmp,ad1.bmp, etc. Prefix the name with "s_" to send to shareware players, with "r_" to send to registered players, and "b_" to send to both. For example, "b_ad0.bmp". Subgame will then randomly pick advertisements to display to players.

=== SendMode ===
''Datatype:'' Sum (bitfield).

Determines when advertisements are sent.
*1 = send them when the player enters the zone only.
*2 = send them when player dies.

=== DisplayMode ===
''Datatype:'' Enumeration.

*0 = at top of screen behind all other graphics.
*1 = at top of screen on top of all other graphics.
*2 = floating around like a backdrop.

=== Duration ===
''Datatype:'' Milliseconds.

Length of time an advertisement is displayed. ''Special Value:'' 0 = always on.

== Directory ==
These settings configure subgame's interaction with the [[directory server]].

=== IP ===
''Datatype:'' IP/DNS list.

List of directory servers subgame will send its entry to. As of 24 May 2005, the following list is recommended:
<pre>sscentral.ds98.com,sscentral.subspace.inet.fi,sscentral.subspacehq.com</pre>

=== Description ===
''Datatype:'' String.

This description will be sent to the directory server to be associated with your zone. Include an ss:// DNS address to have Continuum keep your IP up to date.

=== NamePassword ===
''Datatype:'' String.

The password associated with the zone's server prefix. All zones with the same prefix must have the same NamePassword or the Directory server will not list them.

=== Port ===
''Datatype:'' Integer.

Leave this set to <tt>4991</tt>.

[[Category:Settings]]

Subbill

2005-08-21T18:49:20Z

Cyan~Fire: basic command information

'''Subbill''' is the default billing server that comes with subgame2. It lacks many features of other billers, uses CPU time ineffectively, and has no banning system.

Subbill offers the following commands:
*?login password = logs into server as sysop so you can do these commands
*?adduser Name:Password = adds specified user to database (for closed systems)
*?changepassword Name:Password = changes a users password

As well as the following key combinations when the subbill console is focused:
*F11 = Shows stats (not very useful)
*Shift-F11 = Resets scores
*Shift-F12 = Saves and shutdown the Subbill server