Restocking Shop System for Roblox

===========================================================

🏪 ROBLOX MODULAR SHOP SYSTEM

Demo: https://www.roblox.com/share?code=5d6ffc2a6bf04d498787af1f85f8c96a&type=Experien...

===========================================================

Version: 1.1

Author: Jadon Fischer (Fischer Software e.K. / Jadon | Roblox Tutorials)

License: COMMERCIAL USE ONLY (see bottom)

===========================================================

A fully modular, data-driven shop system for Roblox with **persistent stock saving,**

automatic restocking, developer product integration, and a dynamic GUI.

Designed for scalability and easy customization.

-----------------------------------------------------------

✨ FEATURES

-----------------------------------------------------------

🧩 Modular Architecture — Separate modules for global items and shop listings  

🔁 Automatic & Manual Restocking — Supports timed and Robux-triggered restocks  

💾 Persistent Stock Saving — Only `itemId = stock` pairs are stored server-side for efficiency  

💰 Dual Currency Support — Works with in-game money and Developer Products  

🧍‍ Multiple Shop Support — Easily expand to any number of shops  

🧱 Secure Client–Server Communication — Purchases validated on server  

🖼️ Dynamic GUI — Automatically builds item displays from shop data

-----------------------------------------------------------

⚙️ FILE OVERVIEW

-----------------------------------------------------------

ServerScriptService/

 └─ ShopServer.lua        -- Handles saving, restocking, and purchase logic

StarterPlayerScripts/

 └─ ShopClient.lua        -- Builds the shop UI and handles user interaction

ReplicatedStorage/

 ├─ Remotes/

 │   ├─ UpdateShop (RemoteEvent)

 │   └─ ShopAction (RemoteFunction)

 ├─ Bindables/            -- Optional: Connect your inventory or other systems

 └─ Modules/

     ├─ Items.lua         -- Defines all base items in your game

     └─ Shop.lua          -- Defines shop listings and prices

-----------------------------------------------------------

🧩 SYSTEM ARCHITECTURE

-----------------------------------------------------------

GLOBAL ITEM TABLE (Items module)

--------------------------------

Defines all available items in your game — reusable data that can appear

in multiple shops.

Example:

{

    [1] = {

        Name = "Apple",

        Type = "Seed",

        Image = "rbxassetid://115782078",

        Color = Color3.fromRGB(66, 255, 242),

    }

}

This separation allows you to reuse existing items across multiple shops

without duplicating data. Example: An "Apple" might appear in both a farm

shop and a town market with different prices.

SHOP DATA TABLE (Shop module)

-----------------------------

References the global items by ID and defines how each behaves in a

specific shop.

Example:

{

    [1] = {

        ItemId = 1,

        Name = items[1].Name,

        Price = 10,

        Stock = 5,

        Restock = 5,

        RestockChance = 1,

        MaxStock = 10,

        DeveloperProduct = 3454049265

    }

}

This decoupling makes it easy to:

- Add new shops  

- Rebalance prices independently  

- Keep consistent visuals and names across shops

-----------------------------------------------------------

💾 PERSISTENT STOCK SAVING

-----------------------------------------------------------

The system now **saves only stock quantities** for each item, greatly reducing

DataStore size and improving reliability.

Saved format example:

{

    Stocks = {

        [1] = { [1] = 3, [2] = 1, [3] = 0 }, -- shopIndex = 1

    },

    RestockTimes = {

        [1] = 1731523678

    }

}

All other item data (name, price, etc.) is automatically loaded from

the shop modules, ensuring data consistency across updates.

🧠 Benefits:

- Faster saving/loading  

- Future-proof against data format changes  

- Keeps game logic modular (data stored separately from display info)

-----------------------------------------------------------

🧮 RESTOCK SYSTEM

-----------------------------------------------------------

Each shop restocks independently:

- Every RESTOCK_INTERVALS[i] seconds, or

- When a player buys the RESTOCK_PRODUCT developer product

Each item has its own restock probability:

    RestockChance = 0.5  → 50% chance to restock this item  

    Restock = 2          → Adds 2 units per restock

If you set RESTOCK_INTERVALS[i] to `-1`, that shop will not restock automatically.

-----------------------------------------------------------

🧾 ADDING ANOTHER SHOP

-----------------------------------------------------------

1. Duplicate the Shop module (e.g. "Shop2.lua")

2. Add it to the server script:

    local DATA_TABLES = {

        require(modules:WaitForChild("Shop")),

        require(modules:WaitForChild("Shop2")),

    }

    local RESTOCK_INTERVALS = { 300, 600 }

3. Add another ProximityPrompt in the client script:

    local PROMPTS = {

        workspace.Shop1.Front.ProximityPrompt,

        workspace.Shop2.Front.ProximityPrompt

    }

Each shop’s stock and restock timer are saved separately.

-----------------------------------------------------------

🧱 SERVER SCRIPT SETTINGS

-----------------------------------------------------------

local RESTOCK_INTERVALS = { 300 } -- seconds between restocks  

local RESTOCK_PRODUCT = 3454022944 -- dev product for manual restock  

local DATA_TABLES = {

    require(modules:WaitForChild("Shop")),

}

-----------------------------------------------------------

⚖️ LICENSE — COMMERCIAL USE ONLY

-----------------------------------------------------------

Copyright (c) 2025 Jadon Fischer (Fischer Software e.K. / Jadon | Roblox Tutorials)

Permission is granted to the purchaser to use and modify this system for personal

or commercial Roblox experiences. Redistribution, resale, or public sharing of

the source code, in whole or in part, is prohibited without written permission

from the author.

This software is provided “as is,” without warranty of any kind, express or

implied, including but not limited to the warranties of merchantability,

fitness for a particular purpose, and noninfringement.

-----------------------------------------------------------

✅ CREDITS

-----------------------------------------------------------

Developed by Jadon Fischer (Fischer Software e.K. / Jadon | Roblox Tutorials)

Version 1.1

Includes persistent stock saving for lightweight scalability.

===========================================================