Installation and configuration

To install this Script, simply unzip the downloaded zip folder and drag and drop the loki_luftrettung folder into your resources. Then just refresh your resources and start the script. To add the script to autostart, move the script to a folder inside your resources which gets autostarted, or add ensure loki_luftrettung to your server.cfg or an external .cfg file for starting scripts. It is not needed to install anything database related. Down here, I will guide you through the different Config options in the config.lua file to properly setup the script.

Framework

This script needs your framework for only one single reason, checking the players job. If you did not enable the job check feature, the script is completely standalone. If you want to use a custom framework that is not ESX, QBCore or QBOX, go to the client/custom.lua file and implement support for it. If you do run one of the previously listed frameworks, the script detects it automatically and works out of the box.

Config.Job

Config.Job = 'ambulance'

Whith this setting, you can restrict the interaction marker for the helipad to a specific Job. For example in this case, only players with the job ambulance can see and interact with the marker. For this setting one of these Frameworks is required: ESX, QB-Core or QBOX. Alternatively add support for your own as stated in Framework. You can set this to nil or false to make the marker available for any player. If you set this to nil/false, the script does not need any framework to run.

Config.Locale

Config.Locale = "en"

This setting is used to change the languge. Currently the translations are only used for the help text when standing in the marker. You can set this to "de" or "en" by default. You can also edit the locales/*.lua files for your own translations.

Config.DefaultPosition

Config.DefaultPosition = "inside"

This setting determins, whether the helipad spawns inside or outside the hangar when starting the script. You can set this to either "inside", or "outside".

Config.InteractionKey

Config.InteractionKey = 38

This is the key, used to interact with the marker. 38 is the E key. The IDs for other keys can be found in the FiveM Documentation.

Config.LoopWait

Config.LoopWait = 20

This is the time assigned to waits after each run of the loop used to move the helipad in ms. A higher value means better performance since the helipads position is updated less frequently, while a lower value leads to a smoother animation. 20ms is equivalent to about every second frame at 60 fps.

Config.Marker

Config.Marker = {
    position = vector3(-1359.0, -3347.1, 12.9),
    type = 1,
    rotation = {
        x = 0.0,
        y = 0.0,
        z = 0.0
    },
    scale = 1.0,
    color = {
        r = 110,
        g = 243,
        b = 243
    },
    transparency = 100,
    bop = false,
    faceCamera = false,
    rotate = false,
}

These are the setting for the marker. Position is just the coords of the marker. Type is the marker type, what each type is can be found here. Rotation is the markers rotation around the x y and z axis, for most markers I recommend not to tuch those. But if you decide you still want to try around, feel free to do so. Scale is simply the size of the marker. Color represents the markers color as RGB value. Thats the red, green and blue part of the color, together making your desired color. These values range from 0 (no color at all) to 255 (full color). You can use a color picker to find the values for the color you want. transparency is also part of the color, making it a RGBA value. In this case due to fivem, it also ranges from 0 to 255 wit h0 being the lowest and 255 the highest amount of visibility. Bop will make the marker constantly bop up and down slowly. faceCamera will overwrite the rotation and make the Marker always face the players camera. Rotate means the marker will constantly slowly rotate around itself.

Config.DefaultOffset

Config.DefaultOffset = vector3(0.0, 0.0, 1.0)

This is the offset used when attatching the helicopter to the helipad while moving the helipad. These values are used when there is no custom value specified in Config.CustomOffsets

Config.CustomOffsets

Config.CustomOffsets = {
    [`cargobob`] = vector3(0.0, 0.0, 1.5),
}

These are custom offsets that can be used instead of the default ones, for example for models where the center of the model is not the center of the visual part. Inside the brackets goes the model name, you have to use backticks to convert the model name to the hash.

Still need help?

If you still have any questions or problems, feel free to join our discord and open a Ticket.

https://discord.gg/CfnuaArDBk