درس · الجوائز

كيف تصنع الجوائز اليومية في Roblox Studio

الجائزة اليومية تعطي اللاعبين سببًا لفتح لعبتك غدًا، والسلسلة تعطيهم سببًا لعدم تفويت أي يوم. المنطق كله يقوم على طابع زمني محفوظ: متى استلم اللاعب الجائزة آخر مرة، وكم يومًا متتاليًا. يحفظ هذا الدليل القيمتين بأمان، فلا يستطيع اللاعب استلام الجائزة مرتين بإعادة الدخول إلى اللعبة أو بفتح خادمين، ويضيف زرًا فيه عدّ تنازلي حتى الجائزة التالية.

آخر تحديث ٢٠ نوفمبر ٢٠٢٦القراءة في 3 دبقلم

باختصار

احفظ لكل لاعب رقمين في DataStore: last، وهي قيمة os.time() لآخر استلام، وstreak. يمكن استلام الجائزة بعد مرور 24 ساعة. وإذا مرّ أكثر من 48 ساعة تبدأ السلسلة من جديد من اليوم 1، وإلا فإنها تزيد يومًا واحدًا وتدور على 7 أيام بجوائز تكبر. أجرِ الفحص داخل UpdateAsync حتى يحدث القرار والحفظ معًا.

  • استخدم os.time() على الخادم، لا الوقت الذي يرسله العميل.
  • داخل UpdateAsync أعِد nil عندما لا يمكن استلام الجائزة: يُلغى الحفظ ولا يُمنح شيء.
  • العميل يطلب الحالة ويطلب الجائزة فقط، والخادم هو من يجيب.
في هذه الصفحة
  1. طريقة العمل
  2. 1. الخادم
  3. 2. الزر
  4. Common errors
  5. With RoCode
  6. الأسئلة الشائعة
  7. المصادر والقراءات

كيف تعمل الجوائز اليومية والسلاسل

ماذا يحدث عند الاستلام بحسب الوقت منذ المرة السابقة
الوقت منذ آخر استلامالنتيجة
أقل من 24 ساعةما زال الوقت مبكرًا. يُظهر الزر عدًّا تنازليًا.
من 24 إلى 48 ساعةيمكن استلام الجائزة، وتزيد السلسلة يومًا واحدًا.
أكثر من 48 ساعةيمكن استلام الجائزة، وتبدأ السلسلة من جديد من اليوم 1.
بعد اليوم 7الاستلام التالي هو اليوم 1 من أسبوع جديد.

تُعيد os.time() على الخادم وقت Unix الحالي بالثواني بتوقيت UTC، لذلك تتفق عليه كل الخوادم. ساعة حاسوب اللاعب لا دخل لها، ولهذا لا يفيد تغيير التاريخ على الهاتف بشيء.

الخطوة 1: خادم الجوائز

فعّل Enable Studio Access to API Services في Game Settings، ثم Security (يجب أن يكون المكان منشورًا). ثم أدرج Script في ServerScriptService باسم DailyRewards:

Script في ServerScriptService باسم DailyRewards
-- Script في ServerScriptService باسم DailyRewards.
-- جائزة واحدة كل 24 ساعة. إذا استُلمت مجددًا خلال 48 ساعة تستمر السلسلة،
-- وتكبر الجوائز كل يوم طوال الأسبوع، ثم يبدأ الأسبوع من جديد.
local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local REWARDS = { 50, 75, 100, 150, 200, 300, 500 } -- العملات للأيام من 1 إلى 7 في السلسلة
local CLAIM_EVERY = 24 * 60 * 60 -- الثواني بين كل استلامين
local STREAK_LOST_AFTER = 48 * 60 * 60 -- فوّت يومًا كاملًا، فتبدأ السلسلة من جديد

type Record = { last: number, streak: number }

local store = DataStoreService:GetDataStore("DailyRewards_v1")
local statusFunction = Instance.new("RemoteFunction")
statusFunction.Name = "GetDailyStatus"
statusFunction.Parent = ReplicatedStorage
local claimFunction = Instance.new("RemoteFunction")
claimFunction.Name = "ClaimDaily"
claimFunction.Parent = ReplicatedStorage

local records: { [Player]: Record } = {}
local claiming: { [Player]: boolean } = {}

local function readRecord(data: any): Record
	if type(data) == "table" and type(data.last) == "number" and type(data.streak) == "number" then
		return { last = data.last, streak = data.streak }
	end
	return { last = 0, streak = 0 }
end

-- يوم السلسلة للاستلام التالي، من 1 إلى 7
local function nextDay(record: Record, now: number): number
	if now - record.last >= STREAK_LOST_AFTER then
		return 1
	end
	return record.streak % #REWARDS + 1
end

local function addCoins(player: Player, amount: number)
	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	if coins and coins:IsA("IntValue") then
		coins.Value += amount
	end
end

Players.PlayerAdded:Connect(function(player: Player)
	local ok, data = pcall(function()
		return store:GetAsync(tostring(player.UserId))
	end)
	if ok then
		records[player] = readRecord(data)
	else
		warn("DailyRewards: could not load", player.Name, data)
	end
end)

