Kısaca
Eşyalarını ve fiyatlarını ReplicatedStorage'daki bir ModuleScript'te tut, pencereyi bir ScreenGui, bir ScrollingFrame ve bir UIGridLayout ile kur ve her Buy butonunun sadece eşyanın id'sini göndererek bir RemoteFunction çağırmasını sağla. Sonra ServerScriptService'teki bir Script fiyatı kendisi bulur, oyuncunun Coins'ini kontrol edip düşer ve eşyayı verir.
- Fiyatı asla client'ın göndermesine izin verme. Herkes remote'larını her değerle çağırabilir, bu yüzden sunucu fiyatı kataloğun kendi kopyasından okur.
- Satın alınan bir Tool'u vermek için onu ServerStorage'dan oyuncunun Backpack'ine (hemen kullanmak için) ve StarterGear'ına (yeniden doğduktan sonra geri gelmesi için) klonla.
- Robux ile satılanlar pass'ler ve developer product'lardır ve MarketplaceService ile yönetilir. Roblox bunun için otomatik bir Shop da oluşturur; bu, bir coin mağazasından ayrı bir şey.
Bu sayfada
Çalışan bir mağaza nasıl bir araya gelir
Canlı bir oyunda çalışan bir mağaza, oyuncunun cihazı ile sunucu arasında bölünmüştür. Cihaz pencereyi çizer ve "kılıcı almak istiyorum" der. Güvenebileceğin tek taraf olan sunucu, bunun olup olmayacağına karar verir. "Çalışmayan" ya da oyuncuların exploit ettiği mağaza scriptleri bu kararı çoğu zaman yanlış tarafta verir.
| Parça | Nereye konur | Ne yapar |
|---|---|---|
ShopCatalog ModuleScript'i | ReplicatedStorage | Eşyaların id'leri, adları ve fiyatları, ayrıca her birinin verdiği Tool. İki taraf da okur. |
BuyItem RemoteFunction'ı | ReplicatedStorage, ShopRemotes adlı bir klasörde | Satın alma isteğini sunucuya götürür ve cevabı geri getirir. |
ShopClient LocalScript'i | StarterPlayerScripts | Mağaza penceresini kurar ve bir Buy butonuna basıldığında eşyanın id'sini gönderir. |
ShopService Script'i | ServerScriptService | İsteği kontrol eder, Coins'i düşer ve Tool'u verir. |
| Sattığın Tool'lar | ServerStorage, ShopItems adlı bir klasörde | Sunucunun kopyaladığı orijinaller. ServerStorage'daki hiçbir şey oyunculara gönderilmez. |
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
Adım 1: coin'leri ve satılık eşyaları hazırla
Mağaza, oyuncunun leaderstats'ındaki bir Coins değerini harcar. Leaderboard rehberini takip ettiysen zaten bir tane var, yani bu scripti atla. Yoksa ServerScriptService'e Leaderstats adında bir Script ekle. Satın almaları baştan test edebilmen için herkes 200 coin ile başlar.
local Players = game:GetService("Players")
local STARTING_COINS = 200 -- mağazayı test etmeye yeter; oyuncular coin kazanabildiğinde 0 yap
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
Tek bir leaderstats scriptin olsun. Her biri bir leaderstats klasörü oluşturan iki script her oyuncuya iki klasör verir ve mağaza yanlış olanı okuyabilir.
Şimdi scriptlerin aradığı nesneleri oluştur. Adlar büyük küçük harfe duyarlı, yani onları aynen yaz.
- Explorer'da fareyle ReplicatedStorage üzerine gel, + butonuna tıkla ve
ShopRemotesadında bir Folder ekle. İçineBuyItemadında bir RemoteFunction ekle. - Fareyle ServerStorage üzerine gel ve
ShopItemsadında bir Folder ekle. - ShopItems'in içine her eşya için bir Tool koy, adları
ClassicSword,Flashlight,GrappleHookveSpeedCoilolsun. İlk test için bir Tool'un içinde sadeceHandleadında anchored olmayan bir Part olması yeter. Zaten sahip olduğun her Tool da olur: ona karşılık gelen adı ver. Gerçekten hasar veren bir silah için onu kılıç rehberiyle ya da silah rehberiyle (İngilizce) yap; her biri onu katalogla nasıl eşleştireceğini anlatıyor. - Her Tool'u seç ve Properties penceresinde CanBeDropped'ın işaretini kaldır. İşaretliyse Backspace'e basınca tool Workspace'e düşer ve alıcının parasını ödediği şeyi herhangi bir oyuncu alabilir.
Tek bir Tool ile başlayabilirsin. Bir eşyanın Tool'u eksikse sunucu onu satmayı reddeder ve adıyla bir uyarı gösterir, yani oyuncudan hiçbir şey düşülmez.
Adım 2: eşyaları ve fiyatları bir kataloğa koy
Katalog, mağazanın sattığı her şeyin tek listesidir. LocalScript kartları çizmek için, sunucu da fiyatları bulmak için onu okur, yani bir fiyatı değiştirmek tek bir yerde tek bir değişikliktir.
Fareyle ReplicatedStorage üzerine gel, bir ModuleScript ekle, adını ShopCatalog yap ve içeriğini bununla değiştir:
export type ShopItem = {
id: string, -- sonra data store'lara kaydedilir: biri eşyaya sahip olduktan sonra asla değiştirme
name: string, -- kartta gösterilir; değiştirebilirsin
price: number, -- Coins cinsinden
description: string,
toolName: string, -- oyuncunun aldığı ServerStorage.ShopItems içindeki Tool
}
-- Kartlar bu sırayla görünür
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
-- Bu id'ye sahip eşyayı döndürür, yoksa nil
function ShopCatalog.get(id: string): ShopItem?
return byId[id]
end
-- Oyuncu bir eşyaya sahip olduğunda sunucunun true yaptığı Player attribute'u
function ShopCatalog.ownedAttribute(id: string): string
return "Owns_" .. id
end
return ShopCatalog
Her eşyanın gösterilecek bir name'inin yanında bir id'si var. Bir oyuncu bir şeye sahip olduğunda sunucunun kaydettiği şey id'dir, yani kayıtlı satın almaları bozmadan "Classic Sword"un adını sonra değiştirebilirsin. Açıklamalar kartta sadece metin; bir Tool'un ne yaptığı kendi scriptlerine bağlı.
Oyuncular ReplicatedStorage'daki bir ModuleScript'i okuyabilir, yani bu fiyatlar herkese açık. Sorun değil: zaten kartlarda yazıyorlar. Önemli olan, client ile sunucunun modülün her biri kendi kopyasını çalıştırması, yani fiyatları kendi cihazında değiştiren bir oyuncu sunucuda hiçbir şeyi değiştirmez.
Adım 3: mağaza GUI'sini kur
Bu LocalScript tüm pencereyi kodla kuruyor: bir Shop butonu, kaydırılabilir bir kart ızgarası olan bir panel, katalogdaki her eşya için bir Buy butonu, bir Coins sayacı ve sunucunun cevapları için bir durum satırı. Her şey kod olduğu için yapıştırıp Play'e basabilirsin. Sonraki tablo, pencereyi elle kurmayı tercih edersen her nesneyi listeliyor.
- Explorer'da StarterPlayer'ı aç, fareyle StarterPlayerScripts üzerine gel ve
ShopClientadında bir LocalScript ekle. - İçeriğini aşağıdaki kodla değiştir.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- ShopCatalog modülünün döndürdüğü şey, böylece strict mod kullandığımız alanları kontrol eder
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: mağazanın oyuncunun ekranına çizdiği her şeyi tutar
local gui = Instance.new("ScreenGui")
gui.Name = "ShopGui"
gui.ResetOnSpawn = false -- karakter yeniden doğduğunda mağazayı korur
-- Sol kenarda mağazayı açıp kapatan bir buton
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)
-- Mağaza penceresi: ortada ve oyuncu açana kadar gizli
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) -- büyük ekranlarda pencerenin devasa olmasını engeller
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
-- Sunucunun cevapları burada görünür, "You need 20 more coins." gibi
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: sığandan fazla kart olduğunda kayan alan
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() -- sıfırdan başlar; AutomaticCanvasSize kartlar sığsın diye onu büyütür
list.AutomaticCanvasSize = Enum.AutomaticSize.Y
list.Parent = panel
-- UIGridLayout: kartları satırlara dizer ve sığmadıklarında bir sonraki satıra geçer
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..."
-- Sadece eşyanın id'sini gönder. Fiyatı sunucu kendisi bulur.
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)
-- Sunucu bu attribute'u satın alma tamamlandığında (ya da kayıtlı eşyalar yüklendiğinde) ayarlar
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")
-- Oyuncunun coin'lerini gösterir. Gerçek değer sunucunun; bu sadece gösterir.
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()
Butonlar MouseButton1Click yerine Activated kullanıyor: fare tıklamasıyla, telefonda dokunmayla ve oyun kumandasındaki A ya da X butonuyla tetiklenir.
Baştaki type tanımları ShopCatalog'un döndürdüğü şeyi anlatıyor, böylece strict mod item.prise gibi yanlış yazılmış bir alanı yakalar. Oyun çalışırken hiçbir şeyi değiştirmezler.
| Nesne | Mağazadaki işi | Önemli özellikler |
|---|---|---|
ScreenGui | Ekrana çizilen her şeyi tutar | ResetOnSpawn false, böylece mağaza yeniden doğuştan sağ çıkar |
Frame | Pencere ve her eşya kartı | Pencereyi ortalamak için AnchorPoint 0.5, 0.5 ve Position 0.5, 0.5 |
UISizeConstraint | Büyük ekranlarda pencereyi sınırlar | MaxSize 640 x 460 |
ScrollingFrame | Sığandan fazla kart olduğunda kayar | CanvasSize 0 ve AutomaticCanvasSize Y, böylece kayan alan kartlarla büyür |
UIGridLayout | Kartları satırlara dizer ve bir sonraki satıra geçirir | CellSize 180 x 200, CellPadding 12, SortOrder LayoutOrder |
UICorner | Köşeleri yuvarlar | 8 ile 14 piksel arası CornerRadius |
UIPadding | İç boşluk | Her kenarda 10 ile 12 piksel arası |
TextButton | Shop, kapatma ve Buy butonları | Activated event'i |
Pencereyi elle tasarlamak için aynı nesneleri bu özelliklerle StarterGui'nin içinde kur, orada da ScreenGui'nin ResetOnSpawn'unu false yap ve LocalScript'in katalogdaki her eşya için klonladığı bir şablon kart bırak. Böylece script sadece kartları doldurur ve butonları bağlar. Sonraki adımdaki satın alma mantığı değişmez.
Oyunun bir ana menüyle başlıyorsa, o rehber Shop butonunun sadece oyuncu Play'e bastıktan sonra görünmesi için ShopClient'a eklenecek satırı veriyor. Mağazayı bir satıcıyla konuşarak açmak için NPC diyalog rehberi, ShopClient'a penceresini açmasını söyleyen bir OpenShop eylemi eklemeyi gösteriyor; satın almalar ise yine mağazanın sunucu kontrollerinden geçiyor.
Adım 4: satın almaları sunucuda kontrol et ve tamamla
Bu Script, bir satın almanın gerçekleşebileceği tek yer. Eşyanın id'sini alır, kontrol eder, fiyatı bulur, oyuncunun Coins'ini kontrol eder, sonra coin'leri düşer ve Tool'u verir. Buy butonuna true ya da false ve gösterilecek bir mesajla cevap verir.
Fareyle ServerScriptService üzerine gel, ShopService adında bir Script ekle ve şunu yapıştır:
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- ShopCatalog modülünün döndürdüğü şey, böylece strict mod kullandığımız alanları kontrol eder
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: oyuncu tool'u hemen kullanabilir
local backpack = player:FindFirstChildOfClass("Backpack")
if backpack then
template:Clone().Parent = backpack
end
-- StarterGear: karakter her doğduğunda Roblox onu tekrar Backpack'e kopyalar
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'ın gönderdiği tek şey bir eşya id'si, yani bir string olmalı
if type(itemId) ~= "string" then
return false, "That item does not exist."
end
-- 2. Çift tıklamaları ve scriptle yapılan istek yağmurlarını görmezden gel
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. Eşyayı sunucunun kendi katalog kopyasında ara
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. Fiyat katalogdan gelir, asla client'tan değil
if coins.Value < item.price then
return false, `You need {item.price - coins.Value} more coins.`
end
-- 5. Coin'leri düş, sonra eşyayı ver. Burada hiçbir şey yield yapmaz, yani aynı oyuncudan
-- iki istek bu kod çalışmadan önce yukarıdaki kontrollerin ikisini birden geçemez.
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)
Oyuncunun bir eşyaya sahip olduğu, Player'da bir attribute olarak kaydedilir, mesela Owns_sword. Sunucunun ayarladığı attribute'lar oyuncunun cihazına replike edilir, yani LocalScript o kartı "Owned"a çevirebilir. Bir oyuncunun kendi kopyasında yaptığı değişiklik asla sunucuya ulaşmaz.
Tool iki yere gider. Backpack'teki kopya eşya çubuğunda hemen görünür. StarterGear'daki kopya, karakter her doğduğunda Roblox'un yeni Backpack'e koyduğu kopyadır. O olmadan, satın alınan bir eşya oyuncu ilk öldüğünde kaybolur.
Client neden asla fiyatı göndermez
Bir oyuncunun cihazındaki her şeyi o oyuncu değiştirebilir. Exploiter'lar oyunun kendi kopyalarında kendi kodlarını çalıştırır: LocalScript'lerini okuyabilir, GUI'yi düzenleyebilir ve BuyItem:InvokeServer()'ı istedikleri argümanlarla, istedikleri kadar çağırabilirler. Roblox'un güvenlik rehberi bir remote'un aldığı her şeyin türünün ve değerinin kontrol edilmesi gerektiğini söylüyor ve örnek olarak bir mağaza kullanıyor.
| Bir exploiter şunu gönderir | Sunucu buna inansaydı | ShopService ne yapar |
|---|---|---|
| 0 fiyat | Tüm eşyalar bedava olur | Görmezden gelir. Fiyat katalogdan gelir. |
| -1000 fiyat | Coins.Value -= -1000 ona 1.000 coin verir | Görmezden gelir. |
Fiyat olarak NaN | NaN ile her karşılaştırma false verir, yani "yeterli coin'in yok" kontrolü hiç tetiklenmez | Görmezden gelir. |
| Katalogda olmayan bir id ya da string yerine bir tablo | Scriptte hatalar ya da hiç satmak istemediğin eşyalar | "That item does not exist." cevabını verir. |
| Saniyede yüzlerce istek | Sunucuya yük ve kontrollerindeki her açık yüzlerce kez saldırıya uğrar | Oyuncu başına yarım saniyede en fazla bir isteği işler. |
| Kendi ekranında düzenlenmiş coin'ler | Sahip olmadığı coin'lerle satın almalar | Bunu hiç görmez. Sunucu sadece kendi Coins değerini okur. |
Kural yazdığın her remote için geçerli: oyuncunun seçtiğini gönder, bir eşya id'si ya da bir yuva numarası gibi; asla neyin ne kadar tuttuğunu ya da ne alması gerektiğini gönderme. RemoteEvent rehberi bir remote'un argümanlarının nasıl doğrulanacağını derinlemesine anlatıyor.
Adım 5: mağazayı test et
- Play'e bas. Solda bir Shop butonu görünür. Onu aç ve Flashlight'ı al: Coins'in 25 düşer, tool eşya çubuğunda görünür ve butonu Owned'a döner.
- 300 tutan Speed Coil'i dene. Durum satırı kaç coin'in eksik olduğunu söyler ve senden hiçbir şey düşülmez.
- Karakterini oyun menüsünden sıfırla. StarterGear'daki kopya sayesinde Flashlight yeni Backpack'te geri gelir.
- Test ederken kendine daha fazla coin vermek için Client/Server düğmesine tıklayıp Server'a geç, Explorer'da
Players, adın,leaderstats,Coins'i bul ve Properties penceresinde Value'sunu değiştir. Aynısını Client modunda yaparsan sadece senin ekranın değişir; bu da tam olarak sunucunun görmezden geldiği türde bir değişiklik.
Bir buton "The shop did not answer" diye cevap verirse Studio'nun Window menüsünden Output penceresini aç ve ShopService'ten kırmızı bir hata ara. Bunun yerine bir buton "Buying..." durumunda kalıyorsa ShopService çalışmıyor ya da bir nesneyi beklerken takılmış: Sık karşılaşılan hatalar'a bak.
Robux ile game pass satmak
Coins senin kendi para birimin, yani yukarıdaki mağaza her satın almaya kendi başına karar verir. Bir oyuncunun Robux ile aldığı şeyler farklı çalışır: bir game pass bir kez alınır ve kalır (VIP avantajları, kalıcı bir tool), bir developer product ise tekrar tekrar alınabilir (bir coin paketi, bir seviye atlama). İkisi de Roblox'un MarketplaceService'inden geçer ve ödemeyi senin scriptin değil, Roblox tahsil eder.
Bu rehberden iki kural geçerli kalıyor: satın almayı client'taki bir butondan göster ve avantajı sadece sunucuda, Roblox satın almayı onayladığında ya da oyuncu pass'e zaten sahipse ver. Roblox game pass scripti rehberi (İngilizce) bunu baştan sona kuruyor: girişte sahiplik kontrolü, satın alma penceresi, VIP kapısı gibi avantajlar ve bunun yerine ne zaman bir developer product kullanılacağı. Bir fiyat seçmek için ücretsiz Robux vergi hesaplayıcı, Roblox'un payından sonra bir pass'in ya da bir developer product'ın sana ne kadar kazandırdığını gösteriyor.
Oyuncuların satın aldıklarını kaydet
Şimdiye kadarki her şey bir oturum sürer: bir data store ile kaydedene kadar coin'ler ve satın alınan eşyalar oyuncu çıkınca sıfırlanır. Kayıt kodunu burada tekrarlamak yerine DataStore eğitimini (ya da daha kısa bir sürüm için leaderboard rehberinin 3. adımını) takip et ve mağaza için şu kuralları aklında tut:
- Eşyaların id'lerini,
{ "sword", "flashlight" }gibi, Coins değeriyle aynı tabloya kaydet, böylece tek bir kayıt hem harcanan coin'leri hem satın alınan eşyayı birlikte tutar. Tool'lar ve diğer instance'lar bir data store'a kaydedilemez. - Veriler yüklendiğinde kayıtlı id'lerin üzerinden geç, katalogda artık olmayanları atla, her
Owns_attribute'unu ayarla ve Tool'u tıpkıgiveTool'un yaptığı gibi ver. Mağaza penceresi kendi kendine güncellenir, çünkü bu attribute'ları dinliyor. - Pass'leri kaydetmeye gerek yok:
UserOwnsGamePassAsyncoyuncu her girdiğinde Roblox'a sorar. - Verileri yüklenmemiş bir oyuncuyu asla kaydetme, yoksa başarısız bir yükleme satın almalarını boş bir listeyle değiştirebilir.
Sık karşılaşılan hatalar ve çözümleri
Mağaza bozulduğunda önce bunlara bak. Her şeyden önce Output penceresini aç (Window menüsü, sonra Output): bir script hatası scriptin adını ve satırı söyler.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("ShopRemotes")'
Bir script tam olarak o adla var olmayan bir nesneyi bekliyor. ShopRemotes, BuyItem, ShopCatalog ve ShopItems'in büyük küçük harfleriyle nasıl yazıldığını ve ShopItems'in ReplicatedStorage'da değil ServerStorage'da olduğunu kontrol et. Script hataları rehberi bu uyarıyı ayrıntılı açıklıyor.
Bir Buy butonu "Buying..." durumunda kalıyor ve hiç cevap vermiyor
Sunucuda hiçbir şey BuyItem.OnServerInvoke'u ayarlamadı, bu yüzden Roblox biri ayarlayana kadar isteği bekletiyor. ShopService'in bir LocalScript değil, ServerScriptService içinde bir Script olduğundan emin ol ve Output'ta ShopService'ten bir Infinite yield possible uyarısı ara: bu, scriptin ShopCatalog'u, ShopRemotes'u ya da ShopItems'i beklerken takıldığı anlamına gelir.
Bir Buy butonu "The shop did not answer" diyor
Sunucuya yapılan çağrı bir cevap döndürmek yerine başarısız oldu. Genelde ShopService isteği işlerken içinde bir hata oluşmuştur, bu yüzden Output'ta ShopService'ten kırmızı bir hata ara: satırı söyler.
Bir buton "This item is not available right now" diyor
Sunucu ServerStorage, ShopItems içinde o eşyanın toolName'ine sahip bir Tool bulamadı. Output aradığı tam adla bir uyarı gösterir.
Bir tool aldım ama karakterim onu tutamıyor ya da takılıp kalıyor
Bir Tool'un doğrudan çocuğu olarak tam olarak bir tane Handle adlı parçaya ihtiyacı var ve parçalarının hiçbiri anchored olamaz. Tutulacak bir şeyi olmayan bir tool için RequiresHandle'ın işaretini kaldır.
Coin'ler benim ekranımda düştü ama diğerleri için düşmedi
Satın alma bir LocalScript'te yapıldı, yani sadece senin cihazın değişti. Coin değişikliğini ve Tool'un verilmesini 4. adımdaki gibi bir sunucu Script'ine taşı.
Satın alınan eşyalar tekrar girdiğimde kayboluyor
Henüz hiçbir şey kaydedilmiyor. Oyuncuların satın aldıklarını kaydet'e bak.
RoCode ile kur
Bunların hepsini elle bağlamak istemiyorsan RoCode bunu açık olan place'inde kurabilir. Kod yazan bağımsız bir yapay zeka ajanı: özelliği web sohbetinde anlatıyorsun, Roblox Studio plugin'i de scriptleri, remote'u ve GUI'yi Explorer'ında oluşturuyor, yani bir sohbet penceresinden kod kopyalamıyorsun.
Bir coin mağazası ekle: leaderstats'ımdaki Coins ile fiyatlandırılmış dört tool'luk bir ızgara açan bir Shop butonu. Sunucu fiyatı kontrol etmeli ve tool'u Backpack'e ve StarterGear'a vermeli.
- Search Scripts ve Read Script ile place'inde zaten var olan leaderstats'ı ve mağaza kodunu arayabilir, böylece ikinci bir tane eklemek yerine senin Coins değerini yeniden kullanır
- Pencerenin temelini Build UI ile kurabilir; onun mağaza tasarımı örnek eşya kartları ve fareyle üzerine gelme efektleri ile kapatma butonu için bir LocalScript getirir; satın alma mantığı ayrı scriptlerde yazılır
- RemoteFunction'ı Create Instance ile oluşturur, katalog ModuleScript'ini, sunucu Script'ini ve LocalScript'i de Create Script ile yazar
- Her scriptin derlendiğini Studio içinde Check Script ile kontrol eder (tür denetimi yapmaz, onları çalıştırmaz) ve her değişiklik grubu Studio'da bir geri alma noktasıdır
Pass'leri Creator Hub'da yine sen oluşturuyorsun, çünkü RoCode pass ya da developer product oluşturamaz, satın almaları da sen test ediyorsun: plugin 3.9 ya da üstüyle RoCode kısa bir test yapıp hataları okuyabilir, plugin 3.9.15 ya da üstüyle de test karakteri Shop ve Buy butonlarına tıklayabilir, ama sadece test etmeyi seçtiği şeyi kontrol eder. Bir mağaza genelde oyunun ana döngüsünden ve kayıttan sonra gelir; RoCode ile adım adım oyun yapma süreci nereye oturduğunu gösteriyor. RoCode Studio'ya nasıl bağlanır.
Sık sorulan sorular
Buy butonu RemoteEvent mi yoksa RemoteFunction mı kullanmalı?
Kontrolleri sunucu yaptığı sürece ikisi de olur. Bir RemoteFunction butonun sunucunun cevabını beklemesine ve onu göstermesine izin verir; bu rehber bu yüzden bir tane kullanıyor ve Roblox'un güvenlik rehberi de mağaza örneğinde bir RemoteFunction kullanıyor. Onu sadece client'tan çağır: InvokeClient çağıran bir sunucu, client hiç cevap vermezse sonsuza kadar bekleyebilir. RemoteEvent rehberi ikisini karşılaştırıyor.
Mağazayı bir buton yerine bir NPC'den nasıl açarım?
NPC'nin HumanoidRootPart'ı gibi bir parçasının içine bir ProximityPrompt koy, onun Triggered event'ini bir sunucu Script'inde dinle ve LocalScript paneli göstersin diye o oyuncuya bir RemoteEvent gönder. Satın alma sadece NPC'nin yanında mümkün olmalıysa BuyItem handler'ının içinde NPC'ye olan mesafeyi de kontrol et, çünkü bir client remote'u her yerden çağırabilir.
Birden fazla kez alınabilen eşyaları nasıl satarım?
O eşyalar için "zaten sahipsin" kontrolünü kaldır ve bir Tool yerine sayılabilen bir şey ver, mesela iksirleri sayan bir IntValue'ya 1 ekle. Fiyat aramayı ve coin kontrolünü tam olarak olduğu gibi bırak.
Karakterim yeniden doğduğunda mağazam neden kayboluyor?
ScreenGui'sinin ResetOnSpawn'u varsayılan değer olan true, bu yüzden Roblox onu yeniden doğuşta siliyor. 3. adımdaki scriptin yaptığı gibi false yap.
Ücretsiz bir mağaza GUI şablonu kullanabilir miyim?
Evet, Buy butonları sadece bir eşya id'si gönderdiği ve satın almanın kendisi ShopService gibi bir sunucu Script'inde yapıldığı sürece her tasarım olur. Bir şablonu kullanmadan önce scriptlerinin coin düşüp düşmediğine ya da eşyaları bir LocalScript'te verip vermediğine bak.
Kaynaklar ve ek okumalar
- Roblox Creator Docs: Securing the client-server boundary (İngilizce). bir remote'un argümanlarını doğrulamak, NaN, istek sınırı ve oyun içi mağaza örneği
- Roblox Creator Docs: Remote events and callbacks (İngilizce). RemoteFunction, InvokeServer, OnServerInvoke ve InvokeClient'ın riskleri
- Roblox Creator Docs: Passes (İngilizce). pass oluşturmak ve satmak, UserOwnsGamePassAsync ve PromptGamePassPurchaseFinished
- Roblox Creator Docs: Shop (İngilizce). Roblox'un otomatik oluşturduğu oyun içi Shop
- Roblox Creator Docs: Developer Products (İngilizce). tekrarlanan Robux satın almaları ve ProcessReceipt
- Roblox Creator Docs: StarterGear (İngilizce). StarterGear'daki bir Tool neden yeniden doğduktan sonra geri gelir
- Roblox Creator Docs: In-game tools (İngilizce). Handle, anchored durumu ve RequiresHandle
Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.