Frequently Asked Questions

General

Which Minecraft versions are supported?

PlumDelivery supports all Minecraft versions from 1.13 to 1.21.x. It is built on Paper API and is compatible with Paper, Purpur, and Folia server software.

Does it support Folia?

Yes! PlumDelivery is fully Folia-compatible. All scheduling uses RozsLib's Folia-aware scheduler abstractions, ensuring smooth operation on multi-threaded servers.

Is PlaceholderAPI required?

No, PlaceholderAPI is optional. The plugin works perfectly without it. However, if you want to display leaderboard data, remaining time, and player stats on scoreboards, holograms, or tab menus, PlaceholderAPI is recommended.

What are the dependencies?

PlumDelivery has no required dependencies. The following are bundled or loaded automatically:

• RozsDB-Lite — Bundled (file-based database)
• RLib — Bundled (utility library)
• HikariCP — Auto-downloaded via Paper libraries
• MySQL Connector — Auto-downloaded via Paper libraries
• PlaceholderAPI — Optional soft dependency

Configuration

Can I create unlimited categories?

Absolutely! You can define as many categories as you want in config.yml. Each category can have its own icon, required objects, goals, and rewards.

Can I mix COLLECT and KILL objectives in one category?

Yes! A single category can have both COLLECT (item submission) and KILL (entity kills) required objects. Points from both types count toward the same category total.

How do I change the menu appearance?

Every aspect of the GUI is configurable in config.yml:

• Menu titles and sizes
• Item materials, names, and lore
• Slot positions (index)
• Custom model data for resource packs
• Fill items (glass panes)

Can I add custom model data to items?

Yes! Add custom-model-data to any icon configuration:

icon:
  title: "&aCustom Item"
  material: PAPER
  custom-model-data: 1001

Events

Do events restart automatically?

Yes, if you set auto-restart: true for a delivery type:

deliveries:
  daily:
    enabled: true
    auto-restart: true

Can I run multiple event types simultaneously?

Yes! Daily, Weekly, and Monthly events run independently. You can have all three running at the same time, each with its own timer and leaderboard.

What happens if no players participate?

The event ends normally when the timer expires. No rewards are distributed if no players have points, and the event restarts if auto-restart is enabled.

Do timers persist across server restarts?

Yes! Countdown timers are automatically saved to data.yml every 10 minutes and on server shutdown. When the server starts again, timers resume from where they left off.

Rewards

Do offline players receive rewards?

Yes! When an event ends, all top-ranked players receive their placement rewards — even if they're offline at that moment. Commands are executed via console with the player's name.

How are goal rewards different from placement rewards?

Can I set rewards for multiple placements?

Yes! Configure as many placements as you want:

rewards:
  farm:
    daily:
      top-1:
        - "give %player% diamond 10"
      top-2:
        - "give %player% diamond 5"
      top-3:
        - "give %player% diamond 3"

Database

What database options are available?

Three options:

1. RozsDBLite — File-based, no setup required (default)
2. SQLite — Lightweight SQL database
3. MySQL/MariaDB — For large servers and networks

Can I switch databases without losing data?

No, switching the database driver creates a fresh database. Make sure to back up your data before switching.

How often is data saved?

Data is automatically saved every 10 minutes (12,000 ticks) and on server shutdown.