Daily Rewards Login Streak System v1.0

Overview

---

A premium daily-rewards system for Roblox games. Configure a per-day reward table with up to 30 entries, pick a UI layout, pick a color theme, and the engine handles streak math, day boundaries, vacation freeze, milestones, claim validation, and DataStore persistence.

Eight built-in reward kinds cover currency, leaderstats, attributes, path-based stats, timed boosts, items, gamepass perks, and tools. The custom kind is the universal escape hatch — write a grant function and you can do anything Roblox lets you do server-side.

Four UI layouts: grid (default 7-wide calendar), timeline (horizontal track with progress bar), showcase (hero card + side mini-cards), and compact (floating corner widget). Each is a separate ModuleScript — buyers can write their own and swap it in.

Six color themes: treasure (gold + emerald, default), royal (purple + gold), arctic (cyan + white), ember (orange + crimson), forest (sage + amber), and mono (white + gray). Live-swappable via the admin panel.

A 3-tab admin dashboard for force-claiming, freezing/unfreezing, resetting, broadcasting themes, and viewing every player's streak at a glance.

Open source. Fully readable Luau. No obfuscation. Modify freely.

Features (36+)

---

Core Engine (8)

• Cycle length configurable from 1 to 30 days
• Per-day reward table with up to 30 entries
• Multi-reward days — list as many entries as you want per day
• Server-side claim validation (no client-trust)
• UTC day boundary (configurable timezone offset)
• Rate-limited claims (2-second debounce)
• Race-safe DataStore writes via UpdateAsync
• Parallel BindToClose saves with 25s timeout safety

Reward Kinds (8)

• currency / leaderstat — adds to player.leaderstats.<name>
• attribute — adds to player or character attribute
• stat — path-based, e.g. "PlayerData.Stats.Wins"
• boost — timed multiplier, auto-resets after duration
• item — JSON inventory attribute, your code processes
• gamepass — marks gamepass-style perk as unlocked
• tool — clones an Instance from ServerStorage to Backpack
• custom — your own grant function (the escape hatch)

Streak Mechanics (5)

• Lifetime streak counter (climbs across cycle wraps)
• Cycle position tracker (1..CycleDays)
• Lifetime milestones — bonus drops at day 7/14/30/100 (configurable)
• Vacation freeze — preserves streak after extended absence
• Streak shields — optional gamepass that pardons missed days

UI / UX (10)

• 4 distinct layouts — grid / timeline / showcase / compact
• 6 color themes (live-swappable via admin)
• Custom theme — override every color
• Floating dock — mid-right REW + ADM circular buttons
• Full mobile support — auto-detected, scaled controls
• Scale-based UI — looks right on phone / tablet / desktop / 4K
• Pulse animation on the REW button when claim is ready
• Claim animation — card pulses on successful claim
• Reminder toasts (join + idle nag, configurable interval)
• ✓ CLAIMED badge — clear visual state on completed days

Admin Panel (4)

• Overview tab — every player's streak, cycle, totals at a glance
• Per-player actions — Grant / Skip / Freeze / Reset
• Theme tab — broadcast a theme change to every player
• Config tab — read-only summary of cycle / shields / vacation

Game Integration (6)

• _G.CoreShunRewards_OnClaim — analytics / quest progress
• _G.CoreShunRewards_OnStreakBreak — churn tracking
• _G.CoreShunRewards_OnMilestone — celebrate big streaks
• _G.CoreShunRewards_OnShieldSave — thank shield owners
• _G.CoreShunRewards_OnResumeFromVacation — welcome back
• _G.CoreShunRewards_BeforeClaim — gate claims (return false to block)

Cross-Product Integration (1)

• CoreShun Toast Notifications — auto-fires Info toasts on join/idle, Success toast on claim. Auto-detected, no setup. (Bundle with CoreShun Toast for the full experience.)

Permission Modes (5)

---

Configure who can use the admin panel. Combine modes — pass if any matches.

• "owner" — only the place creator (default)
• "rank" — group rank ≥ MinRank
• "gamepass" — gamepass holders only
• "userid" — whitelist specific UserIds
• "public" — everyone (don't ship with this)

What's Included

---

• RewardsConfig.lua — single config file for everything
• RewardsServer.server.lua — main engine (DataStore, claim validation, reward routing)
• RewardsClient.client.lua — bootstrap, layout dispatch, hotkeys
• RewardsLayoutGrid.lua — default 7-wide calendar
• RewardsLayoutTimeline.lua — horizontal progress track
• RewardsLayoutShowcase.lua — hero + side mini-cards
• RewardsLayoutCompact.lua — floating corner widget
• RewardsAdminPanel.lua — 3-tab admin UI
• RewardsDock.lua — floating REW + ADM toggle buttons
• Installer.lua — one-line command bar installer
• README.txt and CHEATSHEET.txt — quick reference docs
• Manual.pdf — comprehensive 18-section guide
• Cheatsheet.pdf — visual one-page quick-ref
• Rojo project (default.project.json + ship.project.json) for active development

Easy Installation

---

1. Drag the included .rbxmx into your place
2. Open the Studio Command Bar
3. Run require(workspace.CoreShunDailyRewards.Installer)
4. Press K in-game to open the rewards panel, J for admin

Or use the included Rojo project for live development. Compatible with Rojo 7.x.

Frequently Asked

---

Can I grant items / pets / XP / cinematics — not just cash?
Yes. The custom reward kind is a server-side function you write. Anything Roblox lets you do server-side, you can do here. 12 ready-to-paste recipes are bundled in the config (random drops, pet unlocks, conditional rewards, chest spawns, cinematics, and more).

How is the day boundary calculated?
UTC midnight. Configurable via Config.General.TimezoneOffsetHours.

Can a player claim multiple times per day?
No. Server-side check rejects with "already_claimed_today" if lastClaimDay == today.

What happens if a player goes offline for weeks?
Vacation freeze preserves their streak after the configured threshold (default 14 days). When they return and claim, they pick up from the same cycle position. The display correctly shows them which day they'll claim next.

Can I bundle this with other CoreShun products?
Yes — Daily Rewards auto-detects CoreShun Toast Notifications and fires three toasts automatically. Pair with Toast for the polished experience.

Mobile support?
Full. Auto-detection, scaled controls, mid-right floating dock for opening panels (since hotkeys aren't available without a keyboard). All four layouts use scale-based positioning so they look right at every viewport.

Will it conflict with my existing leaderstats?
No. The system only reads/writes leaderstats by name when a currency reward applies. Other game systems are unaffected.

Open source?
Fully. Plain Luau, no obfuscation. Edit any file to customize.

More Tools by coreshun

---

• In-Game Systems — Music Player, Admin Dashboard, Anti-Exploit, Chat System, Toast, Overhead Tags, AutoRejoin, Codes Redemption
• Studio Plugins — Color Picker, UI Wireframe, Gamepass Manager, TODO Tracker (free)
• Bundles — up to 45% off

Browse all: builtbybit.com/creators/coreshun

Support

---

Discord: discord.com/invite/hdB5tadkk8