Туториал · Игровые системы

Как сделать инвентарь в Roblox Studio

Инвентарь кажется задачей про интерфейс, но то, можно ли его взломать и теряет ли он предметы, решает место, где хранятся предметы. В этом гайде предметы каждого игрока лежат в таблице на сервере, каждый игрок получает копию и рисует её сеткой, экипирует Tool и использует расходники через запросы, которые проверяет сервер, а всё сохраняется в дата стор.

Обновлено 14 ноября 2026 г.14 мин чтенияАвтор:

Коротко

Храните предметы каждого игрока в таблице на сервере, внутри ModuleScript в ServerScriptService, и только этот код может добавлять, убирать и складывать их в стаки. Опишите предметы один раз в ModuleScript в ReplicatedStorage (id, название, максимальный стак). После каждого изменения сервер отправляет этому игроку RemoteEvent с копией его инвентаря, а LocalScript рисует его сеткой через ScrollingFrame и UIGridLayout.

  • Клиент никогда не добавляет предметы. Он может только попросить, например "экипируй мой меч", и сервер проверяет, что у игрока он есть, прежде чем что-то делать.
  • Предметы появляются только через серверный код, который вы контролируете: подбор, покупки в магазине после проверки на сервере, награды.
  • Сохраняйте id предметов и их количество, а не Tool, через DataStoreService, когда игрок выходит, когда сервер выключается и раз в несколько минут. Никогда не сохраняйте игрока, чьи данные не загрузились.
На этой странице
  1. Как это устроено
  2. Почему предметы на сервере
  3. 1. Готовим Explorer
  4. 2. Каталог предметов
  5. 3. Инвентарь на сервере
  6. 4. Загрузка и сохранение
  7. 5. Подбор предметов
  8. 6. Экипировка и использование
  9. 7. Сетка UI
  10. Проверка
  11. Common errors
  12. С RoCode
  13. Частые вопросы
  14. Источники и что почитать

Как устроен инвентарь

ИллюстрацияНажмите B, наведите курсор на предмет, чтобы прочитать описание, кликните по Sword, чтобы взять его в руку.

Система состоит из шести маленьких частей, у каждой одна задача. Все правила про предметы живут в одном серверном модуле, поэтому когда что-то ломается, искать нужно ровно в одном месте.

Части системы и где они работают
ЧастьТип и местоЗадача
ItemCatalogModuleScript в ReplicatedStorageЧто представляет собой каждый предмет: название, описание, максимальный стак и можно ли его экипировать или использовать. Его читают сервер и все клиенты.
InventoryServiceModuleScript в ServerScriptServiceХранит слоты всех игроков. Единственный код, который добавляет, убирает и складывает предметы в стаки.
InventoryDataScript в ServerScriptServiceЗагружает предметы игрока при входе и сохраняет их.
InventoryActionsScript в ServerScriptServiceПроверяет и выполняет запросы на экипировку и использование.
ItemPickupScript внутри PartВыдаёт предмет тому, кто его подобрал.
InventoryClientLocalScript в StarterPlayerScriptsРисует сетку и отправляет запросы. Сам ничего не меняет.

Данные идут в одну сторону. Сервер меняет инвентарь, затем отправляет этому игроку InventoryUpdated со всем инвентарём, и клиент перерисовывает его. Когда игрок кликает по слоту, клиент отправляет EquipItem или UseItem с id предмета; сервер проверяет запрос, вносит изменение, и новая копия приходит тем же путём. Отправлять весь инвентарь проще, чем отправлять изменения, а для нескольких десятков слотов сообщение остаётся маленьким.

Почему клиент никогда не добавляет предметы

Хочется добавить предмет прямо в LocalScript, который его показывает: игрок кликнул, слот заполнился. Это ломается двумя способами.

  • Никто другой этого не видит. Изменение в LocalScript существует только на устройстве этого игрока. Сервер о нём не узнаёт, поэтому оно не сохраняется, и ни один серверный скрипт не может его использовать.
  • Подделать может кто угодно. Если починить это ремоутом вроде AddItem(itemId, amount), читер сможет сам вызывать этот ивент, с любыми аргументами и сколько угодно раз. В гайде Roblox по безопасности сказано, что сервер должен проверять всё, что присылает клиент, прежде чем это использовать.

Поэтому в этом гайде клиент может только просить что-то сделать с предметами, которые у игрока уже есть: "экипируй это" и "используй это". В каждом запросе один id предмета и никаких количеств, и на сервере он проходит одну проверку: это строка, такой предмет существует, у игрока есть хотя бы один, и игрок шлёт не больше четырёх запросов в секунду. Затем сервер сам находит Tool по каталогу. Он никогда не принимает от клиента Tool, путь или инстанс, о чём предупреждает тот же гайд.

Предметы попадают в инвентарь только через серверный код: подбор, который проверил сервер, покупку, за которую сервер списал деньги (её собирает гайд по магазину), награду за квест или дроп. Про ремоуты в целом, с проверкой других видов аргументов, читайте в гайде по RemoteEvent.

Шаг 1: подготовьте Explorer

Создайте эти объекты вручную. Скрипты из следующих шагов ищут их по имени, поэтому пишите каждое имя точно как здесь.

  1. В ReplicatedStorage вставьте Folder с именем InventoryRemotes. Внутрь вставьте три RemoteEvent с именами InventoryUpdated, EquipItem и UseItem.
  2. В ServerStorage вставьте Folder с именем ItemTools. Внутрь вставьте Tool с именем Sword, а в Tool Part с именем Handle (1 на 4 на 1 стад вполне подойдёт). Проверьте, что галочка Anchored у Handle снята: Roblox предупреждает, что персонаж застревает на месте, если держит инструмент с анкерными партами. Подойдёт и Tool, который у вас уже есть, если его имя совпадает с каталогом из шага 2.
  3. Добавляйте скрипты по мере прохождения шагов. Дерево показывает, куда идёт каждый из них.
Explorer, когда гайд пройден
ReplicatedStorage
  ItemCatalog ModuleScript new
  InventoryRemotes Folder new
    InventoryUpdated RemoteEvent new
    EquipItem RemoteEvent new
    UseItem RemoteEvent new
