> For the complete documentation index, see [llms.txt](https://lng.gitbook.io/lng-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lng.gitbook.io/lng-docs/companion-mod/basics/profiles-lngcompanion-config-json.md). # profiles\LNGCompanion\config.json *** #### 📋 `config.json` Overview This is the primary configuration file for the LNG Companion system. It controls UI styles, active map zones, item blacklists, and the massive 16-stage audio storyline. *** #### ⚙️ General System & UI Settings These settings control the visual interface and core behavior of the drone. | **Setting** | **Type** | **Description** | | ---------------------- | -------- | ----------------------------------------------------------------------------------------------------- | | `ConfigVersion` | `Int` | Do not change. Used internally by the mod to track data wipes/updates. | | `DroneUIStyle` | `Int` | Sets the visual theme of the Drone Interface. (Variants: `1` = Legacy, `2` = Modern, `3` = Terminal). | | `MainMenuDronePreview` | `String` | The exact classname of the drone model shown spinning in the UI menu (e.g., `"LNG_panda1_C_9"`). | | `Vault3DModel` | `String` | The base DayZ model used when rendering the physical crate in the world. Default: `"SeaChest"`. | | `VIPPurchaseLink` | `String` | The URL (like a Discord or Tebex link) opened when a player clicks the VIP store button. | | `VIPPurchaseMessage` | `String` | The UI text displayed right before the VIP link opens. | *** #### 🛡️ Zones & Protections Controls where the drone functions and where dynamic events are allowed to occur. | **Setting** | **Type** | **Description** | | ----------------------- | -------- | ----------------------------------------------------------------------------------------------------- | | `zones` | `Array` | Defines custom interactive areas. Includes `ZoneName`, `CenterCords` (X, Y, Z), and `Radius`. | | ↳ `ZoneActionType` | `String` | What happens inside the zone: `"notification"` (warning), `"teleport"` (force move), or `"kill"`. | | ↳ `Enter/ExitAudio` | `String` | Sound set played when crossing the zone border. | | ↳ `TeleportDest` | `Array` | The X, Y, Z coordinates to send players if the action type is `"teleport"`. | | `EventBlacklistedZones` | `Array` | Defines areas (like Safezones) where random events (KOTH, Trial Beacons) are forbidden from spawning. | *** #### 🎒 Economy & Vault Items Manages what can and cannot be stored inside the Drone Vaults. | **Setting** | **Type** | **Description** | | ----------------------- | -------- | ------------------------------------------------------------------------------------------------------- | | `StarterVaultItems` | `Array` | Item classnames given to the player the *very first time* they open Vault #1. | | `BlacklistedVaultItems` | `Array` | CRITICAL: Items forbidden from entering the vault. Use this to block keys, receipts, and exploit items. | *** #### 🎵 General Audio & Visual Effects Settings for menu interactions, upgrades, and cosmetics. | **Setting** | **Type** | **Description** | | ---------------------- | -------- | ----------------------------------------------------------------------------------- | | `WelcomeAudio` | `String` | The sound played when the drone is first activated. | | `MaxWelcomeAudioCount` | `Int` | Maximum number of times the welcome audio plays before being muted for that player. | | `UnlockedVaultAudio` | `Array` | Sounds that can play upon successfully unlocking a new vault (picks randomly). | | `TransmuterStartAudio` | `String` | Audio triggered when spinning the Transmuter device. | | `TransmuterSuccess...` | `String` | Audio triggered upon a successful Transmuter gamble. | | `VIPRedeemAudio` | `String` | Audio played when a player successfully applies a VIP module. | | `ValentineAuraName` | `String` | Classname for specific particle trails attached to the drone. | | `ValentineAuraOffset` | `Array` | (X, Y, Z) coordinate offset for where the aura particle attaches to the drone. | | `VIPParticles` | `Array` | Particle IDs specifically attached to VIP drones. | *(Note: Minor audio fail-safes like `FallbackErrorAudio`, `ConduitInstallAudio`, and `VaultUpgradeAudioMax` function exactly the same, pointing to specific `CfgSoundSets`.)* *** #### 📖 The 16-Stage Storyline (Audio Progression) These arrays link directly to your server's sound shaders. Because they are arrays, you can add multiple variations for the same stage, and the mod will randomly pick one to keep the storyline dynamic. * `Storyintro`: The initial broadcast. * `Stage0` - `Stage6`: The Base Awakening (Maze, Signal, Outbreak, Steel, Awakening, Overseer, Victory). * `Stage7` - `Stage15`: The Deer Isle Transition (The City, Lockdown, Naval, Prison, Excavation, Rig, Arctic, Apex Master, Agartha). *** #### 💻 The Complete `config.json` *(Copy and paste this directly into your server file)* JSON ``` { "ConfigVersion": 3, "DroneUIStyle": 2, "zones": [ { "ZoneName": "TraderCity", "CenterCords": [ 4500.0, 0.0, 10200.0 ], "Radius": 100.0, "ZoneActionType": "notification", "EnterNotification": "Drone: Entering Safe Zone", "ExitNotification": "Drone: Leaving Safe Zone", "EnterAudio": "", "ExitAudio": "", "TeleportDest": [ 0.0, 0.0, 0.0 ], "ObjectToSpawn": "" } ], "VaultUpgradeAudioLvl1_2": "LNG_Test2_Sound", "VaultUpgradeAudioMax": "LNG_Audio_MaxVaultReached_Random", "WelcomeAudio": "LNG_Audio_WelcomeLNG", "MaxWelcomeAudioCount": 5, "VIPPurchaseLink": "https://discord.gg/s472bQVkvP", "VIPPurchaseMessage": "Opening Store... Please check your browser!", "UnlockedVaultAudio": [ "LNG_Audio_UpgradeSuccess", "LNG_Audio_UpgradeSuccess_V2", "LNG_Audio_UpgradeSuccess_V3" ], "SkippedUpgradeVaultAudio": [ "LNG_Audio_SkippedUpgrade", "LNG_Audio_SkippedUpgrade_V2" ], "ReachedMaxVaultUpAudio": [ "LNG_Audio_MaxVaultReached", "LNG_Audio_MaxVaultReached_V2", "LNG_Audio_MaxVaultReached_V3" ], "SecondChanceAudio": [ "LNG_Audio_GuardianAngel_Random" ], "WatchOutAudio": [ "LNG_Audio_Watchout_Random" ], "Storyintro": [ "LNG_Audio_StoryIntro_Random" ], "Stage0": [ "LNG_Audio_Stage0_Maze_Random" ], "Stage1": [ "LNG_Audio_Stage1_Signal_Random" ], "Stage2": [ "LNG_Audio_Stage2_Outbreak_Random" ], "Stage3": [ "LNG_Audio_Stage3_Steel_Random" ], "Stage4": [ "LNG_Audio_Stage4_Awakening_Random" ], "Stage5": [ "LNG_Audio_Stage5_Overseer_Random" ], "Stage6": [ "LNG_Audio_Stage6_Victory_Random" ], "Stage7": [ "LNG_Audio_Stage7_TheCity_Random" ], "Stage8": [ "LNG_Audio_Stage8_Lockdown_Random" ], "Stage9": [ "LNG_Audio_Stage9_Naval_Random" ], "Stage10": [ "LNG_Audio_Stage10_Prison_Random" ], "Stage11": [ "LNG_Audio_Stage11_Excavation_Random" ], "Stage12": [ "LNG_Audio_Stage12_Rig_Random" ], "Stage13": [ "LNG_Audio_Stage13_Arctic_Random" ], "Stage14": [ "LNG_Audio_Stage14_ApexMaster_Random" ], "Stage15": [ "LNG_Audio_Stage15_Agartha_Random" ], "StarterVaultItems": [ "br_sleepingbag", "WaterBottle", "BakedBeansCan", "Battery9V" ], "BlacklistedVaultItems": [ "ExpansionCarKey", "VehicleKey", "Receipt", "CarReceipt", "VGLNG" ], "EventBlacklistedZones": [ { "ZoneName": "TraderCity", "CenterCords": [ 4654.47, 309.71, 7266.35 ], "Radius": 800.0 }, { "ZoneName": "TraderCity1", "CenterCords": [ 13060.56, 459.70, 879.98 ], "Radius": 800.0 } ], "VIPParticles": [], "ValentineAuraName": "CupidBoltTrail", "ValentineAuraOffset": [ 0.5, 0.5, 0.0 ], "MainMenuDronePreview": "LNG_panda1_C_9", "TransmuterStartAudio": "LNG_Audio_Wormhole", "TransmuterSuccessAudio": "LNG_Trader_Success_Shader", "LinkDroneSuccessAudio": "LNG_Audio_UpgradeSuccess", "VIPRedeemAudio": "LNG_Audio_UpgradeSuccess", "ConduitInstallAudio": "LNG_Audio_Wormhole", "FallbackErrorAudio": "LNG_Audio_SkippedUpgrade_Random", "FallbackWelcomeAudio": "LNG_Audio_Welcome_Random", "Vault3DModel": "SeaChest" } ``` *** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://lng.gitbook.io/lng-docs/companion-mod/basics/profiles-lngcompanion-config-json.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.