Players.PlayerRemoving:Connect(function(player: Player)
	records[player] = nil
	claiming[player] = nil
end)

-- ما تعرضه القائمة: الثواني حتى الاستلام التالي (0 = ممكن الآن) وأي يوم هو
statusFunction.OnServerInvoke = function(player: Player)
	local record = records[player]
	if not record then
		return nil
	end
	local now = os.time()
	return {
		wait = math.max(0, record.last + CLAIM_EVERY - now),
		day = nextDay(record, now),
		rewards = REWARDS,
	}
end

claimFunction.OnServerInvoke = function(player: Player): string
	local record = records[player]
	if not record then
		return "Still loading, try again in a moment"
	end
	if claiming[player] then
		return "One moment..."
	end
	claiming[player] = true
	local now = os.time()
	local claimedDay: number? = nil
	-- يقرأ UpdateAsync أحدث سجل محفوظ ويقرر داخل التحديث، لذلك
	-- لا يستطيع خادم ثانٍ (أو نقرة ثانية) استلام اليوم نفسه مرتين
	local ok, err = pcall(function()
		store:UpdateAsync(tostring(player.UserId), function(old: any)
			-- قد يستدعي UpdateAsync هذه الدالة عدة مرات: لا يُحسب إلا الاستدعاء الأخير
			claimedDay = nil
			local saved = readRecord(old)
			if now - saved.last < CLAIM_EVERY then
				return nil -- ما زال مبكرًا: إعادة nil تلغي الحفظ
			end
			local day = nextDay(saved, now)
			claimedDay = day
			return { last = now, streak = day }
		end)
	end)
	claiming[player] = nil
	if not ok then
		warn("DailyRewards: could not save", player.Name, err)
		return "Could not save, try again later"
	end
	local day = claimedDay
	if not day then
		return "Come back later for your next reward"
	end
	records[player] = { last = now, streak = day }
	addCoins(player, REWARDS[day])
	return string.format("Day %d reward: +%d coins!", day, REWARDS[day])
end

يحدث الاستلام داخل الدالة الممرَّرة إلى UpdateAsync. يستدعيها Roblox مع أحدث سجل محفوظ. إذا كان الوقت ما زال مبكرًا تُعيد الدالة nil، فيلغي Roblox الكتابة. وإلا فإنها تُعيد السجل الجديد، ويتذكر السكربت أي يوم استُلم. لا تُضاف العملات إلا بعد أن ينتهي UpdateAsync دون خطأ. وإذا غيّر خادم آخر المفتاح في هذه الأثناء، فقد يستدعي Roblox الدالة مرة أخرى بقيمة أحدث، ولهذا يُتخذ القرار داخلها.

الخطوة 2: زر بعدّ تنازلي

أدرج LocalScript في StarterPlayer > StarterPlayerScripts باسم DailyRewardsMenu:

LocalScript في StarterPlayerScripts باسم DailyRewardsMenu
-- LocalScript في StarterPlayerScripts باسم DailyRewardsMenu.
-- زر Daily بعدّ تنازلي. عندما تجهز الجائزة يُكتب عليه Claim.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local statusFunction = ReplicatedStorage:WaitForChild("GetDailyStatus") :: RemoteFunction
local claimFunction = ReplicatedStorage:WaitForChild("ClaimDaily") :: RemoteFunction

local gui = Instance.new("ScreenGui")
gui.Name = "DailyGui"
gui.ResetOnSpawn = false
local button = Instance.new("TextButton")
button.Size = UDim2.fromOffset(170, 48)
button.Position = UDim2.new(0, 12, 0.5, 52)
button.BackgroundColor3 = Color3.fromRGB(240, 170, 40)
button.TextColor3 = Color3.new(1, 1, 1)
button.Font = Enum.Font.GothamBold
button.TextSize = 17
button.Text = "Daily reward"
local corner = Instance.new("UICorner")
corner.CornerRadius = UDim.new(0, 10)
corner.Parent = button
button.Parent = gui
gui.Parent = Players.LocalPlayer:WaitForChild("PlayerGui")

local readyAt: number? = nil -- وقت os.clock() الذي تجهز فيه الجائزة
local day = 1
local busy = false

local function refresh()
	local ok, status = pcall(function()
		return statusFunction:InvokeServer()
	end)
	if ok and type(status) == "table" and type(status.wait) == "number" then
		readyAt = os.clock() + status.wait
		day = if type(status.day) == "number" then status.day else 1
	end
end

local function format(seconds: number): string
	local h = seconds // 3600
	local m = (seconds % 3600) // 60
	local s = seconds % 60
	return string.format("%02d:%02d:%02d", h, m, s)
end

button.Activated:Connect(function()
	if busy or not readyAt or os.clock() < readyAt then
		return
	end
	busy = true
	button.Text = "Claiming..."
	local ok, message = pcall(function()
		return claimFunction:InvokeServer()
	end)
	button.Text = if ok and type(message) == "string" then message else "Try again"
	task.wait(2)
	refresh()
	busy = false
end)

