🌸 What is LilsDeferred?
LilsDeferred is a lightweight utility plugin for Paper that allows server administrators to queue commands and actions to run later.
Tasks can either run after a specified amount of time or the next time a particular player joins the server.
Everything is persisted using SQLite, meaning queued tasks survive restarts and remain available for inspection, cancellation, retrying and historical review.
/deferred in 30m say The event has started!
/deferred player Lily next-login give Lily diamond 3
✨ Features
- Persistent scheduled commands
- Next-login player actions
- SQLite storage
- Automatic retry support
- Crash-safe interrupted task handling
- Paginated task history
- Clickable task inspection
- Configurable MiniMessage output
- Granular permissions
- Automatic history cleanup
⏰ Examples
/deferred in <duration> <command...>
/deferred player <player> next-login <command...>
📋 Commands
| Command | Description |
|---|---|
/deferred in <duration> <command...> |
Schedule a command for later |
/deferred player <player> next-login <command...> |
Queue a command for a player's next login |
/deferred list [page] |
View stored deferred tasks |
/deferred inspect <id> |
Inspect a task in detail |
/deferred cancel <id> |
Cancel a pending or failed task |
/deferred retry <id> |
Retry a failed task |
/deferred reload |
Reload configuration and messages |
Task entries shown by /deferred list include a clickable Inspect action for quickly opening the corresponding task.
🔐 Permissions
| Permission | Description |
|---|---|
lilsdeferred.create |
Create scheduled and next-login tasks |
lilsdeferred.list |
View stored task listings |
lilsdeferred.manage |
Inspect, cancel and retry tasks |
lilsdeferred.reload |
Reload configuration and messages |
lilsdeferred.admin |
Grants all LilsDeferred permissions |
All permissions default to server operators.
🏡 Architecture
LilsDeferred keeps its runtime, business logic and persistence layers deliberately separated.
Commands / PlayerJoinEvent
│
▼
DeferredTaskService
│ │
▼ ▼
TaskRepository ScheduledTaskQueue
│ │
▼ ▼
SQLite ScheduledTaskRunner
│
▼
TaskExecutor
│
▼
Paper Main Thread
⚡ Performance
- No normal SQL work on Paper's main thread
- No recurring SQLite polling for scheduled tasks
- Indexed database queries
- Configurable backlog limits
- Single dedicated database thread
- WAL mode SQLite persistence
🛡️ Crash Safety
There is an unavoidable ambiguity when executing persistent commands:
Task marked RUNNING
↓
Command dispatched successfully
↓
Server crashes
↓
COMPLETED state was never persisted
✅ Requirements
- Paper 26.2+
- Java 25
LilsDeferred is developed and tested against Paper.
Other server implementations are not currently officially supported.
🌸 The Lils Plugin Collection
LilsDeferred is part of the Lils collection: a growing set of clean, lightweight Paper utilities with a focus on practical server administration, efficient implementation and maintainable code.
The goal of each project is to remain focused rather than becoming an oversized all-in-one plugin.
📜 License
LilsDeferred is open-source software licensed under the MIT License.
You are free to use, modify and redistribute the project in accordance with the terms of the license.
See the full LICENSE file for details.