ServerScriptService
  InventoryService ModuleScript new
  InventoryData Script new
  InventoryActions Script new
ServerStorage
  ItemTools Folder new
    Sword Tool new
      Handle Part new
StarterPlayer
  StarterPlayerScripts
    InventoryClient LocalScript new
Workspace
  Apple Part new
    ItemPickup Script new

Шаг 2: опишите предметы в каталоге

Каталог описывает каждый предмет, который может существовать, один раз. Инвентари потом хранят только id предмета и количество. Так сохранения остаются маленькими, и позже можно переименовать предмет или переписать его описание, не трогая ничьи сохранённые данные.

Вставьте ModuleScript в ReplicatedStorage, назовите его ItemCatalog и замените его содержимое на это:

ModuleScript в ReplicatedStorage с именем ItemCatalog
-- Все предметы, которые могут быть в игре. Этот список читают сервер и все
-- клиенты; только сервер решает, у кого что есть.
export type Item = {
	id: string, -- должен совпадать с ключом ниже
	name: string,
	description: string,
	maxStack: number, -- сколько этого предмета помещается в один слот
	icon: string?, -- необязательная картинка: "rbxassetid://" плюс ID вашего изображения
	toolName: string?, -- Tool в ServerStorage.ItemTools: предмет можно экипировать
	heal: number?, -- сколько здоровья восстанавливает: предмет расходуемый
}

local items: { [string]: Item } = {
	sword = {
		id = "sword",
		name = "Sword",
		description = "Equip it to put it in your hand.",
		maxStack = 1,
		toolName = "Sword",
	},
	apple = {
		id = "apple",
		name = "Apple",
		description = "Use it to restore 25 health.",
		maxStack = 10,
		heal = 25,
	},
	wood = {
		id = "wood",
		name = "Wood",
		description = "A building material.",
		maxStack = 50,
	},
}

local ItemCatalog = {}

-- Возвращает предмет с этим id или nil, если такого предмета нет
function ItemCatalog.get(id: string): Item?
	return items[id]
end

return ItemCatalog

Необязательные поля решают, что делает предмет. toolName делает его экипируемым, heal делает его используемым, а предмет без обоих полей, как дерево, лежит в инвентаре, пока его не уберёт другой серверный код (крафт, продажа).

Чтобы добавить предмет, добавьте запись, у которой ключ и id совпадают. Id чувствительны к регистру и именно они сохраняются, поэтому никогда не меняйте id, когда предмет уже есть у игроков: меняйте его name.

Шаг 3: храните инвентари на сервере

Этот ModuleScript владеет инвентарём каждого игрока. Каждый инвентарь это список слотов, в каждом слоте id предмета и количество, плюс вместимость в 20 слотов. Другие серверные скрипты вызывают его функции, и больше никто таблицу не редактирует.

Вставьте ModuleScript в ServerScriptService и назовите его InventoryService:

ModuleScript в ServerScriptService с именем InventoryService
-- Единственный код, который меняет инвентари. Он лежит в ServerScriptService,
-- где клиенты не могут ни увидеть, ни запустить его.
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- Strict-режим не видит, что возвращает require через WaitForChild, поэтому
-- описываем ту часть модуля, которую использует этот скрипт
type Item = { id: string, maxStack: number }
type Catalog = { get: (id: string) -> Item? }
local ItemCatalog = require(ReplicatedStorage:WaitForChild("ItemCatalog")) :: Catalog

local remotes = ReplicatedStorage:WaitForChild("InventoryRemotes")
local inventoryUpdated = remotes:WaitForChild("InventoryUpdated") :: RemoteEvent

export type Slot = { id: string, count: number }
type Inventory = { slots: { Slot }, capacity: number, equipped: string? }

local CAPACITY = 20 -- слотов на игрока
local STARTER_ITEMS: { Slot } = { -- с чем начинает совсем новый игрок
	{ id = "sword", count = 1 },
	{ id = "apple", count = 3 },
}

local inventories: { [Player]: Inventory } = {}

local InventoryService = {}

-- Отправляет владельцу копию его инвентаря. Вызывается после каждого изменения.
local function sync(player: Player)
	local inventory = inventories[player]
	if inventory then
		inventoryUpdated:FireClient(player, {
			capacity = inventory.capacity,
			slots = inventory.slots,
			equipped = inventory.equipped,
		})
	end
end

-- Правила стаков: сначала доливаем неполные стаки, потом начинаем новые стаки
-- в пустых слотах. Возвращает, сколько добавлено, это может быть меньше запрошенного.
local function addToInventory(inventory: Inventory, item: Item, amount: number): number
	local remaining = amount
	for _, slot in inventory.slots do
		if remaining == 0 then
			break
		end
		if slot.id == item.id and slot.count < item.maxStack then
			local moved = math.min(item.maxStack - slot.count, remaining)
			slot.count += moved
			remaining -= moved
		end
	end
	while remaining > 0 and #inventory.slots < inventory.capacity do
		local moved = math.min(item.maxStack, remaining)
		table.insert(inventory.slots, { id = item.id, count = moved })
		remaining -= moved
	end
	return amount - remaining
end

function InventoryService.count(player: Player, itemId: string): number
	local inventory = inventories[player]
	local total = 0
	if inventory then
		for _, slot in inventory.slots do
			if slot.id == itemId then
				total += slot.count
			end
		end
	end
	return total
end

