![LilsDeferred Banner](https://raw.githubusercontent.com/LilyK-97/LilsDeferred/main/images/lilsdeferred-banner.png) --- ## 🌸 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. ```text /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 ```text /deferred in ``` ```text /deferred player next-login ``` ## 📋 Commands | Command | Description | |---|---| | `/deferred in ` | Schedule a command for later | | `/deferred player next-login ` | Queue a command for a player's next login | | `/deferred list [page]` | View stored deferred tasks | | `/deferred inspect ` | Inspect a task in detail | | `/deferred cancel ` | Cancel a pending or failed task | | `/deferred retry ` | 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 Diagram](https://raw.githubusercontent.com/LilyK-97/LilsDeferred/main/images/lilsdeferred-diagram.png) LilsDeferred keeps its runtime, business logic and persistence layers deliberately separated. ```text 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: ```text 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](https://github.com/LilyK-97/LilsDeferred/blob/main/LICENSE) file for details.

lil.krause97

LilsUtilities