Resource:Race - Revision history

SpeedyFolf: Specified that you can press your vehicle enter/exit key to respawn rather than typing a chat command, updated link to batch race converter, updated map syntax, and added a note about using the cylinder checkpoint type

2025-05-25T05:28:43Z

Specified that you can press your vehicle enter/exit key to respawn rather than typing a chat command, updated link to batch race converter, updated map syntax, and added a note about using the cylinder checkpoint type

← Older revision		Revision as of 05:28, 25 May 2025
Line 11:		Line 11:
	*'''Vehicle change pickups:''' these display the name of a vehicle above them. As soon as you drive over a pickup your vehicle will be changed.		*'''Vehicle change pickups:''' these display the name of a vehicle above them. As soon as you drive over a pickup your vehicle will be changed.

	Lastly, if you get stuck during a race, you can enter the /kill command in the chatbox to kill yourself and respawn at the previous checkpoint.		Lastly, if you get stuck during a race, you can enter the /kill command in the chatbox or press your vehicle enter/exit key to kill yourself and respawn at the previous checkpoint.

	==Converting MTA:Race maps==		==Converting MTA:Race maps==
	Use the [~~http~~://files.mtasa.com/apps/1.0/raceconv.zip batch converter] to convert all your MTA:Race maps into MTA:SA maps in one go.		Use the [https://web.archive.org/web/20120128231117/https://files.mtasa.com/apps/1.0/raceconv.zip batch converter] to convert all your MTA:Race maps into MTA:SA maps in one go.

	==Map syntax==		==Map syntax==
	You can create race maps using the ~~new~~ MTA:SA [[Resource:editor\|map editor]]. The map syntax is given here for reference.		You can create race maps using the MTA:SA [[Resource:editor\|map editor]]. The map syntax is given here for reference.

	===.map file===		===.map file===
Line 23:		Line 23:
	<map>		<map>
	<!-- One or more -->		<!-- One or more -->
	<spawnpoint posX="X" posY="Y" posZ="Z" ~~rotation~~="~~Rotation in degrees~~" ~~vehicle~~="~~Vehicle ID~~" id="~~spawnpointID~~" [ paintjob="~~paintjob~~ ID" upgrades="~~comma~~-separated list of upgrades" ] />		<spawnpoint id="Textual or numeric spawnpoint ID" vehicle="Vehicle ID" interior="Interior ID" posX="posX" posY="posY" posZ="posZ" rotX="rotX" rotY="rotY" rotZ="rotZ" [ paintjob="Paintjob ID" upgrades="Comma-separated list of upgrades" ]></spawnpoint>

	<!-- Zero or more -->		<!-- Zero or more -->
	<checkpoint ~~posX~~="X" ~~posY~~="Y" ~~posZ~~="Z" ~~color~~="~~#FF0000~~" id="~~textual or numeric checkpoint~~ ID" nextid="ID of checkpoint after this one" ~~[ size~~="~~checkpoint size~~" vehicle="~~vehicle~~ ID to change into~~" type="checkpoint/ring/cylinder/arrow/corona~~" paintjob="~~paintjob~~ ID" upgrades="~~comma~~-separated list of upgrades" ] />		<checkpoint id="Textual or numeric checkpoint ID" type="checkpoint\|ring\|corona\|cylinder\|arrow" color="#RrGgBbAa" size="Checkpoint size" interior="Interior ID" nextid="ID of checkpoint after this one" posX="posX" posY="posY" posZ="posZ" rotX="rotX" rotY="rotY" rotZ="rotZ" [ vehicle="Vehicle ID to change into" paintjob="Paintjob ID" upgrades="Comma-separated list of upgrades" ]></checkpoint>

	<!-- Zero or more -->		<!-- Zero or more -->
	<~~object posX~~="X" ~~posY~~="~~Y" posZ="Z" rotX=~~"~~in degrees" rotY~~="in ~~degrees~~" ~~rotZ~~="~~in degrees" model="model~~ ID" id="~~objectID~~" />		<racepickup id="Textual or numeric pickup ID" type="nitro\|repair\|vehiclechange" respawn="Respawn time in milliseconds" interior="Interior ID" posX="posX" posY="posY" posZ="posZ" rotX="rotZ" rotY="rotY" rotZ="rotZ" [ vehicle="Vehicle ID to change into, if a vehiclechange pickup" paintjob="Paintjob ID" upgrades="Comma-separated list of upgrades" ]></racepickup>

	~~<!-- Zero or more -->~~
	~~<pickup posX~~="X" ~~posY~~="Y" ~~posZ~~="Z" ~~type~~="~~repair\|nitro\|vehiclechange~~" id="~~pickupID~~" [ vehicle="~~vehicle~~ ID" paintjob="~~paintjob~~ ID" upgrades="~~comma~~-separated list of upgrades" ] />
	</map>		</map>
	</syntaxhighlight>		</syntaxhighlight>
			Keep in mind that currently the cylinder checkpoint type uses the sphere [[Element/Collision shape\|colshape]], not tube like you would expect.

	===meta.xml===		===meta.xml===
	<syntaxhighlight lang="xml">		<syntaxhighlight lang="xml">
	<meta>		<meta>
	<info type="map" gamemodes="race" name="Map name" author="Author name" description="Map description" version="Map version number"/>		<info type="map" gamemodes="race" name="Map name" author="Author name" description="Map description" version="Map version number"/>
	<race src="Map file.map"/>		<race src="Map file.map"/>
	<settings>		<settings>
	<setting name="#optionName" value="optionValue"/>		<setting name="#optionName" value="optionValue"/>
	...		...
	</settings>		</settings>
	</meta>		</meta>
	</syntaxhighlight>		</syntaxhighlight>

Surge at 13:22, 24 October 2018

2018-10-24T13:22:06Z

← Older revision		Revision as of 13:22, 24 October 2018
Line 282:		Line 282:
	\|}		\|}

			[[hu:Resource:Race]]
	[[ru:Resource:Race]]		[[ru:Resource:Race]]

