Με λίγα λόγια
Κρατήστε τα αντικείμενα και τις τιμές σε ένα ModuleScript στο ReplicatedStorage, φτιάξτε το παράθυρο από ScreenGui, ScrollingFrame και UIGridLayout και αφήστε κάθε κουμπί Buy να καλεί ένα RemoteFunction στέλνοντας μόνο το id του αντικειμένου. Μετά ένα Script στο ServerScriptService βρίσκει μόνο του την τιμή, ελέγχει και αφαιρεί τα Coins του παίκτη και δίνει το αντικείμενο.
- Μην αφήνετε ποτέ τον client να στέλνει την τιμή. Οποιοσδήποτε μπορεί να καλέσει τα remotes σας με όποιες τιμές θέλει, γι' αυτό ο server παίρνει την τιμή από το δικό του αντίγραφο του καταλόγου.
- Το Tool που αγοράστηκε δίνεται με clone από το ServerStorage στο Backpack του παίκτη (για να το χρησιμοποιήσει αμέσως) και στο StarterGear (για να επιστρέψει μετά το respawn).
- Ό,τι πουλιέται με Robux είναι passes και developer products, και με αυτά δουλεύει το MarketplaceService. Γι' αυτά η Roblox φτιάχνει επιπλέον μόνη της ένα Shop, που δεν είναι το ίδιο με ένα μαγαζί με coins.
Σε αυτή τη σελίδα
Πώς είναι στημένο ένα μαγαζί που δουλεύει
Ένα μαγαζί που δουλεύει σε πραγματικό παιχνίδι μοιράζεται ανάμεσα στη συσκευή του παίκτη και στον server. Η συσκευή σχεδιάζει το παράθυρο και λέει "θέλω να αγοράσω σπαθί". Ο server, η μόνη πλευρά που μπορείτε να εμπιστευτείτε, αποφασίζει αν θα γίνει. Τα scripts μαγαζιού που "δεν δουλεύουν" ή που οι παίκτες σπάνε με cheats συχνά παίρνουν αυτή την απόφαση στη λάθος πλευρά.
| Μέρος | Πού βρίσκεται | Τι κάνει |
|---|---|---|
ModuleScript ShopCatalog | ReplicatedStorage | Τα id των αντικειμένων, τα ονόματα, οι τιμές και το Tool που δίνει το καθένα. Το διαβάζουν και οι δύο πλευρές. |
RemoteFunction BuyItem | ReplicatedStorage, στον φάκελο ShopRemotes | Μεταφέρει το αίτημα αγοράς στον server και την απάντηση πίσω. |
LocalScript ShopClient | StarterPlayerScripts | Φτιάχνει το παράθυρο του μαγαζιού και στέλνει το id του αντικειμένου όταν πατηθεί το κουμπί Buy. |
Script ShopService | ServerScriptService | Ελέγχει το αίτημα, αφαιρεί τα Coins και δίνει το Tool. |
| Τα Tools που πουλάτε | ServerStorage, στον φάκελο ShopItems | Τα πρωτότυπα που αντιγράφει ο server. Τίποτα από το ServerStorage δεν στέλνεται στους παίκτες. |
ReplicatedStorage
ShopCatalog ModuleScript new
ShopRemotes Folder new
BuyItem RemoteFunction new
ServerStorage
ShopItems Folder new
ClassicSword Tool new
Handle Part
Flashlight Tool new
GrappleHook Tool new
SpeedCoil Tool new
ServerScriptService
Leaderstats Script
ShopService Script new
StarterPlayer
StarterPlayerScripts
ShopClient LocalScript new
Βήμα 1: Coins και αντικείμενα προς πώληση
Το μαγαζί ξοδεύει την τιμή Coins στα leaderstats του παίκτη. Αν ακολουθήσατε τον οδηγό για το leaderboard, την έχετε ήδη και μπορείτε να παραλείψετε αυτό το script. Αλλιώς βάλτε ένα Script στο ServerScriptService με όνομα Leaderstats. Δίνει σε όλους 200 coins στην αρχή, ώστε να δοκιμάζετε αγορές αμέσως.
local Players = game:GetService("Players")
local STARTING_COINS = 200 -- αρκούν για δοκιμή του μαγαζιού· βάλτε 0 όταν οι παίκτες μπορούν να κερδίζουν coins
local function setupLeaderstats(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats"
local coins = Instance.new("IntValue")
coins.Name = "Coins"
coins.Value = STARTING_COINS
coins.Parent = leaderstats
leaderstats.Parent = player
end
Players.PlayerAdded:Connect(setupLeaderstats)
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
Κρατήστε μόνο ένα script leaderstats. Δύο scripts που φτιάχνουν το καθένα έναν φάκελο leaderstats δίνουν σε κάθε παίκτη δύο φακέλους, και το μαγαζί μπορεί να διαβάσει τον λάθος.
Μετά φτιάξτε τα αντικείμενα που ψάχνουν τα scripts. Τα κεφαλαία και τα μικρά στα ονόματα μετράνε, οπότε γράψτε τα ακριβώς όπως εδώ.
- Στο Explorer περάστε τον δείκτη πάνω από το ReplicatedStorage, πατήστε το κουμπί + και βάλτε ένα Folder με όνομα
ShopRemotes. Μέσα του βάλτε ένα RemoteFunction με όνομαBuyItem. - Περάστε τον δείκτη πάνω από το ServerStorage και βάλτε ένα Folder με όνομα
ShopItems. - Βάλτε στο ShopItems ένα Tool για κάθε αντικείμενο, με ονόματα
ClassicSword,Flashlight,GrappleHookκαιSpeedCoil. Για την πρώτη δοκιμή αρκεί στο Tool ένα Part χωρίς anchor με όνομαHandle. Κάνει και οποιοδήποτε Tool έχετε ήδη: δώστε του το σωστό όνομα. Όπλα που κάνουν πραγματικά ζημιά φτιάξτε με τον οδηγό για το σπαθί ή τον οδηγό για το όπλο· ο καθένας γράφει πώς να το συνδέσετε με τον κατάλογο. - Επιλέξτε κάθε Tool και ξετσεκάρετε το CanBeDropped στο παράθυρο Properties. Όταν είναι τσεκαρισμένο, το Backspace πετά το tool στο Workspace και οποιοσδήποτε παίκτης μπορεί να σηκώσει αυτό που πλήρωσε ο αγοραστής.
Μπορείτε να ξεκινήσετε με ένα μόνο Tool. Αν λείπει το Tool ενός αντικειμένου, ο server αρνείται να πουλήσει αυτό το αντικείμενο και γράφει μια προειδοποίηση με το όνομά του, οπότε από τον παίκτη δεν αφαιρείται τίποτα.
Βήμα 2: Αντικείμενα και τιμές στον κατάλογο
Ο κατάλογος είναι η μόνη λίστα με όλα όσα πουλά το μαγαζί. Το LocalScript τον διαβάζει για να σχεδιάσει τις κάρτες και ο server τον διαβάζει για να βρει τις τιμές, οπότε η αλλαγή μιας τιμής είναι μία διόρθωση σε ένα σημείο.
Περάστε τον δείκτη πάνω από το ReplicatedStorage, βάλτε ένα ModuleScript, μετονομάστε το σε ShopCatalog και αντικαταστήστε το περιεχόμενο με αυτό:
export type ShopItem = {
id: string, -- αποθηκεύεται αργότερα στο data store: μην το αλλάζετε όταν οι παίκτες έχουν ήδη το αντικείμενο
name: string, -- φαίνεται στην κάρτα· μπορείτε να το αλλάξετε
price: number, -- σε Coins
description: string,
toolName: string, -- το Tool στο ServerStorage.ShopItems που παίρνει ο παίκτης
}
-- Οι κάρτες εμφανίζονται με αυτή τη σειρά
local items: { ShopItem } = {
{
id = "sword",
name = "Classic Sword",
price = 50,
description = "A basic sword for close fights.",
toolName = "ClassicSword",
},
{
id = "flashlight",
name = "Flashlight",
price = 25,
description = "Lights up dark corners.",
toolName = "Flashlight",
},
{
id = "grapple",
name = "Grapple Hook",
price = 150,
description = "Reach high ledges.",
toolName = "GrappleHook",
},
{
id = "speedcoil",
name = "Speed Coil",
price = 300,
description = "Run faster while you hold it.",
toolName = "SpeedCoil",
},
}
local byId: { [string]: ShopItem } = {}
for _, item in items do
byId[item.id] = item
end
local ShopCatalog = {}
ShopCatalog.items = items
-- Επιστρέφει το αντικείμενο με αυτό το id ή nil αν δεν υπάρχει τέτοιο αντικείμενο
function ShopCatalog.get(id: string): ShopItem?
return byId[id]
end
-- Το attribute του Player που ο server βάζει σε true όταν ο παίκτης έχει το αντικείμενο
function ShopCatalog.ownedAttribute(id: string): string
return "Owns_" .. id
end
return ShopCatalog
Κάθε αντικείμενο έχει ένα id και ξεχωριστά ένα name που εμφανίζεται. Ο server καταγράφει ακριβώς το id όταν ο παίκτης έχει κάτι, οπότε μπορείτε αργότερα να μετονομάσετε το "Classic Sword" χωρίς να χαλάσουν οι αποθηκευμένες αγορές. Οι περιγραφές είναι μόνο κείμενο στην κάρτα· τι κάνει το Tool το αποφασίζουν τα δικά του scripts.
Οι παίκτες μπορούν να διαβάσουν ένα ModuleScript στο ReplicatedStorage, άρα αυτές οι τιμές είναι δημόσιες. Αυτό είναι εντάξει: γράφονται έτσι κι αλλιώς στις κάρτες. Σημασία έχει ότι ο client και ο server τρέχουν ο καθένας το δικό του αντίγραφο του module, οπότε ένας παίκτης που άλλαξε τις τιμές στη συσκευή του δεν αλλάζει τίποτα στον server.
Βήμα 3: Φτιάχνουμε το GUI του μαγαζιού
Αυτό το LocalScript φτιάχνει όλο το παράθυρο σε κώδικα: το κουμπί Shop, ένα πάνελ με πλέγμα καρτών που κυλά, ένα κουμπί Buy για κάθε αντικείμενο του καταλόγου, μετρητή Coins και γραμμή κατάστασης για τις απαντήσεις του server. Αφού όλα γίνονται με κώδικα, μπορείτε να το επικολλήσετε και να πατήσετε Play. Ο πίνακας μετά από αυτό απαριθμεί κάθε αντικείμενο, αν θέλετε να στήσετε το παράθυρο με το χέρι.
- Στο Explorer ανοίξτε το StarterPlayer, περάστε τον δείκτη πάνω από το StarterPlayerScripts και βάλτε ένα LocalScript με όνομα
ShopClient. - Αντικαταστήστε το περιεχόμενό του με τον κώδικα παρακάτω.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- Τι επιστρέφει το module ShopCatalog, ώστε ο αυστηρός έλεγχος τύπων να ελέγχει τα πεδία που χρησιμοποιούμε
type ShopItem = { id: string, name: string, price: number, description: string, toolName: string }
type Catalog = {
items: { ShopItem },
get: (id: string) -> ShopItem?,
ownedAttribute: (id: string) -> string,
}
local ShopCatalog = require(ReplicatedStorage:WaitForChild("ShopCatalog")) :: Catalog
local buyItem = ReplicatedStorage:WaitForChild("ShopRemotes"):WaitForChild("BuyItem") :: RemoteFunction
local player = Players.LocalPlayer
local COLOURS = {
panel = Color3.fromRGB(24, 20, 36),
card = Color3.fromRGB(38, 32, 56),
accent = Color3.fromRGB(124, 77, 255),
owned = Color3.fromRGB(70, 66, 84),
text = Color3.fromRGB(240, 238, 245),
muted = Color3.fromRGB(170, 165, 185),
good = Color3.fromRGB(120, 220, 150),
}
local REGULAR = Font.fromEnum(Enum.Font.BuilderSans)
local BOLD = Font.fromEnum(Enum.Font.BuilderSansBold)
local function addCorner(parent: GuiObject, radius: number)
local corner = Instance.new("UICorner")
corner.CornerRadius = UDim.new(0, radius)
corner.Parent = parent
end
local function addPadding(parent: GuiObject, pixels: number)
local padding = Instance.new("UIPadding")
padding.PaddingTop = UDim.new(0, pixels)
padding.PaddingBottom = UDim.new(0, pixels)
padding.PaddingLeft = UDim.new(0, pixels)
padding.PaddingRight = UDim.new(0, pixels)
padding.Parent = parent
end
local function newLabel(parent: GuiObject, text: string, textSize: number, font: Font): TextLabel
local label = Instance.new("TextLabel")
label.BackgroundTransparency = 1
label.Text = text
label.TextSize = textSize
label.FontFace = font
label.TextColor3 = COLOURS.text
label.TextXAlignment = Enum.TextXAlignment.Left
label.TextWrapped = true
label.Parent = parent
return label
end
local function newButton(parent: GuiObject, text: string): TextButton
local button = Instance.new("TextButton")
button.BackgroundColor3 = COLOURS.accent
button.TextColor3 = COLOURS.text
button.FontFace = BOLD
button.TextSize = 18
button.Text = text
button.Parent = parent
addCorner(button, 8)
return button
end
-- ScreenGui: κρατά όλα όσα σχεδιάζει το μαγαζί στην οθόνη του παίκτη
local gui = Instance.new("ScreenGui")
gui.Name = "ShopGui"
gui.ResetOnSpawn = false -- το μαγαζί μένει όταν ο χαρακτήρας κάνει respawn
-- Κουμπί στην αριστερή άκρη που ανοίγει και κλείνει το μαγαζί
local openButton = Instance.new("TextButton")
openButton.Name = "OpenShop"
openButton.AnchorPoint = Vector2.new(0, 0.5)
openButton.Position = UDim2.new(0, 16, 0.5, 0)
openButton.Size = UDim2.fromOffset(110, 44)
openButton.BackgroundColor3 = COLOURS.accent
openButton.TextColor3 = COLOURS.text
openButton.FontFace = BOLD
openButton.TextSize = 20
openButton.Text = "Shop"
openButton.Parent = gui
addCorner(openButton, 10)
-- Το παράθυρο του μαγαζιού: στο κέντρο, κρυφό μέχρι να το ανοίξει ο παίκτης
local panel = Instance.new("Frame")
panel.Name = "Panel"
panel.AnchorPoint = Vector2.new(0.5, 0.5)
panel.Position = UDim2.fromScale(0.5, 0.5)
panel.Size = UDim2.fromScale(0.8, 0.75)
panel.BackgroundColor3 = COLOURS.panel
panel.Visible = false
panel.Parent = gui
addCorner(panel, 14)
addPadding(panel, 12)
local sizeLimit = Instance.new("UISizeConstraint")
sizeLimit.MaxSize = Vector2.new(640, 460) -- δεν αφήνει το παράθυρο να γίνει τεράστιο σε μεγάλες οθόνες
sizeLimit.Parent = panel
local title = newLabel(panel, "Shop", 26, BOLD)
title.Size = UDim2.new(0.5, 0, 0, 32)
local coinsLabel = newLabel(panel, "Coins: ...", 20, BOLD)
coinsLabel.AnchorPoint = Vector2.new(1, 0)
coinsLabel.Position = UDim2.new(1, -44, 0, 0)
coinsLabel.Size = UDim2.new(0.5, -44, 0, 32)
coinsLabel.TextXAlignment = Enum.TextXAlignment.Right
local closeButton = newButton(panel, "X")
closeButton.AnchorPoint = Vector2.new(1, 0)
closeButton.Position = UDim2.fromScale(1, 0)
closeButton.Size = UDim2.fromOffset(32, 32)
closeButton.BackgroundColor3 = COLOURS.card
-- Εδώ εμφανίζονται οι απαντήσεις του server, για παράδειγμα "You need 20 more coins."
local status = newLabel(panel, "", 18, REGULAR)
status.AnchorPoint = Vector2.new(0, 1)
status.Position = UDim2.fromScale(0, 1)
status.Size = UDim2.new(1, 0, 0, 24)
status.TextColor3 = COLOURS.muted
-- ScrollingFrame: η περιοχή που κυλά όταν οι κάρτες είναι περισσότερες από όσες χωρούν
local list = Instance.new("ScrollingFrame")
list.Name = "Items"
list.Position = UDim2.fromOffset(0, 44)
list.Size = UDim2.new(1, 0, 1, -76)
list.BackgroundTransparency = 1
list.BorderSizePixel = 0
list.ScrollBarThickness = 6
list.ScrollingDirection = Enum.ScrollingDirection.Y
list.CanvasSize = UDim2.new() -- ξεκινά από το μηδέν· το AutomaticCanvasSize το μεγαλώνει για τις κάρτες
list.AutomaticCanvasSize = Enum.AutomaticSize.Y
list.Parent = panel
-- UIGridLayout: βάζει τις κάρτες σε σειρές και τις αναδιπλώνει στην επόμενη σειρά
local grid = Instance.new("UIGridLayout")
grid.CellSize = UDim2.fromOffset(180, 200)
grid.CellPadding = UDim2.fromOffset(12, 12)
grid.SortOrder = Enum.SortOrder.LayoutOrder
grid.Parent = list
local function makeCard(item: ShopItem, order: number)
local card = Instance.new("Frame")
card.Name = item.id
card.LayoutOrder = order
card.BackgroundColor3 = COLOURS.card
card.Parent = list
addCorner(card, 10)
addPadding(card, 10)
local nameLabel = newLabel(card, item.name, 20, BOLD)
nameLabel.Size = UDim2.new(1, 0, 0, 26)
local description = newLabel(card, item.description, 15, REGULAR)
description.Position = UDim2.fromOffset(0, 30)
description.Size = UDim2.new(1, 0, 1, -80)
description.TextColor3 = COLOURS.muted
description.TextYAlignment = Enum.TextYAlignment.Top
local buyButton = newButton(card, "")
buyButton.Name = "Buy"
buyButton.AnchorPoint = Vector2.new(0, 1)
buyButton.Position = UDim2.fromScale(0, 1)
buyButton.Size = UDim2.new(1, 0, 0, 40)
local ownedAttribute = ShopCatalog.ownedAttribute(item.id)
local busy = false
local function refresh()
if player:GetAttribute(ownedAttribute) == true then
buyButton.Text = "Owned"
buyButton.BackgroundColor3 = COLOURS.owned
buyButton.AutoButtonColor = false
else
buyButton.Text = `Buy: {item.price} coins`
buyButton.BackgroundColor3 = COLOURS.accent
buyButton.AutoButtonColor = true
end
end
buyButton.Activated:Connect(function()
if busy or player:GetAttribute(ownedAttribute) == true then
return
end
busy = true
buyButton.Text = "Buying..."
-- Στέλνουμε μόνο το id του αντικειμένου. Την τιμή τη βρίσκει μόνος του ο server.
local ok, bought, message = pcall(function()
return buyItem:InvokeServer(item.id)
end)
if ok and type(message) == "string" then
status.Text = message
status.TextColor3 = if bought == true then COLOURS.good else COLOURS.muted
else
status.Text = "The shop did not answer. Try again."
status.TextColor3 = COLOURS.muted
end
busy = false
refresh()
end)
-- Ο server βάζει αυτό το attribute όταν η αγορά πέρασε (ή όταν φόρτωσαν τα αποθηκευμένα αντικείμενα)
player:GetAttributeChangedSignal(ownedAttribute):Connect(refresh)
refresh()
end
for index, item in ShopCatalog.items do
makeCard(item, index)
end
openButton.Activated:Connect(function()
panel.Visible = not panel.Visible
status.Text = ""
end)
closeButton.Activated:Connect(function()
panel.Visible = false
end)
gui.Parent = player:WaitForChild("PlayerGui")
-- Δείχνουμε τα coins του παίκτη. Η πραγματική τιμή είναι στον server· εδώ απλώς εμφανίζεται.
local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue
local function updateCoins()
coinsLabel.Text = `Coins: {coins.Value}`
end
coins.Changed:Connect(updateCoins)
updateCoins()
Τα κουμπιά χρησιμοποιούν Activated και όχι MouseButton1Click: ενεργοποιείται με κλικ του ποντικιού, με άγγιγμα στο κινητό και με το κουμπί A ή το X σε χειριστήριο.
Οι ορισμοί type στην αρχή περιγράφουν τι επιστρέφει το ShopCatalog, ώστε ο αυστηρός έλεγχος τύπων να πιάσει ένα τυπογραφικό λάθος σε πεδίο, για παράδειγμα item.prise. Όταν τρέχει το παιχνίδι δεν αλλάζουν τίποτα.
| Αντικείμενο | Ρόλος στο μαγαζί | Κύριες ιδιότητες |
|---|---|---|
ScreenGui | Κρατά όλα όσα σχεδιάζονται στην οθόνη | ResetOnSpawn false, ώστε το μαγαζί να αντέξει το respawn |
Frame | Το παράθυρο και κάθε κάρτα αντικειμένου | AnchorPoint 0.5, 0.5 και Position 0.5, 0.5, ώστε το παράθυρο να είναι στο κέντρο |
UISizeConstraint | Περιορίζει το παράθυρο σε μεγάλες οθόνες | MaxSize 640 επί 460 |
ScrollingFrame | Κυλά όταν οι κάρτες είναι περισσότερες από όσες χωρούν | CanvasSize 0 και AutomaticCanvasSize Y, ώστε η περιοχή κύλισης να μεγαλώνει μαζί με τις κάρτες |
UIGridLayout | Βάζει τις κάρτες σε σειρές και τις αναδιπλώνει | CellSize 180 επί 200, CellPadding 12, SortOrder LayoutOrder |
UICorner | Στρογγυλεύει τις γωνίες | CornerRadius από 8 έως 14 pixels |
UIPadding | Εσωτερικά περιθώρια | Από 10 έως 12 pixels σε κάθε πλευρά |
TextButton | Τα κουμπιά Shop, κλεισίματος και Buy | Το event Activated |
Αν θέλετε να σχεδιάσετε το παράθυρο με το χέρι, φτιάξτε τα ίδια αντικείμενα στο StarterGui με αυτές τις ιδιότητες, βάλτε κι εκεί το ResetOnSpawn του ScreenGui σε false και αφήστε μία κάρτα ως πρότυπο που το LocalScript κάνει clone για κάθε αντικείμενο του καταλόγου. Τότε το script μόνο γεμίζει τις κάρτες και συνδέει τα κουμπιά. Η λογική αγοράς στο επόμενο βήμα δεν αλλάζει.
Αν το παιχνίδι σας ξεκινά με κεντρικό μενού, εκείνος ο οδηγός έχει μία γραμμή που πρέπει να προσθέσετε στο ShopClient, ώστε το κουμπί Shop να εμφανίζεται μόνο αφού ο παίκτης πατήσει Play. Για να ανοίγει το μαγαζί με κουβέντα με τον πωλητή, ο οδηγός για διαλόγους με NPC δείχνει πώς να προσθέσετε μια ενέργεια OpenShop που λέει στο ShopClient να ανοίξει το παράθυρο, ενώ οι αγορές περνούν όπως πριν από τους ελέγχους του μαγαζιού στον server.
Βήμα 4: Έλεγχος και αγορά στον server
Αυτό το Script είναι το μόνο σημείο όπου μπορεί να γίνει αγορά. Παίρνει το id του αντικειμένου, το ελέγχει, βρίσκει την τιμή, ελέγχει τα Coins του παίκτη, μετά αφαιρεί τα coins και δίνει το Tool. Στο κουμπί Buy απαντά με true ή false και ένα μήνυμα για εμφάνιση.
Περάστε τον δείκτη πάνω από το ServerScriptService, βάλτε ένα Script με όνομα ShopService και επικολλήστε μέσα αυτό:
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- Τι επιστρέφει το module ShopCatalog, ώστε ο αυστηρός έλεγχος τύπων να ελέγχει τα πεδία που χρησιμοποιούμε
type ShopItem = { id: string, name: string, price: number, description: string, toolName: string }
type Catalog = {
items: { ShopItem },
get: (id: string) -> ShopItem?,
ownedAttribute: (id: string) -> string,
}
local ShopCatalog = require(ReplicatedStorage:WaitForChild("ShopCatalog")) :: Catalog
local buyItem = ReplicatedStorage:WaitForChild("ShopRemotes"):WaitForChild("BuyItem") :: RemoteFunction
local shopItems = ServerStorage:WaitForChild("ShopItems")
local COOLDOWN_SECONDS = 0.5
local lastRequest: { [Player]: number } = {}
local function giveTool(player: Player, template: Tool)
-- Backpack: ο παίκτης μπορεί να χρησιμοποιήσει το tool αμέσως
local backpack = player:FindFirstChildOfClass("Backpack")
if backpack then
template:Clone().Parent = backpack
end
-- StarterGear: η Roblox το αντιγράφει ξανά στο Backpack κάθε φορά που εμφανίζεται ο χαρακτήρας
local starterGear = player:FindFirstChildOfClass("StarterGear")
if starterGear then
template:Clone().Parent = starterGear
end
end
local function onBuyItem(player: Player, itemId: unknown): (boolean, string)
-- 1. Ο client στέλνει μόνο το id του αντικειμένου, άρα πρέπει να είναι string
if type(itemId) ~= "string" then
return false, "That item does not exist."
end
-- 2. Αγνοούμε τα διπλά κλικ και τις ριπές αιτημάτων από scripts
local now = os.clock()
local last = lastRequest[player]
if last and now - last < COOLDOWN_SECONDS then
return false, "Slow down a little."
end
lastRequest[player] = now
-- 3. Ψάχνουμε το αντικείμενο στο δικό του αντίγραφο του καταλόγου στον server
local item = ShopCatalog.get(itemId)
if not item then
return false, "That item does not exist."
end
local ownedAttribute = ShopCatalog.ownedAttribute(item.id)
if player:GetAttribute(ownedAttribute) == true then
return false, "You already own this."
end
local template = shopItems:FindFirstChild(item.toolName)
if not (template and template:IsA("Tool")) then
warn(`ShopItems has no Tool named {item.toolName} for shop item {item.id}`)
return false, "This item is not available right now."
end
local leaderstats = player:FindFirstChild("leaderstats")
local coins = leaderstats and leaderstats:FindFirstChild("Coins")
if not (coins and coins:IsA("IntValue")) then
return false, "Your coins have not loaded yet."
end
-- 4. Η τιμή έρχεται από τον κατάλογο και ποτέ από τον client
if coins.Value < item.price then
return false, `You need {item.price - coins.Value} more coins.`
end
-- 5. Αφαιρούμε τα coins, μετά δίνουμε το αντικείμενο. Εδώ τίποτα δεν κάνει yield, οπότε δύο αιτήματα
-- από τον ίδιο παίκτη δεν μπορούν να περάσουν και τα δύο τους ελέγχους πιο πάνω πριν τρέξει αυτό.
coins.Value -= item.price
giveTool(player, template)
player:SetAttribute(ownedAttribute, true)
return true, `You bought {item.name}.`
end
buyItem.OnServerInvoke = onBuyItem
Players.PlayerRemoving:Connect(function(player: Player)
lastRequest[player] = nil
end)
Η κατοχή αποθηκεύεται ως attribute του Player, για παράδειγμα Owns_sword. Τα attributes που βάζει ο server αναπαράγονται στη συσκευή του παίκτη, οπότε το LocalScript μπορεί να γυρίσει την κάρτα σε "Owned". Μια αλλαγή που κάνει ο παίκτης στο δικό του αντίγραφο δεν φτάνει στον server.
Το Tool μπαίνει σε δύο σημεία. Το αντίγραφο στο Backpack εμφανίζεται αμέσως στο hotbar. Το αντίγραφο στο StarterGear η Roblox το βάζει στο νέο Backpack κάθε φορά που εμφανίζεται ο χαρακτήρας. Χωρίς αυτό, το αντικείμενο που αγοράστηκε χάνεται με τον πρώτο θάνατο του παίκτη.
Γιατί ο client δεν στέλνει ποτέ την τιμή
Ό,τι βρίσκεται στη συσκευή του παίκτη, αυτός ο παίκτης μπορεί να το αλλάξει. Οι cheaters τρέχουν δικό τους κώδικα στο δικό τους αντίγραφο του παιχνιδιού: μπορούν να διαβάζουν τα LocalScript σας, να αλλάζουν το GUI και να καλούν BuyItem:InvokeServer() με όποια ορίσματα θέλουν όσες φορές θέλουν. Ο οδηγός ασφαλείας της Roblox λέει να ελέγχετε και τον τύπο και την τιμή όλων όσων λαμβάνει ένα remote, και ως παράδειγμα χρησιμοποιεί ακριβώς ένα μαγαζί.
| Ο cheater στέλνει | Αν ο server τον πίστευε | Τι κάνει το ShopService |
|---|---|---|
| Τιμή 0 | Όλα τα αντικείμενα δωρεάν | Την αγνοεί. Η τιμή έρχεται από τον κατάλογο. |
| Τιμή -1000 | Το Coins.Value -= -1000 του δίνει 1 000 coins | Την αγνοεί. |
NaN αντί για τιμή | Κάθε σύγκριση με NaN είναι ψευδής, οπότε ο έλεγχος "δεν φτάνουν τα coins" δεν ενεργοποιείται ποτέ | Την αγνοεί. |
| Id που δεν υπάρχει στον κατάλογο, ή table αντί για string | Σφάλματα στο script ή αντικείμενα που δεν σκοπεύατε να πουλήσετε | Απαντά "That item does not exist." |
| Εκατοντάδες αιτήματα το δευτερόλεπτο | Φόρτος στον server, και κάθε τρύπα στους ελέγχους ενεργοποιείται εκατοντάδες φορές | Επεξεργάζεται το πολύ ένα αίτημα ανά παίκτη κάθε μισό δευτερόλεπτο. |
| Coins αλλαγμένα στη δική του οθόνη | Αγορές με coins που δεν έχει | Δεν το βλέπει καθόλου. Ο server διαβάζει μόνο τη δική του τιμή Coins. |
Αυτός ο κανόνας ισχύει για κάθε remote που γράφετε: στείλτε αυτό που διάλεξε ο παίκτης, για παράδειγμα το id ενός αντικειμένου ή τον αριθμό ενός slot, και ποτέ πόσο κοστίζει ή τι πρέπει να πάρει. Ο οδηγός για το RemoteEvent εξετάζει αναλυτικότερα τον έλεγχο των ορισμάτων ενός remote.
Βήμα 5: Δοκιμάζουμε το μαγαζί
- Πατήστε Play. Αριστερά θα εμφανιστεί το κουμπί Shop. Ανοίξτε το και αγοράστε το Flashlight: τα Coins μειώνονται κατά 25, το tool εμφανίζεται στο hotbar και το κουμπί του γίνεται Owned.
- Δοκιμάστε το Speed Coil, που κοστίζει 300. Η γραμμή κατάστασης γράφει πόσα coins λείπουν ακόμη, και δεν αφαιρείται τίποτα.
- Κάντε reset τον χαρακτήρα από το μενού μέσα στο παιχνίδι. Το Flashlight επιστρέφει στο νέο Backpack χάρη στο αντίγραφο στο StarterGear.
- Για να δώσετε στον εαυτό σας coins κατά τη δοκιμή, πατήστε τον διακόπτη Client/Server και περάστε σε Server, βρείτε στο Explorer τα
Players, το όνομά σας,leaderstats,Coinsκαι αλλάξτε το Value στο παράθυρο Properties. Το ίδιο σε λειτουργία Client αλλάζει μόνο την οθόνη σας, και αυτή ακριβώς είναι η αλλαγή που αγνοεί ο server.
Αν το κουμπί απαντά "The shop did not answer", ανοίξτε το παράθυρο Output από το μενού Window του Studio και βρείτε το κόκκινο σφάλμα από το ShopService. Αν πάλι το κουμπί κολλάει στο "Buying...", τότε το ShopService δεν τρέχει ή κόλλησε περιμένοντας ένα αντικείμενο: δείτε τα συχνά σφάλματα.
Πώληση game pass με Robux
Τα coins είναι το δικό σας νόμισμα, γι' αυτό το μαγαζί πιο πάνω αποφασίζει μόνο του κάθε αγορά. Ό,τι αγοράζει ο παίκτης με Robux δουλεύει αλλιώς: ένα game pass αγοράζεται μία φορά και μένει για πάντα (μπόνους VIP, μόνιμο tool), ενώ ένα developer product μπορεί να αγοραστεί ξανά και ξανά (πακέτο coins, παράλειψη επιπέδου). Και τα δύο περνούν από το MarketplaceService της Roblox, και την πληρωμή τη δέχεται η Roblox, όχι το script σας.
Από αυτόν τον οδηγό μεταφέρονται δύο κανόνες: ανοίγετε το παράθυρο αγοράς με κουμπί στον client και δίνετε το μπόνους μόνο στον server, όταν η Roblox επιβεβαίωσε την αγορά ή ο παίκτης έχει ήδη το pass. Ο οδηγός για script game pass τα στήνει όλα: έλεγχο κατοχής στην είσοδο, παράθυρο αγοράς, μπόνους όπως μια πόρτα VIP και πότε είναι καλύτερο ένα developer product αντί για pass. Για να διαλέξετε τιμή, ο δωρεάν υπολογιστής προμήθειας Robux δείχνει πόσα σας αποφέρει ένα pass ή developer product μετά το μερίδιο της Roblox.
Αποθηκεύουμε τις αγορές των παικτών
Όλα όσα φτιάξαμε ζουν μία συνεδρία: τα coins και τα αντικείμενα που αγοράστηκαν μηδενίζονται όταν ο παίκτης φύγει, μέχρι να τα αποθηκεύσετε σε data store. Για να μην επαναλάβουμε εδώ τον κώδικα αποθήκευσης, ακολουθήστε το tutorial για το DataStore (ή το βήμα 3 του οδηγού για το leaderboard, όπου υπάρχει πιο σύντομη εκδοχή) και θυμηθείτε τους κανόνες του μαγαζιού:
- Αποθηκεύετε τα id των αντικειμένων, για παράδειγμα
{ "sword", "flashlight" }, στο ίδιο table με την τιμή Coins, ώστε μία αποθήκευση να γράφει και τα coins που ξοδεύτηκαν και το αντικείμενο που αγοράστηκε. Tool και άλλα instances δεν μπαίνουν σε data store. - Όταν φορτώσουν τα δεδομένα, περάστε από τα αποθηκευμένα id, παραλείψτε όσα δεν υπάρχουν πια στον κατάλογο, ορίστε κάθε attribute
Owns_και δώστε το Tool όπως κάνει τοgiveTool. Το παράθυρο του μαγαζιού ενημερώνεται μόνο του, επειδή ακούει αυτά τα attributes. - Την κατοχή pass δεν χρειάζεται να την αποθηκεύετε: το
UserOwnsGamePassAsyncρωτά τη Roblox κάθε φορά που μπαίνει ο παίκτης. - Μην αποθηκεύετε ποτέ έναν παίκτη του οποίου τα δεδομένα δεν φόρτωσαν, αλλιώς μια αποτυχημένη φόρτωση μπορεί να αντικαταστήσει τις αγορές του με κενή λίστα.
Συνηθισμένα λάθη και λύσεις
Όταν το μαγαζί συμπεριφέρεται παράξενα, ελέγξτε πρώτα αυτά. Πρώτα απ' όλα ανοίξτε το παράθυρο Output (μενού Window, μετά Output): ένα σφάλμα script δείχνει το script και τη γραμμή.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("ShopRemotes")'
Το script περιμένει ένα αντικείμενο που δεν υπάρχει με αυτό ακριβώς το όνομα. Ελέγξτε τη γραφή και τα κεφαλαία στα ShopRemotes, BuyItem, ShopCatalog και ShopItems, και ότι το ShopItems βρίσκεται στο ServerStorage και όχι στο ReplicatedStorage. Ο οδηγός για σφάλματα scripts εξετάζει αναλυτικά αυτή την προειδοποίηση.
Το κουμπί Buy κολλάει στο "Buying..." και δεν απαντά
Στον server κανείς δεν όρισε BuyItem.OnServerInvoke, οπότε η Roblox κρατά το αίτημα μέχρι να γίνει αυτό. Βεβαιωθείτε ότι το ShopService είναι Script και όχι LocalScript και βρίσκεται στο ServerScriptService, και ψάξτε στο Output για την προειδοποίηση Infinite yield possible από το ShopService: σημαίνει ότι το script κόλλησε περιμένοντας το ShopCatalog, το ShopRemotes ή το ShopItems.
Το κουμπί Buy γράφει "The shop did not answer"
Η κλήση στον server απέτυχε αντί να επιστρέψει απάντηση. Η συνηθισμένη αιτία είναι ένα σφάλμα μέσα στο ShopService κατά την επεξεργασία του αιτήματος, οπότε βρείτε στο Output το κόκκινο σφάλμα από το ShopService: γράφει τη γραμμή.
Το κουμπί γράφει "This item is not available right now"
Ο server δεν βρήκε Tool με το toolName αυτού του αντικειμένου μέσα στο ServerStorage, ShopItems. Στο Output υπάρχει μια προειδοποίηση με το ακριβές όνομα που έψαξε.
Αγόρασα ένα tool, αλλά ο χαρακτήρας δεν μπορεί να το κρατήσει ή κολλάει
Το Tool πρέπει να έχει ακριβώς ένα part με όνομα Handle απευθείας μέσα του, και κανένα από τα parts του δεν πρέπει να είναι anchored. Για tool που δεν χρειάζεται να κρατιέται στο χέρι, ξετσεκάρετε αντί γι' αυτό το RequiresHandle.
Τα coins μειώθηκαν στη δική μου οθόνη, αλλά όχι στους άλλους
Η αγορά έγινε σε LocalScript, οπότε άλλαξε μόνο η συσκευή σας. Μεταφέρετε την αφαίρεση των coins και το δόσιμο του Tool σε server Script, όπως στο βήμα 4.
Τα αντικείμενα που αγόρασα χάνονται όταν ξαναμπαίνω
Προς το παρόν τίποτα δεν αποθηκεύεται. Δείτε την αποθήκευση αγορών.
Φτιάξτε το με το RoCode
Αν δεν θέλετε να τα στήσετε όλα αυτά με το χέρι, το RoCode μπορεί να το κάνει στο place που έχετε ανοιχτό. Είναι ένας ανεξάρτητος πράκτορας AI για κώδικα: περιγράφετε τη λειτουργία στη συνομιλία του στο web και το plugin του για το Roblox Studio δημιουργεί τα scripts, το remote και το GUI στο Explorer σας, οπότε δεν χρειάζεται να αντιγράφετε κώδικα από το παράθυρο της συνομιλίας.
Πρόσθεσε ένα μαγαζί με coins: κουμπί Shop που ανοίγει πλέγμα με τέσσερα tools με τιμές σε Coins από τα leaderstats μου. Ο server πρέπει να ελέγχει την τιμή και να δίνει το tool στο Backpack και στο StarterGear.
- Μπορεί να εξετάσει το place σας με Search Scripts και Read Script για leaderstats και κώδικα μαγαζιού που υπάρχουν ήδη, ώστε να χρησιμοποιήσει τη δική σας τιμή Coins και να μην προσθέσει δεύτερη
- Μπορεί να στήσει τον σκελετό του παραθύρου με Build UI: η διάταξη του μαγαζιού έρχεται με κάρτες placeholder και LocalScript για εφέ hover και το κουμπί Close· η λογική αγοράς γράφεται σε ξεχωριστά scripts
- Δημιουργεί το RemoteFunction με Create Instance και γράφει το ModuleScript του καταλόγου, το server Script και το LocalScript με Create Script
- Ελέγχει τη μεταγλώττιση κάθε script στο Studio με Check Script (τύπους δεν ελέγχει και scripts δεν τρέχει), και κάθε ομάδα αλλαγών είναι ένα σημείο αναίρεσης στο Studio
Τα passes πρέπει έτσι κι αλλιώς να τα φτιάξετε μόνοι σας στο Creator Hub, επειδή το RoCode δεν μπορεί να δημιουργεί passes και developer products, και τις αγορές τις δοκιμάζετε επίσης εσείς: με plugin 3.9 ή νεότερο το RoCode μπορεί να τρέξει ένα σύντομο playtest και να διαβάσει τα σφάλματα, και με plugin 3.9.15 ή νεότερο ο χαρακτήρας δοκιμών του μπορεί να πατά τα κουμπιά Shop και Buy, αλλά ελέγχει μόνο ό,τι αποφάσισε ο ίδιος να δοκιμάσει. Το μαγαζί συνήθως έρχεται μετά το βασικό gameplay και την αποθήκευση· ο κύκλος δημιουργίας παιχνιδιού βήμα βήμα με το RoCode δείχνει πού ταιριάζει. Πώς συνδέεται το RoCode με το Studio.
Συχνές ερωτήσεις
Τι είναι καλύτερο για ένα κουμπί Buy στο Roblox: RemoteEvent ή RemoteFunction;
Κάνουν και τα δύο, αρκεί να ελέγχει ο server. Το RemoteFunction αφήνει το κουμπί να περιμένει την απάντηση του server και να τη δείξει, γι' αυτό το χρησιμοποιεί ο οδηγός, και στον οδηγό ασφαλείας της Roblox το παράδειγμα μαγαζιού είναι επίσης με RemoteFunction. Καλέστε το μόνο από τον client: ένας server που καλεί InvokeClient μπορεί να περιμένει για πάντα αν ο client δεν απαντήσει ποτέ. Ο οδηγός για το RemoteEvent συγκρίνει τις δύο επιλογές.
Πώς ανοίγω το μαγαζί από NPC και όχι με κουμπί;
Βάλτε ένα ProximityPrompt σε κάποιο part του NPC, για παράδειγμα στο HumanoidRootPart του, ακούστε το event Triggered του σε ένα server Script και στείλτε σε αυτόν τον παίκτη ένα RemoteEvent ώστε το LocalScript να δείξει το πάνελ. Αν οι αγορές επιτρέπονται μόνο κοντά στο NPC, ελέγχετε επίσης την απόσταση από το NPC μέσα στον handler του BuyItem, επειδή ο client μπορεί να καλέσει το remote από οπουδήποτε.
Πώς πουλάω αντικείμενα που αγοράζονται πολλές φορές;
Για τέτοια αντικείμενα παραλείψτε τον έλεγχο "το έχει ήδη" και αντί για Tool δώστε κάτι που μετριέται, για παράδειγμα προσθέτετε 1 σε ένα IntValue που μετρά φίλτρα. Την αναζήτηση τιμής και τον έλεγχο των coins αφήστε τα όπως είναι.
Γιατί χάνεται το μαγαζί όταν ο χαρακτήρας κάνει respawn;
Στο ScreenGui του το ResetOnSpawn είναι true, που είναι η προεπιλογή, οπότε η Roblox το διαγράφει στο respawn. Βάλτε το false, όπως κάνει το script στο βήμα 3.
Μπορώ να πάρω ένα δωρεάν πρότυπο GUI μαγαζιού;
Ναι, κάνει οποιαδήποτε διάταξη, αρκεί τα κουμπιά Buy της να στέλνουν μόνο το id του αντικειμένου και η ίδια η αγορά να γίνεται σε server Script όπως το ShopService. Πριν πάρετε ένα πρότυπο, ελέγξτε μήπως αφαιρούνται coins ή δίνονται αντικείμενα μέσα σε LocalScript.
Πηγές και περαιτέρω ανάγνωση
- Roblox Creator Docs: Securing the client-server boundary (στα αγγλικά). έλεγχος ορισμάτων των remotes, NaN, περιορισμός συχνότητας και παράδειγμα μαγαζιού μέσα στο παιχνίδι
- Roblox Creator Docs: Remote events and callbacks (στα αγγλικά). RemoteFunction, InvokeServer, OnServerInvoke και οι κίνδυνοι του InvokeClient
- Roblox Creator Docs: Passes (στα αγγλικά). δημιουργία και πώληση passes, UserOwnsGamePassAsync και PromptGamePassPurchaseFinished
- Roblox Creator Docs: Shop (στα αγγλικά). το Shop μέσα στο παιχνίδι που η Roblox δημιουργεί αυτόματα
- Roblox Creator Docs: Developer Products (στα αγγλικά). επαναλαμβανόμενες αγορές με Robux και ProcessReceipt
- Roblox Creator Docs: StarterGear (στα αγγλικά). γιατί ένα Tool στο StarterGear επιστρέφει μετά το respawn
- Roblox Creator Docs: In-game tools (στα αγγλικά). Handle, anchor και RequiresHandle
Πώς ελέγχθηκε ο κώδικας: κάθε script σε αυτή τη σελίδα περνά αυστηρό έλεγχο τύπων Luau με τους ορισμούς του Roblox API (luau-lsp, 20 Νοεμβρίου 2026). Ο έλεγχος τύπων πιάνει λάθη σε ονόματα API και λάθος τύπους, όχι όμως λάθη στη λογική του παιχνιδιού, γι' αυτό δοκιμάστε τα πάντα στο Studio πριν τη δημοσίευση.