Configuration

Configuration for Red Multichar AIO

All main configuration is done in config.lua. Let's go through each section:

Basic Settings

Config.DevMode = true  -- Enable/disable developer mode (debug prints)
Config.Align = "top-left"  -- Menu alignment (top-left, top-right, center)

DevMode: When enabled, you'll see debug messages in the F8 console. Disable this in production.

Language Settings

Lang = "English"  -- Available: English, Spanish, French, German, Portuguese
Config.ServerLogo = "https://your-discord-cdn-link.com/logo.png"

The server logo appears in the character selection screen. Upload your logo to Discord and copy the CDN link.

Character Creation Settings

Config.BannedNames = { "Arthur", "Marshton", "Shit", "Dick" }

Players cannot use these names when creating characters. Add more words as needed.

Config.AllowPlayerDeleteCharacter = true

• true: Players can delete their own characters

• false: Only admins can delete characters

Config.ReloadCharCommand = "rc"

Command to reload character skin (useful after changing clothes). Players use /rc in-game.

Initial Animation Scene

Config.UseInitialAnimScene = true

• true: Shows the Red Dead Online style intro animation when creating a character

• false: Skips the animation and goes straight to character creator

Spawn Coordinates (After Character Creation)

Config.SpawnCoords = {
    { 
        position = vector3(-265.79, 795.91, 118.55),  -- X, Y, Z coordinates
        heading = 100.08,  -- Direction player faces
        label = "Valentine",  -- Location name
        camera = vector4(-264.95, 795.37, 119.45, 98.05)  -- Camera position
    },
    -- Add more spawn locations...
}

What is this? After a player creates their character, they will spawn at one of these locations. The script picks a random location from this list.

How to add a new location:

1. Go to the location in-game

2. Use /getcoords (if you have a coord script) or F8 console

3. Add a new entry to the table:

{
    position = vector3(X, Y, Z),  -- Player spawn position
    heading = HEADING,  -- Direction (0-360)
    label = "Your Location Name",
    camera = vector4(CAM_X, CAM_Y, CAM_Z, CAM_HEADING)  -- Camera looking at player
}

---

Shop Configuration

All shop settings are in config_shops.lua.

Enable/Disable Shops

ConfigShops.UseShops = true  -- Set to false to disable all shops

Second Chance Pricing

ConfigShops.SecondChancePrice = 15000  -- Price for full character edit
ConfigShops.SecondChanceCurrency = 0  -- 0=cash, 1=gold, 2=tokens

Second Chance shops allow players to completely edit their character (appearance, body, etc.) after creation.

Shop Types

You can create different types of shops:

• clothing - Buy clothes, hats, boots, etc.

• hair - Change hairstyle, beard, eyebrows

• makeup - Lipstick, blush, eyeliner, etc.

• face - Facial features, teeth, eyes

• lifestyle - Scars, acne, freckles, moles

• secondchance - Full character editor (all features)

Adding a Shop Location

Here's a complete example with explanations:

{
    -- Prompt configuration (where player interacts)
    Prompt = {
        Position = vector3(-326.1, 774.48, 117.46),  -- Where the prompt appears
        Label = "Clothing Store",  -- Text shown to player
    },
    
    -- NPC configuration (shop keeper)
    Npc = {
        Enable = true,  -- Set to false to remove NPC
        Model = "CS_FRANCIS_SINCLAIR",  -- NPC model name
        Position = vector4(-325.55, 773.02, 116.44, 15.63),  -- X, Y, Z, Heading
        Scenario = 'WORLD_HUMAN_STAND_WAITING',  -- NPC animation (optional)
    },
    
    -- Map blip configuration
    Blip = {
        Enable = true,  -- Set to false to hide from map
        Sprite = 1195729388,  -- Blip icon hash
        Name = "Clothing Store",  -- Name shown on map
        -- Color = 'BLIP_MODIFIER_MP_COLOR_23',  -- Optional color
    },
    
    -- Editor location (where player is teleported during editing)
    EditCharacter = {
        Position = vector4(-329.43, 775.29, 121.63, 278.17),
    },
    
    -- Return location (where player spawns after finishing)
    SpawnBack = {
        Position = vector4(-323.12, 774.47, 121.63, 186.42),
    },
    
    -- Camera settings for the editor
    CameraPosition = {
        Position = vector3(-327.38, 775.48, 122.00),  -- Camera location
        Heading = 97.6,  -- Camera rotation
        MaxUp = 122.75,  -- Maximum Z height camera can move
        MaxDown = 120.91,  -- Minimum Z height camera can move
    },
    
    TypeOfShop = "clothing",  -- Shop type (see list above)
    DrawLight = false,  -- Enable spotlight in shop (true/false)
}

Shop Pricing

Scroll down in config_shops.lua to find:

ConfigShops.Prices = {
    clothing = {
        Hat = { price = 100 },
        Shirt = { price = 150 },
        Pant = { price = 120 },
        Boots = { price = 180 },
        -- More categories...
        
        -- Special pricing for specific items
        Hat = {
            price = 100,
            extra = {
                { comp = 0x12345678, price = 500 },  -- This specific hat costs $500
            }
        },
    },
    
    hair = {
        Hair = { price = 50 },
        Beard = { price = 30 },
        eyebrows = { price = 20 },
    },
    
    makeup = {
        lipsticks = { price = 25 },
        blush = { price = 20 },
    },
    
    face = {
        Teeth = { price = 100 },
        jaw = { price = 200 },
        chin = { price = 200 },
    },
    
    lifestyle = {
        scars = { price = 50 },
        acne = { price = 30 },
    }
}

