Log in to reply

[.NET] [C#] [SHVDN] Modding Basics! Vector3s and Vehicles Manipulation [Part 3]

  • Hello guys! Wussap. I know its been a long time since I posted a tutorial, and tbh I really don't have a good excuse for that :( I was just lazy. BUT in this part of the series, we'll see how to manipulate vehicles and that sort of things.

    Knowledge of the last tutorial(s)

    What we'll learn to do in this part

    • Learn Vector3s(i.e. what positions are called in script, and how to manipulate them)
    • Spawning vehicles
    • Doing stuff with them

    There is one main thing you should know about GTA 5 or really any other 3D game in existence.. Vector3

    What is Vector3 you ask? Well, a vector3 consists of three float variables, X, Y and Z. All of these variables are coordinates indicating to a point in the game world. X and Y are the left and right coordinates, and the Z is the height coordinate, the 3 Dimensions. Brackeys, a game developer has a very good video explaining game math, which you should totally check out:

    Spawning Cars
    All world related functions, which includes spawning a car, is stored in a static class World. We can use World.CreateVehicle to spawn a specific car at a specific position(Vector3) with a specific rotation.

    Finally, we come to the good stuff ;). To make our code organized I'll make a function for spawning cars easily:
    alt text

    I'll make the car spawn 5 units in front of the player, but you can edit that easily. There is a very awesome helper function in Game.Player.Character which is GetOffsetInWorldCoords. It gives you the offset in world coords(lol). I'll first make a Vector3 variable:
    alt text
    And then get the player:
    alt text
    And then use the helper function I mentioned above!
    alt text
    This function requires a Vector3 offset, so if we want the car to spawn 5 units in front of us, we'll use new Vector3(0, 5, 0) or if we want it, say, 5 units in front of us(lol), we'll use new Vector3(0, 0, 5). I don't know why anyone would want to use it but ¯_(ツ)_/¯.

    So now that we have the spawn position, lets spawn our car! To do that, we use the above function, World.CreateVehicle:
    alt text
    This function takes in two parameters, the Model or the model hash of the vehicle we want to spawn, and the position. We already declared a position, so all we have to do is get the model. Luckily, SHVDN has a whole enum full of all the hashes for all the vehicles in the game, and we can spawn them easily. The enum is called VehicleHash. We'll spawn the turismo.
    alt text
    SHVDN converts the VehicleHash into a Model, so we dont have to worry about that :). As you can see, the second parameter is the spawning position, so we'll pass the one we got above.

    Alright! So our function is ready but we aren't calling it anywhere. The most traditional way to test something is by keybinds sooo lets add that in. Later on, we'll learn to use INI files for configuration of keys too.
    alt text
    Alright! So now our script spawns a vehicle when we press U! Go ahead and test it in game. When you're done, come back and I'll teach you a few tricks you can do with the car you spawned :)

    Manipulating the vehicle
    The World.CreateVehicle function returns the car it created/spawned so we can use that to get the vehicle. Lets store it in a variable:
    alt text
    Now, you can do literally anything you want with this vehicle! All you have to do, is type in the name of the car, then press the "dot" key(.). Look at all the things you can do!
    alt text

    If I explained each and every one of them, it would take days, so I wont bother :laughing:. Just experiment, see what works and what doesn't. If you're confused with anything, ask here and I'll reply back to tell you how it works.

    But anyways guys, in the next tutorial, we'll learn about loading stuff from INIs. But till then bye.

  • @GTAVModder4Life hey dude, me again :laughing:
    my code looks a little bit different because i want to spawn add-on cars.
    how can i check if the model is valid?
    what if we are already in a vehicle? we have to add something like "...is no longer needed..." so can you please add those two lines to your tutorial for a good vehicle spawn function or at least tell me how i can implement it in my code
    thank you

    you talked about vector, but out there it gives only one real vector ;)

  • @TobsiCred Alright, so first of all.. if you did Function.Call(Hash.SET_VEHICLE_MOD_KEY, v.Handle, 0);
    then there is no need to call v.InstallModKit();
    I think thats why that code isn't working.

    second of all. I don't need to check if it is valid because its a vanilla or unmodded vehicle. I know it will always be valid since its in the game. If you want to do add-on vehicles, you can do something like this:

        void SpawnCar()
            Vector3 spawnPos = Game.Player.Character.GetOffsetInWorldCoords(new Vector3(0, 5, 0));
            Model addonModel = new Model("yourYFTModelNameHere");
            Vehicle spawnedCar;
            if (addonModel.IsValid)
                spawnedCar = World.CreateVehicle(addonModel, spawnPos);

    If the else statement is run, that means the user doesnt have the vehicle. So you can send the message there :)

    Third of all. I am not wrapping myself inside the vehicle I spawn. So, I don't care if I'm in a vehicle, at least for this mod. Though doing v.MarkAsNoLongerNeeded() after spawning the car is good practice since it releases it from memory. I'll add that next tutorial :).

  • @GTAVModder4Life i know ;) Function.Call(Hash.SET_VEHICLE_MOD_KEY, v.Handle, 0); didnt work for me for some reason so i tried the other code instead but same effort :disappointed:

    yes, you`re right dont need to check ingame models. my fault
    thanks for the code, work :thumbsup:

Log in to reply

Looks like your connection to GTA5-Mods.com Forums was lost, please wait while we try to reconnect.