GTATournament

From GTAModding
Jump to: navigation, search

The gtaTournament (GTAT) project was the first multiplayer modification for GTA Vice City and GTA San Andreas.

Grand Thefts Online

"gtaTournament is no Deathmatch GTA. Our aim is to get grand thefts online, like the single player just with more then one guy."
–DracoBlue

To make every server unique instead of hardcoding the server, a scripting language is used called VCS. There are hundreds of script commands which make servers capabable of game modes based on racing, Deathmatch, Role Playing Games (RPG), Capture the Flag (CTF) and many others.

Script Language

Like some other script langauges, in VCS there are two types of processes: Events and Commands. These are explained in the following sections.

Commands

Commands are structured like function calls in a similar way to other programming languages. They require at least one parameter and they return a value.

Code Sample

// @title  Message all players in an circle
// @author DracoBlue  | @date 24.09.2005 | @update 24.09.2005
// Needs $x,$y,$z with coords, and $pl,$tmp as temp vars.
$radius:="100";
$text:="Hello!";
$pl:=PLAYERS_IN_CIRCLE($x,$y,$z,$radius);
$tmp:="0";
while (BIGGER(LCOUNT($pl),$tmp))
  begin
    $tmp:=ADD($tmp,"1");
    messageto(
      PLAYERSNAMEBYID(LGET($pl,$tmp)),
      $text)
    );
  end;

A complete list of all commands is available in the official documentation.

Events

Events are "raised" if something special happens. For example, a player joining or sending a message using the in-game chat system. When an event is raised, a section of commands associated with that event are automatically processed.

Code Sample

// Adds a line to VCS-Console, when someone enters the game.
procedure ON_PLAYER_JOIN;
    var $text;
  begin
    $nickname:=PlayersNameByID($nickname);
    $text:=concat("Gejoint ist :",$nickname);
    echo($text);
  end;

More information about events is available in the official documentation.

Version Release History

  • 2006-02-16, 21:01: 0.3c
  • 2006-02-06, 20:42: 0.3b
  • 2006-01-23, 20:29: 0.3a
  • 2005-11-04, 20:19: 0.2
  • 2005-09-28, 14:48: 0.1c
  • 2005-07-14, 18:56: 0.1b
  • 2005-07-02, 12:52: 0.1a

The GTAVC and GTA3 releases are not shown here yet.

Links