Hướng dẫn · Hệ thống game

Cách làm inventory trong Roblox Studio

Inventory trông như một việc về giao diện, nhưng việc nó có bị hack hay làm mất vật phẩm hay không lại do nơi lưu vật phẩm quyết định. Trong hướng dẫn này, vật phẩm của mỗi người chơi nằm trong một bảng trên server, mỗi người chơi nhận một bản sao và vẽ nó thành lưới, trang bị Tool và dùng vật phẩm tiêu hao qua các yêu cầu được server kiểm tra, và mọi thứ được lưu vào data store.

Cập nhật ngày 20 tháng 11, 202618 phút đọcTác giả:

Tóm tắt

Lưu vật phẩm của mỗi người chơi trong một bảng trên server, bên trong ModuleScript trong ServerScriptService, và chỉ code này mới được thêm, bớt và gộp chúng thành stack. Mô tả vật phẩm một lần trong ModuleScript trong ReplicatedStorage (id, tên, stack tối đa). Sau mỗi thay đổi, server gửi cho đúng người chơi đó một RemoteEvent kèm bản sao inventory của họ, còn LocalScript vẽ nó thành lưới bằng ScrollingFrame và UIGridLayout.

  • Client không bao giờ tự thêm vật phẩm. Nó chỉ có thể yêu cầu, ví dụ "trang bị kiếm của tôi", và server kiểm tra người chơi có món đó trước khi làm gì.
  • Vật phẩm chỉ xuất hiện qua code server do bạn kiểm soát: nhặt đồ, mua trong shop sau khi server kiểm tra, phần thưởng.
  • Lưu id vật phẩm và số lượng, không lưu Tool, bằng DataStoreService khi người chơi thoát, khi server tắt và cứ vài phút một lần. Không bao giờ lưu người chơi mà dữ liệu chưa tải được.
Trong trang này
  1. Cách hoạt động
  2. Vì sao vật phẩm ở server
  3. 1. Chuẩn bị Explorer
  4. 2. Catalog vật phẩm
  5. 3. Inventory trên server
  6. 4. Tải và lưu
  7. 5. Nhặt vật phẩm
  8. 6. Trang bị và sử dụng
  9. 7. Lưới UI
  10. Kiểm tra
  11. Common errors
  12. Với RoCode
  13. Câu hỏi thường gặp
  14. Nguồn và tài liệu đọc thêm

Inventory hoạt động thế nào

Minh họaNhấn B, rê chuột lên vật phẩm để đọc mô tả, bấm vào Sword để cầm nó trên tay.

Hệ thống gồm sáu phần nhỏ, mỗi phần một nhiệm vụ. Mọi quy tắc về vật phẩm nằm trong một module server duy nhất, nên khi có gì hỏng, bạn chỉ cần tìm ở đúng một chỗ.

Các phần của hệ thống và nơi chúng chạy
PhầnLoại và vị tríNhiệm vụ
ItemCatalogModuleScript trong ReplicatedStorageMỗi vật phẩm là gì: tên, mô tả, stack tối đa và có trang bị hoặc dùng được không. Server và mọi client đều đọc nó.
InventoryServiceModuleScript trong ServerScriptServiceGiữ slot của tất cả người chơi. Là code duy nhất thêm, bớt và gộp vật phẩm thành stack.
InventoryDataScript trong ServerScriptServiceTải vật phẩm của người chơi khi vào game và lưu chúng.
InventoryActionsScript trong ServerScriptServiceKiểm tra và thực hiện yêu cầu trang bị và sử dụng.
ItemPickupScript bên trong PartTrao vật phẩm cho người nhặt nó.
InventoryClientLocalScript trong StarterPlayerScriptsVẽ lưới và gửi yêu cầu. Bản thân nó không thay đổi gì.

Dữ liệu đi theo một chiều. Server thay đổi inventory, rồi gửi cho người chơi đó InventoryUpdated kèm toàn bộ inventory, và client vẽ lại. Khi người chơi bấm vào một slot, client gửi EquipItem hoặc UseItem kèm id vật phẩm; server kiểm tra yêu cầu, thực hiện thay đổi, và bản sao mới quay về theo đúng đường đó. Gửi cả inventory đơn giản hơn gửi từng thay đổi, và với vài chục slot thì gói tin vẫn nhỏ.

Vì sao client không bao giờ tự thêm vật phẩm

