Requirements and Rewards

Requirements and Rewards

Requirements

Hold an item and use the requirement action in the task editor. Enter the desired amount when prompted.

OlDelivery can match normal materials or exact custom items. Exact item templates may preserve custom name, lore, CustomModelData, and other similarity metadata.

Dynamic targets can scale requirements according to online player count or Town population. Use this for goals that should remain balanced across different server sizes.

Reward types

• Experience
• Items
• Console commands
• Vault economy money
• Random reward-pool items
• Contribution-based bonus XP
• Weekly streak bonus XP
• Town bank rewards
• First-completion Town bonus

Use %player% inside reward commands where the receiving player name should be inserted.

Reward safety

Rewards use persistent cycle-specific identifiers. This prevents repeated claims for the same task occurrence. Offline eligible players can receive pending rewards when they join, provided the configured delivery still exists.

If a player's inventory is full, item overflow is dropped naturally at the player's location.

Test mode

Test mode exercises task progress without distributing rewards. Always use it after changing complex requirements or command rewards.

Vault

Money rewards require Vault, a compatible economy provider, and the vault-economy feature. Core item, XP, and command rewards do not require Vault.