View source for Race Module

== Introduction ==

    The [[Race]] module attempts to implement one of the long requested
    server features.  In the history of zones like Pod Racer comes
    automated racing under an [[ASSS]] module.  [[Race]] was initially
    developed by [[User:Smong|Smong]], but now maintained by [[User:i88gerbils|i88gerbils]].

== Requirements ==

    [[ASSS]] version *1.3.x* or newer.

== [http://wiki.aswz.com/index.php/ChangeLog-Race ChangeLog] ==

<pre>
11/05/04        v 1.3i          i88gerbils

        * "i" branch started ;-)
        * RaceReward hack, does not use a separate module.
        * RaceDelay timer added to set maximum race time.
        * AutoRace functionality added to start races automatically.
        * InSafeToPlay changed to spec OR ignore non-racers.
        * stats->SendUpdates works.  Now scores will update immediately.  Yay.
</pre>

== Todo ==

        * RaceMinDelay                                  min=0
          Minimum time needed to pass a checkpoint before being disqualified.
            - d->chkpttime = 0 (start_game)
            - if( (current_ticks() - d->start) / 100 + d->chkpttime > mindelay ) d->chkpttime = current_ticks() - d->start / 100 + d->chkpttime - mindelay;
            - else FINISH player
        * RaceRewardMode
          Add in a new race reward mode based on time.  This will probably be
          players^2 * RaceReward / rank / (mytime-1sttime) [except for 1st place racer
          of course!]

== Download ==

    [http://www.aswz.com/files/race-1.3i.tar.gz Current Tarball]

== Build Instructions (UNIX) ==

     * tar zxf race-*version*.tar.gz
     * cp race-*version*
     * cp race.* /path/to/[ASSS]/src
     * cd /path/to/[ASSS]/src
     * *make -f race.mk*

== Installation ==

     * make -f race.mk install
     * cp race.conf ../arenas/MY_RACE_ARENA/
     * Append race:race to /path/to/[ASSS]/conf/modules.conf
     * Append cmd_race to /path/to/[ASSS]/conf/groupdef.dir/mod

== Configuration ==

    *[[Race_Module:MinPlaying|MinPlaying]]
    *[[Race_Module:MinTeams|MinTeams]]
    *[[Race_Module:Laps|Laps]]
    *[[Race_Module:ContinuousMap|ContinuousMap]]
    *[[Race_Module:Chkpt0|Chkpt0]]
    *[[Race_Module:ChkptX|ChkptX]]
    *[[Race_Module:AutoRace|AutoRace]]
    *[[Race_Module:StartDelay|StartDelay]]
    *[[Race_Module:RaceDelay|RaceDelay]]
    *[[Race_Module:RaceReward|RaceReward]]
    *[[Race_Module:InSafeToPlay|InSafeToPlay]]

    *[[Race_Module:Stages|Stages]]
    *[[Race_Module:Actions|Actions]]
    *[[Race_Module:Macros|Macros]]

== Commands ==

    ?race start|stop|status

== Contact ==

     * [[User:Smong|Smong]]
     * [[User:i88gerbils|i88gerbils]]

[[Category: Custom Modules]]