باختصار
احفظ لكل لاعب رقمين في DataStore: last، وهي قيمة os.time() لآخر استلام، وstreak. يمكن استلام الجائزة بعد مرور 24 ساعة. وإذا مرّ أكثر من 48 ساعة تبدأ السلسلة من جديد من اليوم 1، وإلا فإنها تزيد يومًا واحدًا وتدور على 7 أيام بجوائز تكبر. أجرِ الفحص داخل UpdateAsync حتى يحدث القرار والحفظ معًا.
- استخدم
os.time()على الخادم، لا الوقت الذي يرسله العميل. - داخل UpdateAsync أعِد nil عندما لا يمكن استلام الجائزة: يُلغى الحفظ ولا يُمنح شيء.
- العميل يطلب الحالة ويطلب الجائزة فقط، والخادم هو من يجيب.
كيف تعمل الجوائز اليومية والسلاسل
| الوقت منذ آخر استلام | النتيجة |
|---|---|
| أقل من 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.
-- جائزة واحدة كل 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.
-- زر 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.
اختبره
- للاختبار اضبط
CLAIM_EVERYعلى30، وSTREAK_LOST_AFTERعلى60. - اضغط Play. على الزر مكتوب «Claim day 1!». اضغطه: +50 عملة.
- يعدّ الزر 30 ثانية. استلم مجددًا خلال الثلاثين ثانية التالية: اليوم 2، +75.
- انتظر أكثر من دقيقة: سيكون الاستلام التالي اليوم 1 من جديد.
- قبل النشر أعِد القيمتين إلى سطري 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، وزرًا بعدّ تنازلي، مع الحفظ والفحص على الخادم.
- يستطيع في خطوة واحدة إدراج شاشة جوائز يومية متحركة جاهزة من مجموعات 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 ساعة المتحركة أبسط وتعمل بالطريقة نفسها في كل المناطق الزمنية.
المصادر والقراءات
- Roblox Creator Docs: GlobalDataStore:UpdateAsync (بالإنجليزية). دالة التحديث والإلغاء عبر nil
- Roblox Creator Docs: Data stores (بالإنجليزية). الوصول من Studio وأساسيات data store
- Roblox Creator Docs: Remote events and functions (بالإنجليزية). RemoteFunction
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.