Creating Maps

Map Structure

R_FFA uses two separate configurations:

Maps - Define available maps with weapons and settings
Arenas - Define physical arena locations and zones

Creating a Map

Add to R.Maps in config.lua:

R.Maps = {
    {
        Name = "Pistol Arena",
        Image = "https://your-image-url.png",
        Description = "Only pistols allowed",
        Weapons = {
            "weapon_pistol",
            "weapon_pistol_mk2",
            "weapon_combatpistol",
        },
        MaxPlayers = 20,
        UseArmor = true,
        MapId = 1, -- Must match Arena
    },
}

Map Parameters

Parameter	Type	Description
`Name`	string	Display name of the map
`Image`	string	URL to map image
`Description`	string	Short description
`Weapons`	table	List of weapon spawn names
`MaxPlayers`	number	Maximum players allowed
`UseArmor`	boolean	Give players armor
`MapId`	number	Links to Arena

Creating an Arena

Add to R.Arenas in config.lua:

R.Arenas = {
    {
        Name = "Pistol Arena",
        Image = "https://your-image-url.png",
        Route = 3131456579, -- route for that arena (do not use same for 2)
        Is1v1Map = false,

        -- 1v1 spawn points (required for 1v1 maps)
        P1Spawn = vector3(-268.64, -1584.75, 31.84),
        P2Spawn = vector3(-262.80, -1556.67, 31.84),

        -- FFA spawn points
        SpawnPoints = {
            vec3(-58.20, 6487.37, 31.50),
            vec3(-40.94, 6456.73, 35.25),
            vec3(-42.51, 6415.77, 31.49),
        },

        -- Arena zone
        ZoneType = "Sphere",
        RadiusOrThickness = 90.0,
        Coords = vec3(-111.86, 6421.03, 31.43),
    },
}

Arena Parameters

Parameter	Type	Description
`Name`	string	Must match Map name
`Image`	string	URL to arena image
`Route`	number	Use different route for each map
`Is1v1Map`	boolean	Enable 1v1 mode
`P1Spawn`	vector3	Player 1 spawn (1v1)
`P2Spawn`	vector3	Player 2 spawn (1v1)
`SpawnPoints`	table	List of FFA spawn points
`ZoneType`	string	”Sphere” or “Poly”
`RadiusOrThickness`	number	Zone size/thickness
`Coords`	vector3	Zone center

Getting Coordinates

Go to Location

Travel to your desired arena location

Get Coordinates

Use a coordinate script or command like /coords

Copy Values

Copy the coordinates

Add to Config

Paste into your arena configuration

Example: Creating a 1v1 wager Map

-- Add to R.Arenas 

{
    Name = "1v1 Pistols",
    Image = "https://example.com/1v1.png",
    Route = 9457459283,
    Is1v1Map = true,

    P1Spawn = vector3(100.0, 200.0, 30.0),
    P2Spawn = vector3(110.0, 200.0, 30.0),

    SpawnPoints = {
        vector3(100.0, 200.0, 30.0),
        vector3(110.0, 200.0, 30.0),
    },

    ZoneType = "Sphere",
    RadiusOrThickness = 25.0,
    Coords = vec3(105.0, 200.0, 30.0),
}

Weapon Configuration

Available weapons for custom lobbies / wagers are defined in R.Weapons:

R.Weapons = {
    "weapon_pistol",
    "weapon_pistol_mk2",
    "weapon_vintagepistol",
    "weapon_combatpistol",
    -- Add more weapons here
}

Weapon Labels

Customize weapon names:

R.WeaponLabels = {
    weapon_pistol = "Pistol",
    weapon_pistol_mk2 = "Pistol MK2",
    -- Add more labels
}

Component Images

Customize weapon component icons:

R.ComponentImages = {
    suppressors = 'nui://ox_inventory/web/images/at_suppressor_light.png',
    extended_clips = 'nui://ox_inventory/web/images/at_clip_extended_pistol.png',
    grips = 'nui://ox_inventory/web/images/at_grip.png',
    scopes = 'nui://ox_inventory/web/images/at_scope_small.png',
    flashlights = 'nui://ox_inventory/web/images/at_flashlight.png',
    magazines = 'nui://ox_inventory/web/images/at_clip_drum_rifle.png'
}

Zone Types

Sphere Zone

Simple circular zone:

ZoneType = "Sphere",
RadiusOrThickness = 50.0, -- Radius
Coords = vec3(0.0, 0.0, 0.0), -- Center point

Polygon Zone

Complex shaped zone (future feature):

ZoneType = "Poly",
RadiusOrThickness = 5.0, -- Wall thickness
-- Define polygon points

Testing Your Map

Enable Debug

R.ZoneDebug = true

Restart Resource

ensure r_ffa

Join Arena

Join your new map and test spawn points

Check Zones

Verify the zone boundaries are correct

Disable Debug

R.ZoneDebug = false

Tips

Start with small arenas (20-30m radius)
Test spawn points don’t overlap
Balance armor with weapon power
Add multiple spawn points to prevent camping

Configuration Guide

Back to configuration

Getting Started

Paid Resources

Map Structure

Creating a Map

Map Parameters

Creating an Arena

Arena Parameters

Getting Coordinates

Example: Creating a 1v1 wager Map

Weapon Configuration

Weapon Labels

Component Images

Zone Types

Sphere Zone

Polygon Zone

Testing Your Map

Tips

Configuration Guide

​Map Structure

​Creating a Map

​Map Parameters

​Creating an Arena

​Arena Parameters

​Getting Coordinates

​Example: Creating a 1v1 wager Map

​Weapon Configuration

​Weapon Labels

​Component Images

​Zone Types

​Sphere Zone

​Polygon Zone

​Testing Your Map

​Tips

Configuration Guide

Map Structure

Creating a Map

Map Parameters

Creating an Arena

Arena Parameters

Getting Coordinates

Example: Creating a 1v1 wager Map

Weapon Configuration

Weapon Labels

Component Images

Zone Types

Sphere Zone

Polygon Zone

Testing Your Map

Tips