NPC Shops (Robbery, In-Game Setup, Unlimited Shops, Job Restrictions & More)

NPC shops allows you to sell any item on your server through these stores. You can spawn, modify and save NPCs everywhere on your map. You can change the items that players can purchase from a large range of pre-configured items and you can easily add your own items through the config files.

NPCs also have a configurable name and description that you can set per NPC via the in-game editor.

There are various pre-coded types of items: Weapons, Ammo, Entity or Custom. The pre-coded ones will run certain code to either give weapons, ammo or spawn your desired entity next to the NPC on purchase.

Custom items allow you to run any Lua code upon purchasing the item.

🚀 In-Game Setup

• NPCs are easily spawned through the Q menu.
• As an admin you can access the admin panel of an NPC directly from the NPC menu (press E).
• Enable which items you'd like for the specific NPC.
• Modify the name and description of the NPC directly from this menu.
• Restrict the NPC to certain teams only.
• Restrict the NPC to specific usergroups of your choice.

💯 Unlimited NPCs

• You are able to have as many NPC shops as you'd like.
• Every NPC has a different/unique set of items configured by the server admin.

🔫 NPC Robbery

• Money earned from a robbery is calculated from stores total worth of items and configs.
• Alarm bell rings while robbing.
• Robber becomes wanted for robbery (only DarkRP support)
• 3D2D display above NPC displays robbery text and countdown.
• Robber must stay close to the NPC and survive for x amount of time.
• When robbery is completed money is added to players balance and npc robbery is placed on cooldown. Cooldown is displayed above the NPC.
• Ability to restrict robbery to certain teams via config.
• You're able to require the player must hold a weapon via configs.
• When a store is being robbed then you will be unable to buy/sell items at that store.

🛒 Item Types

• The addon has a large selection of pre-made items in the config file.
• These are the items that you will see inside the in-game config setup.
• Item types define what happens when someone buys or sells the item.
• Weapons will give the weapon on purchase and take the weapon on sell.
• Entity will spawn the entity by class next to the NPC or try to remove nearby entity on sell.
• Ammo will give ammo directly to the player on purchase.
• Health will add health to the player on purchase.
• Armor will add armor to the player on purchase.
• Custom item type allows you to run any Lua code.

🫰 Sell Items

• You are able to determine what items can be sold to NPCs.
• If you try to sell weapons it will detect if the player has the weapon on them.
• If you try to sell entities it will scan nearby entities of the NPC, remove it and reward the player accordingly.
• The sell price is determined by a percentage of the original price and it's a config option.

💾 Inventory Support

• Supports various inventory systems:
• ItemStore
• Xenin Inventory
• Brick's Essentials Inventory
• Buying Weapons or Entities (based on type) will put the item directly into your inventory.
• If the entity is a prop_physics entity it will spawn it next to the NPC as usual.
• Selling items to NPCs will attempt to take the item directly from your inventory when inventory support is enabled.

💵 Multi currency support

• The NPCs works with all gamemodes as long as you have one of the following currency systems available.
• You can configure the currency that the stores will use inside the configuration file.
• DarkRP Money
• SH Pointshop Points
• SH Pointshop Premium Points
• BaseWars Money
• Helix Money
• mTokens
• Brick's Credit Store
• Pointshop2 Points
• Pointshop2 Premium Points
• SantosRP Money
• Underdone Money

💻 bLogs Support

• The addon supports bLogs.
• Logs when a player purchases an item from an NPC (player name, item name, price, npc name)
• Logs when a player sells an item to an NPC (player name, item name, money earned, npc name)

💯 Level System Support

• Support for Sublime Levels
• Support for Vrondakis Level System
• Support for Elite XP System (EXP2)
• Support for DarkRP Essentials or Brick's Essentials
• Support for GlorifiedLeveling

🌎 Language System

• English
• French
• German
• Danish
• Polish

Discord Server

I own a Discord server for customers and anyone else who wish to join. I will occasionally provide exclusive offers and help with minor issues that might occur with my scripts. If you have a more serious problem, please create a support ticket on GModStore.

Please see the supported economy/money systems to understand if your gamemode/server type is supported.

Put the folderch_npc_shops in to your addons folder. This will give you the following path: addons/ch_npc_shops/lua/etc...

Please visit the Setup & Customizing tab to see how you configure the addon.

CONTENT

There's a single content pack that you must add to your servers workshop collection.

Workshop

There are two configuration files to modify various parts of the addon.

Configure the general settings of the addon in lua/ch_npc_shops/shared/ch_npc_shops_config.lua

Configure your items in lua/ch_npc_shops/shared/ch_npc_shops_config_items.lua

View the configuration HERE and read more about item configuration in the knowledge base.

SETUP NPCS

All you have to do is spawn the NPCs from the Q menu.

You can find the entity in the Q Menu -> Entities -> NPC Shops by Crap-Head

Place them as you wish and use the console command ch_npc_shops_save to save them to the map.

EDIT SHOPS

Simply press E on an NPC to enter the shop. As an admin you will see a config button next to the close button.

This will open a new panel that allows you to modify the NPC name, description, pose.

You can also enable/disable items and restrict the NPC to certain teams from this menu.

REMOVING ENTITIES

If you regret setting up some of the NPCs then you can remove them using the normal Remover Tool and run the console command ch_npc_shops_save to save the current entities to the map.

ADDING ITEMS

You are easily able to add new items using pre-configured item types or Custom code. Please visit the knowledge base for more information

https://www.gmodstore.com/help/addon/npc-shops-in-game-setup-unlimited-shops-job-restrictions-all-gamemodes/items

If you find any problems with the script, please create a support ticket with details of the situation and a copypaste of the error in console. I am also not interested in modifying you a custom version of the addon. Also not upon payment. Sorry!

Conflicting addons is not to be said if I will support that or not. This is something I will decide upon confrontation about a conflicting addon. If you have some sort of proof that an addon is conflicting with my addon, please send me a PM with the details you might have.

Thank you!

Credits

Banners by Im Not Meow Meow

Font is Open Sans by Google

Icons made by freepik from Flaticon

Icons made by Ilham Fitrotul Hayat from Flaticon

Icons made by IconBaandar from Flaticon

German translation thanks to Gamer688

French translation thanks to Tapir

If you like this script, you should check out some of my other addons for DarkRP. Just click the banner to open the script page in a new tab.