Vincent at 13:55, 17 May 2012

2012-05-17T13:55:52Z

← Older revision		Revision as of 13:55, 17 May 2012
Line 281:		Line 281:
	\|-		\|-
	\|}		\|}

			[[ru:Resource:Race]]

Mack Varial at 11:54, 13 November 2011

2011-11-13T11:54:57Z

@@ Line 173: / Line 173: @@
 ==Events for version 0.8.3 in detail==
 '''Note:''' You may have to add the events in your script using addEvent() if you want to use them.
 ===onPlayerReachCheckpoint===
 Triggered when a player reaches any checkpoint but the last one.

Tjong Tjong: /* .map file */

2011-02-01T16:21:45Z

.map file

← Older revision		Revision as of 16:21, 1 February 2011
Line 21:		Line 21:
	===.map file===		===.map file===
	<syntaxhighlight lang="xml">		<syntaxhighlight lang="xml">
	<map ~~mod="deathmatch"~~>		<map>
	<!-- One or more -->		<!-- One or more -->
	<spawnpoint posX="X" posY="Y" posZ="Z" rotation="Rotation in degrees" vehicle="Vehicle ID" id="spawnpointID" [ paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] />		<spawnpoint posX="X" posY="Y" posZ="Z" rotation="Rotation in degrees" vehicle="Vehicle ID" id="spawnpointID" [ paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] />

	<!-- Zero or more -->		<!-- Zero or more -->
	<checkpoint posX="X" posY="Y" posZ="Z" color="#FF0000" id="textual or numeric checkpoint ID" nextid="ID of checkpoint after this one" [ size="checkpoint size" vehicle="vehicle ID to change into" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] />		<checkpoint posX="X" posY="Y" posZ="Z" color="#FF0000" id="textual or numeric checkpoint ID" nextid="ID of checkpoint after this one" [ size="checkpoint size" vehicle="vehicle ID to change into" type="checkpoint/ring/cylinder/arrow/corona" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] />

	<!-- Zero or more -->		<!-- Zero or more -->