Bạn sẽ muốn thêm vật phẩm ngay trong LocalScript đang hiển thị nó: người chơi bấm, slot được lấp đầy. Cách này hỏng theo hai kiểu.

  • Không ai khác thấy được. Thay đổi trong LocalScript chỉ tồn tại trên thiết bị của người chơi đó. Server không biết gì về nó, nên nó không được lưu và không script server nào dùng được.
  • Ai cũng giả mạo được. Nếu sửa bằng một remote kiểu AddItem(itemId, amount), kẻ gian lận có thể tự gọi event đó, với bất kỳ đối số nào và bao nhiêu lần cũng được. Hướng dẫn bảo mật của Roblox nói server phải kiểm tra mọi thứ client gửi lên trước khi dùng.

Vì vậy trong hướng dẫn này client chỉ có thể yêu cầu làm gì đó với vật phẩm người chơi đã có: "trang bị món này" và "dùng món này". Mỗi yêu cầu chỉ có một id vật phẩm, không có số lượng, và trên server nó qua một lượt kiểm tra: đó là chuỗi, vật phẩm đó tồn tại, người chơi có ít nhất một cái, và người chơi gửi không quá bốn yêu cầu mỗi giây. Sau đó server tự tìm Tool theo catalog. Nó không bao giờ nhận Tool, đường dẫn hay instance từ client, đúng như hướng dẫn đó cảnh báo.

Vật phẩm chỉ vào inventory qua code server: lượt nhặt mà server đã kiểm tra, lượt mua mà server đã trừ tiền (phần này được dựng trong hướng dẫn làm shop), phần thưởng nhiệm vụ hoặc đồ rơi. Về remote nói chung, kèm cách kiểm tra các kiểu đối số khác, hãy đọc hướng dẫn RemoteEvent.

Bước 1: chuẩn bị Explorer

Tạo các object này bằng tay. Script ở các bước sau tìm chúng theo tên, nên hãy gõ mỗi tên đúng y như ở đây.

  1. Trong ReplicatedStorage, chèn một Folder tên InventoryRemotes. Bên trong chèn ba RemoteEvent tên InventoryUpdated, EquipItem và UseItem.
  2. Trong ServerStorage, chèn một Folder tên ItemTools. Bên trong chèn một Tool tên Sword, và trong Tool chèn một Part tên Handle (1 x 4 x 1 stud là ổn). Kiểm tra rằng ô Anchored của Handle đã bỏ chọn: Roblox cảnh báo nhân vật sẽ bị kẹt tại chỗ nếu cầm tool có part bị anchor. Tool bạn đã có cũng dùng được, miễn là tên của nó khớp với catalog ở bước 2.
  3. Thêm script dần theo từng bước. Cây bên dưới cho thấy mỗi script đặt ở đâu.
Explorer khi đã làm xong hướng dẫn
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

Bước 2: mô tả vật phẩm trong catalog

Catalog mô tả mỗi vật phẩm có thể tồn tại, một lần duy nhất. Sau đó inventory chỉ lưu id vật phẩm và số lượng. Nhờ vậy dữ liệu lưu luôn nhỏ, và sau này bạn có thể đổi tên vật phẩm hoặc viết lại mô tả mà không đụng tới dữ liệu đã lưu của ai.

Chèn một ModuleScript vào ReplicatedStorage, đặt tên ItemCatalog và thay nội dung của nó bằng đoạn này:

ModuleScript trong ReplicatedStorage tên là ItemCatalog
-- Mọi vật phẩm có thể có trong game. Danh sách này được server và mọi
-- client đọc; chỉ server quyết định ai có gì.
export type Item = {
	id: string, -- phải trùng với key bên dưới
	name: string,
	description: string,
	maxStack: number, -- bao nhiêu cái vật phẩm này vừa một slot
	icon: string?, -- ảnh tùy chọn: "rbxassetid://" cộng ID ảnh của bạn
	toolName: string?, -- Tool trong ServerStorage.ItemTools: vật phẩm trang bị được
	heal: number?, -- hồi bao nhiêu máu: vật phẩm tiêu hao
}

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 = {}

-- Trả về vật phẩm có id này, hoặc nil nếu không có vật phẩm đó
function ItemCatalog.get(id: string): Item?
	return items[id]
end

return ItemCatalog

Các trường tùy chọn quyết định vật phẩm làm gì. toolName khiến nó trang bị được, heal khiến nó dùng được, còn vật phẩm không có cả hai trường, như gỗ, nằm trong inventory cho tới khi code server khác lấy nó đi (chế tạo, bán).

