Skip to content

🧩 Crafting — Core / Recipe / Internal

📦 Folder Overview

This folder contains framework-internal helpers used to support recipe resolution.

These types hide optional-system complexity, cache conversions, and prevent callers from depending on implementation details.

Nothing in this folder is a supported extension surface.

🧩 What Lives Here

RecipeCache

  • RecipeCache Internal utility used by RecipeResolve to convert Unity-facing recipe assets into RecipeCore instances and cache the results
  • conversion is orchestrated via RecipeResolve (including any registered external converters)

Key characteristics:

  • conversion paths depend on optional systems and registered converters
  • converted instances use HideFlags.DontSave
  • resolution failure is handled without exceptions

Callers should not reference or depend on this type directly.

🎯 Purpose

This folder exists to:

  • isolate optional-system handling from the public API
  • reduce allocations through caching
  • keep recipe resolution consistent and contained

🧠 Usage Guidance

  • resolve recipes via RecipeResolve
  • treat resolution failure as a supported outcome
  • do not cache or store references to internal helpers

If additional behaviour is required, it should be exposed through a public seam.

⚠️ Important Notes

  • types are internal and may change without notice
  • caching and conversion behaviour are implementation details
  • stability guarantees do not apply to this folder

🚫 Not for Production Use

This folder is not intended for direct use by consuming projects.

  • Crafting Recipe (public data model)
  • Crafting Core (runtime behaviour)

🧱 Visibility

All types in this folder:

  • are internal to the framework
  • may be renamed, moved, or removed
  • are excluded from public API guarantees

🧠 Design Notes

  • internal plumbing for recipe resolution
  • keeps optional systems out of the public surface

If access to this folder seems necessary, it indicates that a public extension point may be required.