Skip to content

Latest commit

 

History

History
34 lines (18 loc) · 2.58 KB

COMMON-MISTAKES.md

File metadata and controls

34 lines (18 loc) · 2.58 KB

A collection of common mistakes

  1. Packet.Dispose() called right after sending a packet.

Never dispose a packet after enqueuing it for sending, ENet does that for you automatically, otherwise, a memory access failure will occur.

  1. Packet.Dispose() called more than once per received packet.

The Packet structure is a value type thus internal checks will fail for two different copies of a packet, and a memory access failure will occur. Try to keep processing flow under strict control. If the received packet will be sent further, you should not dispose it since ENet will use it as you normally enqueuing a packet for sending.

  1. Channels limit didn't match at the endpoints.

Always make sure that the channel limit set to the same value at the endpoints using Host.Create() and Host.Connect() functions, otherwise, packets will not be delivered on disabled channels.

  1. Round-trip time is unstable even on localhost.

This is the first indication that the Host.Service() is not called often enough. Make sure that the service and events are processed continuously and nothing prevents the ENet to shuttle packets across peers.

  1. Latency gets higher relatively to a count of concurrent connections.

Make sure that only the actual payload is sent and not a whole buffer, a packet should be created with the correct length using the Packet.Create() function. Check that the ENet is not overwhelmed with large reliably fragmented packets.

  1. A host is unable to accept multiple connections or degrades with many packets.

Make sure that the service is processing as many events as possible and not only one event per frame/iteration. Put the service into a loop even within a game loop (but without a timeout to avoid blocking). If nothing helps, you can try to increase the socket buffer size of the host at creation up to one megabyte using the appropriate parameter at both ends.

  1. A host is not flushed after the service is no longer in a loop.

Always flush the host before the end of a session to ensure that all enqueued packets and protocol commands were sent to its designated peers.

  1. Unreliable packets are dropped significantly under simulation of latency.

If the simulated delay/ping is applied in the middle of the process, but not before connection establishment, then unreliable packets will be throttled if simulated latency exceeds the threshold (40 ms by default between service updates). See the description of Peer.ConfigureThrottle() for details and parameters tuning.