Để thêm vật phẩm, thêm một mục có key và id giống nhau. Id phân biệt hoa thường và chính chúng được lưu lại, nên đừng bao giờ đổi id khi người chơi đã có vật phẩm đó: hãy đổi name của nó.

Bước 3: giữ inventory trên server

ModuleScript này sở hữu inventory của mọi người chơi. Mỗi inventory là một danh sách slot, mỗi slot có id vật phẩm và số lượng, cộng sức chứa 20 slot. Các script server khác gọi hàm của nó, và không ai khác sửa bảng này.

Chèn một ModuleScript vào ServerScriptService và đặt tên InventoryService:

ModuleScript trong ServerScriptService tên là InventoryService
-- Code duy nhất thay đổi inventory. Nó nằm trong ServerScriptService,
-- nơi client không thể thấy cũng không thể chạy nó.
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- Chế độ strict không biết require qua WaitForChild trả về gì, nên
-- ta mô tả phần của module mà script này dùng
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 -- số slot mỗi người chơi
local STARTER_ITEMS: { Slot } = { -- người chơi hoàn toàn mới bắt đầu với gì
	{ id = "sword", count = 1 },
	{ id = "apple", count = 3 },
}

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

local InventoryService = {}

-- Gửi cho chủ sở hữu bản sao inventory của họ. Gọi sau mỗi thay đổi.
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

-- Quy tắc stack: trước tiên lấp đầy các stack chưa đầy, sau đó tạo stack mới
-- trong slot trống. Trả về số đã thêm, có thể ít hơn số yêu cầu.
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

-- Còn vừa thêm bao nhiêu cái: chỗ trống trong các stack của nó cộng slot trống
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

-- Thêm tối đa amount cái vật phẩm. Trả về số đã thêm (0 nếu
-- không có vật phẩm đó, inventory đầy hoặc chưa tải xong).
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

-- Bỏ đúng amount cái vật phẩm, bắt đầu từ các stack cuối.
-- Nếu người chơi có ít hơn, không bỏ gì và trả về 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
	-- Đi từ cuối lên để table.remove không bỏ sót slot
	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

-- Được gọi khi dữ liệu đã lưu của người chơi tải xong. saved là thứ
-- data store trả về: nil với người chơi mới. Mỗi mục lại đi qua
-- quy tắc stack, nên vật phẩm đã xóa và kích thước stack cũ không làm hỏng gì.
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

-- Bản sao đơn giản để lưu, hoặc nil nếu dữ liệu của người chơi chưa từng tải được
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

Các dòng type và phép ép kiểu :: sau require chỉ cần cho trình kiểm tra kiểu Luau, vốn không biết module tìm qua WaitForChild trả về gì. Khi chơi chúng không thay đổi gì. Các script còn lại trong hướng dẫn này cũng làm như vậy.

Quy tắc stack hoạt động thế nào với catalog ở trên, nơi táo xếp chồng tới 10:

  • Nếu thêm 15 quả táo cho người chơi đang có stack 7 quả, stack đó được lấp đầy tới 10, rồi một stack mới 5 quả bắt đầu.
  • Khi hết slot, add thêm phần vừa đủ chỗ và trả về con số đó. Hãy gọi spaceFor trước khi bạn cần tất cả hoặc không gì cả, như lượt nhặt ở bước 5.
  • remove hoạt động theo kiểu tất cả hoặc không gì cả. Yêu cầu 3 quả táo từ người chơi chỉ có 2 sẽ không bỏ gì và trả về false, nên hãy kiểm tra kết quả trước khi đưa thứ gì đó để đổi lại.
  • Danh sách slot không có lỗ hổng: khi một slot trống, các slot còn lại dồn lên. Nhờ vậy danh sách dễ gửi và lưu hơn. Về slot giữ nguyên vị trí, xem phần câu hỏi ở cuối.
Các script server khác có thể gọi gì
HàmTrả vềDùng để
add(player, itemId, amount)Số đã thêmNhặt đồ, phần thưởng, mua hàng
remove(player, itemId, amount)true nếu đã bỏ hếtSử dụng, bán, chế tạo
count(player, itemId)Tổng trên mọi stackKiểm tra người chơi có gì
spaceFor(player, itemId)Còn vừa thêm bao nhiêuKiểm tra trước khi thêm theo kiểu tất cả hoặc không gì cả
getEquipped, setEquippedId vật phẩm đang trang bị hoặc nilTrang bị, ở bước 6
load, serialize, unloadBản sao sẵn sàng để lưu (serialize)Tải và lưu, ở bước 4

