Rewards

Rewards

Every quest can grant one or more rewards when completed. Rewards are defined in the rewards array of a quest definition and are automatically granted to the player upon turn-in.

Reward Structure

"rewards": [
  { "type": "quest_tokens", "amount": 10 },
  { "type": "item", "item_id": "Tool_Pickaxe_Copper", "amount": 1 }
]

Each reward requires a type field and type-specific parameters described below.

All Reward Types

Quest Tokens

The primary quest currency. Players earn tokens from completing quests and can spend them in the Quest Token Shop.

{ "type": "quest_tokens", "amount": 25 }

Field	Required	Description
amount	Yes	Number of tokens to grant

Item

Grants a specific item directly to the player’s inventory.

{ "type": "item", "item_id": "Tool_Pickaxe_Copper", "amount": 1 }

Field	Required	Description
item_id	Yes	The item ID (e.g. Weapon_Sword_Iron, Food_Bread)
amount	Yes	Number of items to give

:::note Full Inventory If the player’s inventory is full, the item reward is saved as a pending reward and can be claimed later from the quest book. :::

Lootbag

Grants a loot bag that the player can open for randomized rewards.

{ "type": "lootbag", "lootbag_id": "hunter_reward" }

Field	Required	Description
lootbag_id	Yes	The loot bag definition ID

Currency

Grants a named currency (gold, silver, custom currencies).

{ "type": "currency", "currency": "gold", "amount": 100 }

Field	Required	Description
currency	Yes	Currency name (e.g. gold, silver)
amount	Yes	Amount to grant

RPG XP

Grants general character experience points via the RPG leveling system.

{ "type": "rpg_xp", "amount": 500 }

Field	Required	Description
amount	Yes	XP amount to grant

MMO XP

Grants skill-specific experience points via the MMO skill tree system.

{ "type": "mmo_xp", "skill": "mining", "amount": 150 }

Field	Required	Description
skill	Yes	Skill name (e.g. mining, combat, woodcutting)
amount	Yes	XP amount to grant

Endless XP

Grants experience points for the Endless leveling system.

{ "type": "endless_xp", "amount": 200 }

Field	Required	Description
amount	Yes	XP amount to grant

Leveling XP

Grants experience points for the main character leveling system.

{ "type": "leveling_xp", "amount": 300 }

Field	Required	Description
amount	Yes	XP amount to grant

Title

Unlocks a title that the player can display. Titles are managed through the Achievement system.

{ "type": "title", "title_id": "forest_protector" }

Field	Required	Description
title_id	Yes	Title identifier (e.g. mining_master, newcomer)

Achievement

Unlocks an achievement for the player.

{ "type": "achievement", "achievement_id": "story_complete" }

Field	Required	Description
achievement_id	Yes	Achievement identifier

Command

Executes a server command as a reward. Supports placeholder substitution for the player name.

{ "type": "command", "command": "give {player} Food_Apple 10", "executor": "console" }

Field	Required	Description
command	Yes	The command string. Use {player} as a placeholder for the player name
executor	No	Who runs the command: "console" (default) or "player"

:::tip When to use command rewards Command rewards are a flexible catch-all for integration with other plugins. You can trigger any server command — grant permissions, teleport players, spawn entities, or interact with third-party mods. :::

Reward Type Summary

Type	Key Fields	Scales with Tier	Fallback
quest_tokens	amount	Yes	—
item	item_id, amount	Yes (amount)	Pending reward if inventory full
lootbag	lootbag_id	No	30 Quest Tokens
currency	currency, amount	Yes	—
rpg_xp	amount	Yes	Quest Tokens (XP / 10)
mmo_xp	skill, amount	Yes	Quest Tokens (XP / 10)
endless_xp	amount	Yes	Quest Tokens (XP / 10)
leveling_xp	amount	Yes	Quest Tokens (XP / 10)
title	title_id	No	25 Quest Tokens
achievement	achievement_id	No	15 Quest Tokens
command	command, executor	No	—

Automatic Fallbacks

The quest system gracefully handles situations where external plugins are not installed:

• RPG XP / MMO XP — If the leveling plugin is not available, XP rewards are converted to Quest Tokens at a rate of XP / 10.
• Endless XP — If the Endless leveling plugin is not available, XP rewards are converted to Quest Tokens at a rate of XP / 10.
• Leveling XP — If the leveling plugin is not available, XP rewards are converted to Quest Tokens at a rate of XP / 10.
• Title — If the Achievement plugin is not installed, title rewards are converted to 25 Quest Tokens.
• Achievement — If the Achievement plugin is not installed, achievement rewards are converted to 15 Quest Tokens.
• Lootbag — If the lootbag ID is not found, the reward is converted to 30 Quest Tokens.

This means you can safely configure any reward type without worrying about crashes from missing plugins.

Tier Multiplier

Quests support a dynamic tier system that scales numeric rewards. When a quest has a tier assigned, amount-based rewards (Quest Tokens, Items, Currency, XP) are multiplied by the tier factor. For example, a Hard-tier quest with a 1.5x multiplier turns a "amount": 10 token reward into 15 tokens.

Non-numeric rewards (Titles, Achievements, Lootbags, Commands) are not affected by the multiplier.

Multiple Rewards

Every quest can have any number of rewards. It is recommended to always include at least quest_tokens as a baseline reward:

Example: Mixed reward set

"rewards": [
  { "type": "quest_tokens", "amount": 10 },
  { "type": "item", "item_id": "Weapon_Sword_Iron", "amount": 1 },
  { "type": "lootbag", "lootbag_id": "hunter_reward" },
  { "type": "mmo_xp", "skill": "combat", "amount": 200 }
]

Chapter Completion Rewards

Story chapters can also define rewards that are granted when all quests in a chapter are completed. These use the same reward format:

Example: Chapter rewards in chapters.json

{
  "id": "chapter_1_forest",
  "rewards": [
    { "type": "currency", "currency": "quest_tokens", "amount": 100 },
    { "type": "title", "title_id": "forest_protector" },
    { "type": "lootbag", "lootbag_id": "chapter_1_reward" }
  ]
}

How Rewards Are Granted

1. Player completes all objectives — the quest moves to the “ready to turn in” state
2. Player turns in the quest — either via NPC dialog or through the quest book UI
3. All rewards are processed — items go to inventory, tokens are added, XP is granted
4. If an item reward fails (full inventory) — it becomes a pending reward claimable later
5. A completion message is shown to the player with a summary of all rewards received