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

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

%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.