Troubleshooting

Troubleshooting

The plugin does not load

• Confirm Paper 1.21–1.21.11 and Java 21.
• Read the first OlDelivery exception in the console.
• Confirm the JAR is not renamed as a ZIP or nested inside another archive.
• Allow Paper to resolve the declared SQLite library.

Administration does not open

• Use a player account, not the console.
• Grant oldelivery.admin or test as an operator.
• Use the command matching the client language.

A scheduled task does not start

• Confirm the task is enabled.
• Check timezone.
• Check its HH:mm times and active weekdays.
• Ensure the previous occurrence is not still active.
• Use test mode to validate the task itself.

Money rewards do not work

• Install Vault and an economy provider.
• Enable vault-economy.
• Confirm the economy provider registered successfully with Vault.

Town contracts do not work

• Install and enable Towny.
• Enable towny-deliveries.
• Confirm the task type is Town and currently active.
• Confirm the accepting player is the Town mayor.
• Accept the contract before members contribute.

Placeholders are not replaced

• Install PlaceholderAPI.
• Enable the feature.
• Restart after installing integrations.
• Confirm the other plugin supports PlaceholderAPI.

Language is wrong

Check the player's Minecraft locale, language-mode, and default-language. Verify both files under lang are valid YAML.

Before reporting a bug

Include the Paper build, Java version, OlDelivery version, installed integration versions, reproduction steps, and the complete relevant console error. Remove IP addresses, tokens, database files, and private player data.