-- Сколько ещё предмета влезет: место в его стаках плюс пустые слоты
function InventoryService.spaceFor(player: Player, itemId: string): number
	local inventory = inventories[player]
	local item = ItemCatalog.get(itemId)
	if not inventory or not item then
		return 0
	end
	local space = (inventory.capacity - #inventory.slots) * item.maxStack
	for _, slot in inventory.slots do
		if slot.id == itemId then
			space += item.maxStack - slot.count
		end
	end
	return space
end

-- Добавляет до amount штук предмета. Возвращает, сколько добавлено (0, если
-- предмета нет, инвентарь полон или ещё не загрузился).
function InventoryService.add(player: Player, itemId: string, amount: number): number
	local inventory = inventories[player]
	local item = ItemCatalog.get(itemId)
	local wanted = math.floor(amount)
	if not inventory or not item or wanted < 1 then
		return 0
	end
	local added = addToInventory(inventory, item, wanted)
	if added > 0 then
		sync(player)
	end
	return added
end

-- Убирает ровно amount штук предмета, начиная с последних стаков.
-- Если у игрока меньше, ничего не убирает и возвращает false.
function InventoryService.remove(player: Player, itemId: string, amount: number): boolean
	local inventory = inventories[player]
	local wanted = math.floor(amount)
	if not inventory or wanted < 1 or InventoryService.count(player, itemId) < wanted then
		return false
	end
	local remaining = wanted
	-- Идём с конца, чтобы table.remove не пропускал слоты
	for index = #inventory.slots, 1, -1 do
		local slot = inventory.slots[index]
		if slot.id == itemId then
			local taken = math.min(slot.count, remaining)
			slot.count -= taken
			remaining -= taken
			if slot.count == 0 then
				table.remove(inventory.slots, index)
			end
			if remaining == 0 then
				break
			end
		end
	end
	sync(player)
	return true
end

function InventoryService.getEquipped(player: Player): string?
	local inventory = inventories[player]
	return if inventory then inventory.equipped else nil
end

function InventoryService.setEquipped(player: Player, itemId: string?)
	local inventory = inventories[player]
	if inventory then
		inventory.equipped = itemId
		sync(player)
	end
end

-- Вызывается, когда сохранённые данные игрока загрузились. saved это то, что
-- вернул дата стор: nil для нового игрока. Каждая запись заново проходит через
-- правила стаков, поэтому удалённые предметы и старые размеры стаков ничего не ломают.
function InventoryService.load(player: Player, saved: any)
	local inventory: Inventory = { slots = {}, capacity = CAPACITY }
	local entries: { Slot } = STARTER_ITEMS
	if type(saved) == "table" and type(saved.slots) == "table" then
		entries = {}
		for _, entry in saved.slots do
			if type(entry) == "table" and type(entry.id) == "string" and type(entry.count) == "number" then
				table.insert(entries, { id = entry.id, count = math.floor(entry.count) })
			end
		end
	end
	for _, entry in entries do
		local item = ItemCatalog.get(entry.id)
		if item and entry.count > 0 then
			addToInventory(inventory, item, entry.count)
		end
	end
	inventories[player] = inventory
	sync(player)
end

-- Простая копия для сохранения или nil, если данные игрока так и не загрузились
function InventoryService.serialize(player: Player): { version: number, slots: { Slot } }?
	local inventory = inventories[player]
	if not inventory then
		return nil
	end
	local slots: { Slot } = {}
	for index, slot in inventory.slots do
		slots[index] = { id = slot.id, count = slot.count }
	end
	return { version = 1, slots = slots }
end

function InventoryService.unload(player: Player)
	inventories[player] = nil
end

return InventoryService

Строки type и приведение :: после require нужны только тайпчекеру Luau, который не видит, что возвращает модуль, найденный через WaitForChild. Во время игры они ничего не меняют. Остальные скрипты в этом гайде делают так же.

Как работают правила стаков с каталогом выше, где яблоки стакаются до 10:

  • Если добавить 15 яблок игроку со стаком из 7, этот стак заполнится до 10, а потом начнётся новый стак из 5.
  • Когда слоты кончаются, add добавляет то, что влезло, и возвращает это число. Вызывайте сначала spaceFor, когда нужно всё или ничего, как делает подбор в шаге 5.
  • remove работает по принципу всё или ничего. Запрос 3 яблок у игрока, у которого их 2, ничего не убирает и возвращает false, поэтому проверяйте результат, прежде чем что-то давать взамен.
  • В слотах нет дыр: когда слот пустеет, остальные сдвигаются вверх. Так список проще отправлять и сохранять. Про слоты, которые держат свою позицию, рассказано в вопросах в конце.
Что могут вызывать другие серверные скрипты
ФункцияВозвращаетДля чего
add(player, itemId, amount)Сколько добавленоПодбор, награды, покупки
remove(player, itemId, amount)true, если убрано всёИспользование, продажа, крафт
count(player, itemId)Сумма по всем стакамПроверить, что есть у игрока
spaceFor(player, itemId)Сколько ещё влезетПроверка перед добавлением по принципу всё или ничего
getEquipped, setEquippedId экипированного предмета или nilЭкипировка, в шаге 6
load, serialize, unloadКопия, готовая к сохранению (serialize)Загрузка и сохранение, в шаге 4

Шаг 4: загружайте и сохраняйте каждый инвентарь

Инвентари живут в памяти сервера, поэтому исчезают, когда игрок выходит. Этот скрипт загружает слоты игрока из дата стора, когда он заходит, и записывает их обратно, когда он выходит, когда сервер выключается и каждые три минуты на случай краша сервера. Он сохраняет только id предметов и количество: дата сторы не умеют хранить Instance, например Tool.

Вставьте Script в ServerScriptService и назовите его InventoryData:

Script в ServerScriptService с именем InventoryData
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local RunService = game:GetService("RunService")
local ServerScriptService = game:GetService("ServerScriptService")

type InventoryApi = {
	load: (player: Player, saved: any) -> (),
	serialize: (player: Player) -> any,
	unload: (player: Player) -> (),
}
local InventoryService = require(ServerScriptService:WaitForChild("InventoryService")) :: InventoryApi

local STORE_NAME = "PlayerInventory_v1"
local LOAD_ATTEMPTS = 3
local AUTOSAVE_SECONDS = 180

-- Сохраняются только игроки, чьи данные загрузились. После неудачной загрузки
-- нельзя сохранять, иначе пустой инвентарь заменит настоящий.
local canSave: { [Player]: boolean } = {}
local activeSaves = 0

local function keyFor(player: Player): string
	return "User_" .. player.UserId
end

-- Один неудачный запрос не должен стоить никому предметов, поэтому пробуем несколько раз.
-- GetDataStore тоже внутри pcall, поэтому сессия Studio без доступа к дата
-- сторам получает предупреждение, а не останавливает этот скрипт.
local function loadSaved(player: Player): (boolean, any)
	for attempt = 1, LOAD_ATTEMPTS do
		local ok, result = pcall(function()
			return DataStoreService:GetDataStore(STORE_NAME):GetAsync(keyFor(player))
		end)
		if ok then
			return true, result
		end
		warn(`Inventory load failed for {player.Name} (attempt {attempt}): {result}`)
		if attempt < LOAD_ATTEMPTS then
			task.wait(attempt * 2)
		end
	end
	return false, nil
end

local function onPlayerAdded(player: Player)
	local ok, saved = loadSaved(player)
	if player.Parent ~= Players then
		return -- игрок вышел, пока мы загружали
	end
	if ok then
		InventoryService.load(player, saved) -- saved равен nil для нового игрока
		canSave[player] = true
	elseif RunService:IsStudio() then
		-- Обычно значит, что доступ Studio к API services выключен. Играем со
		-- стартовыми предметами, чтобы можно было тестировать, но никогда их не сохраняем.
		warn("Inventory not loaded: playing with starter items that will not be saved")
		InventoryService.load(player, nil)
	else
		player:Kick("Your inventory could not be loaded. Please rejoin in a minute.")
	end
end

local function save(player: Player)
	if not canSave[player] then
		return -- данные так и не загрузились, безопасно записать нечего
	end
	local data = InventoryService.serialize(player)
	if not data then
		return
	end
	activeSaves += 1
	local ok, err = pcall(function()
		DataStoreService:GetDataStore(STORE_NAME):SetAsync(keyFor(player), data, { player.UserId })
	end)
	activeSaves -= 1
	if not ok then
		warn(`Inventory save failed for {player.Name}: {err}`)
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Players.PlayerRemoving:Connect(function(player: Player)
	save(player)
	canSave[player] = nil
	InventoryService.unload(player)
end)

-- Когда сервер выключается, сохраняем всех, кто ещё здесь, и ждём каждое
-- идущее сохранение, включая те, что запустил PlayerRemoving
game:BindToClose(function()
	for _, player in Players:GetPlayers() do
		task.spawn(save, player)
	end
	while activeSaves > 0 do
		task.wait()
	end
end)

-- Сохраняем всех раз в несколько минут, чтобы краш сервера стоил минут, а не всей сессии
while true do
	task.wait(AUTOSAVE_SECONDS)
	for _, player in Players:GetPlayers() do
		task.spawn(save, player)
	end
end

Что делает скрипт и зачем:

  • Загрузка со значениями по умолчанию. У нового игрока нет сохранённого значения, поэтому GetAsync возвращает nil, и он получает стартовые предметы. Сохранённые слоты заново проходят через правила стаков, поэтому предмет, удалённый из каталога, или уменьшенный максимальный стак не сломают загрузку. Всё, что больше не влезает или чьего id больше нет в каталоге, отбрасывается, и следующее сохранение делает это окончательным, поэтому держите в каталоге каждый id, который может быть у игроков.
  • Никогда не сохранять после неудачной загрузки. Записываются только игроки из canSave. На живом сервере игрока, чьи данные не загрузились и после трёх попыток, просят перезайти. В Studio он вместо этого получает несохраняемые стартовые предметы, на несколько секунд позже из-за повторных попыток. Так и будет, пока плейс не опубликован с включённым доступом к API.
  • Сохранение при выходе и при выключении. BindToClose сохраняет всех, кто ещё на сервере, и ждёт уже идущие сохранения. Roblox даёт привязанным функциям до 30 секунд.
  • Не выходить за лимиты. Одна запись на игрока каждые три минуты плюс одна при выходе это намного меньше стандартного бюджета сервера в 60 записей в минуту плюс 40 на каждого игрока (по документации на 30 сентября 2026). Шаблон ключа User_ взят из рекомендаций Roblox, а передача user ID в SetAsync связывает данные с этим игроком, что Roblox настоятельно рекомендует для обработки запросов на удаление данных.

Для небольшой игры это надёжная основа. Блокировка сессии, которая не даёт игроку, быстро сменившему сервер, загрузить данные раньше, чем старый сервер их сохранил, и когда использовать UpdateAsync вместо SetAsync, разобраны в туториале по DataStore.

Шаг 5: выдавайте предметы из мира

Подбор это самый простой способ, которым предметы попадают в инвентарь: парт с ProximityPrompt, который добавляет предмет, когда игрок его использует. Скрипт слушает его событие Triggered на сервере, поэтому предмет добавляется там, где клиент не может вмешаться.

  1. Добавьте Part в Workspace, назовите его Apple и покрасьте в красный. Включите Anchored и выключите CanCollide, чтобы никто не врезался в него, пока он невидим. Подсказка показывает имя парта.
  2. Выделив парт, прокрутите окно Properties до раздела Attributes и нажмите +. Добавьте ItemId с типом string и нажмите Save, затем задайте значение apple. Так же добавьте Amount типа number со значением 1.
  3. Вставьте Script в парт, назовите его ItemPickup и вставьте этот код:
Script в парт Apple в Workspace с именем ItemPickup
-- Положите этот Script внутрь Part и дайте Part два атрибута:
-- ItemId (строка, например apple) и Amount (число, например 1).
local ServerScriptService = game:GetService("ServerScriptService")

type InventoryApi = {
	add: (player: Player, itemId: string, amount: number) -> number,
	spaceFor: (player: Player, itemId: string) -> number,
}
local InventoryService = require(ServerScriptService:WaitForChild("InventoryService")) :: InventoryApi

local part = script.Parent :: BasePart
local RESPAWN_SECONDS = 15

local itemId = part:GetAttribute("ItemId")
local amount = part:GetAttribute("Amount")
if typeof(itemId) ~= "string" or typeof(amount) ~= "number" or amount < 1 then
	error(`{part:GetFullName()} needs an ItemId (string) and an Amount (number, 1 or more) attribute`)
end

local prompt = Instance.new("ProximityPrompt")
prompt.ActionText = "Pick up"
prompt.ObjectText = part.Name
prompt.Parent = part

local visibleTransparency = part.Transparency

prompt.Triggered:Connect(function(player: Player)
	if not prompt.Enabled then
		return -- кто-то другой подобрал его только что
	end
	-- Проверяем расстояние на сервере, а не верим запросу
	local character = player.Character
	if not character then
		return
	end
	local distance = (character:GetPivot().Position - part.Position).Magnitude
	if distance > prompt.MaxActivationDistance + 5 then
		return
	end
	if InventoryService.spaceFor(player, itemId) < amount then
		return -- не хватает места: оставляем предмет на месте
	end
	InventoryService.add(player, itemId, amount)

	prompt.Enabled = false
	part.Transparency = 1
	task.wait(RESPAWN_SECONDS)
	part.Transparency = visibleTransparency
	prompt.Enabled = true
end)

Копируйте парт, чтобы расставить больше предметов. Меняйте атрибуты, чтобы выдавать дерево, ещё один меч или стак яблок.

Roblox проверяет расстояние для Triggered, но его гайд по безопасности всё равно велит проверять подсказки на сервере: читер может вызывать события подсказки, даже когда Enabled равен false, и может притянуть незаанкеренный парт к своему персонажу. Поэтому скрипт сам проверяет Enabled и расстояние, и поэтому парт заанкерен.

Любой другой серверный скрипт выдаёт предметы так же. После покупки, квеста или убийства подключите InventoryService через require, как скрипты выше, и вызовите InventoryService.add(player, "wood", 5). Сначала проверяйте spaceFor, когда предмет нельзя потерять. Ещё одним источником может быть NPC: в гайде по диалогам с NPC ответ запускает действие на сервере, и это действие может так же вызвать InventoryService.add.

Шаг 6: экипировка Tool и использование предметов

Два RemoteEvent несут единственные запросы, которые может сделать клиент. EquipItem кладёт копию Tool предмета из ServerStorage в Backpack игрока (хотбар внизу экрана) и ему в руку, а повторный запрос убирает её. UseItem убирает одну штуку используемого предмета и применяет его эффект, здесь это лечение.

Вставьте Script в ServerScriptService и назовите его InventoryActions:

Script в ServerScriptService с именем InventoryActions
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerScriptService = game:GetService("ServerScriptService")
local ServerStorage = game:GetService("ServerStorage")

type Item = { id: string, toolName: string?, heal: number? }
type Catalog = { get: (id: string) -> Item? }
type InventoryApi = {
	count: (player: Player, itemId: string) -> number,
	remove: (player: Player, itemId: string, amount: number) -> boolean,
	getEquipped: (player: Player) -> string?,
	setEquipped: (player: Player, itemId: string?) -> (),
}
local ItemCatalog = require(ReplicatedStorage:WaitForChild("ItemCatalog")) :: Catalog
local InventoryService = require(ServerScriptService:WaitForChild("InventoryService")) :: InventoryApi

local remotes = ReplicatedStorage:WaitForChild("InventoryRemotes")
local equipItem = remotes:WaitForChild("EquipItem") :: RemoteEvent
local useItem = remotes:WaitForChild("UseItem") :: RemoteEvent
local itemTools = ServerStorage:WaitForChild("ItemTools")

local COOLDOWN_SECONDS = 0.25
local lastRequest: { [Player]: number } = {}

-- Каждый запрос начинается здесь. Клиент может прислать что угодно когда угодно, поэтому
-- проверяем тип, что предмет существует, что он есть у игрока, и частоту.
local function ownedItem(player: Player, itemId: unknown): Item?
	if typeof(itemId) ~= "string" then
		return nil
	end
	local now = os.clock()
	if now - (lastRequest[player] or 0) < COOLDOWN_SECONDS then
		return nil
	end
	lastRequest[player] = now
	local item = ItemCatalog.get(itemId)
	if not item or InventoryService.count(player, itemId) < 1 then
		return nil
	end
	return item
end

-- Уничтожает Tool этого предмета, где бы ни была копия: хотбар, рука или StarterGear
local function destroyTools(container: Instance?, itemId: string)
	if not container then
		return
	end
	for _, child in container:GetChildren() do
		if child:IsA("Tool") and child:GetAttribute("InventoryItem") == itemId then
			child:Destroy()
		end
	end
end

local function unequip(player: Player)
	local equippedId = InventoryService.getEquipped(player)
	if equippedId then
		destroyTools(player:FindFirstChildOfClass("Backpack"), equippedId)
		destroyTools(player.Character, equippedId)
		destroyTools(player:FindFirstChildOfClass("StarterGear"), equippedId)
		InventoryService.setEquipped(player, nil)
	end
end

local function equip(player: Player, item: Item, toolName: string)
	local template = itemTools:FindFirstChild(toolName)
	local backpack = player:FindFirstChildOfClass("Backpack")
	if not template or not template:IsA("Tool") or not backpack then
		warn(`Cannot equip {item.id}: no Tool named {toolName} in ServerStorage.ItemTools`)
		return
	end
	unequip(player) -- один экипированный инструмент за раз

	local tool = template:Clone()
	tool.CanBeDropped = false -- выброшенную копию мог бы подобрать кто-то другой
	tool:SetAttribute("InventoryItem", item.id)
	tool.Parent = backpack

	-- Вторая копия в StarterGear копируется обратно в Backpack после респавна
	local starterGear = player:FindFirstChildOfClass("StarterGear")
	if starterGear then
		local gearCopy = tool:Clone()
		gearCopy.Parent = starterGear
	end

	local character = player.Character
	local humanoid = character and character:FindFirstChildOfClass("Humanoid")
	if humanoid and humanoid.Health > 0 then
		humanoid:EquipTool(tool) -- сразу в руку
	end
	InventoryService.setEquipped(player, item.id)
end

equipItem.OnServerEvent:Connect(function(player: Player, itemId: unknown)
	local item = ownedItem(player, itemId)
	if not item or not item.toolName then
		return
	end
	if InventoryService.getEquipped(player) == item.id then
		unequip(player) -- повторный клик по экипированному предмету убирает его
	else
		equip(player, item, item.toolName)
	end
end)

useItem.OnServerEvent:Connect(function(player: Player, itemId: unknown)
	local item = ownedItem(player, itemId)
	if not item or not item.heal then
		return
	end
	local heal = item.heal
	local character = player.Character
	local humanoid = character and character:FindFirstChildOfClass("Humanoid")
	if not humanoid or humanoid.Health <= 0 or humanoid.Health >= humanoid.MaxHealth then
		return -- мёртв или уже с полным здоровьем: не тратим предмет
	end
	-- Сначала забираем предмет и лечим, только если это получилось
	if InventoryService.remove(player, item.id, 1) then
		humanoid.Health = math.min(humanoid.MaxHealth, humanoid.Health + heal)
	end
end)

Players.PlayerRemoving:Connect(function(player: Player)
	lastRequest[player] = nil
end)
Что разрешено каждому запросу
ЗапросКлиент присылаетСервер проверяет перед действием
EquipItemId предметаЭто строка, предмет существует, у игрока он есть, запросы приходят не чаще четырёх в секунду, у предмета есть toolName, и Tool с таким именем лежит в ServerStorage.ItemTools
UseItemId предметаТе же проверки типа, владения и частоты, у предмета есть значение heal, персонаж жив и ранен, и один предмет убран до того, как добавлено здоровье

Три детали не дают Tool раздвоиться или потеряться. У копии CanBeDropped равен false, потому что выброшенный Tool падает в Workspace, где его может забрать другой игрок, а оригинал при этом остаётся в инвентаре. Каждая копия несёт атрибут InventoryItem, поэтому при снятии можно найти и уничтожить каждую копию, где бы она ни была. А если у игрока есть контейнер StarterGear, в него кладётся вторая копия. Roblox копирует StarterGear в Backpack при каждом появлении персонажа, поэтому экипированный меч возвращается после респавна.

Экипирован только один Tool за раз, и экипировка не сохраняется, поэтому игрок после перезахода начинает с пустым хотбаром. Если позже добавите продажу или выбрасывание, снимайте предмет, прежде чем его последняя копия покинет инвентарь.

Меч-заглушку можно превратить в меч, который правда сражается: соберите Tool по гайду по мечу, оставьте ему имя Sword и положите в ItemTools вместо заглушки. Серверный скрипт из того гайда будет проверять каждый удар, как бы игрок ни получил меч.

Шаг 7: нарисуйте сетку инвентаря

LocalScript собирает всё окно в коде, поэтому ничего не нужно расставлять вручную. ScrollingFrame держит слоты, UIGridLayout внутри него раскладывает их рядами, а AutomaticCanvasSize увеличивает прокручиваемую область по мере добавления рядов.

В Explorer откройте StarterPlayer, вставьте LocalScript в StarterPlayerScripts и назовите его InventoryClient:

LocalScript в StarterPlayerScripts с именем InventoryClient
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")

type Item = { name: string, description: string, icon: string?, toolName: string?, heal: number? }
type Catalog = { get: (id: string) -> Item? }
type Slot = { id: string, count: number }
type Snapshot = { capacity: number, slots: { Slot }, equipped: string? }

local ItemCatalog = require(ReplicatedStorage:WaitForChild("ItemCatalog")) :: Catalog
local remotes = ReplicatedStorage:WaitForChild("InventoryRemotes")
local inventoryUpdated = remotes:WaitForChild("InventoryUpdated") :: RemoteEvent
local equipItem = remotes:WaitForChild("EquipItem") :: RemoteEvent
local useItem = remotes:WaitForChild("UseItem") :: RemoteEvent

local player = Players.LocalPlayer
local TOGGLE_KEY = Enum.KeyCode.B

local COLOURS = {
	panel = Color3.fromRGB(24, 20, 36),
	slot = Color3.fromRGB(44, 38, 64),
	empty = Color3.fromRGB(34, 30, 48),
	equipped = Color3.fromRGB(124, 77, 255),
	text = Color3.fromRGB(240, 238, 245),
	muted = Color3.fromRGB(170, 165, 185),
}

local function addCorner(parent: GuiObject, radius: number)
	local corner = Instance.new("UICorner")
	corner.CornerRadius = UDim.new(0, radius)
	corner.Parent = parent
end

local function makeLabel(parent: GuiObject, text: string, textSize: number): TextLabel
	local label = Instance.new("TextLabel")
	label.BackgroundTransparency = 1
	label.Font = Enum.Font.BuilderSansBold
	label.TextColor3 = COLOURS.text
	label.TextSize = textSize
	label.Text = text
	label.Parent = parent
	return label
end

-- 1. Собираем окно один раз. ResetOnSpawn = false сохраняет его после респавнов.
local gui = Instance.new("ScreenGui")
gui.Name = "InventoryGui"
gui.ResetOnSpawn = false
gui.Parent = player:WaitForChild("PlayerGui")

local openButton = Instance.new("TextButton")
openButton.AnchorPoint = Vector2.new(0, 0.5)
openButton.Position = UDim2.new(0, 16, 0.5, 0)
openButton.Size = UDim2.fromOffset(140, 40)
openButton.BackgroundColor3 = COLOURS.panel
openButton.Font = Enum.Font.BuilderSansBold
openButton.TextColor3 = COLOURS.text
openButton.TextSize = 18
openButton.Text = "Inventory (B)"
addCorner(openButton, 8)
openButton.Parent = gui

local panel = Instance.new("Frame")
panel.AnchorPoint = Vector2.new(0.5, 0.5)
panel.Position = UDim2.fromScale(0.5, 0.5)
panel.Size = UDim2.fromScale(0.9, 0.8)
panel.BackgroundColor3 = COLOURS.panel
panel.Visible = false
addCorner(panel, 12)
panel.Parent = gui

local sizeLimit = Instance.new("UISizeConstraint")
sizeLimit.MaxSize = Vector2.new(440, 400)
sizeLimit.Parent = panel

local title = makeLabel(panel, "Inventory", 22)
title.Position = UDim2.fromOffset(16, 8)
title.Size = UDim2.new(1, -32, 0, 32)
title.TextXAlignment = Enum.TextXAlignment.Left

local slotCount = makeLabel(panel, "", 16)
slotCount.Position = UDim2.fromOffset(16, 8)
slotCount.Size = UDim2.new(1, -32, 0, 32)
slotCount.TextColor3 = COLOURS.muted
slotCount.TextXAlignment = Enum.TextXAlignment.Right

local grid = Instance.new("ScrollingFrame")
grid.Position = UDim2.fromOffset(12, 48)
grid.Size = UDim2.new(1, -24, 1, -100)
grid.BackgroundTransparency = 1
grid.BorderSizePixel = 0
grid.CanvasSize = UDim2.new() -- AutomaticCanvasSize увеличивает его под ячейки
grid.AutomaticCanvasSize = Enum.AutomaticSize.Y
grid.ScrollingDirection = Enum.ScrollingDirection.Y
grid.ScrollBarThickness = 6
grid.Parent = panel

local layout = Instance.new("UIGridLayout")
layout.CellSize = UDim2.fromOffset(72, 72)
layout.CellPadding = UDim2.fromOffset(8, 8)
layout.SortOrder = Enum.SortOrder.LayoutOrder
layout.Parent = grid

local info = makeLabel(panel, "Click an item to equip or use it.", 16)
info.AnchorPoint = Vector2.new(0, 1)
info.Position = UDim2.new(0, 16, 1, -8)
info.Size = UDim2.new(1, -32, 0, 40)
info.Font = Enum.Font.BuilderSans
info.TextColor3 = COLOURS.muted
info.TextWrapped = true
info.TextXAlignment = Enum.TextXAlignment.Left

-- 2. Одна ячейка на слот. Это только рисует то, что прислал сервер; сам
-- инвентарь отсюда никогда не меняется.
local function makeCell(index: number, slot: Slot?, equippedId: string?)
	local cell = Instance.new("TextButton")
	cell.LayoutOrder = index
	cell.Text = ""
	cell.AutoButtonColor = slot ~= nil
	cell.BackgroundColor3 = if slot then COLOURS.slot else COLOURS.empty
	addCorner(cell, 8)
	cell.Parent = grid
	if not slot then
		return -- пустой слот
	end

	local itemId = slot.id
	local item = ItemCatalog.get(itemId)
	local name = if item then item.name else itemId

	if item and item.icon then
		local image = Instance.new("ImageLabel")
		image.BackgroundTransparency = 1
		image.Size = UDim2.fromScale(1, 1)
		image.Image = item.icon
		image.Parent = cell
	else
		local nameLabel = makeLabel(cell, name, 14)
		nameLabel.Size = UDim2.fromScale(1, 1)
		nameLabel.TextWrapped = true
	end

	if slot.count > 1 then
		local countLabel = makeLabel(cell, `x{slot.count}`, 14)
		countLabel.AnchorPoint = Vector2.new(1, 1)
		countLabel.Position = UDim2.new(1, -6, 1, -4)
		countLabel.Size = UDim2.fromOffset(40, 16)
		countLabel.TextXAlignment = Enum.TextXAlignment.Right
	end

	if itemId == equippedId then
		local outline = Instance.new("UIStroke")
		outline.ApplyStrokeMode = Enum.ApplyStrokeMode.Border
		outline.Color = COLOURS.equipped
		outline.Thickness = 3
		outline.Parent = cell
	end

	cell.MouseEnter:Connect(function()
		info.Text = if item then `{item.name}: {item.description}` else name
	end)
	cell.Activated:Connect(function()
		-- Просим, а не приказываем: сервер проверяет запрос и присылает результат
		if item and item.toolName then
			equipItem:FireServer(itemId)
		elseif item and item.heal then
			useItem:FireServer(itemId)
		end
	end)
end

local function render(snapshot: Snapshot)
	for _, child in grid:GetChildren() do
		if child:IsA("GuiButton") then
			child:Destroy()
		end
	end
	for index = 1, snapshot.capacity do
		makeCell(index, snapshot.slots[index], snapshot.equipped)
	end
	slotCount.Text = `{#snapshot.slots} / {snapshot.capacity} slots`
end

-- Сервер отправляет это после загрузки и после каждого изменения
inventoryUpdated.OnClientEvent:Connect(render)

-- 3. Открываем и закрываем кнопкой или клавишей B
local function toggle()
	panel.Visible = not panel.Visible
end

openButton.Activated:Connect(toggle)
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessedEvent: boolean)
	if not gameProcessedEvent and input.KeyCode == TOGGLE_KEY then
		toggle()
	end
end)

LocalScript в StarterPlayerScripts запускается один раз за сессию, а ResetOnSpawn = false сохраняет ScreenGui при респавне персонажа, поэтому сетка продолжает показывать последнюю копию, которую прислал сервер.

Клиент рисует по ячейке на каждый слот, включая пустые, поэтому инвентарь на 20 слотов всегда выглядит как 20 слотов. Каждое обновление уничтожает старые ячейки и строит новые, это просто и подходит для нескольких десятков слотов. Если сервер отправит InventoryUpdated раньше, чем этот скрипт к нему подключился, Roblox поставит сообщение в очередь и доставит его, как только обработчик подключится, поэтому первый инвентарь не потеряется.

Хотите нарисовать окно в Studio? Соберите ScreenGui с одним слотом-шаблоном и делайте ему Clone в makeCell. Для иконок задайте предмету в каталоге icon с загруженным вами изображением, и его ячейка покажет картинку вместо названия.

Проверьте инвентарь

  1. Нажмите Play. Откройте инвентарь кнопкой слева или клавишей B: у нового игрока есть Sword и 3 Apple, а счётчик показывает 2 / 20 slots. Пока Studio не может обращаться к дата сторам, предметы появляются через несколько секунд, после предупреждений о загрузке в Output, и не сохраняются.
  2. Кликните по Sword. Меч появится у вас в руке и в хотбаре, а его слот получит фиолетовую рамку. Кликните ещё раз, чтобы убрать его.
  3. Подойдите к парту Apple и используйте его подсказку. Стак яблок вырастет до 4, а парт исчезнет на 15 секунд.
  4. Чтобы проверить лечение, сначала уменьшите здоровье. Переключите Client/Server на Server, выделите Humanoid своего персонажа в Explorer, задайте Health равным 50, переключитесь обратно на Client и кликните по Apple.
  5. С включённым доступом Studio к API services остановите игру и запустите снова. Подобранное яблоко на месте. Если загрузка или сохранение не удались, Output об этом скажет.