Bước 4: tải và lưu từng inventory

Inventory sống trong bộ nhớ server, nên biến mất khi người chơi thoát. Script này tải slot của người chơi từ data store khi họ vào, và ghi lại khi họ thoát, khi server tắt và cứ ba phút một lần phòng khi server bị crash. Nó chỉ lưu id vật phẩm và số lượng: data store không lưu được Instance, ví dụ Tool.

Chèn một Script vào ServerScriptService và đặt tên InventoryData:

Script trong ServerScriptService tên là 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

-- Chỉ lưu những người chơi mà dữ liệu đã tải xong. Sau khi tải thất bại
-- không được lưu, nếu không inventory trống sẽ ghi đè inventory thật.
local canSave: { [Player]: boolean } = {}
local activeSaves = 0

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

-- Một yêu cầu thất bại không được làm ai mất vật phẩm, nên ta thử vài lần.
-- GetDataStore cũng nằm trong pcall, nên một phiên Studio không có quyền truy cập data
-- store chỉ nhận cảnh báo chứ không làm script này dừng lại.
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 -- người chơi đã thoát trong lúc ta đang tải
	end
	if ok then
		InventoryService.load(player, saved) -- saved là nil với người chơi mới
		canSave[player] = true
	elseif RunService:IsStudio() then
		-- Thường có nghĩa là quyền truy cập API services của Studio đang tắt. Chơi với
		-- vật phẩm khởi đầu để có thể thử nghiệm, nhưng không bao giờ lưu chúng.
		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 -- dữ liệu chưa từng tải được, không có gì an toàn để ghi
	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)

-- Khi server tắt, lưu mọi người còn ở đây và chờ từng lượt lưu
-- đang chạy, kể cả những lượt do PlayerRemoving khởi động
game:BindToClose(function()
	for _, player in Players:GetPlayers() do
		task.spawn(save, player)
	end
	while activeSaves > 0 do
		task.wait()
	end
end)

-- Lưu mọi người vài phút một lần, để server crash chỉ mất vài phút chứ không mất cả phiên chơi
while true do
	task.wait(AUTOSAVE_SECONDS)
	for _, player in Players:GetPlayers() do
		task.spawn(save, player)
	end
end

Script làm gì và vì sao:

  • Tải với giá trị mặc định. Người chơi mới không có giá trị đã lưu, nên GetAsync trả về nil và họ nhận vật phẩm khởi đầu. Slot đã lưu lại đi qua quy tắc stack, nên vật phẩm bị xóa khỏi catalog hoặc stack tối đa bị giảm sẽ không làm hỏng việc tải. Thứ gì không còn vừa hoặc có id không còn trong catalog sẽ bị bỏ, và lần lưu tiếp theo khiến việc đó thành vĩnh viễn, nên hãy giữ trong catalog mọi id mà người chơi có thể đang có.
  • Không bao giờ lưu sau khi tải thất bại. Chỉ những người chơi trong canSave mới được ghi. Trên server thật, người chơi mà dữ liệu vẫn không tải được sau ba lần thử sẽ được yêu cầu vào lại. Trong Studio họ nhận vật phẩm khởi đầu không được lưu, chậm vài giây vì các lần thử lại. Sẽ như vậy cho tới khi place được publish với quyền truy cập API đã bật.
  • Lưu khi thoát và khi tắt server. BindToClose lưu mọi người còn trên server và chờ các lượt lưu đang chạy. Roblox cho các hàm được bind tối đa 30 giây.
  • Không vượt giới hạn. Một lần ghi mỗi người chơi mỗi ba phút cộng một lần khi thoát là ít hơn nhiều so với ngân sách chuẩn của server là 60 lần ghi mỗi phút cộng 40 cho mỗi người chơi (theo tài liệu ngày 30 tháng 9 năm 2026). Mẫu key User_ lấy từ khuyến nghị của Roblox, còn việc truyền user ID vào SetAsync gắn dữ liệu với người chơi đó, điều Roblox rất khuyến khích để xử lý yêu cầu xóa dữ liệu.

