RX Murals Configuration

RX Murals keeps its settings in config.lua. This file controls how painting feels, how pictures are rendered, how far murals are drawn, who may administer them, and how much the server accepts.

Restart rx_murals after changing the configuration so server limits and client rendering stay aligned.

General

Config.Locale = 'en'
Config.Notify = 'toast'
Config.WallOffset = 0.02

English (en) and Turkish (tr) are included. To add a language, copy locales/en.lua, translate it, and set Locale to the new file name. Any key missing from a translation falls back to English.

Raise WallOffset slightly only if paint flickers into a particular wall. Too high a value makes murals look like they float.

Painting

Config.Paint controls the painting area, the brush, the palette, and paint depletion.

Config.Paint = {
    minSide = 0.25,
    maxSide = 3.0,

    brushMin = 0.01,
    brushMax = 0.12,
    brushStep = 0.01,
    brushDefault = 0.03,

    allowCustomColor = true,

    detailEpsilon = 0.32,
    spacingFactor = 0.55,

    warnTris = 800,

    depletion = true,
    paintCapacity = 0.5,
    dipTime = 1200,

    colors = {
        { 20, 16, 12 },
        { 240, 236, 224 },
        { 178, 34, 34 },
        { 32, 74, 135 },
        { 46, 120, 50 },
        { 218, 165, 32 },
        { 120, 72, 34 },
        { 105, 105, 105 }
    }
}

Area and brush

Stroke detail

Every stroke is simplified before it is drawn. These two values decide how much detail is kept, and the loss is hidden inside the width of the brush.

There is no limit per mural. The only budget is how many triangles can be drawn on screen at once (see Rendering), and a painter may spend it on one large mural or several small ones.

Paint depletion

With depletion on, the brush runs dry as it paints and strokes fade. The painter looks at the bucket set down beside them and holds attack or R to refill it.

Palette

colors is the preset palette, listed as { R, G, B } values from 0 to 255. The defaults are soot black, whitewash, barn red, indigo, forest green, ochre, leather brown, and slate gray. Players cycle through them with the Left and Right arrows or pick them from the panel.

Cloth

The cloth wipes away exactly what it passes over, from a small notch to a whole stroke. It is available inside /mural paint and on its own as /mural erase for walls you are not currently painting.

Config.Eraser = {
    radiusDefault = 0.08,
    radiusMin = 0.01,
    radiusMax = 0.30,
    radiusStep = 0.01,
    toggleKey = 0xCEFD9220
}

The cloth only removes paint. Pressing it on a picture removes the whole picture.

Pictures

Picture mode fills the painting area with a PNG or JPG image. The image is not pasted on: it is rebuilt from translucent brush strokes laid over each other, so it reads as a painting on the wall. Painters can keep painting on top of it.

Config.Image = {
    requirePermission = true,
    adminsAlwaysAllowed = true,

    maxTris = 800,
    defaultTris = 700,
    paintAlpha = 0.45
}

The server enforces the permission as well. A picture sent by a player without it is dropped, and the rest of their paint is kept.

More strokes bring the picture closer to the original. A far-away picture is drawn with fewer of its strokes, so it looks blocked in rather than incomplete. In the panel, players choose between soft, normal, sharp, and hard, which map to different paintAlpha values.

Paint bucket

The bucket is placed on the ground to the painter’s right as soon as the area is locked, and it shows the colour currently on the brush.

Config.Props = {
    bucket = {
        model = 'p_bucketcampmil01x',
        side = 0.6,
        fromWall = 0.35,
        reach = 3.0,
        radius = 0.35,
        paint = { z = 0.20, radius = 0.11, segments = 12 }
    }
}

If you change model, adjust paint.z and paint.radius until the paint sits just under the rim instead of floating above it or hiding inside the prop.

There is no brush prop in the painter’s hand by design: first person view in RedM only draws the arm for weapons the game places there itself.

Rendering

Config.Poly controls how strokes are simplified and how murals are drawn at a distance.

Config.Poly = {
    simplifyEpsilon = 2.0,
    minSegment = 2.5,
    doubleSided = false,

    fullDetailDist = 18.0,
    lod2Dist = 28.0,
    hideDist = 45.0,
    lodEpsilonMul = 3.0,

    maxTrisPerFrame = 900
}

Detail

Distance levels

Per-frame budget

maxTrisPerFrame is the total number of triangles drawn in one frame across every mural on screen.

Do not raise maxTrisPerFrame above roughly 950. RedM accepts about 1024 script draw requests per frame, shared by every resource, and silently drops anything beyond that. The default of 900 leaves room for the painting panel and other resources.

When several murals are on screen and the budget runs short, the ones further away step down to a reduced level instead of disappearing. The budget is calculated per client and per frame, so it limits what one screen shows at a time, never how many murals the server can hold.

Framework

Config.Framework = 'auto'

Under a framework, murals are recorded against the character, and per-player limits apply per character.

Administrator access

The Wall Ledger lists every mural with its painter, date, location, size, and stroke count. Administrators can preview, teleport to, and remove any mural, clear all of them, and turn picture permission on or off per player.

Config.Admin = {
    command = 'muraladmin',
    ace = 'rx_murals.admin',
    allowCommandAce = true,
    groups = { admin = true, god = true, superadmin = true },
    identifiers = {}
}

Any one of these sources is enough to make a player an administrator.

Item mode

With item mode on, painting starts by using an inventory item rather than a command.

Config.Items = {
    enabled = true,
    paint = { name = 'paintkit', label = 'paint kit', consume = false },
    cloth = { name = 'rag', label = 'rag' },
    adminBypass = true
}

Set paint or cloth to false to keep that mode on its command. Item names must already exist in your inventory; see Installation for the item entries.

Item mode needs RSG or VORP. On a standalone server the commands stay available and the console reports it on start.

Sync and limits

Config.Sync controls how murals are sent to players, where they are saved, and what the server accepts.

Config.Sync = {
    bps = 1000000,
    saveDelay = 2000,
    dataFile = 'data/murals.json',

    maxStrokes = 2000,
    maxPoints = 60000,
    maxHoles = 800,

    maxPerPlayer = 25,
    maxTotal = 500,

    reach = 30.0
}

Transfer and saving

Per-mural caps

The server enforces these whatever a client sends.

Mural counts

Set either count to 0 to remove the limit. Every mural is sent to each player when they join, so maxTotal also keeps joining fast. Raise it with care on busy servers.

reach rejects requests that come from nowhere near the wall. Corner picks and the cloth work up to about 15 metres, so normal painting is never affected.