ASSS Wiki - User contributions [en]

Troubleshooting Modules

2011-01-22T22:12:00Z

Hakaku: /* My module crashes whenever I try to use an interface! */ redundant

Here are some general solutions to help you solve a problem with a module that you just wrote.
Keep in mind that these are suggestions, and may not always be correct.

== My module works when I put it in modules.conf, but the zone crashes when I use ?insmod, why? ==

Chances are, you are doing something in the CB_ARENAACTION callback, and are doing something in the AA_PRECREATE or AA_CREATE states.
Simply do this when the module loads:

<pre>
Arena *a;
Link *link;
aman->Lock();
FOR_EACH_ARENA(a)
{
ArenaAction(a,AA_PRECREATE);
ArenaAction(a,AA_CREATE);
}
aman->Unlock();
</pre>

== When my module is in modules.conf, players can not enter the zone, or when I use ?insmod, players can not switch arenas and I get errors about player states! ==

You may be using arena data improperly.
Be sure you have gotten the I_ARENAMAN interface and have used AllocateArenaData() properly.

== My module keeps failing to load! ==

Be sure you have all the necessary modules needed for your module to run.
Make sure your module loads after the modules it is dependant on are already loaded.

== My module crashes whenever I try to use an interface! ==

Make sure you have gotten the interface by using <tt>GetInterface()</tt> properly, that the assigned interface variable is unique, and that you verify whether or not the interface is valid by checking to see if it is not defined. The latter is typically done in the entry point, as shown [[Writing Modules In C#Using Interfaces|here]], by adding an if-statement and returning <tt>MM_FAIL</tt> on failure. If the interface is being called at some other point in the code, make sure to verify if it is defined and to handle cases throughout your code where it may not be valid.

Note also that if a parent interface does not check to see if it is still being used by other modules before unloading, it may cause instability in your zone and eventually result in a crash when a module calls that interface again.

== My module will not compile! Why can't my compiler find certain things? ==

Sometimes, #include asss.h is not enough.
Only the core header files are in asss.h, and you will need to manually include any others.
This may also be true if you are using a custom interface.

== Why does my module keep crashing when a player leaves the zone? ==

You may be saving the player pointer somewhere, and then are trying to access it after the player leaves.
This does not work because the pointer becomes invalid when the player leaves.
Your module is informed when this happens by the CB_NEWPLAYER callback.

[[Category:Module]]
[[Category:Guides]]

List of Custom Modules

2011-01-20T17:48:01Z

Hakaku: +2

Provided below is a list of custom modules and projects for ASSS which have been released for public use. Although several of them were designed for previous versions of ASSS, most of them still work when recompiled against the most recent release of ASSS, often with with little to no modifications necessary.

For help on how to compile C modules, see [[Installing New Modules]] for more details.

= Open Source =
== ASSS 1.5.0 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=8425 ASSS Command List Module] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8673 ASSS Files/Quickfix Module Combo Pack] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8429 ASSS Multipub Module] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8773 LVZHUD] - Samapico
* [http://forums.minegoboom.com/viewtopic.php?t=8690 Small module to help testing other modules] - D1st0rt

; Projects
* [http://forums.minegoboom.com/viewtopic.php?t=8629 ACE -- ASSS C Enricher (beta)] - Arnk Kilo Dylie

== ASSS 1.4.4 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=8676 ASSS Flags Module] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8470 ball_motion] - Goldeye
* [http://forums.minegoboom.com/viewtopic.php?t=8384 Colors] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8425 Command List] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8714 Deanti] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=8716 ?doors] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=8715 Flag Statistics] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=7469 fm_shiplimits] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=8095 Fuschia] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?p=78585#78585 Goal Callback example]
* [http://forums.minegoboom.com/viewtopic.php?t=8092 hs_util] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?p=79093#79093 Jackpot Music Lock] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=7560 King of the Hill] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=8530 Multinews] - JoWie
* [http://forums.minegoboom.com/viewtopic.php?t=8640 Setting banners (example)] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=8431 Sql Query] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=7757 Staff Message of the Day] - JoWie

; Python
* [http://forums.minegoboom.com/viewtopic.php?t=8171 Automated Team Picking] - D1st0rt
* [http://forums.minegoboom.com/viewtopic.php?t=3975 Bounty Rabbit] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=8402 Optparser] - D1st0rt
* [http://forums.minegoboom.com/viewtopic.php?p=82108#82108 Region-activated LVZ popup (example)] - JoWie

; Projects
* [http://forums.minegoboom.com/viewtopic.php?t=8382 Hosted Game Core] - D1st0rt
* [http://forums.minegoboom.com/viewtopic.php?p=80108#80108 Paintball Modules] - Bak

== ASSS 1.4.2 - 1.4.3 ==
; C
* [http://toktok.sscentral.com/ss-asss.html Autobrick] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6567 Chatmenu] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4882 Controllable doors] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3758 CTF flag game] - Smong
* [http://toktok.sscentral.com/ss-asss.html Digithud] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6187 hs_ufo] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=7059 Initial] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=7614 Jpcounter2] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7609 Per ship lvz] - JoWie
* [http://forums.minegoboom.com/viewtopic.php?t=6984 radarzoom - per ship MapZoomFactor] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7399 Region Triggers] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7563 Spree] - Smong, JoWie
* [http://forums.minegoboom.com/viewtopic.php?t=7507 Swappable game interface] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7608 Thor Level] - JoWie
* [http://forums.minegoboom.com/viewtopic.php?t=7055 Vehicles] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=7462 Zombie] - Animate Dreams

; Python
* [http://forums.minegoboom.com/viewtopic.php?t=3564 Autoprize] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7506 Craters] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6117 Dodgeball] - xsp0rtsfanx, Chambahs
* [http://forums.minegoboom.com/viewtopic.php?t=7614 fg_wz_spawns] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7454 Goal Spree] - BDwinsAlt
* [http://forums.minegoboom.com/viewtopic.php?t=7361 Kill lvz] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7391 Noise upon entering] - BDwinsAlt
* [http://forums.minegoboom.com/viewtopic.php?t=7724 ShipFX] - Jonus
* [http://toktok.sscentral.com/ss-asss.html Soundenter2] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7718 Staff Application] - Jonus
* [http://forums.minegoboom.com/viewtopic.php?t=7732 SubSpace Casino] - Jonus
* [http://toktok.sscentral.com/ss-asss.html Suggest] - Smong

; Projects
* [http://forums.minegoboom.com/viewtopic.php?t=5629 CNC Generals] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6035 Direct ASSS Web Stats] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7409 Hyperspace Core Modules] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=5629 Unreal Tournament] - Chambahs, Smong, others

== ASSS 1.3.6 - 1.4.0 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=4776 Cmdalias] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=4817 Drone] - Bak
* [http://toktok.sscentral.com/ss-asss.html Nomysql] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4159 Poll] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=4279 Prize Management System] - 50% Packetloss
* [http://forums.minegoboom.com/viewtopic.php?t=4777 Togglespec] - Bak

; Python
* [http://toktok.sscentral.com/ss-asss.html Autowarp3] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4865 Elim] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4262 Guessing game] - Chambahs, Smong
* [http://toktok.sscentral.com/ss-asss.html Note] - Smong
* [http://toktok.sscentral.com/ss-asss.html To do] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=5426 Turretwar] - D1st0rt
* [http://toktok.sscentral.com/ss-asss.html Wipeout] - Smong

== ASSS 1.2.x - 1.3.5 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=3690 Afk] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3306 hs_antiwarp] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=3305 hs_listnewb] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=3229 %macro expander] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3004 Moveto] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3228 Race] - Smong, i88gerbils

; Python
* [http://forums.minegoboom.com/viewtopic.php?t=3974 Blackjack] - Chambahs

== ASSS 0.9.x - 1.1.x ==
; C
* [http://toktok.sscentral.com/ss-asss.html autowarp2] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3162 Flag neuter] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=1888 No anti in centre] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=2467 Putmap] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=3163 Simple region tools] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=801 Teamkill] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=801 Triggers] - Smong
* [http://toktok.sscentral.com/ss-asss.html Warper] - Smong

= Close Source =
; C
* [http://forums.minegoboom.com/viewtopic.php?t=6757 Bot with Damage] - Smong
* [http://toktok.sscentral.com/ss-asss.html Cheat Detection] - Smong

[[Category:Custom Modules]]

List of Custom Modules

2011-01-20T15:39:29Z

Hakaku:

Provided below is a list of custom modules and projects for ASSS which have been released for public use. Although several of them were designed for previous versions of ASSS, most of them still work when recompiled against the most recent release of ASSS, often with with little to no modifications necessary.

For help on how to compile C modules, see [[Installing New Modules]] for more details.

= Open Source =
== ASSS 1.5.0 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=8425 ASSS Command List Module] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8673 ASSS Files/Quickfix Module Combo Pack] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8429 ASSS Multipub Module] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8773 LVZHUD] - Samapico
* [http://forums.minegoboom.com/viewtopic.php?t=8690 Small module to help testing other modules] - D1st0rt

; Projects
* [http://forums.minegoboom.com/viewtopic.php?t=8629 ACE -- ASSS C Enricher (beta)] - Arnk Kilo Dylie

== ASSS 1.4.4 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=8676 ASSS Flags Module] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8470 ball_motion] - Goldeye
* [http://forums.minegoboom.com/viewtopic.php?t=8384 Colors] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8425 Command List] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8714 Deanti] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=8716 ?doors] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=8715 Flag Statistics] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=7469 fm_shiplimits] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=8095 Fuschia] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?p=78585#78585 Goal Callback example]
* [http://forums.minegoboom.com/viewtopic.php?t=8092 hs_util] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?p=79093#79093 Jackpot Music Lock] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=7560 King of the Hill] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=8640 Setting banners (example)] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=8431 Sql Query] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=7757 Staff Message of the Day] - JoWie

; Python
* [http://forums.minegoboom.com/viewtopic.php?t=8171 Automated Team Picking] - D1st0rt
* [http://forums.minegoboom.com/viewtopic.php?t=3975 Bounty Rabbit] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=8402 Optparser] - D1st0rt

; Projects
* [http://forums.minegoboom.com/viewtopic.php?t=8382 Hosted Game Core] - D1st0rt
* [http://forums.minegoboom.com/viewtopic.php?p=80108#80108 Paintball Modules] - Bak

== ASSS 1.4.2 - 1.4.3 ==
; C
* [http://toktok.sscentral.com/ss-asss.html Autobrick] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6567 Chatmenu] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4882 Controllable doors] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3758 CTF flag game] - Smong
* [http://toktok.sscentral.com/ss-asss.html Digithud] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6187 hs_ufo] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=7059 Initial] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=7614 Jpcounter2] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7609 Per ship lvz] - JoWie
* [http://forums.minegoboom.com/viewtopic.php?t=6984 radarzoom - per ship MapZoomFactor] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7399 Region Triggers] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7563 Spree] - Smong, JoWie
* [http://forums.minegoboom.com/viewtopic.php?t=7507 Swappable game interface] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7608 Thor Level] - JoWie
* [http://forums.minegoboom.com/viewtopic.php?t=7055 Vehicles] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=7462 Zombie] - Animate Dreams

; Python
* [http://forums.minegoboom.com/viewtopic.php?t=3564 Autoprize] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7506 Craters] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6117 Dodgeball] - xsp0rtsfanx, Chambahs
* [http://forums.minegoboom.com/viewtopic.php?t=7614 fg_wz_spawns] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7454 Goal Spree] - BDwinsAlt
* [http://forums.minegoboom.com/viewtopic.php?t=7361 Kill lvz] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7391 Noise upon entering] - BDwinsAlt
* [http://forums.minegoboom.com/viewtopic.php?t=7724 ShipFX] - Jonus
* [http://toktok.sscentral.com/ss-asss.html Soundenter2] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7718 Staff Application] - Jonus
* [http://forums.minegoboom.com/viewtopic.php?t=7732 SubSpace Casino] - Jonus
* [http://toktok.sscentral.com/ss-asss.html Suggest] - Smong

; Projects
* [http://forums.minegoboom.com/viewtopic.php?t=5629 CNC Generals] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6035 Direct ASSS Web Stats] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7409 Hyperspace Core Modules] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=5629 Unreal Tournament] - Chambahs, Smong, others

== ASSS 1.3.6 - 1.4.0 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=4776 Cmdalias] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=4817 Drone] - Bak
* [http://toktok.sscentral.com/ss-asss.html Nomysql] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4159 Poll] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=4279 Prize Management System] - 50% Packetloss
* [http://forums.minegoboom.com/viewtopic.php?t=4777 Togglespec] - Bak

; Python
* [http://toktok.sscentral.com/ss-asss.html Autowarp3] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4865 Elim] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4262 Guessing game] - Chambahs, Smong
* [http://toktok.sscentral.com/ss-asss.html Note] - Smong
* [http://toktok.sscentral.com/ss-asss.html To do] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=5426 Turretwar] - D1st0rt
* [http://toktok.sscentral.com/ss-asss.html Wipeout] - Smong

== ASSS 1.2.x - 1.3.5 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=3690 Afk] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3306 hs_antiwarp] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=3305 hs_listnewb] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=3229 %macro expander] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3004 Moveto] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3228 Race] - Smong, i88gerbils

; Python
* [http://forums.minegoboom.com/viewtopic.php?t=3974 Blackjack] - Chambahs

== ASSS 0.9.x - 1.1.x ==
; C
* [http://toktok.sscentral.com/ss-asss.html autowarp2] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3162 Flag neuter] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=1888 No anti in centre] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=2467 Putmap] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=3163 Simple region tools] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=801 Teamkill] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=801 Triggers] - Smong
* [http://toktok.sscentral.com/ss-asss.html Warper] - Smong

= Close Source =
; C
* [http://forums.minegoboom.com/viewtopic.php?t=6757 Bot with Damage] - Smong
* [http://toktok.sscentral.com/ss-asss.html Cheat Detection] - Smong

[[Category:Custom Modules]]

List of Custom Modules

2011-01-20T15:38:38Z

Hakaku: /* ASSS 1.4.4 */ Updated list (I may have gotten some wrongly categorized)

Provided below is a list of custom modules and projects for ASSS which have been released for public use. Although several of them were designed for previous versions of ASSS, most of them still work when recompiled against the most recent release of ASSS, often with with little to no modifications necessary.

For help on how to compile C modules, see [[Installing New Modules]] for more details.

= Open Source =
== ASSS 1.5.0 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=8425 ASSS Command List Module] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8673 ASSS Files/Quickfix Module Combo Pack] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8429 ASSS Multipub Module] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8773 LVZHUD] - Samapico
* [http://forums.minegoboom.com/viewtopic.php?t=8690 Small module to help testing other modules] - D1st0rt

== ASSS 1.4.4 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=8676 ASSS Flags Module] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8470 ball_motion] - Goldeye
* [http://forums.minegoboom.com/viewtopic.php?t=8384 Colors] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8425 Command List] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8714 Deanti] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=8716 ?doors] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=8715 Flag Statistics] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=7469 fm_shiplimits] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=8095 Fuschia] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?p=78585#78585 Goal Callback example]
* [http://forums.minegoboom.com/viewtopic.php?t=8092 hs_util] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?p=79093#79093 Jackpot Music Lock] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=7560 King of the Hill] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=8640 Setting banners (example)] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=8431 Sql Query] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=7757 Staff Message of the Day] - JoWie

; Python
* [http://forums.minegoboom.com/viewtopic.php?t=8171 Automated Team Picking] - D1st0rt
* [http://forums.minegoboom.com/viewtopic.php?t=3975 Bounty Rabbit] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=8402 Optparser] - D1st0rt

; Projects
* [http://forums.minegoboom.com/viewtopic.php?t=8629 ACE -- ASSS C Enricher (beta)] - Arnk Kilo Dylie
* [http://forums.minegoboom.com/viewtopic.php?t=8382 Hosted Game Core] - D1st0rt
* [http://forums.minegoboom.com/viewtopic.php?p=80108#80108 Paintball Modules] - Bak

== ASSS 1.4.2 - 1.4.3 ==
; C
* [http://toktok.sscentral.com/ss-asss.html Autobrick] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6567 Chatmenu] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4882 Controllable doors] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3758 CTF flag game] - Smong
* [http://toktok.sscentral.com/ss-asss.html Digithud] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6187 hs_ufo] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=7059 Initial] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=7614 Jpcounter2] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7609 Per ship lvz] - JoWie
* [http://forums.minegoboom.com/viewtopic.php?t=6984 radarzoom - per ship MapZoomFactor] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7399 Region Triggers] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7563 Spree] - Smong, JoWie
* [http://forums.minegoboom.com/viewtopic.php?t=7507 Swappable game interface] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7608 Thor Level] - JoWie
* [http://forums.minegoboom.com/viewtopic.php?t=7055 Vehicles] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=7462 Zombie] - Animate Dreams

; Python
* [http://forums.minegoboom.com/viewtopic.php?t=3564 Autoprize] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7506 Craters] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6117 Dodgeball] - xsp0rtsfanx, Chambahs
* [http://forums.minegoboom.com/viewtopic.php?t=7614 fg_wz_spawns] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7454 Goal Spree] - BDwinsAlt
* [http://forums.minegoboom.com/viewtopic.php?t=7361 Kill lvz] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7391 Noise upon entering] - BDwinsAlt
* [http://forums.minegoboom.com/viewtopic.php?t=7724 ShipFX] - Jonus
* [http://toktok.sscentral.com/ss-asss.html Soundenter2] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7718 Staff Application] - Jonus
* [http://forums.minegoboom.com/viewtopic.php?t=7732 SubSpace Casino] - Jonus
* [http://toktok.sscentral.com/ss-asss.html Suggest] - Smong

; Projects
* [http://forums.minegoboom.com/viewtopic.php?t=5629 CNC Generals] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6035 Direct ASSS Web Stats] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7409 Hyperspace Core Modules] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=5629 Unreal Tournament] - Chambahs, Smong, others

== ASSS 1.3.6 - 1.4.0 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=4776 Cmdalias] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=4817 Drone] - Bak
* [http://toktok.sscentral.com/ss-asss.html Nomysql] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4159 Poll] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=4279 Prize Management System] - 50% Packetloss
* [http://forums.minegoboom.com/viewtopic.php?t=4777 Togglespec] - Bak

; Python
* [http://toktok.sscentral.com/ss-asss.html Autowarp3] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4865 Elim] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4262 Guessing game] - Chambahs, Smong
* [http://toktok.sscentral.com/ss-asss.html Note] - Smong
* [http://toktok.sscentral.com/ss-asss.html To do] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=5426 Turretwar] - D1st0rt
* [http://toktok.sscentral.com/ss-asss.html Wipeout] - Smong

== ASSS 1.2.x - 1.3.5 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=3690 Afk] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3306 hs_antiwarp] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=3305 hs_listnewb] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=3229 %macro expander] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3004 Moveto] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3228 Race] - Smong, i88gerbils

; Python
* [http://forums.minegoboom.com/viewtopic.php?t=3974 Blackjack] - Chambahs

== ASSS 0.9.x - 1.1.x ==
; C
* [http://toktok.sscentral.com/ss-asss.html autowarp2] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3162 Flag neuter] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=1888 No anti in centre] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=2467 Putmap] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=3163 Simple region tools] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=801 Teamkill] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=801 Triggers] - Smong
* [http://toktok.sscentral.com/ss-asss.html Warper] - Smong

= Close Source =
; C
* [http://forums.minegoboom.com/viewtopic.php?t=6757 Bot with Damage] - Smong
* [http://toktok.sscentral.com/ss-asss.html Cheat Detection] - Smong

[[Category:Custom Modules]]

Troubleshooting Modules

2011-01-20T14:29:50Z

Hakaku: /* My module crashes whenever I try to use an interface! */ Expanding

Here are some general solutions to help you solve a problem with a module that you just wrote.
Keep in mind that these are suggestions, and may not always be correct.

== My module works when I put it in modules.conf, but the zone crashes when I use ?insmod, why? ==

Chances are, you are doing something in the CB_ARENAACTION callback, and are doing something in the AA_PRECREATE or AA_CREATE states.
Simply do this when the module loads:

<pre>
Arena *a;
Link *link;
aman->Lock();
FOR_EACH_ARENA(a)
{
ArenaAction(a,AA_PRECREATE);
ArenaAction(a,AA_CREATE);
}
aman->Unlock();
</pre>

== When my module is in modules.conf, players can not enter the zone, or when I use ?insmod, players can not switch arenas and I get errors about player states! ==

You may be using arena data improperly.
Be sure you have gotten the I_ARENAMAN interface and have used AllocateArenaData() properly.

== My module keeps failing to load! ==

Be sure you have all the necessary modules needed for your module to run.
Make sure your module loads after the modules it is dependant on are already loaded.

== My module crashes whenever I try to use an interface! ==

Make sure you have gotten the interface by using <tt>GetInterface()</tt> properly, that the assigned interface variable is unique, and that you verify whether or not the interface is valid by checking to see if it is not defined. The latter is typically done in the entry point, as shown [[Writing Modules In C#Using Interfaces|here]], by adding an if-statement and returning <tt>MM_FAIL</tt> on failure. If the interface is being called at some other point in the code, make sure to verify if it is defined and to handle cases throughout your code where it may not be valid.

Note also that if a parent interface does not check to see if it is still being used by other modules before unloading, it may cause instability in your zone and eventually result in a crash when such modules call the interface again.

== My module will not compile! Why can't my compiler find certain things? ==

Sometimes, #include asss.h is not enough.
Only the core header files are in asss.h, and you will need to manually include any others.
This may also be true if you are using a custom interface.

== Why does my module keep crashing when a player leaves the zone? ==

You may be saving the player pointer somewhere, and then are trying to access it after the player leaves.
This does not work because the pointer becomes invalid when the player leaves.
Your module is informed when this happens by the CB_NEWPLAYER callback.

[[Category:Module]]
[[Category:Guides]]

Module General Faq

2011-01-20T13:59:52Z

Hakaku:

== I want to put in more modules, how do I do this? ==

'''For C modules:'''

To add modules to a zone, to be loaded on startup, edit your <tt>conf/modules.conf</tt> file, and add a new line containing <tt>filename:modulename</tt>. The <tt>filename</tt> part must be the name of an <tt>.so</tt> or <tt>.dll</tt> file in the zone's <tt>bin</tt> directory.

Or you can dynamically load the module in-game by using <tt>?insmod filename:modulename</tt>. You can use ?help insmod for more info.

'''For Python modules:'''

Mostly the same thing, except you must append the line <tt><py> modulename</tt> in modules.conf or type <tt>?insmod <py> modulename</tt> in-game. The <tt>modulename</tt> should be the name of a <tt>.py</tt> file in your zone's <tt>bin</tt> directory.

== I added a custom module, why aren't the commands working? ==
You can add new commands to the group files found in conf/groupdef.dir. Prefix cmd_ to the command to allow users to send the command publicly and privcmd_ for team and private targets.

[[Category: Module]]
[[Category: FAQ]]

Fg wz Module

2011-01-20T13:54:51Z

Hakaku: Changing category

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:Module]]

Search Phrases

2010-05-29T02:47:21Z

Hakaku: Undo revision 6125 by Jstone626 (Talk)

Top 1000 search phrases for the year 2006. Feel free to use this list to create new pages that may target specific words, to help people find the information they need. They are sorted by search count, then by who knows what.

* ASSS Wiki
# asss
# continuum hacks
# big asss
# priitk
# twcore
# asss wiki
# continuum wine
# priit kasesalu
# snrrrubspace
# mervbot
# asss subspace
# spawn cfg
# continuum hack
# asss commands
# wine continuum
# spawn.cfg
# pump that asss
# winetools-0.9jo-iii.tar.gz
# subspace asss
# spawn.cfg download
# download spawn.cfg
# subspace hacks
# round asss
# asss traffic
# smod commands
# smong
# sk spawn cfg
# subspace continuum hacks
# asss continuum
# asss.com
# ip flooders
# metal gear ctf
# logicbot
# proxy randomizer
# subspace wiki
# hacks for continuum
# mervbot tutorial
# a small subspace server
# powerbot
# minegoboom wiki
# logicbot subspace
# small asss
# continuum on wine
# vie subspace
# cebot
# nip spawn cfg
# sony infantry hacks
# asss command
# continuum asss
# continuum subspace hacks
# subspace continuum hack
# continuum lvl file.format
# catid subspace
# wiki minegoboom
# cfg spawn
# client connection request from billing server ignored
# mine go boom
# minegoboom
# macid randomizer
# ekted
# continuum wiki
# mr ekted
# asss tutorial
# subspace mod commands
# continuum 0.39
# smod wiki
# mine go boom wiki
# a.s.s.s
# zc321
# chatnet asss
# subspace powerbot
# winetools-0.9jo-iii.tar.gz download
# pretty asss
# python unload module
# subspace proxy
# wine color depth
# www.shanky.com
# continuum ban bypass
# free asss
# win-deps
# bm2 file
# continuum encryption
# priitk kazaa
# subspace ports
# python unload
# subspace commands
# mervbot download
# super asss
# subspace hack
# catid
# download winetools-0.9jo-iii.tar.gz
# asss setup
# www.asss
# www.asss.com
# lvz file
# asss userguide
# minegoboom.com
# confess321
# udp game protocol
# invalid login packet continuum
# www.big asss.com
# smod spawning weapons
# continuum ports
# bang commands continuum
# subspace continuum ports
# all that asss
# asss subspace server
# subspace sysop commands
# continuum game wine
# continuum 0.38 hacks
# ssdownloads
# naodw29
# asss wiki minegoboom
# asss server
# twcore help
# windows time time_t problem seconds milliseconds needed
# setting up a asss zone
# python timers
# catid cat02e@fsu.edu
# twbot
# subspace ban
# 2v2 asss mervbot
# cfg de spawn
# asss source
# crash.cfg
# ip flooder
# continuum subspace ce
# continuum 0.38
# 2v2 bot asss
# big asss.com
# game protocol
# mervbot help
# lvz extension
# Ã‚Â´Ã‚Â´priitk
# wine minegoboom
# inurl server.ini
# asss setup and commands
# asss com
# catid subbill
# hacking subspace continuum
# www. asss. com
# continuum 0.38 web installer
# ie7
# sk|spawn.cfg download
# subspace continuum protocol
# asss server download
# download mervbot
# unknown packet type 36 subbill
# mgb wiki
# asss python modules
# continuum linux wine
# sage386
# continuum subspace troubleshooting
# continuum proxy
# wiki asss
# subspace bans
# asss chatnet
# continuum wine wiki
# subspace bang
# subspace billing server
# best asss
# run winecfg
# tallfont.bm2
# asss source code
# forums.minegoboom
# www.all asss.com
# priit kasealu
# wikipedia minegoboom
# download spawn.cfg
# asss ban command
# chatnut asss
# python unload module dll
# clit continuum lvz ini tool
# metalgearctf
# new subspace continuum hacks 2006
# continuum unban
# venn diagram
# continuum in wine
# wiki viagra
# bm2 format
# soccer settings
# asss permit only
# asss trafic
# sscentral.sscuservers
# mediawiki lost sysop password
# win-deps download
# bm2 extension
# pump this asss
# sk|spawn cfg
# how to hack subspace
# extension bm2
# continuum bots
# clit map editor
# snrrrubspace source
# continuum is wiki
# continuum hacking
# asss pwd
# mybot.dll
# weapon commands for smod
# ssdbz
# how do i open a .bm2 file
# chatbot wiki
# all about asss
# free spawn.cfg download
# how to crash asss
# twcore?
# asss subspace allow older versions
# tinyurl infantry hacks
# host subspace
# asss subgame
# mgb asss wiki
# where european play subspace
# counter-strike spawn.cfg
# subspace continuum moderator commands
# subspace cheating
# subspace or continuum network ban machine id
# asss modules
# subspace continuum firewall port
# svs port asss
# continuum twister hack
# asss chat
# fastbombing subspace
# infantry hack cheat
# mikethenose
# .rgn file editor
# that asss
# priitk skype
# infantry ip banned sony
# clit subspace
# hacking subspace
# smod cfg file
# cfg of spawn
# minegoboom linux
# changing continuum machine id
# asss listing
# brickspan
# subspace continuum player pictures
# asss password
# subspace continuum hack cheat editor
# how to login as sysop on continuum
# python profiler howto
# how can i bypass a banned game server?
# .bm2 what program?
# ce cheat subspace
# getprivateprofilestring tutorial
# wine asss
# bang for subspace
# continuum misc spawn
# mp564 hotmail
# pro-x bombing
# asss subspace port
# .bm2 extension
# empbomb
# 2v2 settings asss
# continuum level/lvz tool
# subgame zone permission
# continuum subspace ce hacks
# yes.asss
# wormhole animation
# continuum with wine
# counter strike unban hack or cheat or program or crack
# beginners.subspace
# how to hack subspace servers
# subspace continuum server asss
# download sk|spawn.cfg counter strike
# subspace troubleshooting
# continuum wine patch
# smong java chat subspace
# asss mirror
# subspace asss modules
# asss on linux
# continuum game client about
# www.asss.
# continuum .38 ship rotator
# subspace game
# sk spawn cfg download
# hpra
# winecfg drives tab
# yarekim
# infantry sony cheating
# warnet wikipedia
# subspace biller setup
# .lvl files
# ce subspace continuum cheats
# subbill
# lvz zlib
# talk server configuration
# subspace hack downloads
# subspace server
# machine id randomizer
# bypass proxy server.cfg python client
# continuum router crashes
# unbanned from subspace continuum
# what is bm2 file
# shawnbot subspace
# ipblock.txt
# evade ban subspace
# twcore bot
# dilbert.slopeout.com
# continuum subspace router
# subspace continuum firewall
# mediawiki lock
# cheating in continuum subspace
# asss.yi
# subspace asss installer
# spawn.cpp
# hostname ban
# subspace twister 3
# continuum cheat hacks
# asss is asss
# chatnet protocol asss
# priit kasesalu skype
# sony infantry online hacks
# subgame permissions
# a.s.s.s.
# smong asss
# continuum subspace server setting
# using a premade dynamic link library .dll c
# continuum billing server
# mervbot functions
# wiki
# subspace lvl format
# mervbot wiki
# subspace continuum ce
# metal gear ctf hacking
# subspace server setup
# how to setup a wiki server
# mervbot spawns
# twister subspace
# pokeword game password
# continuum lvz tool
# http packets lagger by one bot
# subspace protocol
# hockey zone server ip
# subgame cfg files
# kustom eagle radar protocol
# wine set colordepth
# unload module in python
# hack sony infantry
# subspace hyperspace game screenshot
# talk bak
# tutorial for 2 player rampage
# .www.shanky.com
# duel continuum clients
# change lvl warp to arena
# subspace continuum proxy
# subspace arena settings
# enna jameson
# the best asss
# thruster prize
# python timer example
# continuum subspace encryption
# sound wa2
# asss sysop
# soccer howto
# wine colordepth
# asss setup server
# continuum unban machine id
# explode1.bm2
# 1ststrike zone
# cpp .get .set struct -perl
# bypass netban on game
# subspace continuum linux
# aswz subspace
# writing modules in c
# continuum twister 3
# logicbot continuum
# asss include
# download asss 1.4.3
# catid mervbot
# continuum firewall subspace
# subspace akai
# subspace making plugins
# asss a lot
# asss command list
# minegoboom wikipedia
# continuum pr1
# catid mervbot ssihosting
# subspace directory server
# create asss
# hack for continuum
# asss encryption
# flood crash.cfg counter strike
# pthreads dev c
# asss.asss
# continuum spawn
# blast radius calculator
# subspace hack ce
# d1st0rt
# convert .rgn files
# asss encryption continuum
# asss programming
# asss initial ship settings
# twcore bots
# devcpp change makefile name
# asss subgame server
# subspacehq
# change machine id to unban
# subspace twister hack
# asss.yi.org
# continuum ball area spawn
# asss user guide
# asss!!
# cfg to asss
# downloading ssme for subspace continuum
# subspace continuum proxy setting
# continuum protocol subspace
# continuum linux wiki
# continuum mod commands
# wiki 17th parallel
# jericho24.
# byte asss
# bongs
# subspace unknown packet type
# subspace junklv
# halo pc mods server password hacking
# asss installation
# spinning subspace logo
# www asss
# wikipedia asss
# asss setting up staff
# download sk server cfg
# lvz file format continuum
# chatnut
# asss cheat sheet
# ban continuum name ip
# server.ini
# subspace continuum hack download
# writing module python
# running continuum under wine wiki minegoboom
# pthreads devcpp
# mervbot .src file
# asss ban
# sscx
# infantry commands smod
# subspace twister
# how to change machine id continuum
# mervbot plugin tutorial
# mine go boom shanky
# continuum hack cheat
# warp c python module
# catid.ssihosting.com
# continuum modified .bm2
# asss .com
# lvl file
# subspace server password
# bullet level doors
# site wiki.minegoboom.com asss
# similar to putfile
# winecfg depth
# asss website
# lvz scripting
# asss 1.3
# how to remove continuum netban
# subspace continuum crash
# default sysop wiki password
# releaseinterface com
# shawnbot
# safezone.png
# sscu super ships
# subspace biller delete user
# rgn format
# asss and more asss
# bypass a banned game server
# how to evade bans counter strike source
# nip spawn config
# mystic kingdom subspace
# lvz continuum
# sk | mohammed <spawn> config free
# subspace billing servers
# infantry sony hacks
# editing lvl files
# ssci gundam wing
# continuum 0.39pr2
# asss download
# spawns cfg
# big huge asss.com
# subspace bot
# continuum lvz scripting
# continuum subspace proxy
# cheating subspace
# subgame packet types
# trench wars continuum resolution limit
# subspace lvz tutorial
# how to apply wine res patch
# conter strike cdq
# asss region
# asss server commands banning
# continuum level ini tool
# format rgn
# how to open bm2 file
# subspace continuum 0.39
# sk spawn config download
# requested name doesn t exist name client
# mervbot catid
# machine id local_machine
# subspace bot setup
# mystic kingdom mods
# wine continuum minegoboom
# grelminar
# asss elim command
# cebot subspace
# spawn settings
# subspace bot level file format
# chaos sscx private arena
# nip|spawn.cfg download
# ssc hyperspace
# hack continuum
# top-left corner of png file
# dj silk.com
# the continuum executable
# mervbot plugin
# continuum subspace game ip port firewall
# how to evade trench wars
# continuum 0.38 exe
# subgame protocol continuum
# asss faq
# lvl map
# asss kick command
# more asss
# subspace opensource
# subspace directory server port udp
# elvl
# continuum encrypt
# forums minegoboom
# dat asss
# subspace commands for sysop
# subspace.net
# clit for continuum
# continuum multiplayer space
# trench wars dev server address
# how to setup a wiki
# how to hack subspace continuum
# continuum - custom zones
# subspace history
# mervbot homepage
# wiki.minegoboom
# ssme map editor
# mm_load
# asss bouncing bullet setting
# mervbot sendprivate to self
# monotone firewall proxy settings
# subspace ship sets
# mine go boom wiki continuum
# mybot download
# subspace continuum cfg
# elvl format
# continuum linux
# hacks for subspace
# ping commads
# bypass continuum netban
# bang system hacks subspace
# 8 bit graphics wine
# dll plugin tutorial mervbot
# empburst
# subspace source
# sscentral.sscuservers.net
# discretion
# allinurl user.bak -www -
# continuum subspace halo
# continuum explode1
# continuum asss sysop command
# sscu starwars realm
# sony infantry hacks unbanned
# winetools 0.9 .deb download
# selecttime timer
# subspace hacking
# .lvz file
# asss vip .com
# subspace hacks unban
# set_timer python
# subspace asss server tutorial
# continuum subspace proxy setting
# rgn file convert .map
# twcore enigma what is
# clit continuum
# bots for sony infantry hacks
# asss yi
# girls that have asss.com
# asss\
# download sscc metal gear ctf
# continuum subspace tricks
# continuum .38 hacks
# nip cfg
# host a subspace continuum server
# subspace continuum socks5 proxy
# reading lvz format
# continuum 0.39 game hacks
# continuum asss chat messages
# big asss.com
# asss ship settings
# continuum bak client
# trench wars bots
# winetools-0.9jo-iii
# bot unknown packet
# hack ip flooders
# scoring subbill
# crash.cfg download
# wiki help contents
# asss tutorial continuum
# crash.cfg downlo
# winetools-0.9jo-iii.tar.gz ubuntu
# continuum port
# continuum clit
# asss a small subspace server
# lvz tutorial
# subspace minegoboom continuum
# http//www3.to/asss
# continuum bomb shrapnel
# subspace rabbit map
# vip asss
# .bm2 format
# aswz infantry
# wiki map
# subspace twister download
# continuum ?setlevel lvz file
# subspace continuum .38
# subspace continuum ip port
# ssme subspace
# powerbot subspace
# asss protocol
# lvz format
# asss connecting to catid biller
# smod command
# sscc metal gear ctf
# explode2 subspace
# infantry hacks server banned
# priitk@
# ip change unban
# ufo wiki
# smong subspace
# subspace zones
# warp dll continuum catid
# wine continuum ubuntu source
# subspace how to set up zone like hyperspace
# libwin free download
# subspace biller commands
# prizeweight
# subgame wiki
# open bm2 file
# voice lagger new version
# spawn cfg sk
# rgn file format
# source code voice lagger
# mervbot cmpstart
# cplusplus tutorial
# asss homepage
# subspace nat router
# user.bak
# a module in c is
# mervbot tutorial help
# setup asss server
# run continuum wine
# continuum subspace hacks cheats
# bar
# subgame server.cfg
# new phrases yet to be sorted
# continuum/subspace lost password
# bypass ssc ban
# bypassing bans on continuum
# how to get around continuum ban subspace
# continuum subspace server
# subspace continuum hyperspace
# subspace server.cfg
# mysql_database_setup
# how to run a game under wine
# pthread.dll python
# infantry ban evade
# python module add timer
# smod #define
# subspace continuum bots hacks
# cont id subspace
# continuum evade ban
# continuum unknown packet type 36
# ubuntu wine bit depth
# wine linux color depth
# bot continuum
# how to hack sony infantry game
# downlaod spawns cfg
# ping subspace protocol
# .rgn map file
# subspace bots
# continuum 0.39 prerelease 3
# continuum smod commands
# kazaa priitk
# catid subspace continuum mervbot
# wine color depth linux
# subspace continuum source code
# ssci it wiki
# subspace server set up
# howto continuum server
# how to hack on subspace
# setting timer in c tutorial
# openprocess errors
# local_machine/software/d1
# remove mybot-f
# sscanf [a-za-z] tutorial
# port 4990
# catid.mervbot
# crash.cfg
# hacks for continuum 0.38
# subspace bot programming
# asss server commands
# asss staff commands
# run wine in 8 bit
# infantry free server
# asss configuration
# en.wiki.org
# subspace zone files
# setup an asss hosting
# asss chat source
# wiki go boom
# asss load module command
# mervbot startup
# digitization.org
# continuum asss help
# wine continuum patch file to patch
# how bang works c
# blahertech
# continuum server.cfg
# ssn assasin
# settimer example with callback function in c
# cont32 patch
# subspace server.cfg trenchwars
# wine sound hardware acceleration emulation
# pokeword full game download
# subspace adding sounds with lvz
# continuum subspace asss
# continuum font file name
# .www.asss
# converting bm2 to bmp
# asss zones
# bm2 files
# subspace bouncefactor
# bang subspace commands
# minegoboom continuum linux
# testtube continuum
# priitk@
# continuum libwine
# subspace extra tiles wiki
# subspace continuum proxy server
# continuum wine .deb
# asss wiki arena config
# ssn omega fire
# subspace biller server
# lvl editor download
# subspace machine id
# subspace continuum name hack
# subspace 0.39 hacks
# subspace arena setup
# how to open .bm2
# lvz
# getfile putfile commands
# subspace commands asss
# trench wars bot core
# bypassing netban
# how to bypass continuum ban
# unknown packet type 22 subbill
# continuum nat router problems
# programming continuum bots in c
# ssc netop subspace
# 4814012 java
# ship s guns second life
# asss xxx
# billing ip server subspace
# inanchor trace router
# fork my asss
# sk spawn.cfg
# deathcount
# 8 bit colour wine
# sniper voice lagger download
# random stars background
# asss subspace server wiki
# asss its asss
# how to evade bans infantry
# continuum game packets
# minegoboom wine
# seemines
# packetloss udp gaming
# large asss
# proxy servers for continuum 0.38
# dcme continuum
# hacks subspace
# asss documentation
# continuum 39
# smod list of commands
# unban from continuum
# asss subspace wiki
# server.cfg subspace spawn
# ssme editor
# subspace game client
# proxy subspace
# function mm_
# category map for wiki
# subspace zone is red
# infantry free servers
# continuum subspace twister
# wiki chatbot
# zelda motw
# priit kasesalu wiki
# how to get unbanned from subspace
# www.cplusplus.com doc tutorial.zip
# twcore twzone
# continuum hyperspace zone ip
# asss ccc
# asss subspace for linux client
# asteroid tileset
# python repeating timer
# asss chatnet protocol
# subspace zone lit
# mervbot getprivateprofilestring
# subspace bot dll
# subspace client discretion
# how to bypass netban subspace
# murphy talk conf settings
# pthread dev-c
# tinfo is
# continuum biller
# asss allow ship
# catid inside subspace
# 16 pixels by 16 pixels bitmap images
# asss subspace\continuum for linux
# continuum asss command
# how to set up twcore
# the following are all files in continuum s \graphics directory which ... hlthbar.bm2 - this is the image that will appear over your health bar on the top of ...
# subspace wa2 converter
# asss subspace for linux
# how to open a bm2 file
# subspace private trench zone server
# wiki subspace
# continuum subspace getting around ban
# unban evade infantry
# undoc.h downlaod
# bypass netban continuum
# writing python modules
# make modules modules-install
# subspace continuum mapmaking program
# twister hack continuum
# editing wa2 files continuum
# what is a lagger
# <anim period>
# php display time 1/100th
# loading modules for asss
# download sscc continuum 0.38
# netban counter-strike
# asssÃ¢â‚¬â„¢
# continuum 0.39 ports
# http www asss xxx
# dev-c load create dll source code
# continuum level
# subspace continuum smod commands list
# hack sscc desert storm
# twcore modules
# metalgear ctf staff
# mervbot - tutorial
# continuum unban code
# spawn.cfg nip
# subspace clients
# chris sscx
# continuum twister hacks download
# subspace directory port router
# asss checks
# download twcore
# bm2 file extension
# svs settings
# wine color depth xorg
# bypassing subspace ban
# continuum level tool
# subspace server.ini file
# invalid login packet received
# asss plug
# subspace killing spree messages list
# installing pthreads dev-cpp
# change computer machine id hack
# asss is as
# how open extension bm2
# wine emulate 8 bit depth
# subspace ban hack
# zelda servers for subspace continuum
# web installer subspace
# region format wiki
# chatnet protocol
# download online sscc metal gear ctf
# setting wine color depth
# converting .bm2 extension
# obscene.txt download
# tutorial.rar pass
# asss addword
# netban id id data continuum
# bouncing bombs
# station infantry free
# subspace mapcreator
# winecfg alsa
# printf align right c tutorial
# unban hack
# continuum directx
# smod bullet time slow down
# asss s
# tcp ping wiki
# asss show
# smod maps
# wine 8bit colors
# dowload nip player cfg
# wiki sscc
# winetools-0.9
# asss .set to .conf
# trenchwars cfg
# powerballzone asss
# subspace map editor ssme
# continuum 0.38 zip
# continuum in linux
# winecfg serial advanced settings
# continuum unban hack
# continuum server subspace
# asss packets
# color depth continuum wine
# continuum tricks
# bot powerbot
# battlefieldzone
# problems running games under wine
# asss zone configuration
# subspace asss server
# devcpp pthread.dll
# vie subspace creator
# red asss
# writing a python module
# udp game
# activateappshutdowntime
# asss configuring staff
# installing new modules python
# ssi continuum server
# bm2 extensions
# machine id wiki
# sysop continuum logging in
# spawn.cfg file
# thinkcspy pdb
# winecfg color depth
# how-to-patch-wine
# asss zone
# create a launcher to run wine
# halo ctf continuum
# proxys socks5 100ms
# continuum ban
# 25 days gettickcount windows
# continuum lvz ini tool
# ssihosting.com
# tinfo wiki continuum
# mr. ekted
# ssc subspace zone server hosting
# 0.39pr2
# subspace continuum memory locations
# wiki vxv
# sony infantry source code
# adding powers to one arena asss
# confclean linux
# subspace asss download
# bang machineid
# halo udp packet flooding
# starbot
# machine id subspace
# subspace continuum wa2 converter
# continuum mystic kingdom flag map
# asss locate person
# running continuum in linux
# phrases spawn
# patching wine source
# obscene.txt
# subspace linux server
# reading into struct
# getting unbanned from infantry
# ce continuum subspace
# openprocess failed
# subspace aswz
# hyperspace game wiki
# accessing global pointer from a timerfunc
# asss ccc servers
# dyndns server configuration
# argyle wiki
# uneven file permissions
# mines go boom
# continuum .lvz
# minegoboom asss
# spawn .cfg
# arena subspace commands
# .bm2 file hack
# subspace continuum dll
# bots for subspace
# c string to char wiki .com
# smong.
# how can i ban machineid
# subspace continuum download 0.38
# string to char cpp
# dusted map
# asss can t connect to myself
# ssme continuum
# subbill.ini
# run continuum in ubuntu
# crash.cfg counter strike
# bypass local prox server ip search
# hacked continuum subspace

[[Category: Wiki]]

Sius

2010-05-26T22:44:59Z

Hakaku: +cat

'''Sius''' is a SubSpace [[TCP Billing Protocol|TCP]] [[Biller]] created by Hakaku and written in C#. The biller is designed to be stable, reliable, and configurable. For bug reports, suggestions, and questions, refer to [http://forums.minegoboom.com/viewtopic.php?t=8691 this forum thread]. To download it directly, please [http://forums.minegoboom.com/download.php?id=2362 click here].

;Features
* Player authentication
* Password encryption and salting
* Configurable limits (such as chats, messages, zones, players)
* Chat support
* Banner support
* Squad support
* Message support
* Logging
* Support for ASSS 1.4.x and higher

;Supported Commands
* ''Messaging:'' ?message, ?messages, ?chat
* ''Squad'': ?squad, ?squadcreate, ?squadjoin, ?squadowner, ?squadlist, ?squadkick, ?squadgrant, ?squadleave, ?squaddissolve, ?squadpassword
* ''Biller:'' ?buptime, ?btime, ?bversion, ?bzones (?zones), ?bzone
* ''Other:'' ?find, ?password, ?userid

[[Category: Biller]]
[[Category: Servers]]

Sius

2010-05-26T22:36:45Z

Hakaku:

TCP Billing FAQ

2010-05-24T23:04:58Z

Hakaku: /* Are there any TCP billers available for public download? */ +sius

== What's so special about TCP billers? ==
TCP billers use a new simpler protocol compared to the original UDP billers. See [[TCP Billing Protocol]] for more details.

== Can I use subgame with a TCP biller? ==
No, currently only ASSS can connect to a TCP biller. It is possible to use proxy to convert between the UDP and TCP protocols to allow subgame.

== Why is there no ability for the billing server to shutdown/restart a server? ==
The ability of the billing servers to shutdown a zone server is a relic from the old system. The biller is no longer considered an administrative and control server, but simply a validation system used mainly to control bans and passwords for player names.

== Are there any TCP billers available for public download? ==
Yes, but only unfinished ones.

* Two different versions of [[POCoB]] written by [[User:Smong|Smong]] are available at http://toktok.sscentral.com/ss-pocob.php.
* [[SkyBill]] written by [[User:Doc flabby|Doc Flabby]].
* [[UBill]] written by [http://braddavis.info BDwinsAlt] is available at http://forums.minegoboom.com/viewtopic.php?t=7543.
* [[Sius]] written by Hakaku is available at http://forums.minegoboom.com/viewtopic.php?t=8691.


== Are there things I should be wary about when using the protocol? ==
Like any protocol, you will need to implement the [[TCP Billing Protocol]] with caution. The following applies mainly to those who plan on creating billers that implement it:

* For starters, the protocol makes extensive use of player identification numbers rather than names. This can be a nuisance when requiring the player's name for communication between, for example, different zones and databases. Try to effectively find one or multiple solutions to store the player id along with their name for quick and efficient retrieval later on.

* The colon (:) is used extensively in the TCP Protocol. Be wary of zone names, player names, passwords, and messages among others containing them. You will likely want to reject those zones and players from connecting, but there is no need from blocking extra colons in the final parameter. This includes namely messages. If you intend on separating the parameters into an array of some sort, make sure to join the extra parameters together (do not forget to re-add a colon), otherwise player messages will be accidentally cut off (e.g. ''CHAT:0:2:0:And then he said''':''' "what are you staring at?"'' - The final parameter is the entire section underlined.).

* Be careful about implementing "unlimited" of a certain feature. Although theoretically possible, biller hosts should still be allowed to control the limits, otherwise a mischievous player could attempt to exhaust the memory and space limits of the server and or database.

* When using and storing player passwords, make sure to hash them to prevent player names and passwords from being easily stolen should your database ever be compromised. The popular MD5 cryptographic function is no longer recommended, instead, you will want to look up the safety and reliability of [http://en.wikipedia.org/wiki/Cryptographic_hash_function#Cryptographic_hash_algorithms other hash algorithms] such as SHA-512, RIPEMD, or WHIRLPOOL for example. Appending random salts to each password will greatly increase the odds that each password is unique, and it will ultimately make it more difficult and timely to crack (Do not use a straight-forward formula for generating the salt, e.g. ''password+username''. If this formula is known, then you have ultimately gained no more protection than the password alone).

* ''CHA'''TT'''XT'' has a double t in it.

* Always test the features you add and log the events and errors that occur. Even seemingly minor bugs could cause the biller disconnect a zone or crash.

[[Category: FAQ]]
[[Category: Protocol]]

Sius

2010-05-24T23:03:06Z

Hakaku:

'''Sius''' is a SubSpace [[TCP Billing Protocol|TCP]] [[Biller]] created by Hakaku and written in C# for the Windows operating system. The biller is designed to be stable, reliable, and configurable. For bug reports, suggestions, and questions, refer to [http://forums.minegoboom.com/viewtopic.php?t=8691 this forum thread]. To download it directly, please [http://forums.minegoboom.com/download.php?id=2362 click here].

;Features
* Player authentication
* Password encryption and salting
* Configurable limits (such as chats, messages, zones, players)
* Chat support
* Banner support
* Squad support
* Message support
* Logging
* Support for ASSS 1.4.x and higher

;Supported Commands
* ''Messaging:'' ?message, ?messages, ?chat
* ''Squad'': ?squad, ?squadcreate, ?squadjoin, ?squadowner, ?squadlist, ?squadkick, ?squadgrant, ?squadleave, ?squaddissolve
* ''Biller:'' ?buptime, ?btime, ?bversion, ?bzones (?zones), ?bzone
* ''Other:'' ?find, ?password, ?userid

Sius

2010-05-24T23:02:17Z

Hakaku: Sius

'''Sius''' is a SubSpace [[TCP Billing Protocol|TCP]] [[Biller]] created by Hakaku and written in C# for the Windows operating system. The biller is designed to be stable, reliable, and configurable. For bug reports, suggestions, and questions, refer to [http://forums.minegoboom.com/viewtopic.php?t=8691 this forum thread]. To download it directly, please [http://forums.minegoboom.com/download.php?id=2362 click here].

;Features
* Password encryption and salting
* Configurable limits (such as chats, messages, zones, players)
* Chat support
* Banner support
* Squad support
* Message support
* Logging
* Support for ASSS 1.4.x and higher

;Supported Commands
* ''Messaging:'' ?message, ?messages, ?chat
* ''Squad'': ?squad, ?squadcreate, ?squadjoin, ?squadowner, ?squadlist, ?squadkick, ?squadgrant, ?squadleave, ?squaddissolve
* ''Biller:'' ?buptime, ?btime, ?bversion, ?bzones (?zones), ?bzone
* ''Other:'' ?find, ?password, ?userid

Creating and Testing a Simple Discretion Module in Eclipse

2009-12-15T05:51:26Z

Hakaku: +cat

This tutorial is a '''video''' tutorial describing how anyone can using minGW (and probably g++) and Eclipse to compile a simple module and put get it to run on [[Discretion]]. It assumes you're using Windows (although g++ may work) and you don't have any tools installed. However, you should have already gotten the source code (if not see the [[Obtaining the Discretion Source using Subversion]] tutorial). This tutorial is part of a series of tutorials consisting of the [[Discretion Module Tutorial]].

minGW stands for minimalistic Gnu for Windows. It is an open source complier almost identical to gcc and g++, which are the compilers used for linux, among other things. The compiler produces native Windows exectuables, and best of all it's free! However, its interface isn't the best for the novice user. Thus, we use eclipse to help manage the minGW compiler for us.

Eclipse, is an integrated development environment (IDE) which is also open-source and free. It is basically a program that makes it easier to make other programs. It was originally designed for Java development, but people made plugins to allow C++ development. These extensions are called the CDT (C/C++ Development Tooling). The CDT integrates nicely with minGW so these two make a good match. Discretion's modules come with Eclipse Projects when you get the source so modifications are easy to make. Eclipse is implemented in Java, so in order to use it you need the Java Runtime Environment. The good news is you probably already have this installed. Nonetheless, the tutorial covers downloading it if you don't already have it installed.

==Videos==

This tutorial is divided a few parts:
* [[Media:Disc_mingw.wmv|Obtaining and Testing minGW]]
* [[Media:Disc_jre.wmv|Getting the Java Runtime Environment]] (90% of people can skip this step)
* [[Media:Disc_eclipse.wmv|Downloading Eclipse with CDT]]
* [[Media:Disc_simplemod.wmv|Creating and Testing a Simple Module within Discretion]]
* [[Media:Disc_tricks.wmv|Discretion with Eclipse Tricks and Tips]]

==Links==

minGW: [http://sourceforge.net/project/showfiles.php?group_id=2435 Sourceforge File List]

java runtime environment: [http://java.sun.com/javase/downloads/?intcmp=1281 Downloads]

eclipse: [http://www.eclipse.org/downloads/ Eclipse Downloads]

[http://lazyfoo.net/SDL_tutorials/lesson01/windows/eclipse/index.php Setting up SDL in Eclipse] (steps 1-4)

[[Category:Discretion]]
[[Category:Guides]]

Userguide

2009-11-29T21:48:45Z

Hakaku: fix links

The userguide is a document written by [[grelminar]] which attempts to provide background information regarding ASSS.

Although it has not been updated since April 6, 2006 much of the information has remained the same.

The document is also distributed in each release of ASSS in the /docs/ folder.

=== External Links ===
* [http://mirror.playsubspace.com/asss.yi.org/asss/files/userguide.html Userguide - HTML]
* [http://mirror.playsubspace.com/asss.yi.org/asss/files/userguide.pdf Userguide - PDF]

[[Category: ASSS]]

Search Phrases

2009-11-04T23:51:32Z

Hakaku: Undo revision 6065 by LeilaGrey (Talk)

TCP Billing FAQ

2009-10-18T03:55:36Z

Hakaku: /* Are there things I should be wary about when using the protocol? */

== What's so special about TCP billers? ==
TCP billers use a new simpler protocol compared to the original UDP billers. See [[TCP Billing Protocol]] for more details.

== Can I use subgame with a TCP biller? ==
No, currently only ASSS can connect to a TCP biller. It is possible to use proxy to convert between the UDP and TCP protocols to allow subgame.

== Why is there no ability for the billing server to shutdown/restart a server? ==
The ability of the billing servers to shutdown a zone server is a relic from the old system. The biller is no longer considered an administrative and control server, but simply a validation system used mainly to control bans and passwords for player names.

== Are there any TCP billers available for public download? ==
Yes, but only unfinished ones.

* Two different versions of [[POCoB]] written by [[User:Smong|Smong]] are available at http://toktok.sscentral.com/ss-pocob.php.
* [[SkyBill]] written by [[User:Doc flabby|Doc Flabby]].
* [[UBill]] written by [http://braddavis.info BDwinsAlt] is available at http://forums.minegoboom.com/viewtopic.php?t=7543.


== Are there things I should be wary about when using the protocol? ==
Like any protocol, you will need to implement the [[TCP Billing Protocol]] with caution. The following applies mainly to those who plan on creating billers that implement it:

* For starters, the protocol makes extensive use of player identification numbers rather than names. This can be a nuisance when requiring the player's name for communication between, for example, different zones and databases. Try to effectively find one or multiple solutions to store the player id along with their name for quick and efficient retrieval later on.

* The colon (:) is used extensively in the TCP Protocol. Be wary of zone names, player names, passwords, and messages among others containing them. You will likely want to reject those zones and players from connecting, but there is no need from blocking extra colons in the final parameter. This includes namely messages. If you intend on separating the parameters into an array of some sort, make sure to join the extra parameters together (do not forget to re-add a colon), otherwise player messages will be accidentally cut off (e.g. ''CHAT:0:2:0:And then he said''':''' "what are you staring at?"'' - The final parameter is the entire section underlined.).

* Be careful about implementing "unlimited" of a certain feature. Although theoretically possible, biller hosts should still be allowed to control the limits, otherwise a mischievous player could attempt to exhaust the memory and space limits of the server and or database.

* When using and storing player passwords, make sure to hash them to prevent player names and passwords from being easily stolen should your database ever be compromised. The popular MD5 cryptographic function is no longer recommended, instead, you will want to look up the safety and reliability of [http://en.wikipedia.org/wiki/Cryptographic_hash_function#Cryptographic_hash_algorithms other hash algorithms] such as SHA-512, RIPEMD, or WHIRLPOOL for example. Appending random salts to each password will greatly increase the odds that each password is unique, and it will ultimately make it more difficult and timely to crack (Do not use a straight-forward formula for generating the salt, e.g. ''password+username''. If this formula is known, then you have ultimately gained no more protection than the password alone).

* ''CHA'''TT'''XT'' has a double t in it.

* Always test the features you add and log the events and errors that occur. Even seemingly minor bugs could cause the biller disconnect a zone or crash.

[[Category: FAQ]]
[[Category: Protocol]]

TCP Billing FAQ

2009-10-18T03:41:36Z

Hakaku: /* Are there things I should be wary about when using the protocol? */

== What's so special about TCP billers? ==
TCP billers use a new simpler protocol compared to the original UDP billers. See [[TCP Billing Protocol]] for more details.

== Can I use subgame with a TCP biller? ==
No, currently only ASSS can connect to a TCP biller. It is possible to use proxy to convert between the UDP and TCP protocols to allow subgame.

== Why is there no ability for the billing server to shutdown/restart a server? ==
The ability of the billing servers to shutdown a zone server is a relic from the old system. The biller is no longer considered an administrative and control server, but simply a validation system used mainly to control bans and passwords for player names.

== Are there any TCP billers available for public download? ==
Yes, but only unfinished ones.

* Two different versions of [[POCoB]] written by [[User:Smong|Smong]] are available at http://toktok.sscentral.com/ss-pocob.php.
* [[SkyBill]] written by [[User:Doc flabby|Doc Flabby]].
* [[UBill]] written by [http://braddavis.info BDwinsAlt] is available at http://forums.minegoboom.com/viewtopic.php?t=7543.


== Are there things I should be wary about when using the protocol? ==
Like any protocol, you will need to implement the [[TCP Billing Protocol]] with caution. The following applies mainly to those who plan on creating billers that implement it:

* For starters, the protocol makes extensive use of player identification numbers rather than names. This can be a nuisance when requiring the player's name for communication between, for example, different zones and databases. Try to effectively find one or multiple solutions to store the player id along with their name for quick and efficient retrieval later on.

* The colon (:) is used extensively in the TCP Protocol. Be wary of zone names, player names, passwords, and messages among others containing them. You will likely want to reject those zones and players from connecting, but there is no need from blocking extra colons in the final parameter. This includes namely messages. If you intend on separating the parameters into an array of some sort, make sure to join the extra parameters together (do not forget to readd a colon), otherwise player messages will be accidentally cut off (e.g. ''CHAT:0:2:0:And then he said''':''' "what are you staring at?"'' - The final parameter is the entire section underlined.).

* Be careful about implementing "unlimited" of a certain feature. Although theoretically possible, biller hosts should still be allowed to control the limits, otherwise a mischievous player could attempt to exhaust the memory and space limits of the server and or database.

* When using and storing player passwords, make sure to hash them to prevent player names and passwords from being easily stolen should your database ever be compromised. The popular MD5 cryptographic function is no longer recommended, instead, you will want to look up the safety and reliability of [http://en.wikipedia.org/wiki/Cryptographic_hash_function#Cryptographic_hash_algorithms other hash algorithms] such as SHA-512, RIPEMD, or WHIRLPOOL for example.

* ''CHA'''TT'''XT'' has a double t in it.

* Always test the features you add and log the events and errors that occur. Even seemingly minor bugs could cause the biller disconnect a zone or crash.

[[Category: FAQ]]
[[Category: Protocol]]

TCP Billing FAQ

2009-10-18T03:39:35Z

Hakaku: Adding some notes and precautions

== What's so special about TCP billers? ==
TCP billers use a new simpler protocol compared to the original UDP billers. See [[TCP Billing Protocol]] for more details.

== Can I use subgame with a TCP biller? ==
No, currently only ASSS can connect to a TCP biller. It is possible to use proxy to convert between the UDP and TCP protocols to allow subgame.

== Why is there no ability for the billing server to shutdown/restart a server? ==
The ability of the billing servers to shutdown a zone server is a relic from the old system. The biller is no longer considered an administrative and control server, but simply a validation system used mainly to control bans and passwords for player names.

== Are there any TCP billers available for public download? ==
Yes, but only unfinished ones.

* Two different versions of [[POCoB]] written by [[User:Smong|Smong]] are available at http://toktok.sscentral.com/ss-pocob.php.
* [[SkyBill]] written by [[User:Doc flabby|Doc Flabby]].
* [[UBill]] written by [http://braddavis.info BDwinsAlt] is available at http://forums.minegoboom.com/viewtopic.php?t=7543.


== Are there things I should be wary about when using the protocol? ==
Like any protocol, you will need to implement the [[TCP Billing Protocol]] with caution. The following applies mainly to those who plan on creating billers that implement it:

* For starters, the protocol makes extensive use of player identification numbers rather than names. This can be a nuisance when requiring the player's name for communication between, for example, different zones and databases. Try to effectively find one or multiple solutions to store the player id along with their name for quick and efficient retrieval later on.

* The colon (:) is used extensively in the TCP Protocol. Be wary of zone names, player names, passwords, and messages among others containing them. You will likely want to reject those zones and players from connecting, but there is no need from blocking extra colons in the final parameter. This includes passwords and messages. If you intend on separating the parameters into an array of some sort, make sure to join the extra parameters together (do not forget to readd a colon), otherwise player messages will be accidentally cut off (e.g. ''CHAT:0:2:0:And then he said''':''' "what are you staring at?"'' - The final parameter is the entire section underlined.).

* Be careful about implementing "unlimited" of a certain feature. Although theoretically possible, biller hosts should still be allowed to control the limits, otherwise a mischievous player could attempt to exhaust the memory and space limits of the server and or database.

* When using and storing player passwords, make sure to hash them to prevent player names and passwords from being easily stolen should your database ever be compromised. The popular MD5 cryptographic function is no longer recommended, instead, you will want to look up the safety and reliability of [http://en.wikipedia.org/wiki/Cryptographic_hash_function#Cryptographic_hash_algorithms other hash algorithms] such as SHA-512, RIPEMD, or WHIRLPOOL for example.

* ''CHA'''TT'''XT'' has a double t in it.

* Always test the features you add and log the events and errors that occur. Even seemingly minor bugs could cause the biller disconnect a zone or crash.

[[Category: FAQ]]
[[Category: Protocol]]

UBill

2009-10-18T02:34:26Z

Hakaku:

== UBill 0.2 ==
UBill is a small TCP [[Biller]] created by BDwinsAlt. It is currently in small development. This biller includes BanG and several other features. You can report bugs at http://braddavis.info/help.

A portion of the biller has remained open, so you can create your own commands. All you have to do is edit UBillCmd.java.

== Commands ==
The following commands are supported by UBill:

<blockquote>
------------------------------------------------------------------------------------------------------------------
MSG Commands: ?message, ?messages, ?msgdel 
Misc Commands: ?binfo, ?bnews, ?btime, ?buptime, ?bversion, ?coin, ?man, ?sex 
Other Commands: ?chat, ?password, ?setemail, ?lostpassword, ?8ball, ?find, ?seen, ?bzones 
Squad Commands: ?squad, ?squadjoin, ?squadpassword, ?squadowner, ?squadlist, ?squadkick, ?squadgrant 
Ect. Commands: ?about, ?bstaff, ?levels, ?poetry
------------------------------------------------------------------------------------------------------------------
Note: Syntax differs for some commands. Type ?man <command> for help.
</blockquote>

== Ways to execute this biller ==
(Console) 
java -jar UBill.jar (Must be updated when UBillCmd is updated) 
java UBill (Uses the .class instead of the .jar, does not need to be updated to run UBillCmd) 

(Clicking) 
You can simply double click on the jar file to open it.

== Ways to compile this biller ==
In the terminal: 
1. javac UBill.java 

(The rest is optional if you chose to use the jar file.) 
2. copy all class files into a folder (contents?) [mkdir contents ....then.... cp *.class contents] 
3. jar cvfm UBill.jar ubill.mf -C contents/ . (Copy and paste. Cases, spaces, and periods matter!)

== Using a batch file ==
If you chose not to update a jar each time, create a batch file.

Create a file named compile.bat.
Edit with notepad by copying and pasting:
javac UBill.java

Create a file named run.bat.
Edit with notepad by copying and pasting:
java UBill

== Download UBill ==
You can download UBill at http://forums.minegoboom.com/viewtopic.php?t=7543

[[Category: Biller]]
[[Category: Servers]]

TCP Billing FAQ

2009-09-24T19:12:01Z

Hakaku:

LogicBot

2009-09-04T21:19:27Z

Hakaku:

'''LogicBot++''' is a [[bot]] core created by Admiral Kirk and written in C++, that was designed primarily to record player aliases and provide advanced banning techniques. The latest version, LogicBot2, is open sourced and currently released under the GNU General Public License version 3 (GPLv3).

== Download ==
* [http://www.ssforum.net/index.php?showtopic=23285 LogicBot2]

[[Category: Bots]]

LogicBot

2009-09-04T21:17:27Z

Hakaku: rewritten

'''LogicBot++''' is a [[bot]] core created by Admiral Kirk and written in C++, that was designed primarily to record player aliases and provide advanced banning techniques. The latest version, LogicBot2, is open sourced and currently released licensed under the GNU General Public License version 3 (GPLv3).

== Download ==
* [http://www.ssforum.net/index.php?showtopic=23285 LogicBot2]

[[Category: Bots]]

MERVBot

2009-09-04T20:40:51Z

Hakaku:

MERVBot is an open source bot core written by [[catid]] in C++. It is modular, meaning that you can download user made plugins that will perform a desired action (such as Elim, or Lag Checking).

== Download ==
*[http://www.mervbot.com/files/MERVBot.rar MERVBot 46]
*[http://www.mervbot.com/files/SOS.rar MERVBot 48] (Ported by SOS for .NET languages such as C#)
*A [[MERVBot_script|script for running MERVBot inside linux]].

Here is a rather dubious link to a rar unpacker for those of you that don't like the rar icon ftp://ftp.externet.hu/pub/mirror/sac/pack/unpacker.zip

== Resources ==
*[http://www.mervbot.com/ Homepage]
*[[MERVBot Tutorial]]

[[Category: Bots]]

MERVBot

2009-09-04T20:40:01Z

Hakaku: 'latest' is a misnomer

MERVBot is an open source bot core written by [[catid]] in C++. It is modular, meaning that you can download user made plugins that will perform a desired action (such as Elim, or Lag Checking).

== Download ==
*[http://www.mervbot.com/files/MERVBot.rar MERVBot 46]
*[http://www.mervbot.com/files/MERVBot.rar MERVBot 48] (Ported for .NET languages such as C#)
*A [[MERVBot_script|script for running MERVBot inside linux]].

Here is a rather dubious link to a rar unpacker for those of you that don't like the rar icon ftp://ftp.externet.hu/pub/mirror/sac/pack/unpacker.zip

== Resources ==
*[http://www.mervbot.com/ Homepage]
*[[MERVBot Tutorial]]

[[Category: Bots]]

ChatNet Protocol

2009-08-30T01:36:12Z

Hakaku:

The Simple Chat Protocol is an ASCII (plain text) protocol created by [[grelminar]] for chatting on [[ASSS]]. Being TCP and quite simple allows programmers to create feature rich chat clients quite easily, something that can't be done with the complex standard SubSpace protocol.

== The Protocol ==
The latest version can always be found at http://bitbucket.org/grelminar/asss/src/tip/doc/simple-chat.txt

<pre>
simple chat protocol
version 1.6
grelminar@yahoo.com
--------------------

the protocol is ascii over tcp. each message contains several fields,
the first of which a type field that determines the meaning of the
remaining ones. fields are separated by a colon (':', ascii 58). each
message is terminated by either a CR (ascii 13), a LF (ascii 10) or any
combination of those two.

either side can close the connection at any time. the other side should
respond to this by closing their end of the connection also.

unless otherwise specified, the last field for each message type is
allowed to contain colons.

player names are used to differentiate players. case is insignificant
when comparing player names, but the server is required to use the same
capitalization for all instances of the same player in the same session
(i.e., if someone logs out and logs in again, the case of their name
might change).

the rest of this document will describe the possible message types. if
you recieve an unsupported message type, you should ignore it. in the
following, capital letters generally designate stuff that should be sent
literally, as it is printed here. lowercase letters are descriptions of
fields will be filled in with the relevant data.

login:

client sends:
LOGIN:version:name:password
(the version field contains the protocol version, and also some
information about the client. it should be of the form "1;client
name and version". for example, "1;ccc 1.2, by grelminar".)

server will respond with one of:
LOGINBAD:message
(disconnect)
or
LOGINOK:yourname
(the server/biller can rename clients, so the new name must be
sent back to the client)

entering arenas:

client sends:
GO:name
(use an empty name to mean "first public arena". note that even
if name is empty, the colon is still required.)

server may reply:
INARENA:arenaname:freq
(client should clear its player list when it gets this. freq is
the freq that the client has been assigned. chat clients are
always in spectator mode, and never in ships.)
PLAYER:name:ship:freq
(one line for each player who's in the arena at the time when it
is entered.)

enter/leave notification:

server sends:
ENTERING:name:ship:freq
(when a player enters an arena)
LEAVING:name
(when a player leaves)

ship/freq changes:

client sends:
CHANGEFREQ:freq

server sends:
SHIPFREQCHANGE:name:ship:freq
(ships are numbered from 0 (warbird) to 8 (spectator))

kills:

server sends:
KILL:killername:killedname:bounty:flagscarried

chat (the important part):

client sends:
SEND:PUB:msg
SEND:PUBM:msg
SEND:PRIV:name:msg
(the same message type works for both regular and remove priv msgs)
SEND:FREQ:freq:msg
(freq is the number of the destination freq)
SEND:CHAT:line
(line is either "msg" or "channelnum;msg")
SEND:MOD:msg
SEND:CMD:cmd
SEND:PRIVCMD:name:msg
SEND:SQUAD:squad:msg

server sends:
MSG:ARENA:msg
MSG:CMD:msg
MSG:PUB:name:msg
MSG:PUBM:name:msg
(macroed pub message)
MSG:PRIV:name:msg
MSG:FREQ:name:msg
MSG:CHAT:channelnum:msg
MSG:MOD:name:msg
MSG:SYSOP:msg
MSG:SQUAD:squad:sender:msg

miscellaneous:

client or server can send at any time:
NOOP

this can be used (by the client) to implement a keepalive ping to get
around crappy nat routers, or (by the server) to help time out dead
clients.

document history:

1.6:
added NOOP type.

1.5:
added client name in the version field of LOGIN.
added PUBM message type.

1.4 and before:
detailed history unavailable

# dist: public
</pre>

== See Also ==
* [[:Category:ChatNet Clients|List of ChatNet Clients]]

[[Category: Protocol]]

Trench Wars

2009-08-29T23:24:28Z

Hakaku: +cat

'''SSCU Trench Wars''', an exciting team-based game platform. Trench Wars has become one of the most versatile well known zones in all of Continuum. Primarily created as a team-based flagging game, Trench Wars has evolved into a multi-faceted zone offering over 150 Flagging, Racing, Capture the Flag, Deathmatch, and other specialty sub-arenas. Many of these sub-arenas carry custom shipsets and arena designs downloadable in the game (Events). In addition, Trench Wars has one of the most competitive and versatile Elimination games available, hosted automatically 24 hours a day in two separate arenas (Elim/Baseelim)! If you have yet to download Continuum, click here for the latest version!

Your primary mission in Trench Wars is to help your team in the main public arenas, to capture and hold the flag for points. Point bonuses are given out on an intermittent basis for those who hold the flag, as well as a 200-point bonus per kill if your team carries the flag. Each ship holds a specially designed set of functions, created to promote a balanced and skill oriented flagging match. Many sub-arenas hosted by our Staff members include; Deathmatch style dueling, over 42 different theme maps for Basing and Flagging, several Elimination style games in addition to our 24-hour Elim, specialty Holiday maps, ship specific maps (like Javs or Blind for cloakers), Racing maps with custom racecar ship designs, and Ball games like Hockey or Powerball. Trench Wars developers have also utilized the versatility of Subspace/Continuum, to create some of the most popular sub-games to date! Games like Zombies where the humans have only a short time to make it off the island, or Gravbomber where gravity is your friend and your foe! Each weekend, Trenchers gather and unite with their fellow countrymen in the WW6 battle for global superiority!

Trench Wars also has two very competitive squad based League gaming systems, Trench Wars Leagues (TWL) and the ladder-based Trench Wars Division (TWD). TWL is now starting its tenth season, and continues to be the battlegrounds for the best of the best in Basing, Dueling, and Javelins. Squads compete each weekend during a regular season in order to make their way to the playoffs, for a chance at winning their respective TWL-Cups! TWD is a more versatile league system, where games are played at any time and all squads can compete! All of these games are hosted automatically by the MatchBots, who handle all score reporting, player lagouts, game setup, and referee decisions.

[[Category:Zones]]

ChatNet Protocol

2009-08-28T18:14:16Z

Hakaku: /* The Protocol */ fix link

Creating and Testing a Simple Discretion Module in Eclipse

2009-07-15T23:24:24Z

Hakaku: /* Links */ because it's not obvious to someone who's never used it

User talk:Hakaku

2009-07-14T18:59:24Z

Hakaku: thx

[[User:Mine GO BOOM|Mine GO BOOM]] 20:12, July 12, 2009 (PDT): Very nice job with the ASSS pages.
:Thanks, I didn't think anyone would notice so quickly. - [[User:Hakaku|Hakaku]] 11:59, July 14, 2009 (PDT)

Callbacks

2009-07-14T18:58:41Z

Hakaku: +cat

This page contains a list of callbacks and arguments for functions. I have tried to format them as well as I can in C. Currently, they are listed in alphabetical order of filenames, but that needs to be changed. Correct parameter names are given. In Python, all variables with "inout" after the type need to be returned from the function. In C you can just ignore it.

*'''CB_ARENAACTION'''(Arena *target, int *action): This callback is called whenever the arena is created, changed, destroyed, or configuration files changed. target is the arena being affected, and action is what the arena is doing (AA_*). Gotten from arenaman.h
*'''CB_BALLPICKUP'''(Arena *arena, Player *p, int bid): This callback is called whenever a player picks up a ball. arena is the arena it happened in, p is the player who picked up the ball, and bid is the ID of the ball picked up. Gotten from balls.h
*'''CB_BALLFIRE'''(Arena *arena, Player *p, int bid): Like the CB_BALLPICKUP command, except this is called when the ball is thrown. arena is the arena it happened in, p is the player who picked up the ball, and bid is the ID of the ball. Gotten from balls.h
*'''CB_GOAL'''(Arena *arena, Player *p, int bid, int x, int y): This is called when the ball goes into the goal. arena is the arena it happened in, p is the person who had the ball last, bid is the ID of the ball scored, and x and y is the last position of the ball (PLEASE CONFIRM!). Gotten from balls.h
*'''CB_SET_BANNER'''(Player *p, Banner *banner): This is called when a player sets his/her banner. p is the player (Ship will always be SHIP_SPEC), and banner is the banner that has been set. Gotten from banners.h
*'''CB_CHATMSG'''(Player *p, int type, int sound, Player *target, int freq, const char *text): Called whenever a player sends a message. p is the player, type is the type of message, which is not just zone, arena, freq, or private (see chat.h), target is the target of a private message, freq is the frequency of a team chat message, and of course, text is the message. Gotten from chat.h
*'''CB_REWRITECOMMAND'''(int initial, char *buf, int len): I have no idea what this does, but the file states that "this isn't for general use", so... Gotten from chat.h
*'''CB_GLOBALCONFIGCHANGED'''(void): Called when the global configuration file(s) have been changed. The function does not take any parameters. Gotten from config.h
*'''CB_PLAYERACTION'''(Player *p, int action, Arena *arena): Called when a player does a miscellaneous function, such as enter an arena. p is the player, action is the action (PA_*, see core.h), and arena is the arena being entered/left, depending on what the player is doing. Gotten from core.h
*'''CB_TURFTAG'''(Arena *a, Player *p, int fid, int oldfreq, int newfreq): Called whenever a turf flag is tagged. CB_FLAGONMAP will also run, but this provides more info. a is the arena, p is the player, fid is the flag ID, and old- and newfreq are the old and new frequencies of the flag owners. Gotten from fg_turf.h
*'''CB_WARZONEWIN'''(Arena *a, int freq, int *points): Called to figure out the points rewarded from a won warzone-style game. a is the arena, freq is the winning freq, and points is the points rewarded (PLEASE CONFIRM!), and must be incremented. Gotten from fg_wz.h
*'''CB_FLAGGAIN'''(Arena *a, Player *p, int fid, int how): Called when a player gains a flag. a is the arena, p is the player that got the flags, fid is the ID of the flag(s) gotten (dunno how it works with multiple flags though), and how is how the player got the flags. Gotten from flagcore.h (see that for "how" values)
*'''CB_FLAGLOST'''(Arena *a, Player *p, int fid, int how): The opposite of CB_FLAGGAIN. All parameters are the same, except p is the player that lost the flags. Gotten from flagcore.h
*'''CB_FLAGONMAP'''(Arena *a, int fid, int x, int y, int freq): Called when a flag is placed on the map (dropped, neuted, moved, ect). a is the arena, fid is the flag ID, x and y it the position of the flag, and freq is the frequency of the flags. Gotten from flagcore.h
*'''CB_FLAGRESET'''(Arena *a, int freq, int points): Called when a flag game is reset, including when it is won. a is the arena, freq is the winning frequency (PLEASE CONFIRM!), and points is the points won (PLEASE CONFIRM!). Gotten from flagcore.h
*'''CB_KILL'''(Arena *arena, Player *killer, Player *killed, int bounty, int flags, int inout *pts, int inout *green): Called when a player is killed. arena is the arena, killer is the killer, killed is the killed player, bounty is the bounty displayed in the kill message, flags is the number of flags the killed person was carrying, points is the points the kill is worth, and green is the prize that will be placed after the callback. Gotten from game.h
*'''CB_KILL_POST_NOTIFY''': I guess this is the same as CB_KILL, except it is called AFTER the kill notification is sent. Gotten from game.h
*'''CB_FREQCHANGE'''(Player *p, int newfreq): Called when a player changes frequency. p is the player, and newfreq is the frequency the player is changing to. Gotten from game.h
*'''CB_SHIPCHANGE'''(Player *p, int newship, int newfreq): Called when a player changes ship. p is player, newship is the SHIP_* of the ship, and newfreq is the new frequency. Gotten from game.h
*'''CB_TIMESUP'''(Arena *arena): Called when the game timer is up. arena is the arena. Gotten from game.h
*'''CB_SAFEZONE'''(Player *p, int x, int y, int entering): Called when a player enters or leaves a safe zone. From game.h: "be careful about what you do in here; this runs in the unreliable packet handler thread (for now)." p is the player, x and y is the player's position in pixels, and entering is true if the player is entering. Gotten from game.h
*'''CB_REGION'''(Player *p, Region *rgn, int x, int y, int entering): Called when a player enters/exits an arena. p is the player, rgn is the region, x and y are the player's position, and entering is true if the player is entering. Gotten from game.h
*'''CB_GREEN'''(Player *p, int x, int y, int prize): Called when a player picks up a green. p is the player, x and y is the position of the player (in tiles), and prize is the number of the prize gotten. Gotten from game.h
*'''CB_ATTACH'''(Player *p, Player *to): Called when a player attaches to another player. p is the player attaching and to is the player being attached to. Gotten from game.h
*'''CB_CROWNCHANGE'''(Player *p, int gain, int cause): Called when a player gains/looses a KOTH crown. p is the player, gain is true if the player is gaining the crown, false if losing, and cause is how the player gained/lost the crown. See the file where the callback was gotten from: koth.h
*'''CB_KOTH_START'''(Arena *a, int initial_crowns): Called when a KOTH started. a is the arena, and initial_crowns is the number of players that got crowns (PLEASE CONFIRM!). Gotten from koth.h
*'''CB_KOTH_END'''(Arena *a, int playing, int winners, int points_per_winner): Called when a KOTH game ends. It is called before CB_KOTH_PLAYER_WIN a is the arena, playing is the number of players (PLEASE CONFIRM!), winners number of winners (PLEASE CONFIRM!), and points_per_winner is the number of points awarded to each player. Gotten from koth.h
*'''CB_KOTH_PLAYER_WIN'''(Arena *a, Player *p, int points): Called for each player that won a KOTR game. a is the arena, p is the player, and points is the points won. Gotten from koth.h
*'''CB_KOTH_PLAYER_WIN_END'''(Arena *a): Called after the last CB_KOTH_PLAYER_WIN. a is the arena. Gotten from koth.h
*'''CB_LOGFUNC'''(const char *line): Called when a line is logged. line is the line logged. Gotten from logman.h
*'''CB_MAINLOOP'''(void): I don't know exactly what this does; Here's the comment: "the type of CB_MAINLOOP callbacks". It does not work with python, and really should not be used. Gotten from mainloop.h
*'''CB_CONNINIT'''(struct sockaddr_in *sin, byte *pkt, int len, void *v): I suppose this gets called when a player gets connected. I don't know anything about it, and there is no documentation. Gotten from net.h
*'''CB_INTERVAL_ENDED'''(void): Called when an interval that clears persistent data is triggered. Gotten from persist.h
*'''CB_NEWPLAYER'''(Player *p, int isnew): Called when a player is allocated or deallocated. p is the player, isnew it true if the player is being allocated, false if being deallocated. Gotten from player.h
*'''CB_PLAYERDAMAGE'''(Arena *arena, Player *p, struct S2CWatchDamage *damage, int count): Called when a player takes damage. You need to call AddWatch from I_WATCHDAMAGE before this will take effect (PLEASE CONFIRM!). arena is the arena, p is the player getting hit, and I don't know what damage and count are. Gotten from watchdamage.h
*'''CB_TURFSTEAL'''(Arena *arena, Player *p, int fid): I assume that this is called when a frequency claims a turf-flag (PLEASE CONFIRM!). arena is the arena, p is the player claiming the flag, and fid is the Flag ID. Gotten from turf_reward.h
*'''CB_TURFRECOVER'''(Arena *arena, int fid, int pid, int freq, int dings, int weight, int recovered): "called when a flag is 'recovered'". I don't exactly know the specifics of this... Gotten from turf_reward.h
*'''CB_TURFLOST'''(Arena *arena, int fid, int pid, int freq, int dings, int weight, int recovered): The opposite of CB_TURFRECOVER. Gotten from turf_reward.h
*'''CB_TURFPOSTREWARD'''(Arena *arena, struct TurfArena *ta): Called after players have been prized points. arena is the arena, I don't know what ta is. Gotten from turf_reward.h

If you find a callback not listed here, if you have more notes on a callback, or would like to correct some info, feel free to edit this page (After all, that is what a wiki is for.)

[[Category:ASSS]]

Migration Guide

2009-07-14T18:57:58Z

Hakaku: not sure about the game quirks

This guide will highlight some of the known pitfalls and gotchas when moving from subgame to asss.

You may need to familiarise yourself with [[Module_General_Faq|modules.conf]] to apply some of the fixes.

----

== Settings ==

=== Team:MaxFrequency ===

This setting now behaves as it is written. It is the maximum frequency you can enter. It is not the maximum number of frequencies available. For example setting this to 5 means you can enter 0,1,2,3,4,5.

=== Prize:MinimumVirtual or Why do my flags and balls spawn differently? ===

Flags and balls now have their own spawn settings:
<pre>
SpawnX = 512
SpawnY = 512
SpawnRadius = 20
</pre>

Additionally balls can have multiple spawns as of version 1.4.2:
<pre>
SpawnXN = 512
SpawnYN = 512
SpawnRadiusN = 20
</pre>
Where N is 0,1,2,3.
The numbers correspond to the ball ID. For example if you have 2 balls the ID's will start from 0. Ball 0 will use Spawn...0 and ball 1 will use Spawn...1. You can have up to 8 balls, meaning ball 4 will use Spawn...0 and so on.

== Commands ==

=== Why doesn't ?owner work anymore? ===

This is disabled by default. You need to add the line 'cmd_owner' to conf/groupdef.dir/default.

=== Why doesn't ?objon work anymore? ===

The objects module is not loaded by default. You need to add the line 'objects' to conf/modules.conf.

=== Why doesn't *arena <msg> work anymore? ===

The command has been shortened to ?a <msg>. Additionally ?aa <msg> will anonymise the originator; their name will not be automatically appended to the message.

You can use the sgcompat module to restore this command.

=== Why doesn't *log work anymore? ===

This has been replaced with ?lastlog [<number of lines>] [<filter text>] where [] means an optional parameter.

You can use the sgcompat module to alias this command to *log however the format will not change back to subgame format.

=== Why doesn't ?help <msg> work anymore? ===

For an unknown reason the creator of asss decided to use this command as an online manual for commands and settings. Possibly because many billers used a similar ?man command.

You can change the functionality of the ?help command by loading the notify module. Simply add (or uncomment) the line 'notify' to modules.conf, and put the following in global.conf:

<pre>
[ Help ]
CommandName = man

[ Notify ]
AlertCommand = help,cheater
</pre>

Don't forget to also add 'cmd_cheater' and 'cmd_man' (or other given names) to groupdef.dir/default.

=== Can I add more AlertCommands like ?cheater ? ===

To add AlertCommands such as ?cheater and ?illegal, you will need to load the notify module and make the appropriate changes as explained [[#Why doesn't ?help <msg> work anymore?|above]].

== Game quirks ==

=== I have some LVZ objects controlled by a bot but they don't work anymore ===

The objects module is not loaded by default. You need to add the line 'objects' to conf/modules.conf.

=== Why am I not seeing a greet message when I enter the arena? or Where have the periodic messages gone? ===

The messages module is not loaded by default. You need to add the line 'messages' to conf/modules.conf.

Additionally the PeriodicMessageN settings are bugged in asss. You can download a patch for 1.4.2 from http://toktok.sscentral.com/dump/messages.c.patch.txt.

=== What's up with the goal message? ===

If you are seeing 'SCORE: Warbirds:xx Javelins:xx' and would rather see Team0,Team1 then read on.

The points_goal module was coded for a specific purpose and did not implement all the things from subgame. You can download a patch from http://toktok.sscentral.com/dump/points_goal.c-scoremsg.patch.txt.

=== I want to keep my bots but they aren't behaving, is there any hope? ===

There is a module called sgcompat that creates command aliases from subgame commands to asss commands. To use the module add 'funky:sgcompat' to conf/modules.conf. Additionally, your bot may get silenced for sending multiple consecutive messages and commands. To fix this, add the line 'unlimitedchat' to the appropriate group the bot is in (e.g. groupdef.dir/mod). Lastly, bots that need to toggle objects may flood your screen with red error messages indicating an invalid toggle. You can fix this by adding either 'broadcastbot' or 'broadcastany' to the bot's respective group.

[[Category:ASSS]]
[[Category:Guides]]

List of Custom Modules

2009-07-12T18:17:17Z

Hakaku: incomplete, but makes for a quick & easy reference to existing modules and examples

Provided below is a list of custom modules and projects for ASSS which have been released for public use. Although several of them were designed for previous versions of ASSS, most of them still work when recompiled against the most recent release of ASSS, often with with little to no modifications necessary.

For help on how to compile C modules, see [[Installing New Modules]] for more details.

= Open Source =
== ASSS 1.4.4 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=8384 Colors] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=8425 Command List] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=7469 fm_shiplimits] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=8095 Fuschia] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?p=78585#78585 Goal Callback example]
* [http://forums.minegoboom.com/viewtopic.php?t=8092 hs_util] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?p=79093#79093 Jackpot Music Lock] - Hakaku
* [http://forums.minegoboom.com/viewtopic.php?t=7560 King of the Hill] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=8431 Sql Query] - Cheese
* [http://forums.minegoboom.com/viewtopic.php?t=7757 Staff Message of the Day] - JoWie

; Python
* [http://forums.minegoboom.com/viewtopic.php?t=8171 Automated Team Picking] - D1st0rt
* [http://forums.minegoboom.com/viewtopic.php?t=3975 Bounty Rabbit] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=8402 Optparser] - D1st0rt

; Projects
* [http://forums.minegoboom.com/viewtopic.php?t=8382 Hosted Game Core] - D1st0rt
* [http://forums.minegoboom.com/viewtopic.php?p=80108#80108 Paintball Modules] - Bak

== ASSS 1.4.2 - 1.4.3 ==
; C
* [http://toktok.sscentral.com/ss-asss.html Autobrick] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6567 Chatmenu] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4882 Controllable doors] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3758 CTF flag game] - Smong
* [http://toktok.sscentral.com/ss-asss.html Digithud] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6187 hs_ufo] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=7059 Initial] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=7614 Jpcounter2] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7609 Per ship lvz] - JoWie
* [http://forums.minegoboom.com/viewtopic.php?t=6984 radarzoom - per ship MapZoomFactor] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7399 Region Triggers] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7563 Spree] - Smong, JoWie
* [http://forums.minegoboom.com/viewtopic.php?t=7507 Swappable game interface] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7608 Thor Level] - JoWie
* [http://forums.minegoboom.com/viewtopic.php?t=7055 Vehicles] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=7462 Zombie] - Animate Dreams

; Python
* [http://forums.minegoboom.com/viewtopic.php?t=3564 Autoprize] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7506 Craters] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6117 Dodgeball] - xsp0rtsfanx, Chambahs
* [http://forums.minegoboom.com/viewtopic.php?t=7614 fg_wz_spawns] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7454 Goal Spree] - BDwinsAlt
* [http://forums.minegoboom.com/viewtopic.php?t=7361 Kill lvz] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7391 Noise upon entering] - BDwinsAlt
* [http://forums.minegoboom.com/viewtopic.php?t=7724 ShipFX] - Jonus
* [http://toktok.sscentral.com/ss-asss.html Soundenter2] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7718 Staff Application] - Jonus
* [http://forums.minegoboom.com/viewtopic.php?t=7732 SubSpace Casino] - Jonus
* [http://toktok.sscentral.com/ss-asss.html Suggest] - Smong

; Projects
* [http://forums.minegoboom.com/viewtopic.php?t=5629 CNC Generals] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=6035 Direct ASSS Web Stats] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=7409 Hyperspace Core Modules] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=5629 Unreal Tournament] - Chambahs, Smong, others

== ASSS 1.3.6 - 1.4.0 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=4776 Cmdalias] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=4817 Drone] - Bak
* [http://toktok.sscentral.com/ss-asss.html Nomysql] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4159 Poll] - Bak
* [http://forums.minegoboom.com/viewtopic.php?t=4279 Prize Management System] - 50% Packetloss
* [http://forums.minegoboom.com/viewtopic.php?t=4777 Togglespec] - Bak

; Python
* [http://toktok.sscentral.com/ss-asss.html Autowarp3] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4865 Elim] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=4262 Guessing game] - Chambahs, Smong
* [http://toktok.sscentral.com/ss-asss.html Note] - Smong
* [http://toktok.sscentral.com/ss-asss.html To do] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=5426 Turretwar] - D1st0rt
* [http://toktok.sscentral.com/ss-asss.html Wipeout] - Smong

== ASSS 1.2.x - 1.3.5 ==
; C
* [http://forums.minegoboom.com/viewtopic.php?t=3690 Afk] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3306 hs_antiwarp] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=3305 hs_listnewb] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=3229 %macro expander] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3004 Moveto] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3228 Race] - Smong, i88gerbils

; Python
* [http://forums.minegoboom.com/viewtopic.php?t=3974 Blackjack] - Chambahs

== ASSS 0.9.x - 1.1.x ==
; C
* [http://toktok.sscentral.com/ss-asss.html autowarp2] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=3162 Flag neuter] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=1888 No anti in centre] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=2467 Putmap] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=3163 Simple region tools] - Dr Brain
* [http://forums.minegoboom.com/viewtopic.php?t=801 Teamkill] - Smong
* [http://forums.minegoboom.com/viewtopic.php?t=801 Triggers] - Smong
* [http://toktok.sscentral.com/ss-asss.html Warper] - Smong

= Close Source =
; C
* [http://forums.minegoboom.com/viewtopic.php?t=6757 Bot with Damage] - Smong
* [http://toktok.sscentral.com/ss-asss.html Cheat Detection] - Smong

[[Category:Custom Modules]]

Installing New Modules with Eclipse

2009-07-11T20:15:13Z

Hakaku: /* Step 3 */

Creating your first module can often be an intimidating process when you don't exactly know what you're doing. The following tutorial will guide you step by step on how to create an ASSS module using the [http://www.eclipse.org/cdt/ CDT] (C/C++ Development Tools) Integrated Development Environment (IDE) for [http://www.eclipse.org/ Eclipse] on the Windows operating system. Users already familiar with [[Installing New Modules#With Dev C++|Dev-C++]] will note several similarities between the two. You can obtain the most recent version of Eclipse CDT [http://www.eclipse.org/downloads/packages/eclipse-ide-cc-developers/galileor here]. (Note: you may also need to install MinGW, which can be downloaded from [http://sourceforge.net/projects/mingw/files/ here]. Choose ''Automated MinGW Installer'', then download ''MinGW-5.1.4.exe'')

== Step 1 ==
Once you have completely unpacked Eclipse, start up the program, and specify a workspace (a popup should automatically ask you for this). You can safely ignore the initial welcome screen and go straight to creating your first project. To do that, go to ''File'' > ''New'' > ''C Project''.

[[Image:Eclipse_01.png|300px]]

A new screen should now appear. Give your project a name, and then click the ''Next'' button.

[[Image:Eclipse_02.png|300px]]

Deselect the ''Debug'' option, it isn't necessary for the following tutorial, and then press ''Finish''.

[[Image:Eclipse_03.png]]

Assuming everything went ok, your project should look something like this:

[[Image:Eclipse_04.png|300px]]

== Step 2 ==
[[Image:Eclipse_05.png|300px]]

The next step will be to create new files to add in your project. To do this, go into ''File'' > ''New'' > ''Source File''. A new window will now show up. From here, you can now give your source (.c) file a name. Press the ''Finish'' button once you're done.

[[Image:Eclipse_06.png|300px]]

If you don't already have a module in mind, copy and paste the following (as used throughout the rest of this tutorial):
<pre>
#include "asss.h"

//Interfaces
local Imodman *mm;
local Icmdman *cmd;
local Ichat *chat;

local void Shout(const char *command, const char *params, Player *p, const Target *target)
{
chat->SendMessage(arena, "Hamburger!");
}

EXPORT int MM_hamburger(int action, Imodman *mm_, Arena *arena)
{
if (action == MM_LOAD)
{
mm = mm_;

chat = mm->GetInterface(I_CHAT, arena);
cmd = mm->GetInterface(I_CMDMAN, arena);

if (!chat || !cmd)
return MM_FAIL;
else
{
cmd->AddCommand("hamburger", ShoutHamburger, ALLARENAS, NONE);

return MM_OK;
}
}
else if (action == MM_UNLOAD)
{
cmd->RemoveCommand("hamburger", ShoutHamburger, ALLARENAS);

mm->ReleaseInterface(cmd);
mm->ReleaseInterface(chat);

return MM_OK;
}
return MM_OK;
}
</pre>
[[Image:Eclipse_07.png|300px]]

You'll also need to add the file ''util.c'' into your project, which you can find in your ASSS folder under ''/src/main''. Either open util.c using an external program, or through Eclipse via ''File'' > ''Open File...'' Repeating the same process as from the beginning of Step 2, copy and paste the source of util.c into your project (keep the name the same).

[[Image:Eclipse_08.png|300px]]

== Step 3 ==
Even though you've created a project and added files, you're still not ready to build your module. You should notice that your main source file will be full of question marks; don't panic, this simply means that Eclipse isn't configured properly yet, and doesn't know what to do with your source. To configure your project, click on ''Project'' > ''Properties'' in the menu.

[[Image:Eclipse_09.png]]

Navigate your way under ''C/C++ Build'' > ''Settings''. And choose the tab named ''Tool Settings''.

[[Image:Eclipse_10.png]]

The first thing you want to do is add your include paths. As shown below, add the following directories under ''GCC C Compiler'' > ''Directories''.
* asss/src
* asss/src/include
* asss/windeps

[[Image:Eclipse_11.png|300px]]

Without changing the page, navigate to ''MingGW C Linker'' > ''Miscellaneous''. You'll want to add the pthread.dll/pthreadGC2.dll file (actual name may vary), generally located in ASSS' ''/windeps'' folder.

[[Image:Eclipse_12.png|300px]]

Now click on the tab named ''Build Artifact''. The first thing you want to do is make sure you're creating a Shared Library file, and ''not'' an executable. Then, make sure that the artifact extension is '''dll'''. The latter two can be avoided if you already selected Shared Library at the beginning of [[#Step 1]]. You can also change the name of the name of your output file, and specify a prefix (though not necessary).

[[Image:Eclipse_13.png|300px]]

== Step 4 ==
Once you're all done, click on ''Apply'', then ''OK''. Your project should automatically build itself afterwards, but you can build and rebuild it at any time by clicking on the hammer button, or by going into ''Project'' > ''Build All''.

Eclipse may then give you several warnings and errors if you made a mistake somewhere. Revise the list of warnings and errors to see if there isn't something that you've forgotten (such as adding an #include), or a simple typo.

[[Image:Eclipse_14.png|300px]]

If you used the above example provided in [[#Step 2|Step 2]], you should obtain the following 3 errors and 1 warning:
<pre>
`NONE' undeclared (first use in this function) hamburger.c /hamburger line 26
`ShoutHamburger' undeclared (first use in this function) hamburger.c /hamburger line 26
`arena' undeclared (first use in this function) hamburger.c /hamburger line 10
'Shout' defined but not used hamburger.c /hamburger line 9
</pre>
These can be corrected by replacing ''NONE'' with ''NULL'', ''local void Shout(...'' with ''local void ShoutHamburger(...'', and ''arena'' with ''p''. As you familiarize yourself with both the C language and ASSS, it will be easier for you to understand your mistakes, and know how to fix them.

If everything is compiled properly, Eclipse should now say "Build complete for project X".

[[Image:Eclipse_15.png|300px]]

== Step 5 ==
Now that you've created your first module, you'll want to give it a test run in-game. Locate your dll file in your workspace under the folder ''projectname/Release''. Copy it, and paste in in your ASSS folder under ''/bin''. Now open the file named ''modules.conf'' located in your ''/conf'' folder. Scroll to the bottom of the page, and add a new line with the file name and entry point name (i.e. EXPORT int MM_'''hamburger''') as follows:
* FILENAME:MODULENAME (e.g. hamburger:hamburger)

Make sure to save the file. If you've made a mistake in the name, then ASSS will close after you start it, as soon as it tries to load the non-existant or faulty module. Otherwise, you're now officially ready to give your module a spin!

In the hamburger example, you will also have to make one extra modification. Before starting ASSS, move over to the folder ''/conf/groupdef.dir''. Open up the file named ''Default'' (any text editor will do), and add the line ''cmd_hamburger''. This will now add the command ?hamburger. To test it, start up ASSS, and type ?hamburger in-game.

[[Category:Module]]
[[Category:Guides]]

Installing New Modules with Eclipse

2009-07-11T20:14:32Z

Hakaku:

Creating your first module can often be an intimidating process when you don't exactly know what you're doing. The following tutorial will guide you step by step on how to create an ASSS module using the [http://www.eclipse.org/cdt/ CDT] (C/C++ Development Tools) Integrated Development Environment (IDE) for [http://www.eclipse.org/ Eclipse] on the Windows operating system. Users already familiar with [[Installing New Modules#With Dev C++|Dev-C++]] will note several similarities between the two. You can obtain the most recent version of Eclipse CDT [http://www.eclipse.org/downloads/packages/eclipse-ide-cc-developers/galileor here]. (Note: you may also need to install MinGW, which can be downloaded from [http://sourceforge.net/projects/mingw/files/ here]. Choose ''Automated MinGW Installer'', then download ''MinGW-5.1.4.exe'')

== Step 1 ==
Once you have completely unpacked Eclipse, start up the program, and specify a workspace (a popup should automatically ask you for this). You can safely ignore the initial welcome screen and go straight to creating your first project. To do that, go to ''File'' > ''New'' > ''C Project''.

[[Image:Eclipse_01.png|300px]]

A new screen should now appear. Give your project a name, and then click the ''Next'' button.

[[Image:Eclipse_02.png|300px]]

Deselect the ''Debug'' option, it isn't necessary for the following tutorial, and then press ''Finish''.

[[Image:Eclipse_03.png]]

Assuming everything went ok, your project should look something like this:

[[Image:Eclipse_04.png|300px]]

== Step 2 ==
[[Image:Eclipse_05.png|300px]]

The next step will be to create new files to add in your project. To do this, go into ''File'' > ''New'' > ''Source File''. A new window will now show up. From here, you can now give your source (.c) file a name. Press the ''Finish'' button once you're done.

[[Image:Eclipse_06.png|300px]]

If you don't already have a module in mind, copy and paste the following (as used throughout the rest of this tutorial):
<pre>
#include "asss.h"

//Interfaces
local Imodman *mm;
local Icmdman *cmd;
local Ichat *chat;

local void Shout(const char *command, const char *params, Player *p, const Target *target)
{
chat->SendMessage(arena, "Hamburger!");
}

EXPORT int MM_hamburger(int action, Imodman *mm_, Arena *arena)
{
if (action == MM_LOAD)
{
mm = mm_;

chat = mm->GetInterface(I_CHAT, arena);
cmd = mm->GetInterface(I_CMDMAN, arena);

if (!chat || !cmd)
return MM_FAIL;
else
{
cmd->AddCommand("hamburger", ShoutHamburger, ALLARENAS, NONE);

return MM_OK;
}
}
else if (action == MM_UNLOAD)
{
cmd->RemoveCommand("hamburger", ShoutHamburger, ALLARENAS);

mm->ReleaseInterface(cmd);
mm->ReleaseInterface(chat);

return MM_OK;
}
return MM_OK;
}
</pre>
[[Image:Eclipse_07.png|300px]]

You'll also need to add the file ''util.c'' into your project, which you can find in your ASSS folder under ''/src/main''. Either open util.c using an external program, or through Eclipse via ''File'' > ''Open File...'' Repeating the same process as from the beginning of Step 2, copy and paste the source of util.c into your project (keep the name the same).

[[Image:Eclipse_08.png|300px]]

== Step 3 ==
Even though you've created a project and added files, you're still not ready to build your module. You should notice that your main source file will be full of question marks; don't panic, this simply means that Eclipse isn't configured properly yet, and doesn't know what to do with your source. To configure your project, click on ''Project'' > ''Properties'' in the menu.

[[Image:Eclipse_09.png]]

Navigate your way under ''C/C++ Build'' > ''Settings''. And choose the tab named ''Tool Settings''.

[[Image:Eclipse_10.png]]

The first thing you want to do is add your include paths. As shown below, add the following directories under ''GCC C Compiler'' > ''Directories''.
* asss/src
* asss/src/include
* asss/windeps

[[Image:Eclipse_11.png|300px]]

Without changing the page, navigate to ''MingGW C Linker'' > ''Miscellaneous''. You'll want to add the pthread.dll/pthreadGC2.dll file (actual name may vary), generally located in ASSS' ''/windeps'' folder.

[[Image:Eclipse_12.png|300px]]

Now click on the tab named ''Build Artifact''. The first thing you want to do is make sure you're creating a Shared Library file, and ''not'' an executable. Then, make sure that the artifact extension is '''dll'''. The last two steps can be avoided if you already selected Shared Library at the beginning of [[#Step 1]]. You can also change the name of the name of your output file, and specify a prefix (though not necessary).

[[Image:Eclipse_13.png|300px]]

== Step 4 ==
Once you're all done, click on ''Apply'', then ''OK''. Your project should automatically build itself afterwards, but you can build and rebuild it at any time by clicking on the hammer button, or by going into ''Project'' > ''Build All''.

Eclipse may then give you several warnings and errors if you made a mistake somewhere. Revise the list of warnings and errors to see if there isn't something that you've forgotten (such as adding an #include), or a simple typo.

[[Image:Eclipse_14.png|300px]]

If you used the above example provided in [[#Step 2|Step 2]], you should obtain the following 3 errors and 1 warning:
<pre>
`NONE' undeclared (first use in this function) hamburger.c /hamburger line 26
`ShoutHamburger' undeclared (first use in this function) hamburger.c /hamburger line 26
`arena' undeclared (first use in this function) hamburger.c /hamburger line 10
'Shout' defined but not used hamburger.c /hamburger line 9
</pre>
These can be corrected by replacing ''NONE'' with ''NULL'', ''local void Shout(...'' with ''local void ShoutHamburger(...'', and ''arena'' with ''p''. As you familiarize yourself with both the C language and ASSS, it will be easier for you to understand your mistakes, and know how to fix them.

If everything is compiled properly, Eclipse should now say "Build complete for project X".

[[Image:Eclipse_15.png|300px]]

== Step 5 ==
Now that you've created your first module, you'll want to give it a test run in-game. Locate your dll file in your workspace under the folder ''projectname/Release''. Copy it, and paste in in your ASSS folder under ''/bin''. Now open the file named ''modules.conf'' located in your ''/conf'' folder. Scroll to the bottom of the page, and add a new line with the file name and entry point name (i.e. EXPORT int MM_'''hamburger''') as follows:
* FILENAME:MODULENAME (e.g. hamburger:hamburger)

Make sure to save the file. If you've made a mistake in the name, then ASSS will close after you start it, as soon as it tries to load the non-existant or faulty module. Otherwise, you're now officially ready to give your module a spin!

In the hamburger example, you will also have to make one extra modification. Before starting ASSS, move over to the folder ''/conf/groupdef.dir''. Open up the file named ''Default'' (any text editor will do), and add the line ''cmd_hamburger''. This will now add the command ?hamburger. To test it, start up ASSS, and type ?hamburger in-game.

[[Category:Module]]
[[Category:Guides]]

Installing New Modules with Eclipse

2009-07-11T15:48:58Z

Hakaku: sidenote

Creating your first module can often be an intimidating process when you don't exactly know what you're doing. The following tutorial will guide you step by step on how to create an ASSS module using the [http://www.eclipse.org/cdt/ CDT] (C/C++ Development Tools) Integrated Development Environment (IDE) for [http://www.eclipse.org/ Eclipse] on the Windows operating system. Users already familiar with [[Installing New Modules#With Dev C++|Dev-C++]] will note several similarities between the two. You can obtain the most recent version of Eclipse CDT [http://www.eclipse.org/downloads/packages/eclipse-ide-cc-developers/galileor here]. (Note: you may also need to install MinGW, which can be downloaded from [http://sourceforge.net/projects/mingw/files/ here]. Choose ''Automated MinGW Installer'', then download ''MinGW-5.1.4.exe'')

== Step 1 ==
Once you have completely unpacked Eclipse, start up the program, and specify a workspace (a popup should automatically ask you for this). You can safely ignore the initial welcome screen and go straight to creating your first project. To do that, go to ''File'' > ''New'' > ''C Project''.

[[Image:Eclipse_01.png|300px]]

A new screen should now appear. Give your project a name, and then click the ''Next'' button.

[[Image:Eclipse_02.png|300px]]

Deselect the ''Debug'' option, it isn't necessary for the following tutorial, and then press ''Finish''.

[[Image:Eclipse_03.png]]

Assuming everything went ok, your project should look something like this:

[[Image:Eclipse_04.png|300px]]

== Step 2 ==
[[Image:Eclipse_05.png|300px]]

The next step will be to create new files to add in your project. To do this, go into ''File'' > ''New'' > ''Source File''. A new window will now show up. From here, you can now give your source (.c) file a name. Press the ''Finish'' button once you're done.

[[Image:Eclipse_06.png|300px]]

If you don't already have a module in mind, copy and paste the following (as used throughout the rest of this tutorial):
<pre>
#include "asss.h"

//Interfaces
local Imodman *mm;
local Icmdman *cmd;
local Ichat *chat;

local void Shout(const char *command, const char *params, Player *p, const Target *target)
{
chat->SendMessage(arena, "Hamburger!");
}

EXPORT int MM_hamburger(int action, Imodman *mm_, Arena *arena)
{
if (action == MM_LOAD)
{
mm = mm_;

chat = mm->GetInterface(I_CHAT, arena);
cmd = mm->GetInterface(I_CMDMAN, arena);

if (!chat || !cmd)
return MM_FAIL;
else
{
cmd->AddCommand("hamburger", ShoutHamburger, ALLARENAS, NONE);

return MM_OK;
}
}
else if (action == MM_UNLOAD)
{
cmd->RemoveCommand("hamburger", ShoutHamburger, ALLARENAS);

mm->ReleaseInterface(cmd);
mm->ReleaseInterface(chat);

return MM_OK;
}
return MM_OK;
}
</pre>
[[Image:Eclipse_07.png|300px]]

You'll also need to add the file ''util.c'' into your project, which you can find in your ASSS folder under ''/src/main''. Either open util.c using an external program, or through Eclipse via ''File'' > ''Open File...'' Repeating the same process as from the beginning of Step 2, copy and paste the source of util.c into your project (keep the name the same).

[[Image:Eclipse_08.png|300px]]

== Step 3 ==
Even though you've created a project and added files, you're still not ready to build your module. You should notice that your main source file will be full of question marks; don't panic, this simply means that Eclipse isn't configured properly yet, and doesn't know what to do with your source. To configure your project, click on ''Project'' > ''Properties'' in the menu.

[[Image:Eclipse_09.png]]

Navigate your way under ''C/C++ Build'' > ''Settings''. And choose the tab named ''Tool Settings''.

[[Image:Eclipse_10.png]]

The first thing you want to do is add your include paths. As shown below, add the following directories under ''GCC C Compiler'' > ''Directories''.
* asss/src
* asss/src/include
* asss/windeps

[[Image:Eclipse_11.png|300px]]

Without changing the page, navigate to ''MingGW C Linker'' > ''Miscellaneous''. You'll want to add the pthread.dll/pthreadGC2.dll file (actual name may vary), generally located in ASSS' ''/windeps'' folder.

[[Image:Eclipse_12.png|300px]]

Now click on the tab named ''Build Artifact''. The first thing you want to do is make sure you're creating a Shared Library file, and ''not'' an executable. Then, make sure that the artifact extension is '''dll'''. You can also change the name of the name of your output file, and specify a prefix (though not necessary).

[[Image:Eclipse_13.png|300px]]

== Step 4 ==
Once you're all done, click on ''Apply'', then ''OK''. Your project should automatically build itself afterwards, but you can build and rebuild it at any time by clicking on the hammer button, or by going into ''Project'' > ''Build All''.

Eclipse may then give you several warnings and errors if you made a mistake somewhere. Revise the list of warnings and errors to see if there isn't something that you've forgotten (such as adding an #include), or a simple typo.

[[Image:Eclipse_14.png|300px]]

If you used the above example provided in [[#Step 2|Step 2]], you should obtain the following 3 errors and 1 warning:
<pre>
`NONE' undeclared (first use in this function) hamburger.c /hamburger line 26
`ShoutHamburger' undeclared (first use in this function) hamburger.c /hamburger line 26
`arena' undeclared (first use in this function) hamburger.c /hamburger line 10
'Shout' defined but not used hamburger.c /hamburger line 9
</pre>
These can be corrected by replacing ''NONE'' with ''NULL'', ''local void Shout(...'' with ''local void ShoutHamburger(...'', and ''arena'' with ''p''. As you familiarize yourself with both the C language and ASSS, it will be easier for you to understand your mistakes, and know how to fix them.

If everything is compiled properly, Eclipse should now say "Build complete for project X".

[[Image:Eclipse_15.png|300px]]

== Step 5 ==
Now that you've created your first module, you'll want to give it a test run in-game. Locate your dll file in your workspace under the folder ''projectname/Release''. Copy it, and paste in in your ASSS folder under ''/bin''. Now open the file named ''modules.conf'' located in your ''/conf'' folder. Scroll to the bottom of the page, and add a new line with the file name and entry point name (i.e. EXPORT int MM_'''hamburger''') as follows:
* FILENAME:MODULENAME (e.g. hamburger:hamburger)

Make sure to save the file. If you've made a mistake in the name, then ASSS will close after you start it, as soon as it tries to load the non-existant or faulty module. Otherwise, you're now officially ready to give your module a spin!

In the hamburger example, you will also have to make one extra modification. Before starting ASSS, move over to the folder ''/conf/groupdef.dir''. Open up the file named ''Default'' (any text editor will do), and add the line ''cmd_hamburger''. This will now add the command ?hamburger. To test it, start up ASSS, and type ?hamburger in-game.

[[Category:Module]]
[[Category:Guides]]

Installing New Modules with Eclipse

2009-07-11T04:12:26Z

Hakaku:

Creating your first module can often be an intimidating process when you don't exactly know what you're doing. The following tutorial will guide you step by step on how to create an ASSS module using the [http://www.eclipse.org/cdt/ CDT] (C/C++ Development Tools) Integrated Development Environment (IDE) for [http://www.eclipse.org/ Eclipse] on the Windows operating system. Users already familiar with [[Installing New Modules#With Dev C++|Dev-C++]] will note several similarities between the two. You can obtain the most recent version of Eclipse CDT [http://www.eclipse.org/downloads/packages/eclipse-ide-cc-developers/galileor here].

== Step 1 ==
Once you have completely unpacked Eclipse, start up the program, and specify a workspace (a popup should automatically ask you for this). You can safely ignore the initial welcome screen and go straight to creating your first project. To do that, go to ''File'' > ''New'' > ''C Project''.

[[Image:Eclipse_01.png|300px]]

A new screen should now appear. Give your project a name, and then click the ''Next'' button.

[[Image:Eclipse_02.png|300px]]

Deselect the ''Debug'' option, it isn't necessary for the following tutorial, and then press ''Finish''.

[[Image:Eclipse_03.png]]

Assuming everything went ok, your project should look something like this:

[[Image:Eclipse_04.png|300px]]

== Step 2 ==
[[Image:Eclipse_05.png|300px]]

The next step will be to create new files to add in your project. To do this, go into ''File'' > ''New'' > ''Source File''. A new window will now show up. From here, you can now give your source (.c) file a name. Press the ''Finish'' button once you're done.

[[Image:Eclipse_06.png|300px]]

If you don't already have a module in mind, copy and paste the following (as used throughout the rest of this tutorial):
<pre>
#include "asss.h"

//Interfaces
local Imodman *mm;
local Icmdman *cmd;
local Ichat *chat;

local void Shout(const char *command, const char *params, Player *p, const Target *target)
{
chat->SendMessage(arena, "Hamburger!");
}

EXPORT int MM_hamburger(int action, Imodman *mm_, Arena *arena)
{
if (action == MM_LOAD)
{
mm = mm_;

chat = mm->GetInterface(I_CHAT, arena);
cmd = mm->GetInterface(I_CMDMAN, arena);

if (!chat || !cmd)
return MM_FAIL;
else
{
cmd->AddCommand("hamburger", ShoutHamburger, ALLARENAS, NONE);

return MM_OK;
}
}
else if (action == MM_UNLOAD)
{
cmd->RemoveCommand("hamburger", ShoutHamburger, ALLARENAS);

mm->ReleaseInterface(cmd);
mm->ReleaseInterface(chat);

return MM_OK;
}
return MM_OK;
}
</pre>
[[Image:Eclipse_07.png|300px]]

You'll also need to add the file ''util.c'' into your project, which you can find in your ASSS folder under ''/src/main''. Either open util.c using an external program, or through Eclipse via ''File'' > ''Open File...'' Repeating the same process as from the beginning of Step 2, copy and paste the source of util.c into your project (keep the name the same).

[[Image:Eclipse_08.png|300px]]

== Step 3 ==
Even though you've created a project and added files, you're still not ready to build your module. You should notice that your main source file will be full of question marks; don't panic, this simply means that Eclipse isn't configured properly yet, and doesn't know what to do with your source. To configure your project, click on ''Project'' > ''Properties'' in the menu.

[[Image:Eclipse_09.png]]

Navigate your way under ''C/C++ Build'' > ''Settings''. And choose the tab named ''Tool Settings''.

[[Image:Eclipse_10.png]]

The first thing you want to do is add your include paths. As shown below, add the following directories under ''GCC C Compiler'' > ''Directories''.
* asss/src
* asss/src/include
* asss/windeps

[[Image:Eclipse_11.png|300px]]

Without changing the page, navigate to ''MingGW C Linker'' > ''Miscellaneous''. You'll want to add the pthread.dll/pthreadGC2.dll file (actual name may vary), generally located in ASSS' ''/windeps'' folder.

[[Image:Eclipse_12.png|300px]]

Now click on the tab named ''Build Artifact''. The first thing you want to do is make sure you're creating a Shared Library file, and ''not'' an executable. Then, make sure that the artifact extension is '''dll'''. You can also change the name of the name of your output file, and specify a prefix (though not necessary).

[[Image:Eclipse_13.png|300px]]

== Step 4 ==
Once you're all done, click on ''Apply'', then ''OK''. Your project should automatically build itself afterwards, but you can build and rebuild it at any time by clicking on the hammer button, or by going into ''Project'' > ''Build All''.

Eclipse may then give you several warnings and errors if you made a mistake somewhere. Revise the list of warnings and errors to see if there isn't something that you've forgotten (such as adding an #include), or a simple typo.

[[Image:Eclipse_14.png|300px]]

If you used the above example provided in [[#Step 2|Step 2]], you should obtain the following 3 errors and 1 warning:
<pre>
`NONE' undeclared (first use in this function) hamburger.c /hamburger line 26
`ShoutHamburger' undeclared (first use in this function) hamburger.c /hamburger line 26
`arena' undeclared (first use in this function) hamburger.c /hamburger line 10
'Shout' defined but not used hamburger.c /hamburger line 9
</pre>
These can be corrected by replacing ''NONE'' with ''NULL'', ''local void Shout(...'' with ''local void ShoutHamburger(...'', and ''arena'' with ''p''. As you familiarize yourself with both the C language and ASSS, it will be easier for you to understand your mistakes, and know how to fix them.

If everything is compiled properly, Eclipse should now say "Build complete for project X".

[[Image:Eclipse_15.png|300px]]

== Step 5 ==
Now that you've created your first module, you'll want to give it a test run in-game. Locate your dll file in your workspace under the folder ''projectname/Release''. Copy it, and paste in in your ASSS folder under ''/bin''. Now open the file named ''modules.conf'' located in your ''/conf'' folder. Scroll to the bottom of the page, and add a new line with the file name and entry point name (i.e. EXPORT int MM_'''hamburger''') as follows:
* FILENAME:MODULENAME (e.g. hamburger:hamburger)

Make sure to save the file. If you've made a mistake in the name, then ASSS will close after you start it, as soon as it tries to load the non-existant or faulty module. Otherwise, you're now officially ready to give your module a spin!

In the hamburger example, you will also have to make one extra modification. Before starting ASSS, move over to the folder ''/conf/groupdef.dir''. Open up the file named ''Default'' (any text editor will do), and add the line ''cmd_hamburger''. This will now add the command ?hamburger. To test it, start up ASSS, and type ?hamburger in-game.

[[Category:Module]]
[[Category:Guides]]

Installing New Modules with Eclipse

2009-07-11T03:43:13Z

Hakaku: oops

Creating your first module can often be an intimidating process when you don't exactly know what you're doing. The following tutorial will guide you step by step on how to create an ASSS module using the [http://www.eclipse.org/cdt/ CDT] (C/C++ Development Tools) Integrated Development Environment (IDE) for [http://www.eclipse.org/ Eclipse] on the Windows operating system. Users already familiar with [[Installing New Modules#With Dev C++|Dev-C++]] will note several similarities between the two. You can obtain the most recent version of Eclipse CDT [http://www.eclipse.org/downloads/packages/eclipse-ide-cc-developers/galileor here].

== Step 1 ==
Once you have completely unpacked Eclipse, start up the program, and specify a workspace (a popup should automatically ask you for this). You can safely ignore the initial welcome screen and go straight to creating your first project. To do that, go to ''File'' > ''New'' > ''C Project''.

[[Image:Eclipse_01.png|300px]]

A new screen should now appear. Give your project a name, and then click the ''Next'' button.

[[Image:Eclipse_02.png|300px]]

Deselect the ''Debug'' option, it isn't necessary for the following tutorial, and then press ''Finish''.

[[Image:Eclipse_03.png]]

Assuming everything went ok, your project should look something like this:

[[Image:Eclipse_04.png|300px]]

== Step 2 ==
[[Image:Eclipse_05.png|300px]]

The next step will be to create new files to add in your project. To do this, go into ''File'' > ''New'' > ''Source File''. A new window will now show up. From here, you can now give your source (.c) file a name.

[[Image:Eclipse_06.png|300px]]

If you don't already have a module in mind, copy and paste the following (as used throughout the rest of this tutorial):
<pre>
#include "asss.h"

//Interfaces
local Imodman *mm;
local Icmdman *cmd;
local Ichat *chat;

local void Shout(const char *command, const char *params, Player *p, const Target *target)
{
chat->SendMessage(arena, "Hamburger!");
}

EXPORT int MM_hamburger(int action, Imodman *mm_, Arena *arena)
{
if (action == MM_LOAD)
{
mm = mm_;

chat = mm->GetInterface(I_CHAT, arena);
cmd = mm->GetInterface(I_CMDMAN, arena);

if (!chat || !cmd)
return MM_FAIL;
else
{
cmd->AddCommand("hamburger", ShoutHamburger, ALLARENAS, NONE);

return MM_OK;
}
}
else if (action == MM_UNLOAD)
{
cmd->RemoveCommand("hamburger", ShoutHamburger, ALLARENAS);

mm->ReleaseInterface(cmd);
mm->ReleaseInterface(chat);

return MM_OK;
}
return MM_OK;
}
</pre>
[[Image:Eclipse_07.png|300px]]

You'll also need to add the file ''util.c'' into your project, which you can find in your ASSS folder under ''/src/main''. Either open util.c using an external program, or through Eclipse via ''File'' > ''Open File...'' Repeating the same process as from the beginning of Step 2, copy and paste the source of util.c into your project (keep the name the same).

[[Image:Eclipse_08|300px]]

== Step 3 ==
Even though you've created a project and added files, you're still not ready to build your module. You should notice that your main source file will be full of question marks; don't panic, this simply means that Eclipse isn't configured properly yet, and doesn't know what to do with your source. To configure your project, click on ''Project'' > ''Properties'' in the menu.

[[Image:Eclipse_09.png]]

Navigate your way under ''C/C++ Build'' > ''Settings''. And choose the tab named ''Tool Settings''.

[[Image:Eclipse_10.png]]

The first thing you want to do is add your include paths. As shown below, add the following directories under ''GCC C Compiler'' > ''Directories''.
* asss/src
* asss/src/include
* asss/windeps

[[Image:Eclipse_11.png|300px]]

Without changing the page, navigate to ''MingGW C Linker'' > ''Miscellaneous''. You'll want to add the pthread.dll/pthreadGC2.dll file (actual name may vary), generally located in ASSS' ''/windeps'' folder.

[[Image:Eclipse_12.png|300px]]

Now click on the tab named ''Build Artifact''. The first thing you want to do is make sure you're creating a Shared Library file, and ''not'' an executable. Then, make sure that the artifact extension is '''dll'''. You can also change the name of the name of your output file, and specify a prefix (though not necessary).

[[Image:Eclipse_13.png|300px]]

== Step 4 ==
Once you're all done, click on ''Apply'', then ''OK''. Your project should automatically build itself afterwards, but you can build and rebuild it at any time by clicking on the hammer button, or by going into ''Project'' > ''Build All''.

Eclipse may then give you several warnings and errors if you made a mistake somewhere. Revise the list of warnings and errors to see if there isn't something that you've forgotten (such as adding an #include), or a simple typo.

[[Image:Eclipse_14.png|300px]]

If you used the above example provided in [[#Step 2|Step 2]], you should obtain the following 3 errors and 1 warning:
<pre>
`NONE' undeclared (first use in this function) hamburger.c /hamburger line 26
`ShoutHamburger' undeclared (first use in this function) hamburger.c /hamburger line 26
`arena' undeclared (first use in this function) hamburger.c /hamburger line 10
'Shout' defined but not used hamburger.c /hamburger line 9
</pre>
These can be corrected by replacing ''NONE'' with ''NULL'', ''local void Shout(...'' with ''local void ShoutHamburger(...'', and ''arena'' with ''p''. As you familiarize yourself with both the C language and ASSS, it will be easier for you to understand your mistakes, and know how to fix them.

If everything is compiled properly, Eclipse should now say "Build complete for project X".

[[Image:Eclipse_15.png|300px]]

== Step 5 ==
Now that you've created your first module, you'll want to give it a test run in-game. Locate your dll file in your workspace under the folder ''projectname/Release''. Copy it, and paste in in your ASSS folder under ''/bin''. Now open the file name ''modules.conf'' located in your ''/conf'' folder. Scroll to the bottom of the page, and add a new line with the file name and entry point name (i.e. EXPORT int MM_'''hamburger''') as follows:
* FILENAME:MODULENAME (e.g. hamburger:hamburger)

Make sure to save the file. If you've made a mistake in the name, then ASSS will close after you start it, as soon as it tries to load the non-existant or faulty module. Otherwise, you're now officially ready to give your module a spin!

In the hamburger example, you will also have to make one extra modification. Before starting ASSS, move over to the folder ''/conf/groupdef.dir''. Open up the file named ''Default'' (any text editor will do), and add the line ''cmd_hamburger''. This will now add the command ?hamburger. To test it, start up ASSS, and type ?hamburger in-game.

[[Category:Module]]
[[Category:Guides]]

Installing New Modules

2009-07-11T03:37:57Z

Hakaku:

When you want to add more functionality to your server you can install new custom modules. Differences in server versions often mean something will break in a module, compiling from source can help fix this.

== C modules ==

=== Using Makefile fragments ===
This is probably the easiest way to get a new module compiling under linux. Let's call <tt>*.mk</tt> files "Makefile fragments". All the correct compiler flags and such are supplied for you since the Makefile fragments are in included into the main Makefile.

This example will demonstrate how to create a shared library <tt>example.so</tt> containing two modules <tt>moo</tt> and <tt>lala</tt>. Create a directory for your module as a subdirectory of <tt>src</tt>, the directory containing all the ASSS code.
<pre>
$ cd asss-1.4.3/src
$ mkdir example
</pre>

Place your source code <tt>moo.c</tt> and <tt>lala.c</tt> into this newly created directory. Then create a file called <tt>example.mk</tt> within that directory that looks like this:
<pre>
example_mods = moo lala

$(eval $(call dl_template,example))
</pre>

All <tt>*.mk</tt> files in any subdirectories will be included during compilation. Two fragments come in the <tt>contrib</tt> and <tt>turf</tt> directories of the ASSS package, which you might want to look at as examples.

Now before we can compile the module we need to update the "deps". Make sure you are in the <tt>src</tt> directory.
<pre>
$ cd ..
$ pwd
asss-1.4.3/src
$ make deps
(some output here, some warnings can be safely ignored)
</pre>

Finally we can compile it, this step will automatically install it to the bin directory:
<pre>
$ make
(some output here)
</pre>

The module specifier for the new modules will be <tt>example:moo</tt> and <tt>example:lala</tt>, for use in modules.conf or with ?insmod.

=== Using a custom Makefile ===
Sometimes you might want to create your own Makefile, if you need to use custom compilation options, or a different source file layout. Here is a very basic one (they can get very long).
<pre>
# simple makefile

OUTFILE = somefile.so
MODULES = autoturret.o

CC = gcc -std=gnu99 -pipe
CFLAGS = -s -O2 -Wall

all: ${OUTFILE}

${OUTFILE}: ${MODULES}
${CC} -fPIC -shared -o ${OUTFILE} ${MODULES}

install: ${OUTFILE}
install ${OUTFILE} ../bin/${OUTFILE}

clean:
rm -f ${OUTFILE} ${MODULES}
</pre>
You can change the name of the resulting file with ''OUTFILE'' and add more modules on the ''MODULES'' line. Note: the indentation must be a tab and not a bunch of spaces.

To use a makefile one would type something like this:
<pre>
$ make -f some.mk
$ make -f some.mk install
</pre>
The ''-f'' switch tells make to use ''some.mk'' instead of the default which is 'Makefile'. Also two commands are used so you can spot any errors during compilation.

=== With Dev C++ ===
This tutorial uses [http://www.bloodshed.net/dev/devcpp.html Dev C++ 4.9.9.2] ASSS 1.4.0 and Smong's [http://toktok.sscentral.com/ss-asss.html nomysql] module. Although it should work with all modules and a recent version of Dev C++.

==== Step 1 ====
[[Image:devcpp-140-step1.png|right]]
Load up Dev C++ and go to ''File'', ''New'', ''Project''.
 
 

==== Step 2 ====
[[Image:devcpp-140-step2.png|left]]
Choose the DLL project and give the project a descriptive name. Note: the name of the project will also be the name of the final .dll file, more about that later. Make sure to select ''C Project''.
 
 
 

==== Step 3 ====
[[Image:devcpp-140-step3.png|right]]
'''A)''' The DLL project comes with some template files. Remove them by right clicking on their tab and selecting close.

'''B)''' Click the icon of a document with a plus sign on it. This will open a dialog that lets you add files to the project. Here you can add the module's source files. For nomysql this is just nomysql.c. Also add util.c from from asss/src/main. You can download the ASSS source code from http://asss.yi.org/asss.
 

==== Step 4 ====
[[Image:devcpp-140-step4.png|left]]
Before compiling some include and library paths must be setup. Go to ''Project'', ''Project Options'' from the menu bar.
 
 

==== Step 5 ====
[[Image:devcpp-140-step5.png|right]]
First add pthread.dll by going to the ''Parameters'' tab and clicking on ''Add Library or Object''.
 
 
 
 

==== Step 6 ====
[[Image:devcpp-140-step6.png|left]]
You need to change the file type filter in the open file dialog to ''All Files (*.*)''. Then select pthread.dll (actual name may vary).
 
 
 
 

==== Step 7 ====
[[Image:devcpp-140-step7.png|right]]
Now add the following include directories:
* asss/src
* asss/src/include
* asss/windeps
These are needed so the compiler can find all the .h files that the module source requires.
 
 
 

==== Step 8 ====
[[Image:devcpp-140-step8.png|left]]
This part is optional. You may want to change the name of the output .dll file and you can do so from the ''Build Options'' tab. The default name for the output .dll file is the name you gave the project when you created it.
 
 
 
 

==== Step 9 ====
[[Image:devcpp-140-step9.png|right]]
Now click the compile button. It looks like four colored squares.
 

==== Step 10 ====
[[Image:devcpp-140-step10.png|left]]
If all goes well you should see this dialog. Congratulations on compiling your first module!
 
 
 

=== With Eclipse ===
See [[Installing New Modules with Eclipse]] for more details.

=== With MSVC ===
-write me-

=== By hand ===
You may need to execute the commands to compile from source, and then move the resulting .so file to the bin directory using install if running ASSS on Linux. If you are running ASSS on Windows and are updating a module you should shutdown the server before copying the .dll file to the bin directory.

== Python modules ==
No compiling is necessary. Move the .py file to the bin directory. There may be 'softcoded' settings within the .py file, so examine any comments near the top of the file for instructions.

== Configuring ==
It is a good idea to examine any documents that came with the module. There may be comments at the top of the source code and if you are unsure you can do a search on the file for 'cfg->Get', which will return all customisable settings this module reads.
<pre>
$ grep 'cfg->Get' src/module.c
$ grep 'cfg.Get' bin/module.py
</pre>
I suggest putting module settings in their own .conf file and include this from your [[arena.conf]].

There may also be commands that you must set the permissions for. You can add new commands to the group files found in conf/groupdef.dir. Prefix cmd_ to the command to allow users to send the command publicly and privcmd_ for team and private targets.

Finally you must load the module. Either add an entry to conf/modules.conf or use ?insmod. Some modules are arena specific, in which case you must also add it to your arena.conf Modules:AttachModules setting or use ?attmod.

If you have any questions left chances are they have already been answered at the [[Module General Faq|Module FAQ]].

[[Category:Module]]
[[Category:Guides]]

Installing New Modules with Eclipse

2009-07-11T03:36:53Z

Hakaku: +cat

Creating your first module can often be an intimidating process when you don't exactly know what you're doing. The following tutorial will guide you step by step on how to create an ASSS module using the [http://www.eclipse.org/cdt/ CDT] (C/C++ Development Tools) Integrated Development Environment (IDE) for [http://www.eclipse.org/ Eclipse] on the Windows operating system. Users already familiar with [[Installing New Modules#With Dev C++|Dev-C++]] will note several similarities between the two. You can obtain the most recent version of Eclipse CDT [http://www.eclipse.org/downloads/packages/eclipse-ide-cc-developers/galileor here].

== Step 1 ==
Once you have completely unpacked Eclipse, start up the program, and specify a workspace (a popup should automatically ask you for this). You can safely ignore the initial welcome screen and go straight to creating your first project. To do that, go to ''File'' > ''New'' > ''C Project''.

[[Image:Eclipse_01.png|300px]]

A new screen should now appear. Give your project a name, and then click the ''Next'' button.

[[Image:Eclipse_02.png|300px]]

Deselect the ''Debug'' option, it isn't necessary for the following tutorial, and then press ''Finish''.

[[Image:Eclipse_03.png]]

Assuming everything went ok, your project should look something like this:

[[Image:Eclipse_04.png|300px]]

== Step 2 ==
[[Image:Eclipse_05.png|300px]]

The next step will be to create new files to add in your project. To do this, go into ''File'' > ''New'' > ''Source File''. A new window will now show up. From here, you can now give your source (.c) file a name.

[[Image:Eclipse_06.png|300px]]

If you don't already have a module in mind, copy and paste the following (as used throughout the rest of this tutorial):
<pre>
#include "asss.h"

//Interfaces
local Imodman *mm;
local Icmdman *cmd;
local Ichat *chat;

local void Shout(const char *command, const char *params, Player *p, const Target *target)
{
chat->SendMessage(arena, "Hamburger!");
}

EXPORT int MM_commandlist(int action, Imodman *mm_, Arena *arena)
{
if (action == MM_LOAD)
{
mm = mm_;

chat = mm->GetInterface(I_CHAT, arena);
cmd = mm->GetInterface(I_CMDMAN, arena);

if (!chat || !cmd)
return MM_FAIL;
else
{
cmd->AddCommand("hamburger", ShoutHamburger, ALLARENAS, NONE);

return MM_OK;
}
}
else if (action == MM_UNLOAD)
{
cmd->RemoveCommand("hamburger", ShoutHamburger, ALLARENAS);

mm->ReleaseInterface(cmd);
mm->ReleaseInterface(chat);

return MM_OK;
}
return MM_OK;
}
</pre>
[[Image:Eclipse_07.png|300px]]

You'll also need to add the file ''util.c'' into your project, which you can find in your ASSS folder under ''/src/main''. Either open util.c using an external program, or through Eclipse via ''File'' > ''Open File...'' Repeating the same process as from the beginning of Step 2, copy and paste the source of util.c into your project (keep the name the same).

[[Image:Eclipse_08|300px]]

== Step 3 ==
Even though you've created a project and added files, you're still not ready to build your module. You should notice that your main source file will be full of question marks; don't panic, this simply means that Eclipse isn't configured properly yet, and doesn't know what to do with your source. To configure your project, click on ''Project'' > ''Properties'' in the menu.

[[Image:Eclipse_09.png]]

Navigate your way under ''C/C++ Build'' > ''Settings''. And choose the tab named ''Tool Settings''.

[[Image:Eclipse_10.png]]

The first thing you want to do is add your include paths. As shown below, add the following directories under ''GCC C Compiler'' > ''Directories''.
* asss/src
* asss/src/include
* asss/windeps

[[Image:Eclipse_11.png|300px]]

Without changing the page, navigate to ''MingGW C Linker'' > ''Miscellaneous''. You'll want to add the pthread.dll/pthreadGC2.dll file (actual name may vary), generally located in ASSS' ''/windeps'' folder.

[[Image:Eclipse_12.png|300px]]

Now click on the tab named ''Build Artifact''. The first thing you want to do is make sure you're creating a Shared Library file, and ''not'' an executable. Then, make sure that the artifact extension is '''dll'''. You can also change the name of the name of your output file, and specify a prefix (though not necessary).

[[Image:Eclipse_13.png|300px]]

== Step 4 ==
Once you're all done, click on ''Apply'', then ''OK''. Your project should automatically build itself afterwards, but you can build and rebuild it at any time by clicking on the hammer button, or by going into ''Project'' > ''Build All''.

Eclipse may then give you several warnings and errors if you made a mistake somewhere. Revise the list of warnings and errors to see if there isn't something that you've forgotten (such as adding an #include), or a simple typo.

[[Image:Eclipse_14.png|300px]]

If you used the above example provided in [[#Step 2|Step 2]], you should obtain the following 3 errors and 1 warning:
<pre>
`NONE' undeclared (first use in this function) hamburger.c /hamburger line 26
`ShoutHamburger' undeclared (first use in this function) hamburger.c /hamburger line 26
`arena' undeclared (first use in this function) hamburger.c /hamburger line 10
'Shout' defined but not used hamburger.c /hamburger line 9
</pre>
These can be corrected by replacing ''NONE'' with ''NULL'', ''local void Shout(...'' with ''local void ShoutHamburger(...'', and ''arena'' with ''p''. As you familiarize yourself with both the C language and ASSS, it will be easier for you to understand your mistakes, and know how to fix them.

If everything is compiled properly, Eclipse should now say "Build complete for project X".

[[Image:Eclipse_15.png|300px]]

== Step 5 ==
Now that you've created your first module, you'll want to give it a test run in-game. Locate your dll file in your workspace under the folder ''projectname/Release''. Copy it, and paste in in your ASSS folder under ''/bin''. Now open the file name ''modules.conf'' located in your ''/conf'' folder. Scroll to the bottom of the page, and add a new line with the file name and entry point name (i.e. EXPORT int MM_'''hamburger''') as follows:
* FILENAME:MODULENAME (e.g. hamburger:hamburger)

Make sure to save the file. If you've made a mistake in the name, then ASSS will close after you start it, as soon as it tries to load the non-existant or faulty module. Otherwise, you're now officially ready to give your module a spin!

In the hamburger example, you will also have to make one extra modification. Before starting ASSS, move over to the folder ''/conf/groupdef.dir''. Open up the file named ''Default'' (any text editor will do), and add the line ''cmd_hamburger''. This will now add the command ?hamburger. To test it, start up ASSS, and type ?hamburger in-game.

[[Category:Module]]
[[Category:Guides]]

File:Eclipse 03.gif

2009-07-11T03:36:12Z

Hakaku: please delete this (accidental duplicate)

PLEASE DELETE

Installing New Modules with Eclipse

2009-07-11T03:35:38Z

Hakaku: resizing

Creating your first module can often be an intimidating process when you don't exactly know what you're doing. The following tutorial will guide you step by step on how to create an ASSS module using the [http://www.eclipse.org/cdt/ CDT] (C/C++ Development Tools) Integrated Development Environment (IDE) for [http://www.eclipse.org/ Eclipse] on the Windows operating system. Users already familiar with [[Installing New Modules#With Dev C++|Dev-C++]] will note several similarities between the two. You can obtain the most recent version of Eclipse CDT [http://www.eclipse.org/downloads/packages/eclipse-ide-cc-developers/galileor here].

== Step 1 ==
Once you have completely unpacked Eclipse, start up the program, and specify a workspace (a popup should automatically ask you for this). You can safely ignore the initial welcome screen and go straight to creating your first project. To do that, go to ''File'' > ''New'' > ''C Project''.

[[Image:Eclipse_01.png|300px]]

A new screen should now appear. Give your project a name, and then click the ''Next'' button.

[[Image:Eclipse_02.png|300px]]

Deselect the ''Debug'' option, it isn't necessary for the following tutorial, and then press ''Finish''.

[[Image:Eclipse_03.png]]

Assuming everything went ok, your project should look something like this:

[[Image:Eclipse_04.png|300px]]

== Step 2 ==
[[Image:Eclipse_05.png|300px]]

The next step will be to create new files to add in your project. To do this, go into ''File'' > ''New'' > ''Source File''. A new window will now show up. From here, you can now give your source (.c) file a name.

[[Image:Eclipse_06.png|300px]]

If you don't already have a module in mind, copy and paste the following (as used throughout the rest of this tutorial):
<pre>
#include "asss.h"

//Interfaces
local Imodman *mm;
local Icmdman *cmd;
local Ichat *chat;

local void Shout(const char *command, const char *params, Player *p, const Target *target)
{
chat->SendMessage(arena, "Hamburger!");
}

EXPORT int MM_commandlist(int action, Imodman *mm_, Arena *arena)
{
if (action == MM_LOAD)
{
mm = mm_;

chat = mm->GetInterface(I_CHAT, arena);
cmd = mm->GetInterface(I_CMDMAN, arena);

if (!chat || !cmd)
return MM_FAIL;
else
{
cmd->AddCommand("hamburger", ShoutHamburger, ALLARENAS, NONE);

return MM_OK;
}
}
else if (action == MM_UNLOAD)
{
cmd->RemoveCommand("hamburger", ShoutHamburger, ALLARENAS);

mm->ReleaseInterface(cmd);
mm->ReleaseInterface(chat);

return MM_OK;
}
return MM_OK;
}
</pre>
[[Image:Eclipse_07.png|300px]]

You'll also need to add the file ''util.c'' into your project, which you can find in your ASSS folder under ''/src/main''. Either open util.c using an external program, or through Eclipse via ''File'' > ''Open File...'' Repeating the same process as from the beginning of Step 2, copy and paste the source of util.c into your project (keep the name the same).

[[Image:Eclipse_08|300px]]

== Step 3 ==
Even though you've created a project and added files, you're still not ready to build your module. You should notice that your main source file will be full of question marks; don't panic, this simply means that Eclipse isn't configured properly yet, and doesn't know what to do with your source. To configure your project, click on ''Project'' > ''Properties'' in the menu.

[[Image:Eclipse_09.png]]

Navigate your way under ''C/C++ Build'' > ''Settings''. And choose the tab named ''Tool Settings''.

[[Image:Eclipse_10.png]]

The first thing you want to do is add your include paths. As shown below, add the following directories under ''GCC C Compiler'' > ''Directories''.
* asss/src
* asss/src/include
* asss/windeps

[[Image:Eclipse_11.png|300px]]

Without changing the page, navigate to ''MingGW C Linker'' > ''Miscellaneous''. You'll want to add the pthread.dll/pthreadGC2.dll file (actual name may vary), generally located in ASSS' ''/windeps'' folder.

[[Image:Eclipse_12.png|300px]]

Now click on the tab named ''Build Artifact''. The first thing you want to do is make sure you're creating a Shared Library file, and ''not'' an executable. Then, make sure that the artifact extension is '''dll'''. You can also change the name of the name of your output file, and specify a prefix (though not necessary).

[[Image:Eclipse_13.png|300px]]

== Step 4 ==
Once you're all done, click on ''Apply'', then ''OK''. Your project should automatically build itself afterwards, but you can build and rebuild it at any time by clicking on the hammer button, or by going into ''Project'' > ''Build All''.

Eclipse may then give you several warnings and errors if you made a mistake somewhere. Revise the list of warnings and errors to see if there isn't something that you've forgotten (such as adding an #include), or a simple typo.

[[Image:Eclipse_14.png|300px]]

If you used the above example provided in [[#Step 2|Step 2]], you should obtain the following 3 errors and 1 warning:
<pre>
`NONE' undeclared (first use in this function) hamburger.c /hamburger line 26
`ShoutHamburger' undeclared (first use in this function) hamburger.c /hamburger line 26
`arena' undeclared (first use in this function) hamburger.c /hamburger line 10
'Shout' defined but not used hamburger.c /hamburger line 9
</pre>
These can be corrected by replacing ''NONE'' with ''NULL'', ''local void Shout(...'' with ''local void ShoutHamburger(...'', and ''arena'' with ''p''. As you familiarize yourself with both the C language and ASSS, it will be easier for you to understand your mistakes, and know how to fix them.

If everything is compiled properly, Eclipse should now say "Build complete for project X".

[[Image:Eclipse_15.png|300px]]

== Step 5 ==
Now that you've created your first module, you'll want to give it a test run in-game. Locate your dll file in your workspace under the folder ''projectname/Release''. Copy it, and paste in in your ASSS folder under ''/bin''. Now open the file name ''modules.conf'' located in your ''/conf'' folder. Scroll to the bottom of the page, and add a new line with the file name and entry point name (i.e. EXPORT int MM_'''hamburger''') as follows:
* FILENAME:MODULENAME (e.g. hamburger:hamburger)

Make sure to save the file. If you've made a mistake in the name, then ASSS will close after you start it, as soon as it tries to load the non-existant or faulty module. Otherwise, you're now officially ready to give your module a spin!

In the hamburger example, you will also have to make one extra modification. Before starting ASSS, move over to the folder ''/conf/groupdef.dir''. Open up the file named ''Default'' (any text editor will do), and add the line ''cmd_hamburger''. This will now add the command ?hamburger. To test it, start up ASSS, and type ?hamburger in-game.

File:Eclipse 15.png

2009-07-11T03:28:30Z

Hakaku:

File:Eclipse 14.png

2009-07-11T03:28:22Z

Hakaku:

File:Eclipse 13.png

2009-07-11T03:28:14Z

Hakaku:

File:Eclipse 12.png

2009-07-11T03:28:08Z

Hakaku:

File:Eclipse 11.png

2009-07-11T03:28:01Z

Hakaku:

File:Eclipse 10.png

2009-07-11T03:27:53Z

Hakaku:

File:Eclipse 09.png

2009-07-11T03:27:46Z

Hakaku:

File:Eclipse 08.png

2009-07-11T03:27:39Z

Hakaku: