Installation Guide

Let's start with the initial installation steps you need to follow to make the script work correctly.

📄 Configuration Guide

This guide covers the configuration options available for the Crime Tablet system. You can customize framework integration, command setup, interaction methods, UI styling, ranks/roles, upgrades, and more.

This resource is fully configurable via config.lua.

Requirement: You must have pinkFrog_organizations installed and properly configured. Without it, the script will not work.

---

General Settings

Config.frameworkType = 'ESX' -- 'QBCore' / 'ESX' / 'QBOX' / 'CUSTOM'
Config.notifyType = 'OX' -- 'ESX' / 'QBCore' / 'OX' / 'CUSTOM'

• frameworkType – Select your framework. If you use CUSTOM, configure it inside */editable.lua.

• notifyType – Select notification system. If CUSTOM, configure it inside */editable.lua.

Config.minimalCrimePlayersToStart = 0

Minimum number of online organization players required to start a zone.

Config.canCheckPlayersFromOrganizationsWhoTakeZone = true

If enabled, checks players from all organizations when starting a zone.

Config.inventoryAddingDropType = 'ox_inventory'

• ox_inventory – Uses stash system.

• standard – Gives items directly (works with any inventory system).

Config.hideBlipsWhenNoOrg = true

Hide zone blips if player is not in any organization.

---

Interaction Settings

Config.interactionSettings = {
    ['mainInteraction'] = 'drawText3D', -- 'drawText3D' / 'ox_target'
    ['interacationKey'] = 38,
    ['interactionDistance'] = 5.0,
}

• Choose interaction type.

• Set interaction key (default: E = 38).

• Set interaction distance.

If using drawText3D, you can also configure markers:

['markerSettings'] = {
    ['enableMarker'] = true,
    ['markersColor'] = {r = 255, g = 135, b = 211, a = 50},
    ['markerType'] = 1,
    ['markerBoucing'] = true,
    ['markerSize'] = {x = 2.0, y = 2.0, z = 2.0},
}

---

Gang Colors

Config.gangColors = {
    ['BallasNew'] = 27,
    ['Families'] = 52,
}

Defines blip color per gang. Colors list: https://docs.fivem.net/docs/game-references/blips/#blip-colors

---

Crime Areas

All zones are configured inside:

Config.crimeAreas = {
    ['zoneName'] = { ... }
}

Each zone supports:

Basic Settings

['centerCoords'] = vector3(x, y, z),
['dropCoordsPlacement'] = vector3(x, y, z),
['cooldown'] = 1800,
['time'] = 900,
['distanceArea'] = 80.0,
['weapons'] = 'all' -- 'all' / 'white'

• centerCoords – Main capture point.

• dropCoordsPlacement – Where the reward crate drops.

• cooldown – Zone cooldown in seconds.

• time – Time required to capture zone.

• distanceArea – Capture radius.

• weapons – Restrict weapons:

  • all – All weapons allowed.

  • white – Only melee weapons allowed.

---

Rewards

['rewards'] = {
    ['black_money'] = {count = math.random(50000,80000), chance = 100},
    ['weapon_ceramicpistol'] = {count = 1, chance = 35},
}

• count – Amount given.

• chance – Percentage chance to receive reward.

---

Organization Passive Income

['giveMoneyToAccountGroupWhoOwnedZone'] = true,
['howMuchMoneyPerUpdate'] = 2500,
['timeToDecrementUpdateOfOwnedZoneByPercent'] = 10,

When enabled:

• Zone starts at 100%.

• Every X seconds:

  • Zone % decreases by 1.

  • Organization receives money.

• Total income = howMuchMoneyPerUpdate * 100.

---

Peds

['enablePeds'] = true,
['peds'] = {
    {model = 'g_m_y_ballasout_01', coords = vector4(x,y,z,h), weapon = 'weapon_pistol'},
}

• Enable/disable AI enemies.

• Define model, position and weapon.

Optional:

['groupAlsoNearbyPeds'] = {
    ['enable'] = true,
    ['weaponToAdd'] = {'weapon_pistol'}
}

Nearby peds will attack players capturing the zone.

---

Helicopter Drop

['enableHelicopter'] = true,
['enableCameraRotation'] = true,
['helicopter'] = {
    ['model'] = 'buzzard',
    ['coordsToSpawnHelicopter'] = vector3(x,y,z),
    ['dropCoords'] = vector3(x,y,z),
    ['dropHeight'] = 30.0,
    ['ropeLength'] = 12.0,
}

Controls crate air-drop system.

---

Blip & Zone State

['label'] = 'Zone Name',
['blipIcon'] = 154,
['blipColor'] = 27,
['disabledGroups'] = {'Example'},
['taken'] = false,
['ownerGroup'] = nil,

• disabledGroups – Groups that cannot capture this zone.

• taken – Zone state.

• ownerGroup – Current owner.

---

Localization

Config.useLocale = 'en'

You can edit or add translations inside:

Config.locales = {
    ['en'] = { ... }
}

Supports:

• Client notifications

• UI texts

• Target texts

• Server logs

• Discord log messages

---

If needed, you can duplicate any zone inside Config.crimeAreas to create additional custom zones.