Fomoxa

EN/VI

Ecosystem · November 2026

One specification, many implementations

The specification is Fomoxa. Everything else on this page is a tool that helps you use it, a sample of how it can be implemented, or a package built on it. All of it is stable and usable today.

Layers

What is the protocol, and what is not

Protocol Specification · RFC-0001, 0002, 0003 The only definition of Fomoxa. v1.1.0, Final. If anything below disagrees with it, the specification wins.
Tool fomoxac · fomoxa-inspect Generates codecs from annotated types in seven languages, checks schema compatibility, and decodes payloads for debugging.
Samples Runtime implementations Framing, schema handshake and heartbeat over TCP/UDP, following the implementation guide. Examples of how Fomoxa can be carried, not part of the specification.
Built on Fomoxa Fomoxa for Unity Networking packages for Unity and a game backend template, built on the Fomoxa.Net sample runtime. Like the samples, they sit outside the specification.

Replace any of these with your own and the wire format holds. A hand-written codec that passes 100% of the RFC-0003 vectors is exactly as Fomoxa Compatible as a generated one.

Specification

Tools

fomoxac

One source generator for seven languages. It reads annotations, writes plain source, and exits. The generated code has no runtime dependency.

fomoxac generate Annotations in, codec source out Reads annotated model types in one of seven languages and writes the generated codec, a schema.json, and a build-graph.json. It does not fail on a breaking change; it reports the change and generates the code anyway.
fomoxac compat Schema compatibility check Compares a base schema against the current source tree, or against another schema file, and prints a compatibility report. Exits non-zero on a breaking verdict.
fomoxac ci A gate for pull requests Confirms the committed schema.json matches the branch's source, then compares it against the target branch's schema over git. Fails the build on drift or a breaking change.
fomoxa-inspect Decode a payload by hand Reads a raw byte stream, from a file or hex on the command line, against a schema.json and prints every field with its offset and its bytes. Ships in the same binary as fomoxac.
PackageVersionInstallStatus
fomoxacgenerator · fomoxa-inspect 0.2.3 cargo install fomoxac Stable
fomoxa-attributesRust annotations 0.1.1 cargo add fomoxa-attributes Stable
Fomoxa.AttributesC# annotations 0.1.0 dotnet add package Fomoxa.Attributes Stable
Codec backendModel annotationNeedsChecked in fomoxac CI
Rust#[network] #[codec(...)]fomoxa-attributes✓ cargo test
C#[Network] [Codec(...)]Fomoxa.Attributes✓ build
Go//fomoxa:model · struct tagsnothing✓ build + vet
TypeScript// FOMOXA_MODELnothing✓ build + smoke test
JavaScript// FOMOXA_MODELnothing✓ smoke test
CFOMOXA_MODELfomoxa.h (3 macros)✓ build + smoke test
C++FOMOXA_MODELfomoxa.h (3 macros)✓ build + smoke test

tests/vectors/fomoxa-vectors.json is the cross-language reference: fixed bytes and fixed fingerprints every backend is expected to reproduce. The Rust backend checks it byte for byte in CI, and cross-language tests pin the same fingerprint for the same model written in different languages.

Samples

Runtime implementations

Each one carries opaque payloads: framing, schema handshake, heartbeat and a non-blocking tick loop over TCP or UDP. None of them contains a codec; codecs come from fomoxac.

Language Package Version Install Interop Status
Rust fomoxa-netno runtime deps, no async 0.1.5 cargo add fomoxa-net ✓ Stable
C# · Unity Fomoxa.Netnetstandard2.1 · Unity 2021+ IL2CPP 0.1.4 dotnet add package Fomoxa.Net ✓ Stable
Go github.com/fomoxa/gostandard library only, no goroutines 0.1.2 go get github.com/fomoxa/go ✓ Stable
C · C++ fomoxaC99, no deps, no threads · C++17 header wrapper 0.1.3 CMake FetchContent ✓ Stable
TypeScript · JavaScript @fomoxa/netNode.js 22+, ESM, no runtime deps 0.1.3 npm install @fomoxa/net ✓ Stable

Interop means the runtime is part of fomoxa/interop: two processes in different languages complete a handshake over a real TCP or UDP socket and exchange a message.

Built on Fomoxa

Fomoxa for Unity

A server-authoritative networking package for Unity 6, with a Rapier physics backend, a Steam transport, fRPC services and a template for the game backend. The package runs on Fomoxa.Net and generates its codecs with the fomoxac it bundles.

PackageVersionInstallStatus
com.fomoxa.networkingnetworking · Unity 6000.5+ 0.3.4 Package Manager · Git URL Stable
com.fomoxa.networking.rapierRapier physics backend 0.2.4 Package Manager · Git URL Stable
com.fomoxa.rpcfRPC services · directory pod 0.1.5 Package Manager · Git URL Stable
com.fomoxa.networking.steamSteam transport · relay through Valve 0.1.0 Package Manager · Git URL Stable
Fomoxa.Backend.Templatesgame backend template 0.1.1 dotnet new install Fomoxa.Backend.Templates Stable

The documentation, in English and Vietnamese, covers installation, a first multiplayer game, the console server, deployment and the Red Runner example. The release notes list which versions of the five parts go together.

Proof

People

Who builds it

Maintainer Ha Duy Thang Author of the specification and maintainer of every repository on this page. github.com/fomoxa ↗
Contribute Issues and pull requests Spec questions go to the specification repository. Bugs in a tool or runtime go to that tool's repository. Open an issue ↗
Using Fomoxa? Tell us, or list your implementation Projects and independent implementations that pass 100% of RFC-0003 can be listed here. Open a pull request against this site. fomoxa.github.io ↗