Чтобы проверить с несколькими игроками, выберите в настройках теста Server & Clients с 2 клиентами. Каждый игрок видит только свой инвентарь, а меч в руке другого видят оба.

Частые ошибки и решения

Большинство проблем видно в окне Output как предупреждение или красная строка ошибки. Читайте первую: следующие ошибки часто вытекают из неё.

Infinite yield possible на вызове WaitForChild

Скрипт ждёт объект, которого нет под точно таким именем. Сравните свой Explorer с деревом из шага 1: InventoryRemotes с тремя RemoteEvent в ReplicatedStorage, ItemTools в ServerStorage и два модуля. Имена чувствительны к регистру. Гайд по ошибкам скриптов разбирает это предупреждение подробнее.

Сетка открывается, но остаётся пустой

Клиент рисует только то, что присылает сервер. Поищите в Output предупреждения Inventory load failed и проверьте, что InventoryData это Script, а не LocalScript, в ServerScriptService, и рядом лежит ModuleScript InventoryService. Если Output показывает ошибку Remote event invocation, на клиенте никто не слушает InventoryUpdated: ищите более раннюю ошибку от InventoryClient.

Предметы сбрасываются каждый раз, когда я играю в Studio

Если Output пишет Inventory not loaded: playing with starter items that will not be saved, плейс не опубликован или доступ Studio к API services выключен. Включите его, как описано в шаге 4, в тестовой копии своей игры.

