Cronjobs
This page lists the scheduled commands configured in the target project.
Overview
The project uses the following recurring jobs through the Laravel scheduler.
| Command | Schedule | Description |
|---|---|---|
referrals:process | Hourly | Check pending referrals and award silk when referred players reach the required character level. |
queue:work --stop-when-empty | Every minute | Process all queued jobs (e.g. Discord webhook notifications) and exit when the queue is empty. |
| Scheduler heartbeat | Every minute | Writes a timestamp to cache so the admin panel can detect whether the cron is active. |
What It Does
referrals:process
The referrals:process command processes all pending referrals, validates them based on the required character level, and awards silk once the referral conditions are met.
queue:work --stop-when-empty
Starts a short-lived queue worker every minute to process any pending queued jobs. This is used by the Discord Notifications system to deliver webhook messages asynchronously. The worker exits automatically once the queue is empty — no persistent process required.
Scheduler Heartbeat
Every minute the scheduler writes a timestamp to the application cache. The Discord Notifications admin page reads this value to show a live status banner indicating whether the cron is running correctly.
TIP
Make sure the system cron calls php artisan schedule:run every minute so all scheduled commands run on time. See the platform-specific setup guides:
- Ubuntu/Linux → Step 17: Configure Cron for Scheduled Tasks
- Windows (Laragon) → Step 8: Configure Laravel Scheduler in Laragon