Custom Missions
Custom Missions is a feature available in the CTGP-7 modpack that allows loading extra missions for the Mission Mode via the MyStuff folder.
Custom missions are loaded by placing them in the MyStuff/Missions
folder. Each mission should be placed in a subfolder with the name cup-level
where cup
is the cup number and level
is the course number inside the cup. Inside the subfolder, the files listed below can be placed.
settings.cmsn
This file contains all the configuration for the mission, and can be generated using the CTGP-7 EveryFileExplorer plugin. After installing the plugin, new files can be created through File -> New -> CTGP-7 Plugin -> Custom Mission
, or existing files can be opened through File -> Open...
.
The configuration file is divided in the following sections.
Settings
This section holds general settings for the mission.
Field | Description |
---|---|
General | |
Course | Course for the mission. |
Class | CC for the mission. |
Laps | Amount of laps for the mission. |
CPU | CPU difficulty. |
Mission Type and Subtype | Base mission rules, more information below. |
Calculation | What to use to calculate the player grade. |
Conditions | Special conditions to succeed the mission, more information below. |
Timer Configuration | |
Timer Initial Value | The initial value of the timer when the race starts. |
Timer Direction | Whether the timer counts up or down. |
Timer Finish Race | Automatically finish the race when the timer reaches the value. |
Timer Min Grade Timer Max Grade |
Determines the player grade based on the timer value when finishing the race. |
Score Configuration | |
Timer Score Value | The initial value of the score counter when the race starts. |
Yellow Score | The score counter will turn yellow once this value is reached. |
Score Direction | Whether the score counts up or down. |
Score Finish Race | Automatically finish the race when the score reaches the value. |
Score Min Grade Score Max Grade |
Determines the player grade based on the score value when finishing the race. |
Flags | |
Rank Visible | Enabled the position indicator in the top screen. |
Lakitu Visible | Enables Lakitu showing up when going on reverse or crossing the finish line. |
Play Course Intro | Enables playing the course intro cameras. |
Hide Score | Hides the score counter on the top screen. |
Score Is Bad | Determines if getting a point is a good or bad thing, changing the ingame sound for when that happens. |
Force Backwards | Forces the user to drive backwards by activating the backwards camera and disabling the A and Y buttons. |
Finish Race Section 2 | If the lap amount is 1, makes the game finish the race once the section 2 checkpoint is reached. |
Coin Respawn Time | Changes the amount of time coins take to respawn. By default, they respawn every 5 seconds. |
Mission Types
Depending on the mission type, the behavior of the race will be different. The following mission types are available.
Type | Description |
---|---|
Timer | No special behavior or rules. |
Gates | A point is given when the player goes through a gate. The subtype value Order only gives a point when going through the gates in order, while the subtype value All always gives a point.
|
Object | A point is given every time an object determined by the subtype field is "destroyed" or "obtained". |
Boost | A point is given every time the player obtains a boost from the action determined by the subtype field. |
Mission Complete Conditions
If mission complete conditions are set, all of them will need to be met in order to succeed the mission.
Condition | Description |
---|---|
Yellow score reached | Can only be used if the score configuration is enabled. The yellow score needs to be reached. |
Yellow score not reached | Can only be used if the score configuration is enabled. The yellow score must not be reached. The race will end as soon as this condition can no longer be satisfied. |
Player finishes 1st | The player needs to finish the race in 1st position. The race will end as soon as this condition can no longer be satisfied. |
CPU 1 finishes 1st | The first CPU racer needs to finish the race in 1st position. The race will end as soon as this condition can no longer be satisfied. |
Drivers
This section determines the drivers that will appear in the race.
You can choose the amount of drivers as well as their kart combinations. If driver is set to recommended, the game will decide automatically (based on some internal rival tables).
Items
This section determines how items will act in the race.
You can use any of the preset item modes of the game, or set a custom item mode. Furthermore, you can configure the amount of time item boxes take to respawn (2 seconds by default).
If the item mode is set to custom, the following options can be configured.
Field | Description |
---|---|
General | |
Spawn Item Boxes | Determines if item boxes spawn in the race. |
Player/CPU Specific | |
Mode | The mode to calculate which row from the probability table to use. More information below. |
Give Items | Gives an item automatically as if the driver obtained an item box. The interval of time between giving items and the initial time to wait can be configured. |
Disable Cooldown | Disables the cooldown some items have, such as lightnings or blue shells, and allows getting items of a type which their limits have already been reached (previous items of the same type will vanish if the limit has been reached reached and a new one is spawned). |
Roulette Speed | Changes the amount of time the item roulette will spin before deciding the item (3 seconds by default). |
Probability Table | This table determines the chances for getting a specific item. The row is determined by the Mode field. Once the row is decided, the final item to be given is determined by the probability values from that row. The probability algorithm used is weighted probability (for example: a single column with value 100 means that item has a 100% of appearing and two columns with value 100 means each item has a 50% chance of appearing).
|
Probability Row Mode
The row used to calculate the item probabilities is determined by the Mode
field, which can take the following values.
Mode | Description |
---|---|
Box ID | The row is determined by the item box ID (settings5 in the KMP object entry). If this mode is used and the item box ID is set to 0, undefined behavior will happen. |
Rank | The row is determined by the driver position. If the driver amount is less than 8, the row is calculated proportionally to the player amount (for example: in a 2 driver race, getting an item in 2nd place may give you items from the rows 4 to 8). |
True Rank | The row is determined by the driver position. Unlike Rank mode, the driver amount has no effect on which row is selected.
|
Driver ID | The row is determined by the driver ID. |
WIP