Custom Campaigns

Note

Booleans in XMLs need to be either True, true, False or false.

Custom Campaigns can be loaded into the game by defining events via XML files. These provide you with everything that was made to make the internal campaigns.

All Attributes

Settings

Name Data Type Description
Name string
The name that will be given the campaign on the
menu.
BarracudaAllowed boolean
Whether Barracuda and Caliburn can be selected in the
campaign.
CustomShipsAllowed boolean
Whether Custom Ships can be selected in the campaign.
Video string
The relative path to a video file to use for the campaign
graphic.
FallbackTexture string
The relative path to a PNG image to use for the campaign
graphic. Only used if a video file isn’t provided or available.

Group

Name Data Type Description
PointsToUnlock integer
How many points the player needs to unlock the group.

Frontend

Name Data Type Description
Name string
The name that will be displayed in the event list.
menu.
Description string
Currently unused.

Awards

Name Data Type Description
BronzeValue float
The value needed to obtain a bronze medal. For instance, enter 3
to award the player a bronze medal for coming in 3rd place.
SilverValue float
The value needed to obtain a silver medal. For instance, enter 2
to award the player a silver medal for coming in 2nd place.
GoldValue float
The value needed to obtain a gold medal. For instance, enter 1
to award the player a gold medal for coming in 1st place.
PlatinumValue float
The value needed to obtain a platinum medal. For instance, enter 1
to award the player a platinum medal for coming in 1st place when
playing in hard mode.
EasyScore float
The target score when in easy mode. Used in gamemodes
such as Eliminator.
HardScore float
The target score when in hard mode. Used in gamemodes
such as Eliminator.

Mode

Note

Any parsed attributes that aren’t one of the ones listed below will be treated as a custom gamemode attribute. These allow gamemodes that have a static integer declared and then enter the variables name and the value they want it set to.

Name Data Type Description
Gamemode string
The name of the gamemode to load for the event.
ModernPhysics boolean
Whether 2280 should be used for the event.
FloorHugger boolean
Whether floor hugger should be used for the event.
Overrides 2280.
SpeedClass string
The speed class to use for the event. Toxic, Apex, Halberd,
Spectre or Zen

Level

Level is part of the levels element which takes multiple level attributes. Providing more then one level attribute will automatically setup a tournament.

Name Data Type Description
Name string
The name of the track to load.

Modifiers

Name Data Type Description
Hardcore boolean
Whether double damage should be enabled.
Weapons boolean
Whether weapons should be enabled.
Mirror boolean
Whether mirror mode should be enabled.
Hyperspeed boolean
Whether hyper speed should be enabled.
Extralaps integer
The number of additional laps for the event.
ForcePlayerShip boolean
Whether to force the player ship using the ForcedPlayerShip
setting below.
ForceAiShip boolean
Whether to force the ai ship using the ForcedAiShip
setting below.
ForcedPlayerShip string
The name of the ship to force the player to fly.
ForcedAiShip string
The name of the ship to force the Ai to fly.
ForcedPlayerLivery integer
When forcing a player ship, the index of the livery to
force.
ForcedPlayerScheme integer
When forcing a player ship, the index of the livery
scheme to force.
BlockShipSet string
Supports multiiple attributes. When set, will unlock all
ship sets and then use every BlockShipSet entry to
blacklist ship sets that you don’t want to be selected.
Valid options are Standard, Drag, Drift, Survival and
Custom

Ai

Name Data Type Description
Count boolean
The number of AI ships to spawn.
UseSpeedMult boolean
Whether the speed multiplier below will be used.
SpeedMult boolean
Optional top speed multiplier for the AI.
Difficulty boolean
The difficulty level to use for the AI. Valid options are Novice,
Experienced, Expert, Elite and Hardcore.
Hard mode will force this to Hardcore

Example

This example is a re-creation of the Reflex campaign from the game. This is an older XML file and doesn’t include every attribute listed above, but serves fine as a full example of a campaign. Some attributes have also been changed over the years. It’s reccomended you use this as a structure reference only.

<Settings Name="Not Reflex" BarracudaAllowed="False" CustomShipsAllowed="False" Video="" FallbackTexture="BNG-1.jpg" />
<Group PointsToUnlock="0">
<Event>
    <Frontend Name="Nova Split Time Trial" Description="" />
    <Awards BronzeValue="140" SilverValue="130" GoldValue="120" PlatinumValue="100" EasyScore="0" HardScore="0" />
    <EventSettings>
    <Mode Gamemode="Time Trial" ModernPhysics="False" SpeedClass="Toxic" FloorHugger="True">
        <Levels>
        <Level Name="Nova Split" />
        </Levels>
    </Mode>
    <Modifiers Hardcore="False" Weapons="True" Mirror="False" ExtraLaps="0" ForcePlayerShip="True" ForceAiShip="False" ForcedShip="Barracuda"/>
    <Ai Difficulty="Experienced" Count="7" UseSpeedMult="False" SpeedMult="0" />
    </EventSettings>
</Event>
<Event>
    <Frontend Name="Arrivon XI Introduction Race" Description="" />
    <Awards BronzeValue="0" SilverValue="0" GoldValue="0" PlatinumValue="0" EasyScore="0" HardScore="0" />
    <EventSettings>
    <Mode Gamemode="Race" ModernPhysics="False" SpeedClass="Toxic">
        <Levels>
        <Level Name="Arrivon XI" />
        </Levels>
    </Mode>
    <Modifiers Hardcore="False" Weapons="True" Mirror="False" ExtraLaps="0"/>
    <Ai Difficulty="Experienced" Count="7" UseSpeedMult="False" SpeedMult="0" />
    </EventSettings>
