Kartik Scripts

Contracts

Contracts are missions for the gang. Every gang gets its own board of contracts that refreshes every day.

Contracts
The contracts board on the tablet.

๐Ÿ“‹ The contract board

Open Tablet โ†’ Contracts.

  • Your gang gets 15 random contracts, and a new board every 24 hours. The countdown is shown at the top.
  • Contracts added by other scripts on the server (see External contracts) are always listed on top of the random ones.
  • Each card shows the required level, XP, rewards, time limit and number of steps.
  • Filter by All, Available, Active or Completed.
StatusMeaning
AvailableReady to start
ActiveA member is running it (their name is shown)
CompletedDone for this board
CooldownRecently failed; try again soon
LockedYour gang level is too low

โ–ถ๏ธ Running a contract

  1. Press Start contract (needs the Contracts permission).
  2. A briefing explains the job and the tablet closes.
  3. Follow the markers on your map. A HUD shows your progress and time left.
  4. Finish before the timer runs out.

On the job:

  • Tasks like cracking a truck or grabbing a stash play an animation with a progress bar. You have to be on foot, and the bar cancels if you get downed or knocked over.
  • Guards and ambush crews keep hunting you until they're dead or you get away.
  • Guards leave downed players and on-duty EMS alone, so medics can reach the scene (setting).

Rules:

  • Each contract can be completed once per board.
  • A player can run one contract at a time.
  • For count contracts (for example "spray 3 tags"), actions by any gang member count.

Failing:

  • A contract fails if time runs out, you abandon it, you leave the gang, or you disconnect.
  • A failed contract goes on a 10-minute cooldown.
  • Abandon with /contractabandon or from the tablet.

๐ŸŽ Rewards

When a contract is finished:

  • Cash rewards go into the gang treasury.
  • Items and weapons go to the player who finished it, or straight into the gang hideout stash if the server has set that up (the player gets them if the stash is full or locked).
  • The gang earns the contract's XP.
  • The whole gang is notified.

๐Ÿ“š Contracts included

ContractWhat you doLevelXPReward
Armored ScoreSteal a guarded armoured truck, park it at the breach spot and drill the rear doors open, deliver it to the buyer1320$15,000
Coastal DropCollect a package crate on the coast and get it inland without a wanted level1240$10,000
Convoy AmbushCatch a moving armed convoy, take the cargo van and deliver it1280Pistol + $5,000
Lab RaidTake a guarded mobile drug lab and shake off the pursuit1360$18,000
Relay RunTake the cargo van and hit 3 drop points in 12 minutes1300$15,000
Stash RecoveryGrab a seized stash bag from a guarded site and survive the ambush1290$12,000
Van SnatchTake a van guarded by armed men and deliver it to Paleto1180SNS Pistol
Weed RunnerBring 50 weed to a buyer up the coast1120$5,000
Street ScoutFind a specific car on the street and drop it off151009mm ammo
Tag RunSpray 3 gang tags inside turfs1180$5,000
Clean SweepRemove 5 rival tags inside turfs1180$5,000
Corner HustleClose 50 drug deals inside turfs1180$5,000
Hold the BlockCapture 1 hotspot1150$5,000
Wash CycleLaunder $100,000 through laundering runs (needs the Laundering upgrade)1250SNS Pistol

Each contract has its own config file in shared/contracts/. There you can change its name, description, level, XP, rewards, time limit and cooldown, or turn it off completely.


๐Ÿ”Œ External contracts

Other scripts on the server can add their own jobs to the Contracts page, for example a heist or delivery script. They look and work like any other contract: level lock, start permission, time limit, cooldown, XP and rewards are all handled by the gang system. The other script runs the job itself.

Developers: see Server Exports โ†’ External contracts.


๐Ÿ› ๏ธ Admin

In Admin โ†’ Contracts:

  • See every contract and every run in progress.
  • View any gang's current board.
  • Re-roll one gang's board, or every gang's, to hand out a fresh set straight away.
  • Cancel a run. No cooldown is applied.
  • Browse the run history (active, done, failed, expired).

โš™๏ธ Settings

In shared/contracts/_settings.lua:

SettingDefaultMeaning
Contracts per board15How many contracts each gang gets
New board every24 hoursHow often the board refreshes
One active per gangOffOnly one contract running per gang
One active per playerOnA player runs one contract at a time
Time limit60 minutesDefault time limit
Cooldown10 minutesWait after failing
Whole gang countsOnAny member's actions count towards count contracts
Fail on deathOffDying fails the contract
Reward toCompleterItems go to the finisher, or to the starter
Items toPlayerItems go to the player, or to the gang hideout stash
BriefingOnShow the briefing when starting
HUDOnShow the contract progress HUD
GuardsAccuracy 35, armour 25How tough the enemy NPCs are

On this page