Config

K9 Config Settings

General Structure

FRKN = {
  ServerCallbacks = {},
  OpenPetCommand = "mypet",
  Interaction = { Target = "qb-target" },

  Shops = { Coords = vector3(564.9654, 2745.9912, 42.8771) },

  Job = {'police' , 'sheriff'},

  K9Search = { "joint", "cokebaggy", "crack_baggy", ... },

  Training = { ... },

  Item = { reviveItems = {...}, foodItems = {...}, waterItems = {...},
           energyItems = {...}, leashItems = {...}, connectItems = {...}, tennisItems = {...} },

  DieMode = true,
  AgeControlTime = 600000,

  PetDecay = { health=0.5, notEating=5, hunger=1.0, thirst=1.0, energy=0.8, updateInterval=60000 },

  Cages = { [1] = { coords=vector3(...), heading=... }, ... },

  FeatureList = { {name='15% More Damage', price=1500, type='damage', multiple=15}, ... },

  PetList = { { name="Rex", model="a_c_k9", ... }, ... },

  PartConfigByModel = { ["a_c_k9"] = { vest={...}, ... }, ... },

  Currency = "$",
  ItemShopCoords = vector4(561.2651, 2745.0737, 42.8771, 96.7979),

  Categories = { {id="catfood", label="Cat Food", order=1}, ... },

  Items = { { id="dogrevive", name="Revive", category="health", ... }, ... }
}

Commands & Interaction

`OpenPetCommand`

Type: string
Default: "mypet"
Description: The command used by players to open their personal pet menu.

`Interaction.Target`

Type: string (qb-target / ox_target)
Description: Defines the target system used for shop and interaction zones.

Shop & Job Restrictions

`Shops.Coords`

Type: vector3
Description: The location of the pet shop.

`Job`

Type: string[]
Description: Which jobs are allowed to use the K9 system.
Example: { 'police', 'sheriff' }

Contraband Search

`K9Search`

Type: string[]
Description: List of items that the K9 can detect during a search.

Training Area

Training = {
  requiredLevel = { {name="Side Walk", level=10}, ... },

  MarkerType = 2,
  MarkerScale = vec3(0.6, 0.6, 0.6),
  MarkerColor = { r=0, g=180, b=255, a=180 },
  ReachRadius = 1.2,

  MarkerCoords = vector3(...),
  MarkerHeading = 343.3976,

  Checkpoints = {
    {pos=vec3(...), msg=Lang:t("general.checkpoint_msg_1")},
    ...
  },

  DummyPedModel = "a_m_m_tramp_01",
  DummyPeds = { {pos=vec3(...), heading=70.5}, ... },

  TargetFindRadius = 6.0,
  KOTimeoutMs = 5000,

  TrashModels = { joaat("prop_bin_07c") },
  TrashRadius = 3.0
}

requiredLevel: Defines which skills/actions require a minimum training level.
MarkerType / Scale / Color: Visual configuration for training checkpoints.
ReachRadius: The distance at which a checkpoint is considered reached.
MarkerCoords / Heading: Starting location of the training route.
Checkpoints: Training path points and displayed messages.
DummyPedModel / DummyPeds: Peds placed in the training zone (used for target practice).
TargetFindRadius: Detection radius for training scenarios.
KOTimeoutMs: Duration of knockout/stun in milliseconds.
TrashModels / TrashRadius: Defines searchable objects (e.g., trash bins).

Items (Usage Config)

Item = {
  reviveItems = { {name="dogrevive", event="useReviveItem", value=100, prop=nil}, ... },
  foodItems   = { {name="dogfood", event="useFoodItem", value=20, prop="prop_cs_bowl_01b"}, ... },
  waterItems  = { {name="dogwater", event="useWaterItem", value=20, prop="prop_cs_paper_cup"}, ... },
  energyItems = { {name="dogenergy", event="useEnergyItem", value=20, prop="prop_turkey_leg_01"}, ... },
  leashItems  = { {name="dogleash", event="useLeashItem", prop=nil}, ... },
  connectItems= { {name="dogconnect", event="useConnectItem", prop=nil} },
  tennisItems = { {name="dogtennis", event="useTennisBall", prop="prop_tennis_ball"} }
}

name: The item’s internal ID in your framework.
event: Triggered when the item is used.
value: Amount restored/affected (health, hunger, thirst, energy).
prop: Object shown when the item is used.

Life Cycle & Difficulty

`DieMode`

Type: boolean
Description: If true, once a pet’s health reaches 0, it can no longer be used and must be replaced.

`AgeControlTime`

Type: number (ms)
Default: 600000 (10 minutes)
Description: Interval at which pet age is checked/updated.

`PetDecay`

Type: table
Description: Defines stat decrease over time.
Fields:
- health: Health loss per hour.
- notEating: Extra health loss if not fed/watered.
- hunger, thirst, energy: Hourly decrease values.
- updateInterval: How often stats update (ms).

Cages (Shop Display)

`Cages`

Type: table
Description: Coordinates and headings for pet cages in the shop.
Usage: Pets for sale are placed at these coordinates.

Features (Buffs)

`FeatureList`

Type: table
Description: Purchaseable pet upgrades.
Fields:
- name: Display name.
- price: Cost.
- type: Identifier key used internally.
- multiple: Effect percentage or multiplier.

Pet Catalog

`PetList`

Each pet entry includes:

name, breed, price, image, description, status
model: Ped model (_c_k9, a_c_chop...)
coords, heading: Display position in the shop
Growth values:
- currentHeight, currentWeight
- maxHeight, maxWeight
- heightDivision: Adjust if the pet’s feet do not align correctly with the ground.

Model-Based Parts

`PartConfigByModel`

Type: table
Description: Defines which wearable parts/accessories exist per model.
Fields:
- comp: Component index
- max: Maximum available variations
- allowOff: Whether the part can be removed
- label: Display name in the UI

Shop & Items

`Currency`

Type: string
Description: The currency symbol displayed in the shop (e.g., $, €, ₺).

`ItemShopCoords`

Type: vector4
Description: Coordinates where the shop UI can be accessed.

`Categories`

Type: table
Description: Shop item categories and their display order.

`Items`

Type: table
Description: All purchasable items in the shop.
Fields:
- id: Unique shop identifier
- name: Item name shown in UI
- category: Category ID from Categories
- price: Price in Currency
- image: Path to item image
- desc: Short description
- itemName: Actual framework item ID
- stack: How many fit in one inventory slot
- maxPerCart: Max allowed per purchase

PreviousInstallation NextItems

Last updated 3 months ago