> For the complete documentation index, see [llms.txt](https://ss3d.gitbook.io/systems/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ss3d.gitbook.io/systems/crafting.md). # Crafting See the [Broken mention](broken://spaces/hffJRpQgXgXOOhvtML3c/pages/9G976pcvuiNP5BKocqUk) design doc first for more info on the design of the system. ### Crafting System The crafting system script handle storing all possible recipe. Recipes are organised in an efficient manner that allow to search very fast through them, given we know the target of the recipe and the name of the interaction to execute it. It's using the following structure : ``` Dictionary> ``` The system starts by looking for all recipes in the recipe asset database and fill the structure. Both client and server have access to the full recipe list. ### Crafting interaction The other major element of the system is the crafting interaction abstract class. When you want to add a new interaction, inherit from it, as it will provide the basis for what you need, if you want to implement a new interaction that will result in crafting something. You can use the `SliceInteraction.cs` script as an implementation example. Notice how the code override the CanCraft method, so it can add its own conditions to allow this specific crafting. For a crafting interaction to work in game, the interaction needs to be put on an item that will act as the source of that interaction. In the case of the slice interaction, we could add it to a knife, or any other slicy item. For that, we create a new script that inherits from IInteractionSource : ``` public class Slice : MonoBehaviour, IInteractionSourceExtension { public void GetSourceInteractions(IInteractionTarget[] targets, List interactions) { SliceInteraction interaction = new SliceInteraction(2f, GetComponent().transform); foreach (IInteractionTarget target in targets) { interactions.Add(new InteractionEntry(target, interaction)); } } } ``` Just put that script on your knife game object and you're good to go. See how it creates a new sliceInteraction. ### Adding recipes Recipes are simple scriptable objects in Assets/Content/Data/Recipes currently. Easy to set up. Creating a new recipe is very simple :
You can then fill up the recipe with everything it needs. Should be explicit enough.
If you want your recipe to be accessible in game though, you'll need to [add it to the recipe asset database](/systems/asset-data.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ss3d.gitbook.io/systems/crafting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.