Skip to content

Items Setup

The script moves items in and out of player inventories, but it does not make products usable - a harvested tomato or a cooked bread does nothing on its own until you make it eatable/usable in your framework. The script only removes ingredients and gives products.

Adding the items

Ready-to-paste item definitions for every supported inventory are on the Inventory Item Definitions page - open the section for your inventory and follow it.

Item list

Building materials (all versions): wood, stone, metal, concrete

Other important items (all versions): water_bottle, jerry_can

Gardening (Pro): 14 seeds (tomato_seed, potato_seed, ...), 14 crops (tomato, potato, ...), plant_fertilizer, weed_repellent

Cooking (Pro): baked_potato, grilled_tomato, grilled_corn, bread, vegetable_soup, fruit_salad, apple_juice

Crafting (Pro): nails, rope, lockpick

The material item names and labels are mapped in Config.Items (config/general.lua) - rename them there if your server already has similar items.

Base Control

By default the Base Control is placed straight from the radial build menu - no item is needed. If you prefer an item-based claim, set ItemName on the basecontrol entry in config/props.lua (for example ItemName = "basecontrol") and add that item to your inventory. Players then need the item to place a Base Control, it is used up instead of the materials, and using it from the inventory starts the placement.

Item icons

The UI shows item images (ingredients, seeds, recipes, upkeep materials). Two modes in config/general.lua:

Config.ItemIcons = "inventory"   -- use your inventory's own image folder (from vns-core)
-- or
Config.ItemIcons = "custom"      -- use the icons shipped in the resource's html/icons/others folder

With "inventory" the path comes from vns-core's Config.ItemImagePath, which is auto-detected per inventory. If your inventory is renamed or stores images elsewhere, set Config.ItemImagePath in vns-core/config.lua.

A full icon pack is included in html/icons/:

  • html/icons/building/ - the icons used by the build radial menu (editable)
  • html/icons/others/ - item icons for materials, crops and foods (used in "custom" mode)

Seeds fall back to a single generic seed.png unless you add per-seed images.