Eğitim · Oyun sistemleri

Roblox Studio'da mağaza nasıl yapılır

Bir Roblox oyunundaki mağaza iki iştir: eşyaları gösteren bir GUI ve bir satın almanın gerçekleşip gerçekleşmeyeceğine karar veren bir sunucu scripti. Bu rehber, tool satan bir coin mağazası için ikisini de kuruyor ve Robux ile satın almaların nereye oturduğunu gösteriyor.

Güncellendi: 20 Kasım 202611 dk okumaYazan:

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
  1. Nasıl bir araya gelir
  2. 1. Hazırlık
  3. 2. Eşya kataloğu
  4. 3. Mağaza GUI'si
  5. 4. Sunucuda satın alma
  6. Client neden fiyat göndermez
  7. 5. Test
  8. Game pass
  9. Satın almaları kaydetmek
  10. Sık hatalar
  11. RoCode ile
  12. Sık sorulan sorular
  13. Kaynaklar ve ek okumalar

Çalışan bir mağaza nasıl bir araya gelir

ÇizimOyuncu mağazayı açıyor ve Flashlight'ı 25 coin'e alıyor: Coins 200'den 175'e düşüyor, butonu Owned'a dönüyor ve tool eşya çubuğunda görünüyor.

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.

Mağazanın beş parçası
ParçaNereye konurNe yapar
ShopCatalog ModuleScript'iReplicatedStorageEş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ördeSatın alma isteğini sunucuya götürür ve cevabı geri getirir.
ShopClient LocalScript'iStarterPlayerScriptsMağaza penceresini kurar ve bir Buy butonuna basıldığında eşyanın id'sini gönderir.
ShopService Script'iServerScriptServiceİsteği kontrol eder, Coins'i düşer ve Tool'u verir.
Sattığın Tool'larServerStorage, ShopItems adlı bir klasördeSunucunun kopyaladığı orijinaller. ServerStorage'daki hiçbir şey oyunculara gönderilmez.
Mağaza bittiğinde Explorer
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.

Script konum: ServerScriptService adı: Leaderstats
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.

  1. Explorer'da fareyle ReplicatedStorage üzerine gel, + butonuna tıkla ve ShopRemotes adında bir Folder ekle. İçine BuyItem adında bir RemoteFunction ekle.
  2. Fareyle ServerStorage üzerine gel ve ShopItems adında bir Folder ekle.
  3. ShopItems'in içine her eşya için bir Tool koy, adları ClassicSword, Flashlight, GrappleHook ve SpeedCoil olsun. İlk test için bir Tool'un içinde sadece Handle adı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.
  4. 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:

ModuleScript konum: ReplicatedStorage adı: ShopCatalog
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.

  1. Explorer'da StarterPlayer'ı aç, fareyle StarterPlayerScripts üzerine gel ve ShopClient adında bir LocalScript ekle.
  2. İçeriğini aşağıdaki kodla değiştir.
LocalScript konum: StarterPlayerScripts adı: ShopClient
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.

GUI nesneleri ve önemli özellikleri
NesneMağazadaki işiÖnemli özellikler
ScreenGuiEkrana çizilen her şeyi tutarResetOnSpawn false, böylece mağaza yeniden doğuştan sağ çıkar
FramePencere ve her eşya kartıPencereyi ortalamak için AnchorPoint 0.5, 0.5 ve Position 0.5, 0.5
UISizeConstraintBüyük ekranlarda pencereyi sınırlarMaxSize 640 x 460
ScrollingFrameSığandan fazla kart olduğunda kayarCanvasSize 0 ve AutomaticCanvasSize Y, böylece kayan alan kartlarla büyür
UIGridLayoutKartları satırlara dizer ve bir sonraki satıra geçirirCellSize 180 x 200, CellPadding 12, SortOrder LayoutOrder
UICornerKöşeleri yuvarlar8 ile 14 piksel arası CornerRadius
UIPaddingİç boşlukHer kenarda 10 ile 12 piksel arası
TextButtonShop, 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:

Script konum: ServerScriptService adı: ShopService
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.

Sunucu client'a güvenirse ne olur
Bir exploiter şunu gönderirSunucu buna inansaydıShopService ne yapar
0 fiyatTüm eşyalar bedava olurGörmezden gelir. Fiyat katalogdan gelir.
-1000 fiyatCoins.Value -= -1000 ona 1.000 coin verirGörmezden gelir.
Fiyat olarak NaNNaN ile her karşılaştırma false verir, yani "yeterli coin'in yok" kontrolü hiç tetiklenmezGörmezden gelir.
Katalogda olmayan bir id ya da string yerine bir tabloScriptte hatalar ya da hiç satmak istemediğin eşyalar"That item does not exist." cevabını verir.
Saniyede yüzlerce istekSunucuya yük ve kontrollerindeki her açık yüzlerce kez saldırıya uğrarOyuncu başına yarım saniyede en fazla bir isteği işler.
Kendi ekranında düzenlenmiş coin'lerSahip olmadığı coin'lerle satın almalarBunu 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

  1. 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.
  2. 300 tutan Speed Coil'i dene. Durum satırı kaç coin'in eksik olduğunu söyler ve senden hiçbir şey düşülmez.
  3. Karakterini oyun menüsünden sıfırla. StarterGear'daki kopya sayesinde Flashlight yeni Backpack'te geri gelir.
  4. 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: UserOwnsGamePassAsync oyuncu 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.

Sen yazarsın

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.

RoCode yapar
  • 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

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.

RoCode'u kendi oyununda dene.

Her gün ücretsiz kredi, kart gerekmez. Plugin'i kur, özelliği anlat ve Studio'da ne oluştuğunu kontrol et.