How to integrate KCP into an existing C++ UDP project?

Copy ikcp.h and ikcp.c into your project, set up a callback function for UDP output using kcp->output, and regularly call ikcp_update() with a custom clock. You'll need to handle packet sending and receiving manually, as shown in the basic usage examples.

KCP vs TCP: which is better for online gaming?

KCP is better for real-time PVP games due to lower latency and faster loss recovery, as it sacrifices some bandwidth for speed. TCP is more bandwidth-efficient but can have higher lag spikes in lossy networks, making it less ideal for twitch gameplay.

What are the best KCP settings for a mobile network?

Use fast mode with ikcp_nodelay(kcp, 1, 10, 2, 1) for minimal delay, and adjust rx_minrto to 10-30ms to detect losses quickly. The wiki recommends tuning based on network conditions, as mobile networks have higher packet loss.

Does KCP support encryption for secure tunneling?

No, KCP does not include encryption natively. You must layer encryption separately, such as using AES or integrating with projects like kcptun that add SSL/TLS, as mentioned in the documentation on network encryption.

How does KCP handle congestion control compared to TCP?

KCP offers a non-conceding flow control mode that skips slow start and congestion avoidance for more consistent latency, but this can reduce fairness and bandwidth sharing with TCP traffic, as noted in the protocol description.

Can KCP be used with WebRTC or other real-time frameworks?

Yes, but it requires adaptation since KCP is a low-level protocol. You'd need to replace or augment WebRTC's SCTP with KCP for lower latency, though this involves significant integration work and isn't plug-and-play.

Open-Awesome

KCP

MITC2.1.1

A fast and reliable ARQ protocol that reduces latency by 30-40% compared to TCP, at the cost of 10-20% more bandwidth.

GitHub

16.8k stars2.6k forks0 contributors

What is KCP?

KCP is a lightweight, reliable ARQ protocol built on top of UDP, designed to provide faster and more responsive data transmission than TCP. It reduces average latency by 30-40% and cuts maximum latency by three times, at the cost of a 10-20% bandwidth overhead. It solves the problem of TCP's high latency in unreliable network conditions, such as mobile networks or congested public internet.

Target Audience

Developers building real-time applications like online games, live video streaming, VoIP, or any UDP-based protocol that requires reliable, low-latency data delivery. It's particularly useful for those implementing custom network stacks or tunneling solutions.

Value Proposition

Developers choose KCP because it offers fine-grained control over transmission behavior, is extremely lightweight (just two source files), and provides significantly lower latency than TCP in lossy network environments. Its modular design allows easy integration into existing projects without adopting a full protocol stack.

Overview

:zap: KCP - A Fast and Reliable ARQ Protocol

Use Cases

Best For

Reducing latency in real-time multiplayer games
Accelerating UDP-based tunneling and proxy applications
Improving live video and audio streaming over unreliable networks
Building custom reliable protocols over UDP
Enhancing performance in mobile (3G/4G) and high-loss network environments
Creating low-latency P2P communication systems

Not Ideal For

Applications where maximizing bandwidth efficiency is critical (e.g., bulk file transfers or video-on-demand streaming)
Projects requiring a full, out-of-the-box network stack with built-in encryption and session management
Environments where TCP's congestion control and fairness are sufficient, and latency spikes are acceptable
Developers unfamiliar with UDP programming who need a plug-and-play solution

Pros & Cons

Pros

Proven Low Latency

Implements selective retransmission, fast ACKs, and a 1.5x RTO multiplier to reduce average latency by 30-40% and maximum latency by 3x compared to TCP, as benchmarked in real-world use.

Lightweight and Embeddable

Consists of only two source files (ikcp.h, ikcp.c) with no system dependencies, allowing easy integration into custom UDP-based protocols without adopting a full stack.

Highly Configurable

Offers tunable parameters like nodelay mode, window sizes, and MTU, enabling optimization for specific network conditions, such as mobile or lossy environments.

Industry Adoption

Used in major projects like Genshin Impact and Alibaba Cloud's GRTN, demonstrating reliability and performance in large-scale, real-time applications.

Cons

Manual Integration Overhead

Requires developers to implement UDP sending/receiving, timing, and session management externally, adding complexity compared to all-in-one libraries.

No Built-in Security

Lacks encryption, authentication, or FEC (Forward Error Correction) by default, forcing users to add separate layers for secure or resilient transmission.

Bandwidth Trade-off

Admits to 10-20% higher bandwidth usage than TCP for latency gains, which may be prohibitive for cost-sensitive or bandwidth-constrained deployments.

Frequently Asked Questions

Related Projects

uWebSockets

Simple, secure & standards compliant web server for the most demanding of applications

Stars18,933

Forks1,859

Last commit17 days ago

Cpp-HttpLib

A C++ header-only HTTP/HTTPS server and client library

Stars16,684

Forks2,718

Last commit19 hours ago

Muduo

Event-driven network library for multi-threaded Linux server in C++11

Stars16,206

Forks5,322

Last commit7 months ago

Mongoose

Embedded web server, with TCP/IP network stack, MQTT and Websocket

Stars12,951

Forks2,927

Last commit1 day ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

KCP