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
Inventory hoạt động thế nào
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ỗ.
| Phần | Loại và vị trí | Nhiệm vụ |
|---|---|---|
ItemCatalog | ModuleScript trong ReplicatedStorage | Mỗ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ó. |
InventoryService | ModuleScript trong ServerScriptService | Giữ 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. |
InventoryData | Script trong ServerScriptService | Tải vật phẩm của người chơi khi vào game và lưu chúng. |
InventoryActions | Script trong ServerScriptService | Kiểm tra và thực hiện yêu cầu trang bị và sử dụng. |
ItemPickup | Script bên trong Part | Trao vật phẩm cho người nhặt nó. |
InventoryClient | LocalScript trong StarterPlayerScripts | Vẽ 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.
- Trong ReplicatedStorage, chèn một Folder tên
InventoryRemotes. Bên trong chèn ba RemoteEvent tênInventoryUpdated,EquipItemvàUseItem. - Trong ServerStorage, chèn một Folder tên
ItemTools. Bên trong chèn một Tool tênSword, và trong Tool chèn một Part tênHandle(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. - Thêm script dần theo từng bước. Cây bên dưới cho thấy mỗi script đặt ở đâu.
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:
-- 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:
-- 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,
addthêm phần vừa đủ chỗ và trả về con số đó. Hãy gọispaceFortrước khi bạn cần tất cả hoặc không gì cả, như lượt nhặt ở bước 5. removehoạ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.
| Hàm | Trả về | Dùng để |
|---|---|---|
add(player, itemId, amount) | Số đã thêm | Nhặt đồ, phần thưởng, mua hàng |
remove(player, itemId, amount) | true nếu đã bỏ hết | Sử dụng, bán, chế tạo |
count(player, itemId) | Tổng trên mọi stack | Kiểm tra người chơi có gì |
spaceFor(player, itemId) | Còn vừa thêm bao nhiêu | Kiểm tra trước khi thêm theo kiểu tất cả hoặc không gì cả |
getEquipped, setEquipped | Id vật phẩm đang trang bị hoặc nil | Trang bị, ở bước 6 |
load, serialize, unload | Bả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:
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
GetAsynctrả 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
canSavemớ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.
BindToCloselư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àoSetAsyncgắ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.
- Thêm một Part vào Workspace, đặt tên
Applevà 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. - Khi đang chọn part, cuộn cửa sổ Properties xuống phần Attributes và bấm +. Thêm
ItemIdkiểu string và bấm Save, rồi đặt giá trịapple. Làm tương tự để thêmAmountkiểu number với giá trị1. - Chèn một Script vào part, đặt tên
ItemPickupvà dán code này:
-- Đặ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:
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)
| Yêu cầu | Client gửi | Server kiểm tra trước khi làm |
|---|---|---|
EquipItem | Id 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 |
UseItem | Id vật phẩm | Cù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:
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
- 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.
- 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ó.
- Đ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.
- Để thử hồi máu, trước tiên hãy giảm máu. Chuyển Client/Server sang Server, chọn
Humanoidcủ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. - 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.
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.
- 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
- Roblox Creator Docs: Remote events and callbacks (tiếng Anh). FireClient, OnServerEvent, giới hạn về đối số và cách tin nhắn chưa có người nhận được xếp hàng đợi
- Roblox Creator Docs: Securing the client-server boundary (tiếng Anh). kiểm tra dữ liệu đầu vào của remote, kiểm tra ProximityPrompt và giả mạo dữ liệu trong data store
- Roblox Creator Docs: Data stores (tiếng Anh). GetAsync, SetAsync và bật quyền truy cập từ Studio
- Roblox Creator Docs: Best practices for data stores (tiếng Anh). một key cho mỗi người chơi, mẫu key và lưu định kỳ
- Roblox Creator Docs: Data store error codes and limits (tiếng Anh). giới hạn yêu cầu trên mỗi server và giới hạn kích thước một giá trị
- Roblox Creator Docs: In-game tools (tiếng Anh). Handle, anchor, Backpack và StarterGear
- Roblox Creator Docs: Grid and table layouts (tiếng Anh). kích thước ô UIGridLayout, khoảng cách và thứ tự sắp xếp
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.