Custom Recipes

Custom Recipes lets you define match-specific crafting recipes for Battle Royale. It extends vanilla crafting with match rules like limits and one-time crafts.

Core capabilities

What you can do:

• Create recipes with any ingredients and any result.

• Support shaped and shapeless layouts.

• Run one-time recipes (only one successful craft per match).

• Apply craft limits to control rarity and pacing.

• Create recipes in-game using a GUI.

• Give players a Recipes Book to browse available crafts.

• Keep recipes persistent across restarts.

Custom Recipes is about gameplay pacing. It’s not meant to replace every vanilla craft.

Recipe properties

Each recipe has these core parts:

Property	Meaning
Recipe ID	Stable identifier for the recipe.
Result item	Item granted on a successful craft.
Ingredients	Items consumed during crafting.
Pattern (shaped only)	Crafting grid layout for shaped recipes.
Created by / created at	Who created the recipe, and when.
Metadata (optional) (exposed in developer api only)	Extra tags for future expansion and integrations.

Why this system exists

Custom Recipes exists to make crafting matter in Battle Royale.

• Enable BR-specific items without code changes.

• Create scarcity and “race-to-craft” moments.

• Add progression and non-combat objectives.

• Let server owners ship unique metas per season.

During gameplay (player flow)

What players experience in a live match:

1. Open the Recipes Book to view the recipe browser.

2. Choose a recipe and gather the required ingredients.

3. Craft the item.

4. The system validates:

   • Ingredients match

   • The recipe is currently available

   • Craft limits are not exceeded

   • One-time recipes are not already claimed

5. On success, ingredients are consumed and the result is granted.

Crafting is atomic. If validation fails, nothing is consumed and nothing is granted.

Recipe creation flow (admin GUI)

You can create recipes in-game. No external tools needed.

Workflow:

1. Open the recipe creation interface.

2. Place the ingredients and the result.

3. Choose shaped or shapeless behavior.

4. Set one-time and limit rules for match balance.

5. Enter a recipe identifier.

6. Validate and register the recipe.

Recipes Book lifecycle

The Recipes Book is a guided UI tool for players.

Behavior rules:

• Given to players during pre-game states like WAITING and STARTING.

• Opens the recipe browser.

• Protected from being dropped or moved to prevent loss and abuse.

• Removed or disabled when the match enters PLAYING.

This keeps combat inventories clean. It also prevents recipe browsing from becoming a mid-fight advantage.

Related configuration

• Recipes Book item definition: items.yml

• Crafting reward hooks (optional): currency.yml

Design notes and best practices

Keep recipes fun and readable. Keep the match fair.

• Use one-time recipes for special moments and power spikes.

• Use craft limits to protect your economy and pacing.

• Prefer shaped recipes for important items.

• Test every recipe in a real match flow before going live.