Creating Shop items with REPOLib-Sdk

NOTE

This guide assumes you have a REPOLib Unity project set up for REPOLib modding.
If not, follow Getting Started first.

1. Create an Item Prefab

Create a Unity prefab for your item. Use vanilla items as reference if needed.

Vanilla Items are located in Assets/REPO/Game/Resources/items. You can simply copy a prefab to your mod folder.

2. Create the REPOLib Item Asset

1. Right-click in your mod folder (or subfolder)
2. Select Create > REPOLib > Item
3. Configure the following field:
   • Prefab: Reference to your Item prefab (drag-and-drop, can be located outside mod folder).

3. Create the Item Asset

1. Right-click in your mod folder (or subfolder)
2. Select Create > Other > Item
3. Configure all item properties:

   • Item Name: Display name (e.g., "Laser Gun").

   • Description: Brief description of the item (optional).

   • Item Type: Determines how the ShopManager categorizes your item:

     Item Type Options (click to expand)

     Type	Purpose
     Drone	For drones
     Launcher	For Staffs
     Orb	For orbs
     Grenade	For grenades
     Mine	For mines
     Melee	For melee weapons
     Gun	For guns
     Tracker	For trackers
     Vehicle	For vehicles
     Tool	For tools (e.g. Phase Brigde)
     Item_upgrade	For player upgrades
     Player_upgrade	Unused ItemType/Unknown
     Health Pack	For health packs
     Power_crystals	For energy crystals
     Cart	For carts
     Pocket_cart	For pocket carts

   • Emoji Icon: Emoji to use from the emoji.png file from REPO\Game\Textures\Texture2Ds.

     NOTE

     If you're unsure what to use, Orb_battery is a safe default.
     It's unclear what this property is used for, but it's likely for the TruckScreenUI emoji message when leaving the Shop.

   • Item Volume: Determines correct spawning locations in the Shop (so Items don't get stuck in the walls):

     Item Volume Types (click to expand)

     Volume Type	Example Item
     Small	Drones
     Medium	Handgun
     Large	Frying Pan
     Large_wide	C.A.R.T.
     Power_crystal	Energy Crystal
     Large_high	Item Rubber Duck
     Upgrade	Health Upgrade
     Health Pack	Health Pack
     Large_plus	POCKET C.A.R.T.

   • Item Secret Shop Type: Controls whether the Item spawns in secret/hidden areas in the Shop.

   • Color Preset: Choose the color scheme for the Item's battery UI.

   • Prefab: Reference to your Item prefab (drag-and-drop, can be located outside mod folder).

   • Value Preset: Sets your Item's price range:

     Value Preset Options (click to expand):

     These presets are shared between Valuables and Items, but Items use a ×4 value multiplier.

     These are the values for the first shop visit:

     Preset	Base Range	Item Range (×4)
     Value Very Cheap	250 to 500	1,000 to 2,000
     Value Cheap-	300 to 450	1,200 to 1,800
     Value Cheap	500 to 650	2,000 to 2,600
     Value Health Pack Small	500 to 750	2,000 to 3,000
     Value Cheap+	850 to 1,100	3,400 to 4,400
     Value Health Pack Medium	1,000 to 1,500	4,000 to 6,000
     Value Cheap++	1,200 to 2,000	4,800 to 8,000
     Value Crystal	1,000 to 1,500	4,000 to 6,000
     Value Health Pack Large	2,000 to 3,000	8,000 to 12,000
     Value Medium	2,000 to 3,000	8,000 to 12,000
     Value Medium+	3,500 to 4,500	14,000 to 18,000
     Value Medium++	4,500 to 5,000	18,000 to 20,000
     Value High	5,500 to 7,500	22,000 to 30,000
     Value High+	9,500 to 12,000	38,000 to 48,000

     The following presets are not utilized by vanilla shop items but remain available:

     Preset	Base Range	Item Range (×4)
     Value Expensive	18,000 to 25,000	72,000 to 100,000
     Value Expensive+	30,000 to 45,000	120,000 to 180,000
     Value Expensive++	45,000 to 50,000	180,000 to 200,000

   • Max Amount: Maximum quantity spawned in the Truck (may be overridden by the Item Type property).

   • Max Amount in Shop: Maximum quantity appearing in shop (may be overridden by the Item Type property).

   • Max Purchase (Checkbox): Enables a quantity limit on the Item.

   • Max Purchase Amount: The maximum purchase quantity for the Item (requires the prior checkbox to be enabled).

NOTES

• The Item Type property can override other values.
• Value Presets are shared between Items and Valuables.

TIP

For adding custom functionality to your Item, such as the Valuable Tracker allowing players to easily find valuables, check out Using Custom Scripts with REPOLib SDK.