Với game nhỏ, đây là nền tảng đáng tin cậy. Khóa phiên (session locking), thứ ngăn người chơi đổi server nhanh tải dữ liệu trước khi server cũ kịp lưu, và khi nào nên dùng UpdateAsync thay cho SetAsync, được giải thích trong hướng dẫn DataStore.

Bước 5: trao vật phẩm từ thế giới game

Nhặt đồ là cách đơn giản nhất để vật phẩm vào inventory: một part có ProximityPrompt thêm vật phẩm khi người chơi dùng nó. Script lắng nghe event Triggered của nó trên server, nên vật phẩm được thêm ở nơi client không thể can thiệp.

  1. Thêm một Part vào Workspace, đặt tên Apple và tô màu đỏ. Bật Anchored và tắt CanCollide, để không ai va vào nó khi nó đang vô hình. Lời nhắc hiển thị tên của part.
  2. Khi đang chọn part, cuộn cửa sổ Properties xuống phần Attributes và bấm +. Thêm ItemId kiểu string và bấm Save, rồi đặt giá trị apple. Làm tương tự để thêm Amount kiểu number với giá trị 1.
  3. Chèn một Script vào part, đặt tên ItemPickup và dán code này:
Script trong part Apple trong Workspace tên là ItemPickup
-- Đặt Script này bên trong một Part và cho Part hai attribute:
-- ItemId (chuỗi, ví dụ apple) và Amount (số, ví dụ 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 -- người khác vừa nhặt nó
	end
	-- Kiểm tra khoảng cách trên server, không tin vào yêu cầu
	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 -- không đủ chỗ: để vật phẩm ở nguyên chỗ
	end
	InventoryService.add(player, itemId, amount)

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

Nhân bản part để đặt thêm vật phẩm. Đổi attribute để trao gỗ, thêm một thanh kiếm hoặc một stack táo.

Roblox có kiểm tra khoảng cách cho Triggered, nhưng hướng dẫn bảo mật của họ vẫn bảo kiểm tra lời nhắc trên server: kẻ gian lận có thể kích hoạt event của lời nhắc ngay cả khi Enabled là false, và có thể kéo một part không anchor tới nhân vật của họ. Vì vậy script tự kiểm tra Enabled và khoảng cách, và vì vậy part được anchor.

Mọi script server khác trao vật phẩm theo cùng cách. Sau một lượt mua, nhiệm vụ hoặc hạ gục, hãy require InventoryService như các script ở trên và gọi InventoryService.add(player, "wood", 5). Hãy kiểm tra spaceFor trước khi vật phẩm không được phép mất. NPC cũng có thể là một nguồn: trong hướng dẫn hội thoại NPC, một câu trả lời kích hoạt hành động trên server, và hành động đó cũng có thể gọi InventoryService.add.

Bước 6: trang bị Tool và sử dụng vật phẩm

Hai RemoteEvent mang những yêu cầu duy nhất mà client được gửi. EquipItem đặt một bản sao Tool của vật phẩm từ ServerStorage vào Backpack của người chơi (hotbar ở dưới màn hình) và lên tay họ, còn yêu cầu lần nữa sẽ cất nó đi. UseItem bỏ một cái vật phẩm dùng được và áp dụng hiệu ứng của nó, ở đây là hồi máu.

Chèn một Script vào ServerScriptService và đặt tên InventoryActions:

Script trong ServerScriptService tên là 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 } = {}

-- Mọi yêu cầu bắt đầu ở đây. Client có thể gửi bất cứ thứ gì vào bất cứ lúc nào, nên
-- ta kiểm tra kiểu, vật phẩm có tồn tại, người chơi có nó không, và tần suất.
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

-- Hủy Tool của vật phẩm này ở bất cứ đâu có bản sao: hotbar, tay hoặc 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) -- mỗi lúc chỉ một tool được trang bị

	local tool = template:Clone()
	tool.CanBeDropped = false -- bản sao bị vứt ra có thể bị người khác nhặt
	tool:SetAttribute("InventoryItem", item.id)
	tool.Parent = backpack

	-- Bản sao thứ hai trong StarterGear được chép lại vào Backpack sau khi hồi sinh
	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) -- lên tay ngay
	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) -- bấm lại vào vật phẩm đang trang bị sẽ cất nó
	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 -- đã chết hoặc đầy máu: không tốn vật phẩm
	end
	-- Lấy vật phẩm đi trước, và chỉ hồi máu nếu việc đó thành công
	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)
