CoCoFlow
CoCoFlow is a Unity 6 state-flow framework with typed input, a layered StateGraph, transactional Context commits, and Temporal restore. Version 0.4.5 adds Config collections, stable decimal input, unified State drafts, and StateGraph Editor and Host diagnostic improvements.
What is new in 0.4.5
Section titled “What is new in 0.4.5”- Standard Config supports one-dimensional arrays and
List<T>of supported scalars and pure data structs. Unity’s native controls provide add/remove, drag reordering and element editing; Reset applies to the whole Config. - Decimal input keeps intermediate text such as
2.until confirmation or focus loss updates the draft. Save writes State name, Logic and Config together; Discard abandons the draft. - The StateGraph Editor improves Graph/Layer controls, scoped Transition lists, selection highlights and local refreshes. Save persists and analyzes once, with Undo/Redo and unsaved-change prompts.
- Host setup exception output preserves the original exception, stack and inner exceptions with Host context. Build preflight recognizes Unity-provided BCL references that were previously misclassified.
Memory remains unmanaged, and StateLogic still requires ICoCoStateUpdate.
See the release validation and boundaries
for the maintainer-confirmed Unity runs and Player results. IL2CPP/AOT and High
Managed Stripping remain unverified. Existing Persistence behavior and
known limitations, including BUG-111–114, remain unchanged.
Persistence guide · Usage examples · 0.4.5 release notes
What “mature” means
Section titled “What “mature” means”For this release, mature means that the public Runtime API is stable, the module has been used in a real project to complete its stated responsibility, and its known boundaries are documented. Explicit release changes take precedence over compatibility expectations. It does not mean newest architecture, maximum performance, complete Editor tooling, zero defects, or marketplace certification.
| Module | Status | Accurate scope |
|---|---|---|
| Core Engine | Mature | Contracts, StateFlow, StateGraph, StateGraphAuthoring Runtime, and StateGraphHost; the native 0.4 core. |
| Camera | Mature | The current Rig, priority, and mode APIs are stable and usable. |
| Persistence | Mature | Supports schema v2, typed business-data tables, and StateGraph ContextFrame persistence. |
| UI | Mature | Panel, Widget, Input, and Content-ownership APIs are stable and usable, but this is not a high-performance UI framework. |
| Map | Immature | Usable, but public APIs and configuration/serialized shapes are not compatibility-guaranteed. |
| Pooling | Immature | Usable, but public APIs and configuration/serialized shapes are not compatibility-guaranteed. |
| Other modules | Unrated | No maturity or immaturity judgment is made for this release. |
The Core Engine maturity statement does not include StateGraph Editor or the
older Runtime/Core/*.cs EventBus, Services, and Context facilities.
Each Actor owns its runtime state. The Host commits StateGraph and Context together before publishing committed events. Temporal restore is same-session and exact-layout; durable saves use a separate Persistence schema.
Start reading
Section titled “Start reading”- Install CoCoFlow
- Usage examples
- StateGraph Asset and Compiler
- StateGraph Runtime and Host
- State Flow and Event Boundary
- Temporal Rewind
- Persistence
- Dependency Matrix
- CoCoFlow 0.4.5 release notes
Release policy
Section titled “Release policy”CoCoFlow 0.4.x will iterate in small steps. Mature Runtime surfaces are treated as stable APIs, with explicit changes listed in release notes. Map and Pooling may change their APIs, configuration, and serialized structures during 0.4.x. Unrated modules should be evaluated from their implementation and module documentation rather than inferred from the table above.
CoCoFlow is released under the MIT License.