Fomoxa

EN/VI

Hệ sinh thái · Tháng 11/2026

Một specification, nhiều implementation

Specification chính là Fomoxa. Mọi thứ khác trên trang này là công cụ giúp bạn dùng nó, hàng mẫu cho cách hiện thực nó, hoặc package xây trên nó. Tất cả đều ổn định và dùng được ngay hôm nay.

Các tầng

Đâu là protocol, đâu không phải

Protocol Specification · RFC-0001, 0002, 0003 Định nghĩa duy nhất của Fomoxa. v1.1.0, Final. Nếu bất cứ thứ gì bên dưới mâu thuẫn với nó, specification thắng.
Công cụ fomoxac · fomoxa-inspect Sinh codec từ type có annotation ở bảy ngôn ngữ, kiểm tra tương thích schema, và decode payload để debug.
Hàng mẫu Runtime implementation Framing, schema handshake và heartbeat trên TCP/UDP, theo implementation guide. Ví dụ về cách vận chuyển Fomoxa, không thuộc specification.
Xây trên Fomoxa Fomoxa for Unity Các package networking cho Unity và một template backend cho game, xây trên runtime mẫu Fomoxa.Net. Cũng như hàng mẫu, chúng nằm ngoài specification.

Thay bất kỳ thứ nào trong số này bằng cái của bạn, wire format vẫn giữ nguyên. Một codec viết tay pass 100% vector của RFC-0003 cũng Fomoxa Compatible y như codec được sinh ra.

Specification

Công cụ

fomoxac

Một công cụ sinh code cho bảy ngôn ngữ. Nó đọc annotation, ghi ra source thuần, rồi thoát. Code sinh ra không có dependency lúc chạy.

fomoxac generate Đọc annotation, sinh ra codec Đọc các model đã được annotation bằng một trong bảy ngôn ngữ, ghi ra codec, một schema.json và một build-graph.json. Lệnh này không fail vì breaking change; nó báo cáo thay đổi rồi vẫn sinh code.
fomoxac compat Kiểm tra tương thích schema So sánh một base schema với source hiện tại, hoặc với một schema khác, rồi in ra báo cáo tương thích. Thoát với mã khác 0 nếu kết quả là breaking.
fomoxac ci Cổng kiểm tra cho pull request Xác nhận schema.json đã commit khớp với source của branch, rồi so sánh với schema của branch đích qua git. Làm fail CI nếu lệch nhau hoặc có breaking change.
fomoxa-inspect Giải mã payload thủ công Đọc một chuỗi byte thô, từ file hoặc hex trên dòng lệnh, đối chiếu với schema.json rồi in ra từng field kèm offset và byte của nó. Nằm chung binary với fomoxac.
PackagePhiên bảnCài đặtTrạng thái
fomoxacsinh code · fomoxa-inspect 0.2.3 cargo install fomoxac Ổn định
fomoxa-attributesannotation cho Rust 0.1.1 cargo add fomoxa-attributes Ổn định
Fomoxa.Attributesannotation cho C# 0.1.0 dotnet add package Fomoxa.Attributes Ổn định
Backend codecAnnotation cho modelCầnKiểm tra trong CI của fomoxac
Rust#[network] #[codec(...)]fomoxa-attributes✓ cargo test
C#[Network] [Codec(...)]Fomoxa.Attributes✓ build
Go//fomoxa:model · struct tagskhông cần gì✓ build + vet
TypeScript// FOMOXA_MODELkhông cần gì✓ build + smoke test
JavaScript// FOMOXA_MODELkhông cần gì✓ smoke test
CFOMOXA_MODELfomoxa.h (3 macro)✓ build + smoke test
C++FOMOXA_MODELfomoxa.h (3 macro)✓ build + smoke test

tests/vectors/fomoxa-vectors.json là mốc tham chiếu giữa các ngôn ngữ: byte cố định và fingerprint cố định mà mọi backend phải tái tạo được. Backend Rust kiểm tra từng byte trong CI, và các test đa ngôn ngữ đảm bảo cùng một model viết ở các ngôn ngữ khác nhau cho cùng một fingerprint.

Hàng mẫu

Runtime implementation

Mỗi runtime vận chuyển payload mà không đọc nội dung: framing, schema handshake, heartbeat và tick loop không chặn trên TCP hoặc UDP. Không runtime nào chứa codec. Codec do fomoxac sinh ra.

Ngôn ngữ Package Phiên bản Cài đặt Interop Trạng thái
Rust fomoxa-netkhông dependency, không async 0.1.5 cargo add fomoxa-net ✓ Ổn định
C# · Unity Fomoxa.Netnetstandard2.1 · Unity 2021+ IL2CPP 0.1.4 dotnet add package Fomoxa.Net ✓ Ổn định
Go github.com/fomoxa/gochỉ dùng thư viện chuẩn, không goroutine 0.1.2 go get github.com/fomoxa/go ✓ Ổn định
C · C++ fomoxaC99, không dependency, không thread · wrapper header C++17 0.1.3 CMake FetchContent ✓ Ổn định
TypeScript · JavaScript @fomoxa/netNode.js 22+, ESM, không dependency 0.1.3 npm install @fomoxa/net ✓ Ổn định

Interop nghĩa là runtime nằm trong fomoxa/interop: hai process viết bằng hai ngôn ngữ khác nhau hoàn tất handshake qua socket TCP hoặc UDP thật và trao đổi một message.

Xây trên Fomoxa

Fomoxa for Unity

Package networking server-authoritative cho Unity 6, kèm backend physics Rapier, transport Steam, dịch vụ fRPC và một template cho backend của game. Package chạy trên Fomoxa.Net và sinh codec bằng fomoxac đóng kèm.

PackagePhiên bảnCài đặtTrạng thái
com.fomoxa.networkingnetworking · Unity 6000.5+ 0.3.4 Package Manager · Git URL Ổn định
com.fomoxa.networking.rapierbackend physics Rapier 0.2.4 Package Manager · Git URL Ổn định
com.fomoxa.rpcdịch vụ fRPC · pod của directory 0.1.5 Package Manager · Git URL Ổn định
com.fomoxa.networking.steamtransport Steam · relay qua Valve 0.1.0 Package Manager · Git URL Ổn định
Fomoxa.Backend.Templatestemplate backend của game 0.1.1 dotnet new install Fomoxa.Backend.Templates Ổn định

Tài liệu, bằng tiếng Anh và tiếng Việt, gồm cài đặt, game multiplayer đầu tiên, server console, triển khai và ví dụ Red Runner. Release notes ghi phiên bản nào của năm phần đi cùng nhau.

Bằng chứng

Con người

Ai xây dựng

Maintainer Hà Duy Thắng Tác giả specification và maintainer của mọi repository trên trang này. github.com/fomoxa ↗
Đóng góp Issue và pull request Câu hỏi về spec gửi vào repository specification. Lỗi của công cụ hay runtime gửi vào repository của chính nó. Mở issue ↗
Đang dùng Fomoxa? Cho chúng tôi biết, hoặc đưa implementation của bạn lên đây Dự án và implementation độc lập pass 100% RFC-0003 có thể được liệt kê ở đây. Mở pull request vào repository của trang này. fomoxa.github.io ↗