Configuration
Edit config.lua for the settings below, shared/catalog.lua for the tattoos and their prices, and locales/en.lua for the text players see.
Shop locations
Config.Locations holds the shops. 6 are set up by default.
| Field | What it does |
|---|
coords | The shop |
clerk | Where the artist stands and faces |
style | 'city' or 'country', picks the artist model from Config.Ped.models |
name | The shop's name, shown in the menu |
preset | Optional. A look from Config.Presets for this shop only |
{ coords = vec3(322.14, 180.20, 103.59), clerk = vec4(319.72, 181.42, 103.59, 245.60),
style = 'city', name = 'Blazing Tattoo' },
Config.Counters sets where players browse, as an offset from the artist:
Config.Counters = {
{ filter = 'all', label = 'Tattoos', offset = vec3(0.0, 1.0, 0.0) },
}
Menu look
| Option | Default | What it does |
|---|
Config.Preset | 'blazing' | Look for every shop: 'blazing', 'blackout', 'bone' or 'midnight' |
Config.Theme | 'blazing' | Theme, only used when Config.Preset is nil |
Config.Layout | 'left' | 'left' or 'center', only used when Config.Preset is nil |
Config.Presets | 4 presets | Each preset's theme and layout |
Config.Brands | ['Blazing Tattoo'] = 'blazing' | Shop name to preset, so a brand always gets its look |
Config.StoreName | 'Blazing Tattoo' | Name for a shop that does not set its own |
Config.ListRows | 8 | Rows shown in the list |
Config.Language | 'en' | Which locale to use |
Prices
| Option | Default | What it does |
|---|
Config.Account | 'cash' | Account that pays: 'cash' or 'bank' |
Config.PriceScale | 1.0 | Multiplies every price in shared/catalog.lua |
Config.AllowRemoval | true | Players can remove tattoos they have |
Config.RemovalFee | 0 | Cost to remove one tattoo |
Config.PurchaseCooldown | 1 | Seconds between purchases |
Config.Discount.enabled | false | Turn on a discount on every tattoo |
Config.Discount.percent | 10 | Discount in percent |
Prompt and markers
| Option | Default | What it does |
|---|
Config.Interaction.key | 38 | Prompt key (E) |
Config.Interaction.padKey | 190 | Prompt button on a controller (D-pad right) |
Config.Interaction.showHelp | true | Help text at the top of the screen |
Config.Interaction.keyGlyph | '~INPUT_PICKUP~' | Key shown in the help text |
Config.Interaction.padGlyph | '~INPUT_FRONTEND_RIGHT~' | Button shown in the help text |
Config.Interaction.drawPrompt | false | Draw a 3D prompt above the counter |
Config.Interaction.keyLabel | '~INPUT_PICKUP~' | Key shown in the 3D prompt |
Config.Interaction.drawMarker | true | Draw a marker at the counter |
Config.Interaction.markers | see below | Marker style |
markers = {
all = { type = 21, r = 235, g = 128, b = 32, a = 120, scale = 0.28 },
},
Controller
| Option | Default | What it does |
|---|
Config.Controller.enabled | true | Controller support |
Config.Controller.rumble | true | Rumble on purchase |
Config.Controller.deadzone | 0.14 | Stick deadzone |
Config.Controller.navDelay | 300 | ms before a held direction repeats |
Config.Controller.navRepeat | 95 | ms between repeats |
Config.Controller.controls | see config | Control IDs for menu movement, accept and cancel |
Turning the character
| Option | Default | What it does |
|---|
Config.Turntable.enabled | true | Players can turn their character |
Config.Turntable.left | { 37, 205, 194 } | Controls that turn left |
Config.Turntable.right | { 206, 81, 193 } | Controls that turn right |
Config.Turntable.speed | 14.0 | Mouse turn speed |
Config.Turntable.stickSpeed | 55.0 | Degrees per second while a button is held |
Config.Turntable.rightStickSpeed | 160.0 | Degrees per second at full right stick |
Config.Turntable.maxStep | 3.0 | Most it turns in one movement |
Undress, stand spot and instance
| Option | Default | What it does |
|---|
Config.Strip.enabled | true | Undress the player while browsing |
Config.Stand.enabled | true | Move the player to a set spot while browsing |
Config.Stand.coords | vec4(323.73, 180.11, 103.59, 76.98) | That spot |
Config.Instance.enabled | true | Put the player in a private routing bucket while browsing |
Config.Instance.firstBucket | 600000 | Buckets from here up. Keep clear of other scripts' buckets |
Config.Instance.clearArea | true | No ambient peds or traffic inside the instance |
Config.Instance.hideClerk | true | Hide the artist while browsing |
Camera
| Option | Default | What it does |
|---|
Config.Camera.enabled | true | Shop camera |
Config.Camera.blendIn | 700 | ms to ease in when the shop opens |
Config.Camera.blendOut | 500 | ms to ease out |
Config.Camera.transition | 0 | ms to move between zones (0 = cut) |
Config.Camera.shift | 0.34 | Moves the camera to the side, clear of the menu |
Config.Camera.zoom | { step = 0.12, min = 0.55, max = 1.9 } | Zoom step and limits |
Config.Camera.invertZoom | false | Flip the zoom direction |
Config.Camera.shots | see config | Camera height, distance, pitch, aim and turn for each zone |
Artist
| Option | Default | What it does |
|---|
Config.Ped.spawnDistance | 70.0 | How close before the artist appears |
Config.Ped.groundSnap | false | Snap the artist to the ground |
Config.Ped.removeDefault | true | Remove the game's own artist peds at the shops |
Config.Ped.scenario | 'WORLD_HUMAN_STAND_IMPATIENT' | What the artist does while idle |
Config.Ped.models | u_m_y_tattoo_01 for both | Model for city and country shops |
Greeting
| Option | Default | What it does |
|---|
Config.Greeting.enabled | true | Artist greets players who walk in |
Config.Greeting.triggerRange | 9.0 | How close before the greeting |
Config.Greeting.cooldown | 90 | Seconds before the same shop greets again |
Config.Greeting.speech | true | Spoken greeting |
Config.Greeting.speechLines | 'GENERIC_HI', 'GENERIC_HOWS_IT_GOING' | Speech lines to pick from |
Config.Greeting.showSubtitle | false | Show a subtitle as well |
Config.Greeting.subtitles | 3 lines | Subtitles to pick from |
Chatter
| Option | Default | What it does |
|---|
Config.Chatter.enabled | true | Artist talks while players are in the shop |
Config.Chatter.range | 12.0 | How close the player must be |
Config.Chatter.gap | 22 | Minimum seconds between lines |
Config.Chatter.scatter | 18 | Up to this many extra seconds |
Config.Chatter.avoidRepeats | true | Never the same line twice in a row |
Config.Chatter.speech | true | Spoken with the ped's own voice |
Config.Chatter.speechLines | 6 lines | Speech lines to pick from |
Config.Chatter.showText | false | Show the line as text |
Config.Chatter.duration | 4000 | ms a line stays up when showText is on |
Config.Chatter.lines | any list | Text lines. Add a list named after a brand preset to give that brand its own lines |
Blip
| Option | Default | What it does |
|---|
Config.Blip.enabled | true | Show shop blips |
Config.Blip.sprite | 75 | Blip icon |
Config.Blip.color | 1 | Blip color |
Config.Blip.scale | 0.8 | Blip size |
Config.Blip.label | 'Tattoo Parlor' | Blip name |
Config.Blip.shortRange | true | Only shows on the minimap when nearby |
Sounds
| Option | Default | What it does |
|---|
Config.Sounds.enabled | true | Menu sounds |
nav, select, back, toggle, purchase, denied | game frontend sounds | Each sound's name and set |
Tattoo list
shared/catalog.lua holds every tattoo, per zone, with its price. Change a price to change what it costs. See Custom tattoos to add your own.