Configuration
All settings live in the shared/ folder of kartik-gangs, with one file per feature. Each page below explains every setting in its file: the default value and what changing it does.
Lots of things don't need a config file. Gangs, interiors, turfs, hotspots, rackets, garages, medics, the vehicle catalog, corner prices, upgrade prices and season pass rewards are all set up in the Admin Panel.
Restart the resource after changing a config file.
📁 Config files
| Page | File | Controls |
|---|---|---|
| ⚙️ Core | shared/core.lua | Tablet, feature switches, branding, activity log, admins, police jobs, commands, webhooks, limits, blips |
| 🔑 Permissions | shared/permissions.lua | Permission names and default ranks |
| 💵 Economy | shared/economy.lua | Dirty money item, starting upgrades, upgrade prices and limits |
| 📈 Progression | shared/progression.lua | Max level, XP per level, XP per activity |
| 🎟️ Season Pass | shared/pass.lua | Season, premium price, pass rules, starting rewards |
| 🪜 Tiers | shared/tiers.lua | Tier ladder, requirements, approval and locks |
| 🏆 Leaderboard | shared/leaderboard.lua | Weekly / monthly points and prizes |
| 🎁 Daily Spin | shared/spin.lua | Daily prize wheel |
| 🏠 Hideout | shared/hideout.lua + shared/hideout/ | Instances, guests, stash, shells, interior presets |
| 🛋️ Furniture | shared/furniture.lua | Furniture shop, types and limits |
| 👔 Wardrobe | shared/wardrobe.lua | Gang outfit rules |
| 🚗 Garage | shared/garage.lua | Garage mode, external garages, towing, plate prefix, gang paint, starting dealership |
| 🛒 Market | shared/market.lua | Market rules, fees and allowed items |
| 🗺️ Territory | shared/territory.lua | Turfs, influence, presence, street crime, rivalries, hotspots, rackets, business sales |
| 💊 Corners | shared/corners.lua | Corner selling |
| 🎨 Graffiti | shared/graffiti.lua | Graffiti items, limits, designs, controls |
| ⚔️ Conflicts | shared/conflicts.lua | Gang wars and police raids |
| 📜 Contracts | shared/contracts/ | Contract board rules and each contract |
| 🩺 Underworld | shared/underworld.lua | Black medic, laundering, airdrops, dark chat, ranking |
| 🪢 Restraints | shared/restraints.lua | Tie up, head bag, escort, search |
| 🩹 Teammate Revive | shared/revive.lua | Revive downed teammates when no EMS is on duty |
| 🕵️ Surveillance | shared/surveillance.lua | Cameras, GPS, sensors, binoculars, detector |
| 🌍 Language | locales/ | All in-game text |
⚡ Common changes
| I want to… | Change |
|---|---|
| Open the tablet with a key | Core → Tablet.Keybind = 'F9' |
| Manage the gang from anywhere | Core → ManageFromTablet = true |
| Turn a feature off | Core → Features |
| Add Discord logs | Core → Webhooks |
| Fix time windows for my time zone | Core → UtcOffset |
Use markedbills as dirty money | Economy → DirtyItem |
| Make upgrades cheaper | Admin → Economy |
| Reduce "Settling in" time | Territory → Presence.MinMinutesInside |
| Use my own garage script | Garage → Mode = 'external' |
| Change which items sell on the market | Market → Items |
| Change drug items for corners | Admin → Corners |
| Make a turf sell only one drug | Admin → Corners → Zones |
| Make gangs level faster | Admin → Economy |
| Stop new gangs starting wars | Tiers → Locks.wars |
| Change daily spin prizes | Admin → Daily Spin |
| Change weekly / monthly prizes | Admin → Leaderboard |
| Give gangs a cut of business sales | Territory + the BusinessSale export |
| Require rope and head bags | Restraints → Rope.required, HeadBag.required |
| Make raids need staff approval | Conflicts → RequireApproval = true |
| Change airdrop loot | Underworld → Rewards |
⚠️ Admin panel vs config
Some settings are only read from the config the first time the script starts, or can be overridden in the admin panel.
| Setting | After first start, change it in… |
|---|---|
| Upgrade prices | Admin → Economy (overrides config) |
| Corner selling values | Admin → Corners (overrides config) |
| Gang XP per level and per activity | Admin → Economy (overrides config) |
| Tiers and locks | Admin → Tiers (overrides config) |
| Leaderboard points and prizes | Admin → Leaderboard (overrides config) |
| Daily spin settings and prizes | Admin → Daily Spin (overrides config) |
| Season name, end date, premium price | Admin → Season Pass |
| Season pass rewards | Admin → Season Pass |
| Starting dealership vehicles | Admin → Catalog |
| Starting interiors | Admin → Interiors |
| Starting hotspot | Admin → Hotspots |
| Medic locations | Admin → Medics |
| Default ranks & starting upgrades | Only affect new gangs |