laminar

Laminar

Laminar is an application-level transport protocol which provides configurable reliability and ordering guarantees built on top of UDP. It focuses on fast-paced fps-games and provides a lightweight, message-based interface.

Laminar was designed to be used within the Amethyst game engine but is usable without it.

If you are new to laminar or networking in general, We strongly recommend taking a look at the laminar book

Concepts

This library is loosely based off of Gaffer on Games and shares features similar as RakNet, Steam Socket, netcode.io. The idea is to provide an in rust written, low-level UDP-protocol which supports the use of cases of video games that require multiplayer features. The library itself provides a few low-level types of packets that provide different types of guarantees. The most basic are unreliable and reliable packets. Also ordering, sequencing can be done on multiple streams. For more information, read the projects README.md, book, docs or examples.

Table of contents:

• Useful links
• Features
• Getting Started
• Examples
• Notice
• Contributing
• Authors
• License

Features

These are the features this crate provides:

• Fragmentation
• Unreliable packets
• Unreliable sequenced packets
• Reliable unordered packets
• Reliable ordered packets
• Reliable sequenced packets
• Rtt estimations
• Protocol version monitoring
• Basic connection management
• Heartbeat
• Basic DoS mitigation
• High Timing control
• Protocol Versioning
• Well-tested by integration and unit tests
• Can be used by multiple threads (Sender, Receiver)

Planned

• Handshake Protocol
• Advanced Connection Management
• Cryptography
• Congestion Control

Getting Started

Add the laminar package to your Cargo.toml file.

[dependencies]
laminar = "0.5"

Useful Links

• Documentation.
• Crates.io
• Examples
• Contributing
• Book

Examples

Please check out our examples for more information.

UDP API | see more

This is an example of how to use the UDP API.

Send packets

…

Receive Packets

…

Authors

• Timon Post
• Justin LeFebvre
• Fletcher Haynes

Notice

This library is not fully stable yet, and there may be breaking changes to the API. For more advanced examples of using laminar, you can check out the Amethyst-Network crate.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.