netcode

ネットコード

netcode は、 UDP 上に構築された安全なクライアント/サーバー プロトコルです。

これは、接続指向プロトコルを必要とするが、TCP の行頭ブロックを必要としないリアルタイム マルチプレイヤー ゲームでの使用を目的としています。

ネットコードには次の機能があります。

• 接続トークンを使用してクライアント接続を保護します。承認したクライアントのみがサーバーに接続できます。これは、Web バックエンドでマッチメイキングを実行し、クライアントをサーバーに送信するゲームに最適です。
• クライアントスロットシステム。サーバーにはクライアント用の n 個のスロットがあります。クライアントはサーバーに接続するときにスロットに割り当てられ、すべてのスロットが使用されている場合はすぐに接続が拒否されます。
• 新しいクライアント用のスロットを開くための接続のクライアントまたはサーバー側での高速クリーン切断と、ハード切断のタイムアウト。
• 暗号化および署名されたパケット。接続に関与していない当事者がパケットを改ざんしたり、読み取ったりすることはできません。暗号化は優れたナトリウムライブラリによって実行されます。
• 悪意を持って作成されたパケット、パケットリプレイ攻撃、パケット増幅攻撃に対する堅牢な保護を含む多くのセキュリティ機能。
• Wi-Fi ルーターのジッターを大幅に軽減できるパケットのタグ付けのサポート。詳細については、この記事をお読みください。

ネットコードは安定しており、本番環境に対応しています。

使用法

まず、ランダムな 32 バイトの秘密キーを生成します。秘密キーを誰とも共有しないでください。

特に、クライアントの実行可能ファイルに秘密キーを含めないでください。

テスト用の秘密鍵は次のとおりです。

 static uint8_t private_key [ NETCODE_KEY_BYTES ] = { 0x60 , 0x6a , 0xbe , 0x6e , 0xc9 , 0x19 , 0x10 , 0xea , 
                                                  0x9a , 0x65 , 0x62 , 0xf6 , 0x6f , 0x2b , 0x30 , 0xe4 , 
                                                  0x43 , 0x71 , 0xd6 , 0x2c , 0xd1 , 0x99 , 0x27 , 0x26 ,
                                                  0x6b , 0x3c , 0x60 , 0xf4 , 0xb7 , 0x15 , 0xab , 0xa1 };

秘密キーを使用してサーバーを作成します。

 char * server_address = "127.0.0.1:40000" ;

struct netcode_server_config_t server_config ;
netcode_default_server_config ( & server_config );
memcpy ( & server_config . private_key , private_key , NETCODE_KEY_BYTES );

struct netcode_server_t * server = netcode_server_create ( server_address , & server_config , time );
if ( ! server )
{
    printf ( "error: failed to create servern" );
    return 1 ;
}

次に、必要なクライアント スロットの数を指定してサーバーを起動します。

 netcode_server_start ( server , 16 );

クライアントに接続するには、クライアントは接続トークンを返すバックエンドへの REST API をヒットする必要があります。

接続トークンを使用するとサーバーが保護され、バックエンドで承認されたクライアントのみが接続できるようになります。

 netcode_client_connect ( client , connect_token );

クライアントがサーバーに接続すると、クライアントにはクライアント インデックスが割り当てられ、暗号化および署名されたパケットをサーバーと交換できるようになります。

詳細については、client.c およびserver.c を参照してください。

ソースコード

このリポジトリには、C でのネットコードの実装が保持されます。

他のネットコード実装には次のものがあります。

• ネットコード C# 実装
• ネットコード Golang 実装
• netcode Rust 実装 (vvanders/netcode.io の更新されたフォーク)
• ネットコード Rust 実装 (ゼロからの新しい Rust 実装)
• Unity のネットコード
• UE4 のネットコード
• Typescript のネットコード

独自のネットコード実装を作成したい場合は、ネットコード 1.02 標準を読んでください。

貢献者

これらの人々は素晴らしいです:

• Val Vanders - Rust の実装
• Walter Pearce - Rust の実装
• アイザック・ドーソン - Golang 実装
• Alan Stagner - Unity 統合、C# 実装
• Jérôme Leclecq - ランダム接続トークン nonce のサポート
• Randy Gaul - リプレイ保護の脆弱性を発見
• Benny Chen - Typescript の実装
• Benny Namagimov - Rust の実装

ネットコードへの貢献に感謝します!

著者

このライブラリの著者は Glenn Fiedler です。

同じ作者による他のオープン ソース ライブラリには、reliable、serialize、yojimbo などがあります。

このソフトウェアが役立つと思われる場合は、スポンサーになることをご検討ください。ありがとう！

ライセンス

BSD 3 条項ライセンス。