Клик по мечу ничего не делает

Поищите в Output Cannot equip sword: Tool в ServerStorage.ItemTools должен называться точно как toolName в каталоге. Ещё Tool нужен парт с именем Handle, чтобы его можно было держать, если только вы не задали его RequiresHandle равным false.

Подсказка подбора появляется, но ничего не добавляется

Атрибут ItemId должен точно совпадать с id из каталога, включая регистр: apple, а не Apple. Ничего не добавляется, пока инвентарь игрока ещё загружается или когда нет места на всё количество.

Сохранение ломается после того, как я изменил, что сохраняется

Дата сторы принимают простые данные: строки, числа, булевы значения и таблицы из них. Сохранение Tool, Part или любого другого Instance падает, или значение сохраняется как nil. Сохраняйте id предмета и количество, а всё остальное восстанавливайте из каталога, как делает serialize.

Сделать с RoCode

Если вам проще описать систему, чем собирать её вручную, RoCode может собрать её в открытом у вас плейсе. Это ИИ-агент для Roblox Studio: вы описываете фичу в веб-чате, а его плагин для Studio создаёт скрипты и объекты в вашем Explorer, а не выдаёт код для вставки.

Вы пишете

Добавь инвентарь на 20 слотов со стаками предметов, сетку UI, которая открывается на B, меч из ServerStorage, который игроки могут экипировать, яблоки, которые лечат, и сохранение через DataStoreService.

