Skip to content

🧪 Demo Helpers — Authoring

This folder contains sample-only authoring utilities used by the Crafting demo scenes.

These types exist purely to make demos easier to set up and understand. They are not part of the core Crafting API and are not required for production use.

🎯 Purpose

The Crafting system is built around a pure runtime model:

  • RecipeCore → the actual recipe format used by the system

In production, recipes can be provided in multiple ways:

  • via integrations (e.g. Inventory → RecipeDefinition)
  • via code
  • via custom authoring pipelines

The demo helpers in this folder provide a lightweight Unity authoring surface for standalone Crafting examples, without requiring any integrations.

🧩 Included Types

StandaloneRecipeDefinition

A simple ScriptableObject used in demo scenes to define recipes using:

  • GUIDs (instead of ItemDefinition)
  • quantities
  • optional currency

At runtime, this is converted into a RecipeCore.

⚠️ Important Notes

  • These types are sample scaffolding only
  • They are not used by the Crafting runtime directly
  • They may be removed, changed, or replaced without affecting the core system
  • They are intentionally minimal and not feature-complete

🧠 When to Use This

Use these helpers if:

  • you are exploring Crafting without the Inventory integration
  • you want a quick way to define recipes in demo scenes

🚫 When NOT to Use This

Do not rely on these types as part of your production pipeline.

Instead:

  • use RecipeDefinition when working with Inventory
  • or build your own authoring layer tailored to your project
  • or provide RecipeCore instances directly

🪓 Summary

  • RecipeCore → runtime truth
  • RecipeDefinition → Inventory integration authoring
  • StandaloneRecipeDefinition → demo-only convenience

That’s it — simple, honest, and keeps your architecture clean without confusing the poor bastards using it 👍