3 releases (breaking)

0.3.0 May 12, 2022
0.2.0 Apr 18, 2022
0.1.0 Mar 8, 2022

#657 in Game dev

43 downloads per month
Used in bevy-pigeon

MIT/Apache

85KB
1.5K SLoC

carrier-pigeon

crates.io docs.rs

A rusty networking library for games.

Carrier pigeon builds on the standard library's TcpStream and UdpSocket types and handles all the serialization, sending, receiving, and deserialization. This way you can worry about what to send, and pigeon will worry about how to send it. This also allows you to send and receive different types of messages independently.

Add carrier-pigeon to your Cargo.toml:

carrier-pigeon = "0.3.0"

Also check out the Bevy plugin.

bevy-pigeon.

Documentation

The documentation can be found on Docs.rs

Quickstart

A quickstart guide that goes in more detail is found at /quickstart.md

Examples

There is a simple chat program example in the examples/ directory. This contains a client and server command line programs.

Features

  • Connection, response, disconnect messages built in and extremely flexible.
  • Configuration for buffer size, timeouts and more.
  • Send/Recv calls take an immutable reference allowing for parallelism.
  • Independent message sending.
  • TCP and UDP connections.
  • Client and Server types.
  • Built in serialization/deserialization.
  • Bevy integration (bevy-pigeon).

Planned Features

  • Server discovery.
  • Query support for server. (Optionally listen on another port and respond to query requests).
  • Optional buffering of TCP messages (Buffer all tcp messages sent, then write them all when a send_tcp method is called).
  • Compile messages into MsgTable using macros.

Contributing

To contribute, fork the repo and make a PR. If you find a bug, feel free to open an issue. If you have any questions, concerns or suggestions you can shoot me an email (found in Cargo.toml) or DM me on discord @TheHourGlass34#0459.

By contributing, you agree that your changes are subject to the license found in /LICENSE.

Dependencies

~1.2–2MB
~41K SLoC