RoCode делает
  • Может просмотреть ваш плейс, когда шагу это нужно, через Search Game и Search Scripts, чтобы опереться на уже имеющиеся предметы, ремоуты или код сохранения, а не добавлять вторую систему
  • Создаёт папки и RemoteEvent через Create Instance, а ModuleScript, Script и LocalScript через Create Script
  • Может собрать заготовку окна через Build UI, где есть раскладка инвентаря со слотами-заглушками; код, который заполняет слоты с сервера, пишется отдельными скриптами
  • Проверяет компиляцию каждого скрипта в Studio через Check Script, который ловит ошибки компиляции и несколько рискованных паттернов, но не проверяет типы, не линтит и не запускает ваш код

Каждая пачка изменений это точка отмены в Studio. RoCode не может включить доступ Studio к API services, это вы делаете сами. С плагином 3.9 или новее он может запустить короткий плейтест и прочитать ошибки, а с плагином 3.9.15 или новее его тестовый персонаж может нажимать клавиши и экипировать предметы, но он проверяет только то, что сам решил протестировать, поэтому сохранение проверьте плейтестом сами. Инвентарь стоит поверх других систем, таких как сохранение и инструменты, и ИИ-конструктор игр, который строит в вашем собственном плейсе в Studio, добавляет их по одному промпту за раз. Как RoCode подключается к Studio.

