Skip to content

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.

  • 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

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.

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.