Interaction Recipes

Recipes are short, practical examples for specific outcomes.

This section is not a complete cookbook yet. For now, it captures the first recipe patterns Interaction should support.

Basic Door

Goal: create a simple world actor that receives an interaction request and responds by opening, closing, or toggling state.

Typical flow:

Create door actor
        v
Add interactable capability
        v
Set prompt text such as "Open Door"
        v
Connect the interaction event to door behavior
        v
Verify the prompt appears
        v
Trigger interaction
        v
Confirm the door receives the request

Interaction owns the request path. The door owns what opening means.

Gathering Entry Point

Goal: use Interaction as the way a player starts harvesting without making Interaction responsible for resource rules.

Interaction request
    -> Resource actor
        -> Gathering logic validates harvest
            -> Rewards, depletion, respawn, or skill progress

Interaction should not calculate loot, depletion, respawn timing, or gathering XP. Those decisions belong to the resource actor, the project, or a gathering-focused system.

Crafting Station Entry Point

Goal: use an interaction request to open or activate a crafting station.

Interaction request
    -> Crafting station
        -> Station opens or calls crafting logic
            -> Recipes and crafting rules execute

Interaction gets the request to the station. Crafting owns recipe validation, ingredients, outputs, and related rules.

Reusable Interaction Definitions

A future Interaction Definition could let many actors share the same generic interaction behavior.

For example, several ore actors might use a shared Mine Resource definition for prompt text, hold duration, cancellation behavior, and interaction points. Gathering would still own tool requirements, yield, depletion, respawn, and rewards.

That keeps repeated interaction setup reusable without turning Interaction into a gathering, inventory, quest, or skill system.

Planned Recipes

Future recipes may cover:

• basic interactable door
• timed gathering interaction
• interaction prompt customization
• interaction with a custom UI
• inventory-backed crafting station
• reputation-gated interaction
• quest or dialogue triggered interaction
• multiplayer-authoritative interaction request