⚙️Shopkeeper Settings

Discover all the settings incorporated dynamically into every store.

Shopkeeper Settings

The shopkeeper section in the configuration file is used to define the properties and behavior of the shopkeeper NPC in the store. Let's break down the different parts of this section:

1. location: This is a vec4 representing the shopkeeper's main position within the store. The first three values (X, Y, Z) define the coordinates, and the fourth value represents the heading or rotation.

2. storageSurrender: This vec4 specifies the location where the shopkeeper surrenders and moves to during a robbery when threatened.

3. lockLocation: This vec4 defines the position where the shopkeeper locks the cash registers.

4. blipID: This is the ID of the blip (map icon) that represents the store on the player's map.

5. types: This section is an array that lists the different types of NPCs that can work as shopkeepers in this store. Each type is represented by a number, and you can define multiple types to add variety to the shopkeeper's appearance and behavior.

6. weapons: This section defines the weapons that the shopkeeper can use during a robbery. It is divided into three categories: "melee", "firearm", and "heavy". Each category specifies the weapon's name and its location as a vec4.

7. animations: This section contains various animations that the shopkeeper can perform in different situations. Each animation type has a list of specific animations with their corresponding IDs and locations. The available animation types are:

   • shelves: Animations related to interacting with shelves.

   • janitor: Animations for cleaning and maintaining the store.

   • cleanWindow: Animations for cleaning windows.

   • idle: Idle animations for the shopkeeper when not actively doing tasks.

   • phone: Animations for using the phone.

   • vendingRage: Animation for expressing frustration with a vending machine.

   • smoking: Smoking animations for different genders and behaviors.

To use this section effectively, you need to:

1. Set the appropriate locations for the shopkeeper, storage surrender, and lock positions using vec4 coordinates.

2. Choose the desired blipID to represent the store on the map.

3. Define the types of NPCs that can work as shopkeepers by adding their corresponding numbers to the types array.

4. Specify the weapons the shopkeeper can use during a robbery by providing the weapon names and their locations.

5. Customize the animations for different situations by modifying the animations section, adding or removing specific animations and their locations as needed.

By configuring the shopkeeper section, you can create a dynamic and interactive shopkeeper NPC that responds to various situations and adds immersion to the store robbery gameplay.