Mỗi yêu cầu được phép làm gì
Yêu cầuClient gửiServer kiểm tra trước khi làm
EquipItemId vật phẩmĐó là chuỗi, vật phẩm tồn tại, người chơi có nó, yêu cầu đến không quá bốn lần mỗi giây, vật phẩm có toolName, và Tool có tên đó nằm trong ServerStorage.ItemTools
UseItemId vật phẩmCùng các kiểm tra về kiểu, quyền sở hữu và tần suất, vật phẩm có giá trị heal, nhân vật còn sống và bị thương, và một vật phẩm được bỏ đi trước khi máu được cộng

Ba chi tiết giúp Tool không bị nhân đôi hay biến mất. Bản sao có CanBeDropped là false, vì Tool bị vứt sẽ rơi vào Workspace, nơi người chơi khác có thể lấy, trong khi bản gốc vẫn ở trong inventory. Mỗi bản sao mang attribute InventoryItem, nên khi cất đi có thể tìm và hủy mọi bản sao ở bất cứ đâu. Và nếu người chơi có container StarterGear, bản sao thứ hai được đặt vào đó. Roblox chép StarterGear vào Backpack mỗi lần nhân vật xuất hiện, nên thanh kiếm đang trang bị quay lại sau khi hồi sinh.

Mỗi lúc chỉ trang bị một Tool, và trạng thái trang bị không được lưu, nên sau khi vào lại người chơi bắt đầu với hotbar trống. Nếu sau này bạn thêm bán hoặc vứt đồ, hãy cất vật phẩm trước khi bản sao cuối cùng của nó rời inventory.

Thanh kiếm giữ chỗ có thể biến thành thanh kiếm chiến đấu thật: dựng Tool theo hướng dẫn làm kiếm, giữ tên Sword và đặt vào ItemTools thay cho bản giữ chỗ. Script server trong hướng dẫn đó sẽ kiểm tra từng đòn đánh, bất kể người chơi có kiếm bằng cách nào.

Bước 7: vẽ lưới inventory

LocalScript dựng toàn bộ cửa sổ bằng code, nên không cần sắp xếp gì bằng tay. ScrollingFrame chứa các slot, UIGridLayout bên trong nó xếp chúng thành hàng, còn AutomaticCanvasSize mở rộng vùng cuộn khi có thêm hàng.

Trong Explorer mở StarterPlayer, chèn một LocalScript vào StarterPlayerScripts và đặt tên InventoryClient:

LocalScript trong StarterPlayerScripts tên là 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. Dựng cửa sổ một lần. ResetOnSpawn = false giữ nó qua các lần hồi sinh.
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 mở rộng nó theo các ô
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. Mỗi slot một ô. Phần này chỉ vẽ những gì server gửi; bản thân
-- inventory không bao giờ bị thay đổi từ đây.
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 -- slot trống
	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()
		-- Yêu cầu chứ không ra lệnh: server kiểm tra yêu cầu và gửi lại kết quả
		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

-- Server gửi cái này sau khi tải và sau mỗi thay đổi
inventoryUpdated.OnClientEvent:Connect(render)

-- 3. Mở và đóng bằng nút hoặc phím 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 trong StarterPlayerScripts chạy một lần mỗi phiên, còn ResetOnSpawn = false giữ ScreenGui khi nhân vật hồi sinh, nên lưới tiếp tục hiển thị bản sao mới nhất server đã gửi.

Client vẽ một ô cho mỗi slot, kể cả slot trống, nên inventory 20 slot luôn trông như 20 slot. Mỗi lần cập nhật sẽ hủy các ô cũ và dựng ô mới, cách này đơn giản và hợp với vài chục slot. Nếu server gửi InventoryUpdated trước khi script này kịp kết nối, Roblox sẽ xếp tin nhắn vào hàng đợi và giao nó ngay khi handler được kết nối, nên inventory đầu tiên không bị mất.

Muốn vẽ cửa sổ trong Studio? Dựng một ScreenGui với một slot mẫu và gọi Clone nó trong makeCell. Để có icon, đặt cho vật phẩm trong catalog trường icon với ảnh bạn đã tải lên, và ô của nó sẽ hiển thị ảnh thay cho tên.

