Creating Event Categories (Folders) & Events¶
Gran Turismo 5 & 6 uses very simple XML to represent game events (and in the case of GT6, also whole event folders).
The best way to start off is understanding an existing original event and using it as base. You may notice that all event files start with a letter followed by 3 digits. These XMLs contain the event list for a game event category (i.e Sunday Cup).
(GT5) Creating a new Event Folder¶
If you're creating a new event folder, you will need to refer to this.
For GT5, you can refer to the
gamelist.xml in the
aspec_race folder to figure out which file is which category.
|Unique ID for your event. It must follow a previous one. i.e last is 110, next has to be 111 else your game will black screen. Each hundreds correspond to a different tier:
- 100: Beginner
- 200: Amateur
- 300: Professional
- 400: Expert
- 500: Extreme
- 600: Endurance
|Also has to be unique. i.e 150 would point to the
|Level required to access the folder.
|Event count in that folder.
|Whether the folder is a championship where you cannot start an individual event.
id must be in order! For instance,
109 is the last event folder in the Beginner category, if you are adding a new folder, the next one has to be
The game has a rather poor event handling code, you might see a crash that kicks out of the event menus if ids are not in order.
(GT5) Folder Title/Description¶
The section about Editing Text is required for this step.
In order to add or edit new event information, you will need to do some text editing.
projects/gt5/gtmode/<locale> folder into the GT.RText tool. Go to the
Add a row as such (where xxx is your event ID):
xxxd - For your description
xxxt - For your title
xxxc - For your caption.
Important: Ensure that the row and labels are in order. The last row in the
rt2 must not be below any of the other ids as its last row.
(GT6) Creating a new Event Folder¶
In GT6 compared to GT5 the process has been changed (and made a lot more flexible). GT6 uses a sqlite database to store folder data. You will need something like SQLiteStudio to edit it.
That sqlite database is located at
This file is encrypted, follow the SpecDB guide to decrypt it.
Open the file through SQLiteStudio. You will notice a few tables on the left pane, you'll be interested only in
Go to the "Data" tab.
Create rows for each folder that you want to create and apply them.
|Unique ID, just make sure they're continuous
FolderID required to complete before accessing this one
|Total stars to obtain in that event (for regular folders) - Used for progress, make sure it matches
|File name of your named XML
|Amount of stars in the current category (i.e) novice to open the folder
|XML id which will point to your event list XML (i.e 1000 = r1000.xml)
|Type of event. Refer to the table below.
|For regular folders only. The display list depends on it, if you set it as 0 the folder will show on top of the left pane.
t_event_folder_localize- Name of your folder in each language - required for each folder:
id: Must be unique
LocalizeID: Must match your folder's
- Everything else: Name of your folder in each language - just set it all as english
If you've created your folder or editing an existing one, you can take on doing the event itself.
If you are using GT6, you are strongly recommended to create your own event using the Event Maker. It will allow you to directly export events as XML along with their folders. It is also well documented, most labels will show information while hovering them.
However if you're still editing directly through a text/code editor, you can refer to the XML documentation itself. If you're creating an event make sure it matches the IDs for your folders in either GT5 or GT6, including the xml file names.
Note for GT6
If you are editing original events, you might also notice these
.fgp files - You will need to remove them from the
PDIPFS in order for the game to bypass its event cache or no changes will occur.
Read -> Removing files from the game