refresh()
while true do
	if not busy then
		if not readyAt then
			button.Text = "Loading..."
			refresh()
		elseif os.clock() >= readyAt then
			button.Text = string.format("Claim day %d!", day)
		else
			button.Text = "Next: " .. format(math.ceil(readyAt - os.clock()))
		end
	end
	task.wait(1)
end

يسأل الزر الخادم مرة واحدة كم يجب أن ينتظر، ثم يعدّ بنفسه كل ثانية عبر os.clock()، فلا يتصل بالخادم كل ثانية. وبعد الاستلام يسأل مجددًا. العدّ التنازلي للعرض فقط: الخادم يفحص الوقت على أي حال عندما يضغط اللاعب Claim.

اختبره

  1. للاختبار اضبط CLAIM_EVERY على 30، وSTREAK_LOST_AFTER على 60.
  2. اضغط Play. على الزر مكتوب «Claim day 1!». اضغطه: +50 عملة.
  3. يعدّ الزر 30 ثانية. استلم مجددًا خلال الثلاثين ثانية التالية: اليوم 2، +75.
  4. انتظر أكثر من دقيقة: سيكون الاستلام التالي اليوم 1 من جديد.
  5. قبل النشر أعِد القيمتين إلى سطري 24 و48 ساعة.

الأخطاء الشائعة وحلولها

راقب نافذة Output في وضع Server.

الزر يُظهر Loading... طوال الوقت

لم يُحمَّل سجل اللاعب. فعّل في Studio خيار Enable Studio Access to API Services. يظهر الخطأ في Output بعد «could not load».

عند الاستلام يظهر «Come back later» مع أن الزر كان يقول Claim

السجل المحفوظ كان أحدث مما يعرفه الزر، مثلًا بعد الاستلام على خادم آخر. الإجابة الصحيحة هي التي أعطاها الخادم.

السلسلة تُصفَّر كل يوم

اللاعبون يستلمون الجائزة بفاصل أكبر من 48 ساعة، أو بقي STREAK_LOST_AFTER على القيمة التجريبية.

العملات لا تُضاف

يجب أن يكون لدى اللاعب IntValue باسم Coins داخل leaderstats، أنشأه سكربت على الخادم.

ابنِه باستخدام RoCode

إذا لم ترغب في إعداد هذا يدويًا، يستطيع RoCode بناءه في المكان المفتوح عندك. RoCode وكيل ذكاء اصطناعي مستقل لـ Roblox Studio، وليس من Roblox: تصف التغيير في دردشة الويب، وتنشئ إضافته لـ Studio السكربتات في Explorer عندك.

ما تكتبه

أضف جوائز يومية مع سلسلة 7 أيام: عملات في الأيام من 1 إلى 6 وجوهرة في اليوم 7، وزرًا بعدّ تنازلي، مع الحفظ والفحص على الخادم.

ما يفعله RoCode
  • يستطيع في خطوة واحدة إدراج شاشة جوائز يومية متحركة جاهزة من مجموعات UI المميزة لديه بأحد خمسة أنماط (candy وneon وgold وblocky وpastel)، مع سكربتات خادم تعمل
  • أو يكتب سكربت الخادم والزر من هذا الدليل، موصولين بعملتك الموجودة
  • تعليماته أن يفحص تجميع كل سكربت عبر Check Script، ويضع نقاط تراجع حول كل مجموعة تغييرات

بعد البناء يستطيع RoCode تشغيل روبوت الاختبار الخاص به: يلعب لعبتك في Studio ويضغط الأزرار ويبلّغ PASS أو FAIL. لا يفحص إلا ما اختاره هو للاختبار، أما مؤقت 24 ساعة فيحتاج إلى اختبارك أنت بقيم قصيرة. كيف يتصل RoCode بـ Studio.

الأسئلة الشائعة

كيف أصنع جوائز يومية في Roblox؟

احفظ وقت آخر استلام لكل لاعب عبر os.time() على الخادم، واسمح بالاستلام بعد 24 ساعة، واحفظه داخل UpdateAsync قبل منح الجائزة. السكربت في الخطوة 1.

كيف أصنع سلسلة دخول يومي؟

احفظ عدّاد السلسلة مع وقت الاستلام. إذا جاء الاستلام التالي خلال 48 ساعة فأضف واحدًا، وإذا جاء بعد ذلك فابدأ من 1 من جديد.

هل يستطيع اللاعبون الغش في الجوائز اليومية بتغيير الساعة؟

ليس مع هذا السكربت: فهو يستخدم os.time() الخاصة بالخادم فقط.

أليس الأفضل تصفير الجائزة عند منتصف الليل؟

يمكنك عدّ الأيام التقويمية بتوقيت UTC بدلًا من 24 ساعة. لكن الـ 24 ساعة المتحركة أبسط وتعمل بالطريقة نفسها في كل المناطق الزمنية.

المصادر والقراءات

كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.

جرّب RoCode على لعبتك أنت.

رصيد مجاني كل يوم ودون بطاقة. ثبّت الإضافة، وصف الميزة، وراجع ما يظهر في Studio.