Kiểm tra inventory

  1. Nhấn Play. Mở inventory bằng nút bên trái hoặc phím B: người chơi mới có Sword và 3 Apple, còn bộ đếm hiển thị 2 / 20 slots. Khi Studio chưa truy cập được data store, vật phẩm xuất hiện sau vài giây, sau các cảnh báo tải trong Output, và không được lưu.
  2. Bấm vào Sword. Thanh kiếm xuất hiện trên tay bạn và trên hotbar, còn slot của nó được viền tím. Bấm lần nữa để cất nó.
  3. Đi tới part Apple và dùng lời nhắc của nó. Stack táo tăng lên 4, còn part biến mất trong 15 giây.
  4. Để thử hồi máu, trước tiên hãy giảm máu. Chuyển Client/Server sang Server, chọn Humanoid của nhân vật bạn trong Explorer, đặt Health bằng 50, chuyển lại sang Client và bấm vào Apple.
  5. Khi đã bật quyền truy cập API services của Studio, dừng game rồi chạy lại. Quả táo đã nhặt vẫn còn. Nếu tải hoặc lưu thất bại, Output sẽ báo.

Để thử với nhiều người chơi, trong cài đặt test chọn Server & Clients với 2 client. Mỗi người chơi chỉ thấy inventory của mình, còn thanh kiếm trên tay người kia thì cả hai đều thấy.

Lỗi thường gặp và cách sửa

Phần lớn vấn đề hiện trong cửa sổ Output dưới dạng cảnh báo hoặc dòng lỗi màu đỏ. Hãy đọc dòng đầu tiên: các lỗi sau thường bắt nguồn từ nó.

Infinite yield possible ở lệnh gọi WaitForChild

Script đang chờ một object không tồn tại với đúng tên đó. So sánh Explorer của bạn với cây ở bước 1: InventoryRemotes với ba RemoteEvent trong ReplicatedStorage, ItemTools trong ServerStorage và hai module. Tên phân biệt hoa thường. Hướng dẫn về lỗi script giải thích cảnh báo này chi tiết hơn.

Lưới mở ra nhưng vẫn trống

Client chỉ vẽ những gì server gửi. Tìm trong Output các cảnh báo Inventory load failed và kiểm tra rằng InventoryData là Script chứ không phải LocalScript, nằm trong ServerScriptService, và bên cạnh có ModuleScript InventoryService. Nếu Output báo lỗi Remote event invocation, trên client không có ai lắng nghe InventoryUpdated: hãy tìm lỗi sớm hơn từ InventoryClient.

Vật phẩm bị reset mỗi lần tôi chơi trong Studio

Nếu Output ghi Inventory not loaded: playing with starter items that will not be saved, place chưa được publish hoặc quyền truy cập API services của Studio đang tắt. Bật nó như mô tả ở bước 4, trong một bản sao thử nghiệm của game.

Bấm vào kiếm không có tác dụng gì

Tìm trong Output Cannot equip sword: Tool trong ServerStorage.ItemTools phải có tên đúng như toolName trong catalog. Tool cũng cần một part tên Handle để có thể cầm, trừ khi bạn đặt RequiresHandle của nó bằng false.

Lời nhắc nhặt đồ hiện ra nhưng không có gì được thêm

Attribute ItemId phải trùng chính xác với id trong catalog, kể cả hoa thường: apple, không phải Apple. Không có gì được thêm khi inventory của người chơi còn đang tải hoặc khi không đủ chỗ cho toàn bộ số lượng.

Việc lưu bị hỏng sau khi tôi đổi thứ được lưu

Data store nhận dữ liệu đơn giản: chuỗi, số, giá trị boolean và bảng chứa chúng. Lưu Tool, Part hay bất kỳ Instance nào khác sẽ thất bại, hoặc giá trị được lưu thành nil. Hãy lưu id vật phẩm và số lượng, còn mọi thứ khác dựng lại từ catalog, như serialize làm.

Làm bằng RoCode

Nếu bạn thấy mô tả hệ thống dễ hơn tự dựng bằng tay, RoCode có thể dựng nó trong place bạn đang mở. Đây là AI agent cho Roblox Studio: bạn mô tả tính năng trong web chat, còn plugin cho Studio của nó tạo script và object trong Explorer của bạn, không phải đưa code để bạn dán.

Bạn gõ

Thêm inventory 20 slot có stack vật phẩm, lưới UI mở bằng phím B, một thanh kiếm từ ServerStorage mà người chơi có thể trang bị, táo để hồi máu, và lưu bằng DataStoreService.

