oldelivery

OlDelivery **Real-time delivery quests, shared server goals, and mayor-approved Town contracts — all managed in-game.** OlDelivery is a Paper plugin that turns resource collection into scheduled server events. Create personal quests, server-wide deliveries, or independent Town contracts with localized menus, flexible rewards, and persistent progress. ## Three delivery modes - **Personal:** Every player has separate progress and completes the task independently. - **Shared:** The whole server contributes toward one common target. - **Town:** Every Town has its own contract, progress, contributors, and completion state. Town contracts are kept separate from regular player deliveries. An active contract must be accepted by the Town mayor before members can contribute. When accepted, only online members of that Town receive the notification. ## Real-world scheduling Deliveries run according to the real clock rather than Minecraft time. Each task can have: - One or more start times - Configurable duration - Selected weekdays - Configurable timezone - Announcements before the event starts - Manual and reward-free test starts This makes OlDelivery suitable for daily objectives, weekend events, community projects, and recurring seasonal activities. ## In-game administration The administration interface is divided into clear categories instead of placing every setting on one screen. Administrators can manage: - Localized task names and descriptions - Personal, shared, or Town task type - Required items and exact amounts - Custom-named, custom-lore, and CustomModelData items - Start times, weekdays, duration, and timezone - Item, experience, money, command, and random rewards - Icons, dynamic targets, templates, and test mode - Notifications, visual feedback, integrations, and optional features Most configuration is available directly through the GUI. Task templates can also be saved and reused when creating similar events. ## Flexible rewards Reward players with any combination of: - Experience - Items - Console commands - Vault economy money - Random reward-pool items - Contribution-based bonus experience - Weekly streak bonuses - Town bank rewards - First-completion Town bonuses Persistent one-time reward identifiers help prevent the same reward from being claimed repeatedly for one task cycle. ## Automatic localization OlDelivery detects the player's Minecraft client language automatically. - Turkish clients use `/teslimat` and see Turkish menus, messages, and TAB suggestions. - English clients use `/delivery` and see English menus, messages, and TAB suggestions. Task names and descriptions can be configured separately in Turkish and English. Commands belonging to the other language are hidden from the player's normal TAB suggestions. ## Towny integration When Towny support is enabled, OlDelivery provides: - Mayor-approved contracts - Independent progress for every Town - Town contribution tracking - Town delivery experience and levels - Town bank rewards - First-Town completion bonuses - Town leaderboards - Notifications limited to the relevant Town Towny is optional. Personal and shared deliveries continue to work without it. ## Player feedback and events Optional feedback systems include: - BossBar progress - ActionBar updates - Sounds and particles - Login notifications for active deliveries - Town contract notifications - Delivery history - Player and Town leaderboards - Weekly streaks - Emergency deliveries Each optional system can be enabled or disabled separately. ## Safe persistent storage OlDelivery stores task state, player progress, contributions, pending rewards, and statistics in SQLite. It also includes: - Automatic database backups - Configurable backup interval and retention count - Legacy `data.yml` migration - Organized language, database, backup, and audit-log folders - Active-task recovery after a server restart ## Commands | Language | Player menu | Town contracts | Administration | |---|---|---|---| | English | `/delivery` | `/delivery town` | `/delivery admin` | | Turkish | `/teslimat` | `/teslimat kasaba` | `/teslimat yonetim` | Administration requires the `oldelivery.admin` permission, which defaults to server operators. ## Compatibility - **Server software:** Paper - **Minecraft:** 1.21–1.21.11 - **Java:** 21 - **Required dependencies:** None - **Optional integrations:** Towny, Vault with an economy provider, PlaceholderAPI ## PlaceholderAPI placeholders ```text %oldelivery_contribution% %oldelivery_weekly_streak% %oldelivery_active_count% %oldelivery_active_id% %oldelivery_remaining_minutes% %oldelivery_progress_percent% ``` ## Installation 1. Place the OlDelivery JAR in the server's `plugins` directory. 2. Start or restart the Paper server using Java 21. 3. Open `/delivery admin` or `/teslimat yonetim`. 4. Create and configure deliveries from the in-game menus. 5. Install Towny, Vault, or PlaceholderAPI only for the integrations you want to use. ## Support and feedback OlDelivery is developed by **OlPlugins**. Suggestions, bug reports, and usability feedback are welcome through the project's official discussion or issue channel once available.