How to change prices:

1. Find the category you want to change

2. Update the price value

3. Save and restart the resource

---

Camera Zoom Settings

The character creator uses dynamic camera zoom when you select different categories (hair, face, boots, etc.).

Configuration

In config.lua, find Config.CameraZoomSettings:

Config.CameraZoomSettings = {
    hair = {
        zOffset = 0.60,   -- Camera height offset (positive = up, negative = down)
        fov = 15.0        -- Field of view (lower = closer zoom, higher = wider view)
    },
    
    -- Appearance categories
    beard = { zOffset = 0.60, fov = 15.0 },  -- Close-up on face
    eyebrows = { zOffset = 0.60, fov = 15.0 },
    eyes = { zOffset = 0.60, fov = 15.0 },
    makeup = { zOffset = 0.60, fov = 15.0 },
    
    body = { zOffset = 0.0, fov = 50.0 },  -- Full body view
    heritage = { zOffset = 0.0, fov = 50.0 },
    
    -- Clothing categories
    hat = { zOffset = 0.60, fov = 15.0 },  -- Zoom on head
    mask = { zOffset = 0.60, fov = 15.0 },
    
    shirt = { zOffset = 0.20, fov = 35.0 },  -- Upper body
    vest = { zOffset = 0.20, fov = 35.0 },
    
    pant = { zOffset = -0.20, fov = 40.0 },  -- Lower body
    boots = { zOffset = -0.50, fov = 25.0 },  -- Feet close-up
    
    -- Default for other categories
    default = { zOffset = 0.0, fov = 50.0 }
}

Understanding the Values

zOffset (Camera Height):

• 0.60 = Camera moves up (for head/face)

• 0.0 = Camera at default height (full body)

• -0.50 = Camera moves down (for feet/boots)

FOV (Field of View):

• 15.0 = Very close zoom (for detailed items like hair)

• 35.0 = Medium zoom (for upper body items)

• 50.0 = Wide view (for full body)

Customization Example

If you want players to see more of their character when selecting shirts:

shirt = {
    zOffset = 0.10,  -- Slightly up (was 0.20)
    fov = 45.0       -- Wider view (was 35.0)
},

Helper Commands

Use these commands in-game to find perfect camera positions:

Get current camera position:

/getcampos

Returns: camera = vector4(x, y, z, heading) - Copy this to your config!

Preview camera position:

/previewcam x y z heading

Example: /previewcam -264.95 795.37 119.45 98.05

Adjust camera heading while previewing:

/setheading 180

Show all helper commands:

/spawncamhelp

---

Spawn Points & Job Locations

Character Selection Spawn Points

These are the locations shown in the character selection screen (where players choose where to spawn).

Config.SpawnPoints = {
    {
        name = "Valentine",  -- Display name
        description = "A bustling town in the Heartlands",  -- Short description
        coords = vector4(-275.5, 804.2, 119.4, 2.0),  -- Spawn location
        camera = {
            pos = vector3(-270.0, 810.0, 125.0),  -- Camera position
            rot = vector3(-10.0, 0.0, 45.0),  -- Camera rotation
            fov = 50.0  -- Camera zoom
        }
    },
    -- Add more spawn points...
}

Players can choose between:

1. Spawn points (shown as a list)

2. Last location (where they logged out)

3. Job location (if they have a job)

Job Locations

Configure spawn points for specific jobs:

Config.JobLocations = {
    ["unemployed"] = vector4(-275.5, 804.2, 119.4, 2.0),  -- Valentine
    ["sheriff"] = vector4(2634.5, -1225.3, 53.4, 180.0),  -- Saint Denis Sheriff
    ["doctor"] = vector4(-1805.2, -428.7, 158.8, 180.0),  -- Strawberry
    -- Add more jobs...
}

Format: ["job_name"] = vector4(x, y, z, heading)

How it works:

• When a player selects "Job Location" in character selection, they spawn at their job's coordinates

• If their job is not in the list, they won't see the "Job Location" option

• The job_name must match exactly with your VORP Core job names

Adding New Spawn Points

1. Go to the location in-game where you want players to spawn

2. Use /getcoords to get your position

3. Add to Config.SpawnPoints or Config.JobLocations

4. Save and restart resource

Example: Adding a new spawn point

{
    name = "Emerald Ranch",
    description = "A quiet ranch in the Heartlands",
    coords = vector4(1440.5, 279.3, 88.9, 90.0),  -- Your coordinates here
    camera = {
        pos = vector3(1435.0, 279.3, 95.0),  -- Camera looks at spawn point
        rot = vector3(-15.0, 0.0, 270.0),
        fov = 55.0
    }
}

---

UI Customization

Server Logo

Change the logo in character selection:

Config.ServerLogo = "https://your-cdn-link.com/logo.png"

How to get a CDN link:

1. Upload your logo to any Discord server

2. Click the image

3. Click "Open in Browser"

4. Copy the URL (it will be like https://cdn.discordapp.com/...)

Social Links

Add social media links to the character selection screen:

Config.SocialLinks = {
    {
        name = "Discord",
        icon = "discord-icon.png",
        url = "https://discord.gg/yourserver"
    },
    {
        name = "Website",
        icon = "web-icon.png",
        url = "https://yourserver.com"
    }
}

Credits

Add credits for your team:

Config.Credits = {
    {
        role = "Server Owner",
        name = "YourName",
        description = "Founder & Developer"
    },
    {
        role = "Developer",
        name = "AnotherName",
        description = "Lead Programmer"
    }
}

---