</Event>
<Event>
    <Frontend Name="Marina Rush Introduction Race" Description="" />
    <Awards BronzeValue="0" SilverValue="0" GoldValue="0" PlatinumValue="0" EasyScore="0" HardScore="0" />
    <EventSettings>
    <Mode Gamemode="Race" ModernPhysics="False" SpeedClass="Toxic">
        <Levels>
        <Level Name="Marina Rush" />
        </Levels>
    </Mode>
    <Modifiers Hardcore="False" Weapons="True" Mirror="False" ExtraLaps="0" ForcePlayerShip="False" ForceAiShip="False" ForcedShip="Gtek" />
    <Ai Difficulty="Novice" Count="7" UseSpeedMult="False" SpeedMult="0" />
    </EventSettings>
</Event>
</Group>
<Group PointsToUnlock="6">
<Event>
    <Frontend Name="Marina Rush Knockout" Description="" />
    <Awards BronzeValue="0" SilverValue="0" GoldValue="0" PlatinumValue="0" EasyScore="0" HardScore="0" />
    <EventSettings>
    <Mode Gamemode="Knockout" ModernPhysics="False" SpeedClass="Halberd">
        <Levels>
        <Level Name="Marina Rush" />
        </Levels>
    </Mode>
    <Modifiers Hardcore="False" Weapons="False" Mirror="False" ExtraLaps="0" ForcePlayerShip="False" ForceAiShip="False" ForcedShip="Nexus" />
    <Ai Difficulty="Novice" Count="7" UseSpeedMult="False" SpeedMult="1.12" />
    </EventSettings>
</Event>
<Event>
    <Frontend Name="Nova Split Survival" Description="" />
    <Awards BronzeValue="10" SilverValue="20" GoldValue="30" PlatinumValue="40" EasyScore="0" HardScore="0" />
    <EventSettings>
    <Mode Gamemode="Survival" ModernPhysics="False" SpeedClass="Zen">
        <Levels>
        <Level Name="Nova Split" />
        </Levels>
    </Mode>
    <Modifiers Hardcore="False" Weapons="False" Mirror="False" ExtraLaps="0" ForcePlayerShip="False" ForceAiShip="False" ForcedShip="Gtek" />
    <Ai Difficulty="Novice" Count="0" UseSpeedMult="False" SpeedMult="0" />
    </EventSettings>
</Event>
<Event>
    <Frontend Name="Hyperions Arrivon XI Trial" Description="" />
    <Awards BronzeValue="112.16" SilverValue="115.16" GoldValue="118.16" PlatinumValue="115.97" EasyScore="0" HardScore="0" />
    <EventSettings>
    <Mode Gamemode="Time Trial" ModernPhysics="False" SpeedClass="Halberd">
        <Levels>
        <Level Name="Arrivon XI" />
        </Levels>
    </Mode>
    <Modifiers Hardcore="False" Weapons="False" Mirror="False" ExtraLaps="0" ForcePlayerShip="True" ForceAiShip="False" ForcedShip="Hyperion" />
    <Ai Difficulty="Novice" Count="0" UseSpeedMult="False" SpeedMult="0" />
    </EventSettings>
</Event>
</Group>
<Group PointsToUnlock="12">
<Event>
    <Frontend Name="Arrivon XI Survival" Description="" />
    <Awards BronzeValue="10" SilverValue="20" GoldValue="30" PlatinumValue="40" EasyScore="0" HardScore="0" />
    <EventSettings>
    <Mode Gamemode="Survival" ModernPhysics="False" SpeedClass="Zen">
        <Levels>
        <Level Name="Arrivon XI" />
        </Levels>
    </Mode>
    <Modifiers Hardcore="False" Weapons="False" Mirror="False" ExtraLaps="0" ForcePlayerShip="False" ForceAiShip="False" ForcedShip="Gtek" />
    <Ai Difficulty="Novice" Count="0" UseSpeedMult="False" SpeedMult="0" />
    </EventSettings>
</Event>
<Event>
    <Frontend Name="Omnicoms Nova Split Trial" Description="" />
    <Awards BronzeValue="114.08" SilverValue="117.08" GoldValue="120.08" PlatinumValue="117.03" EasyScore="0" HardScore="0" />
    <EventSettings>
    <Mode Gamemode="Time Trial" ModernPhysics="False" SpeedClass="Halberd">
        <Levels>
        <Level Name="Nova Split" />
        </Levels>
    </Mode>
    <Modifiers Hardcore="False" Weapons="False" Mirror="False" ExtraLaps="0" ForcePlayerShip="True" ForceAiShip="False" ForcedShip="Omnicom" />
    <Ai Difficulty="Novice" Count="0" UseSpeedMult="False" SpeedMult="0" />
    </EventSettings>
</Event>
<Event>
    <Frontend Name="Marina Rush Survival" Description="" />
    <Awards BronzeValue="10" SilverValue="20" GoldValue="30" PlatinumValue="50" EasyScore="0" HardScore="0" />
    <EventSettings>
    <Mode Gamemode="Survival" ModernPhysics="False" SpeedClass="Zen">
        <Levels>
        <Level Name="Marina Rush" />
        </Levels>
    </Mode>
    <Modifiers Hardcore="False" Weapons="False" Mirror="False" ExtraLaps="0" ForcePlayerShip="False" ForceAiShip="False" ForcedShip="Gtek" />
    <Ai Difficulty="Novice" Count="0" UseSpeedMult="False" SpeedMult="0" />
    </EventSettings>
</Event>
</Group>