Arc: /* Element data */

2010-07-10T17:12:00Z

Element data

← Older revision		Revision as of 17:12, 10 July 2010
Line 205:		Line 205:
	==Element data==		==Element data==
	These element data are set on each player:		These element data are set on each player:
	*'''~~Race~~ rank:''' the current position of the player in the race. 1 = first, 2 = second etc. Updated on a 1 second interval.		*'''race rank:''' the current position of the player in the race. 1 = first, 2 = second etc. Updated on a 1 second interval.
	*'''race.checkpoint:''' the number of the checkpoint the player is ''heading for''. When the player spawns this number is 1, after he passed the first checkpoint it's 2, etc.		*'''race.checkpoint:''' the number of the checkpoint the player is ''heading for''. When the player spawns this number is 1, after he passed the first checkpoint it's 2, etc.
	*'''race.finished:''' ''true'' if the player has finished, ''false'' if he's still racing.		*'''race.finished:''' ''true'' if the player has finished, ''false'' if he's still racing.

Driver2: /* Events for version 0.8.3 */

2010-03-02T21:44:02Z

Events for version 0.8.3

← Older revision		Revision as of 21:44, 2 March 2010
Line 53:		Line 53:

	==Events for version 0.8.3==		==Events for version 0.8.3==
			'''Note:''' You may have to add the events in your script using addEvent() if you want to use them.
	===Server===		===Server===

Driver2: /* Events for version 0.8.3 in detail */

2010-02-26T03:18:42Z

Events for version 0.8.3 in detail

← Older revision		Revision as of 03:18, 26 February 2010
Line 172:		Line 172:

	==Events for version 0.8.3 in detail==		==Events for version 0.8.3 in detail==
			'''Note:''' You may have to add the events in your script using addEvent() if you want to use them.
	===onPlayerReachCheckpoint===		===onPlayerReachCheckpoint===
	Triggered when a player reaches any checkpoint but the last one.		Triggered when a player reaches any checkpoint but the last one.

Ccw: /* Server */ Added onPlayerRaceWasted event

2009-10-25T04:38:06Z

Server: Added onPlayerRaceWasted event

← Older revision		Revision as of 04:38, 25 October 2009
Line 113:		Line 113:
	\|}		\|}

			{\| class="wikitable" border="0"
			\|-
			\|width="200pt"\|'''onPlayerRaceWasted'''
			\|width="60pt"\|player
			\|<syntaxhighlight lang="lua">vehicle playersVehicle</syntaxhighlight>
			\|-
			\|}

	===Client===		===Client===

Ccw: typos

2009-10-25T04:34:33Z

typos

← Older revision		Revision as of 04:34, 25 October 2009
Line 205:		Line 205:

	==Super Advanced Element data==		==Super Advanced Element data==
	You can also set player element data to change the ~~players~~ collision status and render transparency:		You can also set player element data to change the player collision status and render transparency:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	e.g. setElementData( thePlayer, "overrideCollide.uniqueblah", 0, false ) -- Collide 'off' for this player		e.g. setElementData( thePlayer, "overrideCollide.uniqueblah", 0, false ) -- Collide 'off' for this player
Line 234:		Line 234:
	{\| class="wikitable" border="0"		{\| class="wikitable" border="0"
	\|-		\|-
	\|width="80pt"\|<syntaxhighlight lang="lua">~~vehicle~~</syntaxhighlight>		\|width="80pt"\|<syntaxhighlight lang="lua">boolean</syntaxhighlight>
	\|width="110pt"\|'''isPlayerFinished'''		\|width="110pt"\|'''isPlayerFinished'''
	\|<syntaxhighlight lang="lua">player thePlayer</syntaxhighlight>		\|<syntaxhighlight lang="lua">player thePlayer</syntaxhighlight>