mudb is a collection of modules for building realtime client-server networked applications.
TypeScript friendly, works great with Node.js.
WORK IN PROGRESS
mudb is a collection of modules for writing realtime distributed applications consisting of many protocols.
A protocol, in the mudb sense`, is a collection of related messages and handlers which are grouped according
Message passing is the basic building block for communication in a distributed system. mudb provides a reliable, ordered message delivery and a faster but unreliable method for sending messages immediately. Messages are strongly typed using user-defined schemas.
A schema is a type declaration for the interface between the client and server. Schemas in mudb are specified using the muschema module. Like protocol buffers or gRPC, muschema uses binary serialized messages with a defined schema and makes extensive use of code generation. However, mudb departs from these systems in 3 important ways:
- Javascript only Unlike protocol buffers,
muschemahas no aspirations of ever being cross-language. However, it does make it much easier to extendmudbto support direct serialization of custom application specific data structures. For example, you could store all of your objects in an octree and apply a custom schema to directly diff this octree into your own data type. - 0-copy delta encoding
muschemaperforms all serialization as a relativediffoperation. This means that messages and state changes can be encoded as changes relative to some observed reference. Using relative state changes greatly reduces the amount of bandwidth required to replicate a given change set - Memory pools JavaScript is a garbage collected language, and creating patched versions of different messages can generate many temporary objects. In order to avoid needless and wasteful GC thrashing,
muschemaprovides a pooling interface and custom memory allocator.
mudb communicates over a generic socket abstraction provided by munet. munet sockets support both reliable and unreliable delivery. Unreliable delivery is used for state replication, while reliable delivery is used for messages. Unreliable delivery is generally faster than reliable delivery since it does not suffer from head-of-line blocking problems. For websocket servers, munet emulates unreliable delivery using multiple websocket connections.
Light reading:
- protocol buffers
- quake 3
- "Planetary Annihilation"
- Janus
- "Implementation of Rewind in Braid"
- "Relativistic replication"
- "Source multiplayer networking"
Academic references:
- C. Savery, T.C. Graham, "Timelines: Simplifying the programming of lag compensation for the next generation of networked games" 2013
- Local perception filters
- TODO
TODO
mudb is implemented as a collection of modules for building realtime networked applications.
mudb is the database itself. For users learning the API, start here after reading about concepts.
mudb is used to define the database schema.
TODO
mudo is a local development server based on budo which handles a lot of the boilerplate around creating and starting a server/client pair for you.
Development supported by Shenzhen DianMao Digital Technology Co., Ltd.
Written in Shenzhen, China.
(c) 2017 Mikola Lysenko, Shenzhen DianMao Digital Technology Co., Ltd.