Mario Kart 64
Loading...
Searching...
No Matches
Course.h
Go to the documentation of this file.
1#ifndef ENGINE_COURSE_H
2#define ENGINE_COURSE_H
3
4#include <libultraship/libultraship.h>
5#include "CoreMath.h"
6
7#ifdef __cplusplus
9#include <optional>
10#include <nlohmann/json.hpp>
13extern "C" {
14#endif
15
16#include "camera.h"
17#include "course_offsets.h"
18#include "data/some_data.h"
19#include "defines.h"
20#include "bomb_kart.h"
21#include "path_spawn_metadata.h"
22#include "waypoints.h"
23#include "sounds.h"
24#include "common_structs.h"
25
26#ifdef __cplusplus
27}
28#endif
29
40
41// Extends infinitely in the Y direction
42// If a player is overtop of a water volume then it should use its height
43// Recommend using the new water surface type. This is here to support the stock tracks.
44// Albeit, there's no reason you cannot use this so long as you input a square.
45// How to use: WaterVolumes.push_back({0, -100, 100, -100, 100});
47 float Height; // Y coordinate of the Water level
48 float MinX;
49 float MaxX;
50 float MinZ;
51 float MaxZ;
52};
53
54typedef struct MinimapProps {
55 const char* Texture;
56 int16_t Width;
57 int16_t Height;
58 IVector2D Pos[2]; // Minimap position for players 1 and 2. 3/4 player mode is hard-coded to the center.
59 int32_t PlayerX; // The offset to place the player markers
60 int32_t PlayerY;
61 float PlayerScaleFactor; // Scale factor of the player markers
62 float FinishlineX; // The offset to place the finishline texture on the minimap
64 RGB8 Colour; // Colour of the visible pixels (the track path)
66
67void ResizeMinimap(MinimapProps* minimap);
68
69typedef struct Properties {
70 char Name[128];
71 char DebugName[128];
72 char CourseLength[128];
75 const char* AIBehaviour;
78 float NearPersp;
79 float FarPersp;
80 int16_t* AIDistance;
87 TrackPathPoint* PathTable[4]; // Only used for podium ceremony
88 TrackPathPoint* PathTable2[5]; // The fifth entry is for vehicles
89 uint8_t* CloudTexture;
95 float WaterLevel; // Used for effects, and Lakitu pick up height. Not necessarily the visual water model height.
96
97#ifdef __cplusplus
98 nlohmann::json to_json() const {
99 nlohmann::json j;
100 // j["Id"] = Id ? Id : "";
101 j["Name"] = Name ? Name : "";
102 j["DebugName"] = DebugName ? DebugName : "";
103 j["CourseLength"] = CourseLength ? CourseLength : "";
104 //j["AIBehaviour"] = AIBehaviour ? AIBehaviour : "";
105 j["LakituTowType"] = LakituTowType;
106 j["AIMaximumSeparation"] = AIMaximumSeparation;
107 j["AIMinimumSeparation"] = AIMinimumSeparation;
108 j["NearPersp"] = NearPersp;
109 j["FarPersp"] = FarPersp;
110
111 // AIDistance as a JSON array
112 j["AIDistance"] = std::vector<int16_t>(AIDistance, AIDistance + 32); // gAIDistances array size of 32
113
114 j["AISteeringSensitivity"] = AISteeringSensitivity;
115
116 // PathSizes - Assuming _struct_gCoursePathSizes_0x10 can be serialized similarly
117 // j["PathSizes"] = PathSizes; // Implement your serialization logic here
118
119 j["CurveTargetSpeed"] = { CurveTargetSpeed[0], CurveTargetSpeed[1], CurveTargetSpeed[2], CurveTargetSpeed[3] };
120 j["NormalTargetSpeed"] = { NormalTargetSpeed[0], NormalTargetSpeed[1], NormalTargetSpeed[2], NormalTargetSpeed[3] };
121 j["D_0D0096B8"] = { D_0D0096B8[0], D_0D0096B8[1], D_0D0096B8[2], D_0D0096B8[3] };
122 j["OffTrackTargetSpeed"] = { OffTrackTargetSpeed[0], OffTrackTargetSpeed[1], OffTrackTargetSpeed[2], OffTrackTargetSpeed[3] };
123
124 // Serialize arrays PathTable and PathTable2 (convert pointers into a JSON array if possible)
125 //j["PathTable"] = {{}};
126 //j["PathTable2"] = {{}};
127 // Populate PathTable and PathTable2
128
129 //j["Clouds"] = Clouds ? nlohmann::json{{"x", Clouds->x, "y", Clouds->y, "z", Clouds->z}} : nullptr;
130 //j["CloudList"] = CloudList ? nlohmann::json{{"x", CloudList->x, "y", CloudList->y, "z", CloudList->z}} : nullptr;
131
132 j["MinimapPosition"] = {Minimap.Pos[0].X, Minimap.Pos[0].Y};
133 j["MinimapPosition2P"] = {Minimap.Pos[1].X, Minimap.Pos[1].Y};
134 j["MinimapPlayerX"] = Minimap.PlayerX;
135 j["MinimapPlayerY"] = Minimap.PlayerY;
136 j["MinimapPlayerScaleFactor"] = Minimap.PlayerScaleFactor;
137 j["MinimapFinishlineX"] = Minimap.FinishlineX;
138 j["MinimapFinishlineY"] = Minimap.FinishlineY;
139 j["MinimapColour"] = {static_cast<int>(Minimap.Colour.r), static_cast<int>(Minimap.Colour.g), static_cast<int>(Minimap.Colour.b)};
140 // SkyboxColors - assuming SkyboxColors can be serialized similarly
141
142 #define TO_INT(value) static_cast<int>(value)
143 j["Skybox"] = {
144 TO_INT(Skybox.TopRight.r), TO_INT(Skybox.TopRight.g), TO_INT(Skybox.TopRight.b),
145 TO_INT(Skybox.BottomRight.r), TO_INT(Skybox.BottomRight.g), TO_INT(Skybox.BottomRight.b),
146 TO_INT(Skybox.BottomLeft.r), TO_INT(Skybox.BottomLeft.g), TO_INT(Skybox.BottomLeft.b),
147 TO_INT(Skybox.TopLeft.r), TO_INT(Skybox.TopLeft.g), TO_INT(Skybox.TopLeft.b),
148 TO_INT(Skybox.FloorTopRight.r), TO_INT(Skybox.FloorTopRight.g), TO_INT(Skybox.FloorTopRight.b),
149 TO_INT(Skybox.FloorBottomRight.r), TO_INT(Skybox.FloorBottomRight.g), TO_INT(Skybox.FloorBottomRight.b),
150 TO_INT(Skybox.FloorBottomLeft.r), TO_INT(Skybox.FloorBottomLeft.g), TO_INT(Skybox.FloorBottomLeft.b),
151 TO_INT(Skybox.FloorTopLeft.r), TO_INT(Skybox.FloorTopLeft.g), TO_INT(Skybox.FloorTopLeft.b)
152 };
153 j["Sequence"] = static_cast<int>(Sequence);
154
155 j["WaterLevel"] = static_cast<float>(WaterLevel);
156 #undef CAST_TO_INT
157
158 return j;
159 }
160
161 // Function to load struct from JSON
162 void from_json(const nlohmann::json& j) {
163 //Id = j.at("Id").get<std::string>().c_str();
164// Name = j.at("Name").get<std::string>().c_str();
165 strncpy(Name, j.at("Name").get<std::string>().c_str(), sizeof(Name) - 1);
166 Name[sizeof(Name) - 1] = '\0'; // Ensure null termination
167
168// DebugName = j.at("DebugName").get<std::string>().c_str();
169 strncpy(DebugName, j.at("DebugName").get<std::string>().c_str(), sizeof(DebugName) - 1);
170 DebugName[sizeof(DebugName) - 1] = '\0'; // Ensure null termination
171
172 // CourseLength = j.at("CourseLength").get<std::string>().c_str();
173 strncpy(CourseLength, j.at("CourseLength").get<std::string>().c_str(), sizeof(CourseLength) - 1);
174 CourseLength[sizeof(CourseLength) - 1] = '\0'; // Ensure null termination
175
176 //AIBehaviour = j.at("AIBehaviour").get<std::string>().c_str();
177 LakituTowType = j.at("LakituTowType").get<int>();
178
179 AIMaximumSeparation = j.at("AIMaximumSeparation").get<float>();
180 AIMinimumSeparation = j.at("AIMinimumSeparation").get<float>();
181 NearPersp = j.at("NearPersp").get<float>();
182 FarPersp = j.at("FarPersp").get<float>();
183
184 const auto temp = j.at("AIDistance").get<std::vector<int16_t>>();
185
186 // Ensure the vector has 32 entries
187 if (temp.size() == 32) {
188 // Copy the data into the existing AIDistances array
189 std::copy(temp.begin(), temp.end(), AIDistance);
190 } else {
191 printf("Course::from_json() AIDistance array not size of 32\n");
192 }
193
194 AISteeringSensitivity = j.at("AISteeringSensitivity").get<uint32_t>();
195
196 // Deserialize PathSizes and other custom structs if needed
197
198 CurveTargetSpeed[0] = j.at("CurveTargetSpeed")[0].get<float>();
199 CurveTargetSpeed[1] = j.at("CurveTargetSpeed")[1].get<float>();
200 CurveTargetSpeed[2] = j.at("CurveTargetSpeed")[2].get<float>();
201 CurveTargetSpeed[3] = j.at("CurveTargetSpeed")[3].get<float>();
202
203 NormalTargetSpeed[0] = j.at("NormalTargetSpeed")[0].get<float>();
204 NormalTargetSpeed[1] = j.at("NormalTargetSpeed")[1].get<float>();
205 NormalTargetSpeed[2] = j.at("NormalTargetSpeed")[2].get<float>();
206 NormalTargetSpeed[3] = j.at("NormalTargetSpeed")[3].get<float>();
207
208 D_0D0096B8[0] = j.at("D_0D0096B8")[0].get<float>();
209 D_0D0096B8[1] = j.at("D_0D0096B8")[1].get<float>();
210 D_0D0096B8[2] = j.at("D_0D0096B8")[2].get<float>();
211 D_0D0096B8[3] = j.at("D_0D0096B8")[3].get<float>();
212
213 OffTrackTargetSpeed[0] = j.at("OffTrackTargetSpeed")[0].get<float>();
214 OffTrackTargetSpeed[1] = j.at("OffTrackTargetSpeed")[1].get<float>();
215 OffTrackTargetSpeed[2] = j.at("OffTrackTargetSpeed")[2].get<float>();
216 OffTrackTargetSpeed[3] = j.at("OffTrackTargetSpeed")[3].get<float>();
217
218 // Deserialize arrays PathTable and PathTable2 similarly
219
220 //Clouds = nullptr; // Deserialize if data is present
221 //CloudList = nullptr; // Deserialize if data is present
222 Minimap.Pos[0].X = j.at("MinimapPosition")[0].get<int32_t>();
223 Minimap.Pos[0].Y = j.at("MinimapPosition")[1].get<int32_t>();
224 Minimap.Pos[1].X = j.at("MinimapPosition2P")[0].get<int32_t>();
225 Minimap.Pos[1].Y = j.at("MinimapPosition2P")[1].get<int32_t>();
226 Minimap.PlayerX = j.at("MinimapPlayerX").get<int32_t>();
227 Minimap.PlayerY = j.at("MinimapPlayerY").get<int32_t>();
228 Minimap.PlayerScaleFactor = j.at("MinimapPlayerScaleFactor").get<float>();
229 Minimap.FinishlineX = j.at("MinimapFinishlineX").get<float>();
230 Minimap.FinishlineY = j.at("MinimapFinishlineY").get<float>();
231 Minimap.Colour.r = j.at("MinimapColour")[0].get<uint8_t>();
232 Minimap.Colour.g = j.at("MinimapColour")[1].get<uint8_t>();
233 Minimap.Colour.b = j.at("MinimapColour")[2].get<uint8_t>();
234 //textures = nullptr; // Deserialize textures if present
235
236 Skybox.TopRight.r = j.at("Skybox")[0].get<uint8_t>();
237 Skybox.TopRight.g = j.at("Skybox")[1].get<uint8_t>();
238 Skybox.TopRight.b = j.at("Skybox")[2].get<uint8_t>();
239
240 Skybox.BottomRight.r = j.at("Skybox")[3].get<uint8_t>();
241 Skybox.BottomRight.g = j.at("Skybox")[4].get<uint8_t>();
242 Skybox.BottomRight.b = j.at("Skybox")[5].get<uint8_t>();
243
244 Skybox.BottomLeft.r = j.at("Skybox")[6].get<uint8_t>();
245 Skybox.BottomLeft.g = j.at("Skybox")[7].get<uint8_t>();
246 Skybox.BottomLeft.b = j.at("Skybox")[8].get<uint8_t>();
247
248 Skybox.TopLeft.r = j.at("Skybox")[9].get<uint8_t>();
249 Skybox.TopLeft.g = j.at("Skybox")[10].get<uint8_t>();
250 Skybox.TopLeft.b = j.at("Skybox")[11].get<uint8_t>();
251
252 Skybox.FloorTopRight.r = j.at("Skybox")[12].get<uint8_t>();
253 Skybox.FloorTopRight.g = j.at("Skybox")[13].get<uint8_t>();
254 Skybox.FloorTopRight.b = j.at("Skybox")[14].get<uint8_t>();
255
256 Skybox.FloorBottomRight.r = j.at("Skybox")[15].get<uint8_t>();
257 Skybox.FloorBottomRight.g = j.at("Skybox")[16].get<uint8_t>();
258 Skybox.FloorBottomRight.b = j.at("Skybox")[17].get<uint8_t>();
259
260 Skybox.FloorBottomLeft.r = j.at("Skybox")[18].get<uint8_t>();
261 Skybox.FloorBottomLeft.g = j.at("Skybox")[19].get<uint8_t>();
262 Skybox.FloorBottomLeft.b = j.at("Skybox")[20].get<uint8_t>();
263
264 Skybox.FloorTopLeft.r = j.at("Skybox")[21].get<uint8_t>();
265 Skybox.FloorTopLeft.g = j.at("Skybox")[22].get<uint8_t>();
266 Skybox.FloorTopLeft.b = j.at("Skybox")[23].get<uint8_t>();
267
268 Sequence = static_cast<MusicSeq>(j.at("Sequence").get<int>());
269 WaterLevel = j.at("WaterLevel").get<float>();
270 }
271 void SetText(char* name, const char* title, size_t bufferSize) {
272 // Copy the title into the name buffer, ensuring it's null-terminated and within bounds
273 std::strncpy(name, title, bufferSize - 1);
274 name[bufferSize - 1] = '\0'; // Ensure the string is null-terminated
275 }
276
277 const char* GetName() {
278 return Name;
279 }
280
281 void New() {
282 SetText(Name, "", sizeof(Name));
283 SetText(DebugName, "", sizeof(DebugName));
284 SetText(CourseLength, "", sizeof(CourseLength));
285 }
286#endif
287
289
290#ifdef __cplusplus
291
292
293class World; // <-- Forward declare
294
295class Course {
296
297public:
298 std::string Id;
299 Properties Props;
300
301 // This allows multiple water levels in a map.
302 // Ex. DK Jungle where there's a waterfall and you can drive above and below it.
303 std::vector<WaterVolume> WaterVolumes;
304
305 const char* vtx = nullptr;
306 const char* gfx = nullptr;
307 size_t gfxSize = 0;
308 const course_texture* textures = nullptr;
309 bool bSpawnFinishline = true;
310 std::optional<FVector> FinishlineSpawnPoint;
311
312 // O2R Loading
313 std::shared_ptr<Ship::Archive> RootArchive;
314 std::string SceneFilePtr;
315 std::string TrackSectionsPtr;
316
317 bool bIsMod = false;
318 std::vector<SpawnParams> SpawnList;
319
320 virtual ~Course() = default;
321
322 explicit Course();
323
324 virtual void LoadO2R(std::string trackPath); // Load custom track from o2r
325 virtual void Load(); // Decompress and load stock courses or from o2r but TrackSectionsPtr must be set.
326 virtual void Load(Vtx* vtx, Gfx *gfx); // Load custom track from code. Load must be overridden and then call to this base class method impl.
327 virtual void LoadTextures();
328 virtual void ParseCourseSections(TrackSectionsO2R* sections, size_t size);
329
334 virtual void BeginPlay();
335 void SpawnActors();
336 virtual void TestPath();
337 virtual void InitClouds();
338 virtual void UpdateClouds(s32, Camera*);
339 virtual void SomeCollisionThing(Player *player, Vec3f arg1, Vec3f arg2, Vec3f arg3, f32* arg4, f32* arg5, f32* arg6, f32* arg7);
340 virtual void InitCourseObjects();
341 virtual void UpdateCourseObjects();
342 virtual void RenderCourseObjects(s32 cameraId);
343 virtual void SomeSounds();
344 virtual void CreditsSpawnActors();
345 virtual void WhatDoesThisDo(Player*, int8_t);
346 virtual void WhatDoesThisDoAI(Player*, int8_t);
347 virtual void SetStaffGhost();
348 virtual void Render(struct UnkStruct_800DC5EC*);
349 virtual void RenderCredits();
350 virtual void Waypoints(Player* player, int8_t playerId);
351 virtual f32 GetWaterLevel(FVector pos, Collision* collision);
352 virtual void ScrollingTextures();
353 virtual void DrawWater(struct UnkStruct_800DC5EC* screen, uint16_t pathCounter, uint16_t cameraRot,
354 uint16_t playerDirection);
355 virtual void Destroy();
356 virtual bool IsMod();
357
358 private:
359 void Init();
360};
361
362#endif
363
364#endif // ENGINE_COURSE_H
struct Properties Properties
void ResizeMinimap(MinimapProps *minimap)
Definition Course.cpp:33
Definition World.h:34
f32 Vec3f[3]
Definition common_structs.h:10
f32 Vec4f[4]
Definition common_structs.h:11
#define j
void SpawnActors(std::vector< std::pair< std::string, SpawnParams > > spawnList)
void Destroy()
Definition ImguiUI.cpp:97
@ f32
Definition GenericArray.h:59
struct StarData CloudData
MusicSeq
Definition sounds.h:118
Definition CoreMath.h:115
Definition Course.h:54
IVector2D Pos[2]
Definition Course.h:58
int16_t Width
Definition Course.h:56
RGB8 Colour
Definition Course.h:64
float FinishlineY
Definition Course.h:63
int32_t PlayerY
Definition Course.h:60
const char * Texture
Definition Course.h:55
float PlayerScaleFactor
Definition Course.h:61
float FinishlineX
Definition Course.h:62
int32_t PlayerX
Definition Course.h:59
int16_t Height
Definition Course.h:57
Definition Course.h:69
char Name[128]
Definition Course.h:70
uint8_t * CloudTexture
Definition Course.h:89
const course_texture * textures
Definition Course.h:93
_struct_gCoursePathSizes_0x10 PathSizes
Definition Course.h:82
TrackPathPoint * PathTable2[5]
Definition Course.h:88
CloudData * Clouds
Definition Course.h:90
Vec4f D_0D0096B8
Definition Course.h:85
Vec4f CurveTargetSpeed
Definition Course.h:83
float AIMaximumSeparation
Definition Course.h:76
float WaterLevel
Definition Course.h:95
int32_t LakituTowType
Definition Course.h:73
Vec4f OffTrackTargetSpeed
Definition Course.h:86
uint32_t AISteeringSensitivity
Definition Course.h:81
TrackPathPoint * PathTable[4]
Definition Course.h:87
const char * AIBehaviour
Definition Course.h:75
char CourseLength[128]
Definition Course.h:72
float NearPersp
Definition Course.h:78
SkyboxColours Skybox
Definition Course.h:92
float AIMinimumSeparation
Definition Course.h:77
enum MusicSeq Sequence
Definition Course.h:94
int16_t * AIDistance
Definition Course.h:80
char DebugName[128]
Definition Course.h:71
CloudData * CloudList
Definition Course.h:91
float FarPersp
Definition Course.h:79
MinimapProps Minimap
Definition Course.h:74
Vec4f NormalTargetSpeed
Definition Course.h:84
Definition common_structs.h:427
Definition Course.h:30
RGB8 BottomLeft
Definition Course.h:33
RGB8 FloorBottomRight
Definition Course.h:36
RGB8 BottomRight
Definition Course.h:32
RGB8 FloorBottomLeft
Definition Course.h:37
RGB8 TopRight
Definition Course.h:31
RGB8 TopLeft
Definition Course.h:34
RGB8 FloorTopRight
Definition Course.h:35
RGB8 FloorTopLeft
Definition Course.h:38
Definition waypoints.h:14
Definition Course.h:46
float Height
Definition Course.h:47
float MaxX
Definition Course.h:49
float MinZ
Definition Course.h:50
float MinX
Definition Course.h:48
float MaxZ
Definition Course.h:51
Definition path_spawn_metadata.h:9
Definition course_offsets.h:10