⚙️NPC Setup Guide

🎅 Santa Claus Ped – Setup Guide

If you want to use the Santa NPC in your risk-xmasvevent script, you can use this ped:

Santa Claus Add-On Ped by JR59 https://www.gta5-mods.com/player/santa-claus-add-on-ped

Full credits go to JR59 for creating and releasing the Santa Claus ped.

---

📦 Download & Extract

1. Download the Santa Claus ped from the link above.

2. Inside the archive, open the folder Santa Claus by JR59.

3. Extract the entire content of this folder and drag all files to your Desktop.

You should now have all Santa files on your Desktop.

---

👤 Replace an existing NPC ped

You can replace any ped model you want by renaming the files.

1. Choose a ped you want to replace, for example: ig_bankman (You can find more ped models here: https://docs.fivem.net/docs/game-references/ped-models/)

2. It is recommended to use an NPC ped that you barely use on your server, e.g. ig_bankman.

3. Rename all Santa files from their original name (e.g. Santaclaus) to the ped you want to replace, for example:

• Santaclaus.ydd → ig_bankman.ydd

• Santaclaus.yft → ig_bankman.yft

• Santaclaus.ytd → ig_bankman.ytd

• Santaclaus.ymt → ig_bankman.ymt

1. After renaming, move all these files into the stream folder of your risk-xmasevent resource.

---

🔧 Config Setup (config.lua)

Open your config.lua and find:

RISK.Shop = { -- Christmas shop location and settings
    coords = vector4(199.2881, -933.1703, 30.6868, 326.4328), -- Shop position and heading
    
    ped = { -- NPC Santa configuration
        enabled = false,
        model = "ig_bankman"
    },

Adjust it as follows:

• Set enabled to true

• Set model to the ped you replaced (for example ig_bankman)

RISK.Shop = { -- Christmas shop location and settings
    coords = vector4(199.2881, -933.1703, 30.6868, 326.4328), -- Shop position and heading
    
    ped = { -- NPC Santa configuration
        enabled = true,
        model = "ig_bankman"
    },
}

If you used a different ped name, make sure model matches that name.

---

📜 Replace your fxmanifest.lua

Replace your existing fxmanifest.lua with the following:

fx_version 'adamant'
lua54 'yes'
game 'gta5'

description 'risk-scripts.tebex.io'
version '1.0'

ui_page 'html/index.html'

files {
    'html/**/**.*',
    'stream/jrbXMAS_Present_Crate.ytyp',
    'stream/ig_bankman.ydd',
    'stream/ig_bankman.yft',
    'stream/ig_bankman.ytd',
    'stream/ig_bankman.ymt'
}

data_file 'DLC_ITYP_REQUEST' 'stream/jrbXMAS_Present_Crate.ytyp'
data_file 'PED_METADATA_FILE' 'stream/ig_bankman.ymt'

shared_scripts {
    'config.lua'
}

client_scripts {
    'main/client.lua'
}

server_scripts {
    'main/server.lua'
}

If you used a different ped model name instead of ig_bankman, make sure you also update all file names in the files section and the PED_METADATA_FILE line accordingly.

---

🔄 Final Step

• Restart your server

• The Santa NPC should now appear at your shop location and use the replaced ped model.