repository·develop·Indexed 42 days ago
https://github.com/atelier-mycelia/amanitaA modernized, community-driven, and free spiritual successor to the Fungus asset package for Unity. It facilitates narrative-driven game development and interactive storytelling—such as visual novels and point-and-click adventures—through visual scripting, allowing users to create games without coding experience. Supports Unity 6 LTS and Unity 2022 LTS.
Fungus is a free, open-source tool for Unity 3D designed to create interactive storytelling games. It is optimized for both beginners with no coding experience and power users seeking a fast visual scripting workflow.
Common use cases include:
The Playground is a collection of scenes designed to demonstrate how to configure and use physics-driven behavior in Unity3D using Fungus. These scenes are not standalone games but serve as technical demonstrations of integrating Fungus flowcharts with Unity physics components.
Key Architectural Patterns:
Rigidbody2D, Collisions, and Triggers. FungusVariable is used to hold references to Rigidbody2D components.EventHandlers under the MonoBehaviour Event category.SendMessage command to communicate specific events to a central GameRules Flowchart. The GameRules flowchart listens for these messages via EventHandlers to update game state (score, lives, etc.) and the UI.Amanita uses the TextAdapter to bridge the gap between the dialog system and TextMeshPro. The TextAdapter works by searching for a component on the target GameObject that possesses a text property. Since TextMeshPro components include this property, the TextAdapter can automatically target them.
Note: Future versions may offer deeper integration, such as leveraging TMPro's 'revealed characters' feature within the Writer component.
To decouple game objects from game logic, use the SendMessage command to notify a central controller (e.g., a GameRules Flowchart) when specific interactions occur.
Example Workflow:
SendMessage command.EventHandlers to catch the message and update variables like score or lives and refresh the UI.The JSONObject class provides several specialized features for handling JSON in Unity/C#:
parse/stringify functions with minimal garbage creation. Includes an asynchronous stringify function for large datasets to prevent frame drops.MaxDepth parameter allows skipping nested data to save resources. Supports a strict mode to fail on non-compliant input (e.g., a raw string instead of an object/array).Infinity and NaN. Can switch between double and float for numeric storage based on precision needs.Baked object type for storing stringified data within parsed objects.JSONTemplates provides serialization for common Unity types like Vector3 and Matrix4x4. ToString() supports a "pretty" flag for formatted output.FungusTown demo scene demonstrates how to implement parallax scrolling sprite effects. You can use this scene as a reference for setting up layers of sprites that move at different speeds to create a sense of depth in your 2D environments.To decode, pass a JSON-formatted string to the JSONObject constructor. The resulting object will contain the parsed data.
If the root is an OBJECT, the data is stored in a public ArrayList called list, with corresponding keys stored in a keys list. If the root is an ARRAY, data is stored directly in list.
Recursive Traversal Pattern:
To process unknown JSON structures, use a recursive function that switches on the obj.type property (e.g., OBJECT, ARRAY, STRING, NUMBER, BOOL, NULL).
string encodedString = "{\"field1\": 0.5,\"field2\": \"sampletext\",\"field3\": [1,2,3]}";
JSONObject j = new JSONObject(encodedString);
void accessData(JSONObject obj){
switch(obj.type){
case JSONObject.Type.OBJECT:
for(int i = 0; i < obj.list.Count; i++){
string key = (string)obj.keys[i];
JSONObject child = (JSONObject)obj.list[i];
accessData(child);
}
break;
case JSONObject.Type.ARRAY:
foreach(JSONObject child in obj.list){
accessData(child);
}
break;
case JSONObject.Type.STRING:
Debug.Log(obj.str);
break;
case JSONObject.Type.NUMBER:
Debug.Log(obj.n);
break;
case JSONObject.Type.BOOL:
Debug.Log(obj.b);
break;
case JSONObject.Type.NULL:
Debug.Log("NULL");
break;
}
}If you need help or documentation, you can use the following resources:
To use the demos in the New InputSystem folder, you must configure your Unity project to support the new Input System package. Follow these steps:
Input System package via the Unity Package Manager or by manually editing your manifest.json.Project Settings -> Player, change the active Input System to the new one.Fungus assembly definition (.asmdef) and add Unity.InputSystem to its list of assembly references.Once these steps are completed, Unity should automatically set the ENABLE_INPUT_SYSTEM hash define in your project. This define triggers the use of new Input System logic within various Fungus systems, commands, and events.
To implement movement and rotation for physics-driven objects in Fungus, use the following commands:
AddForce2D command. For example, in the Football demo, input from GetAxis is combined and scaled into a vector which is then passed to AddForce2D.AddTorque2D command. For example, in the Defender demo, an Input Axis is used as the input value for AddTorque2D to rotate a turret.Transform and Vector3 related commands to manipulate object properties.// Conceptual usage based on Playground elements:
// 1. Get Input
// 2. Apply to Physics
AddForce2D(inputVector)
AddTorque2D(inputAxis)To use TextMeshPro (TMPro) instead of standard Unity UI Text in Amanita's dialog systems, replace the existing UI Text elements for story text, character text, and menu options with TextMeshPro Text UI elements.
When using a SayDialog with TMPro, you must manually assign the following fields in the SayDialog component on the GameObject:
Name Text GOStory Text GOThis manual assignment is required because the TMPro components differ from the default prefab setup. This pattern can be applied to any custom SayDialog or menu implementations in your project.
Detailed installation instructions and tutorial videos are hosted on the official Fungus website. Visit the learning portal to get started with the tool.
http://fungusgames.com/learn