RoCode làm
  • Có thể xem qua place của bạn khi bước đó cần, bằng Search Game và Search Scripts, để dựa trên vật phẩm, remote hoặc code lưu dữ liệu bạn đã có thay vì thêm một hệ thống thứ hai
  • Tạo folder và RemoteEvent bằng Create Instance, còn ModuleScript, Script và LocalScript bằng Create Script
  • Có thể dựng khung cửa sổ bằng Build UI, trong đó có bố cục inventory với slot giữ chỗ; code lấp slot từ server được viết bằng các script riêng
  • Kiểm tra từng script biên dịch được trong Studio bằng Check Script, công cụ bắt lỗi biên dịch và vài mẫu code rủi ro, nhưng không kiểm tra kiểu, không lint và không chạy code của bạn

Mỗi đợt thay đổi là một điểm hoàn tác trong Studio. RoCode không thể bật quyền truy cập API services của Studio, việc đó bạn tự làm. Với plugin 3.9 trở lên nó có thể chạy một lượt playtest ngắn và đọc lỗi, còn với plugin 3.9.15 trở lên nhân vật thử nghiệm của nó có thể nhấn phím và trang bị vật phẩm, nhưng nó chỉ kiểm tra những gì nó tự quyết định thử, nên hãy tự playtest phần lưu dữ liệu. Inventory nằm trên các hệ thống khác như lưu dữ liệu và tool, và AI tạo game dựng ngay trong place của chính bạn trong Studio thêm chúng mỗi lần một prompt. RoCode kết nối với Studio thế nào.

Câu hỏi thường gặp

Có nên dùng Backpack của Roblox thay cho inventory riêng?

Backpack là inventory có sẵn của Roblox: mỗi Tool trong đó hiện thành một nút trên hotbar. Nếu mọi vật phẩm trong game của bạn đều là Tool và bạn không cần stack, số lượng và giới hạn slot, nó có thể đủ, dù bạn vẫn phải lưu xem mỗi người chơi có Tool nào. Inventory riêng cần cho các vật phẩm không phải Tool, ví dụ nguyên liệu và đồ tiêu hao. Hướng dẫn này dùng cả hai: inventory giữ mọi thứ, còn Backpack giữ Tool đang trang bị.

Làm sao ẩn hotbar mặc định trong Roblox?

Từ LocalScript, gọi StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.Backpack, false). Khi hotbar bị ẩn, người chơi cần cách khác để cầm và cất Tool đang trang bị, ví dụ một nút yêu cầu server gọi Humanoid:EquipTool hoặc Humanoid:UnequipTools.

Làm sao để slot giữ nguyên vị trí cho drag and drop?

Lưu một danh sách có độ dài cố định với mỗi slot một mục và đánh dấu slot trống bằng giá trị như id rỗng chứ không phải nil, vì Roblox khuyên không gửi bảng chứa nil qua RemoteEvent. Sau đó thêm RemoteEvent MoveItem gửi hai số slot, và để server kiểm tra cả hai là số nguyên từ 1 tới sức chứa trước khi đổi chỗ chúng.

Inventory đã lưu có thể lớn tới mức nào?

Một giá trị trong data store có thể dài tới 4 194 304 ký tự sau khi serialize (theo tài liệu ngày 30 tháng 9 năm 2026). Danh sách id và số lượng chỉ chiếm một phần rất nhỏ trong đó. Thứ làm dữ liệu lưu phình to là văn bản theo từng vật phẩm, ví dụ tên tự đặt hoặc mô tả dài được lưu cho mỗi vật phẩm.

Làm sao mua và bán vật phẩm bằng xu?

Làm mọi thứ trên server. Để bán, gọi InventoryService.remove và chỉ trả tiền nếu nó trả về true. Để mua, kiểm tra giá và spaceFor, trừ xu, rồi gọi add. Hướng dẫn làm shop dựng phần mua hàng.

Nguồn và tài liệu đọc thêm

Cách kiểm tra code: mọi script trong trang này đều qua trình kiểm tra kiểu nghiêm ngặt (strict) của Luau với định nghĩa API của Roblox (luau-lsp, 20 tháng 11, 2026). Kiểm tra kiểu bắt được API gõ sai và kiểu dữ liệu sai, không bắt được lỗi logic của game, nên hãy thử trong Studio trước khi xuất bản.

Thử RoCode trong chính game của bạn.

Mỗi ngày có credit miễn phí, không cần thẻ. Cài plugin, mô tả tính năng và xem kết quả xuất hiện trong Studio.