Частые вопросы

Использовать Backpack в Roblox вместо своего инвентаря?

Backpack это встроенный инвентарь Roblox: каждый Tool в нём показывается кнопкой в хотбаре. Если все предметы в вашей игре это Tool и вам не нужны стаки, количества и лимит слотов, его может хватить, хотя сохранять, какие Tool есть у каждого игрока, всё равно придётся. Свой инвентарь нужен для предметов, которые не являются Tool, например материалов и расходников. В этом гайде используется и то и другое: инвентарь хранит всё, а Backpack держит экипированный Tool.

Как скрыть стандартный хотбар в Roblox?

Из LocalScript вызовите StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.Backpack, false). Когда хотбар скрыт, игрокам нужен другой способ взять и убрать экипированный Tool, например кнопка, которая просит сервер вызвать Humanoid:EquipTool или Humanoid:UnequipTools.

Как сделать, чтобы слоты держали позицию для drag and drop?

Храните список фиксированной длины с одной записью на слот и помечайте пустые слоты значением вроде пустого id, а не nil, потому что Roblox не советует отправлять таблицы с nil через RemoteEvent. Затем добавьте RemoteEvent MoveItem, который присылает два номера слотов, и пусть сервер проверяет, что оба это целые числа от 1 до вместимости, прежде чем менять их местами.

Какого размера может быть сохранённый инвентарь?

Одно значение в дата сторе может занимать до 4 194 304 символов после сериализации (по документации на 30 сентября 2026). Список id и количеств занимает крошечную часть этого. Размер сохранения растит текст на каждый предмет, например свои названия или длинные описания, сохранённые для каждого предмета.

Как покупать и продавать предметы за монеты?

Делайте всё на сервере. Чтобы продать, вызовите InventoryService.remove и платите, только если он вернул true. Чтобы купить, проверьте цену и spaceFor, заберите монеты, затем вызовите add. Гайд по магазину собирает сторону покупки.

Источники и что почитать

Как проверялся код: каждый скрипт на этой странице проходит строгую проверку типов Luau с определениями Roblox API (luau-lsp, 14 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.

Попробуйте RoCode в своей игре.

Бесплатные кредиты каждый день, без карты. Установите плагин, опишите функцию и проверьте, что появилось в Studio.