librg

Menjadikan pengembangan game multipemain lebih sederhana sejak 2017. Replikasi dunia lintas platform header tunggal di C99 murni.

_{Dibangun dengan cinta menggunakan zpl • Dipersembahkan oleh @inlife, @zpl-zak, dan kontributor lainnya}

Perkenalan

librg adalah perpustakaan ringan yang berfungsi sebagai middleware antara perpustakaan transfer data (jaringan, streaming file, dll.) dan logika aplikasi/game inti.

Tanggung jawab utama perpustakaan meliputi:

• pelacakan entitas (melacak entitas mana yang termasuk dalam dunia apa dan negara bagian apa yang mereka miliki)
• pelacakan pemilik (melacak peserta mana yang memiliki entitas apa)
• Manajemen area of ​​interest (mengontrol apa yang bisa dan tidak bisa dilihat oleh peserta)
• replikasi dunia (menciptakan kembali representasi terbatas di dunia tujuan dari apa yang dianggap terlihat oleh peserta di dunia sumber)

Perpustakaan ini lahir untuk mengatasi kerumitan pengaturan dan pengelolaan aliran game multi-pemain dan server game khusus. Ini merupakan perjalanan panjang dalam menghilangkan hal-hal yang tidak penting, perlahan-lahan membentuknya menjadi bentuknya yang sekarang, yang dapat Anda lihat dan gunakan saat ini.

Mengapa Anda membutuhkannya

Tanpa perpustakaan

Biasanya, dunia game berjaringan terdiri dari sekumpulan pemain yang berjaringan dan sekelompok entitas yang berjaringan. Varian umum dari pengaturan hubungan sinkronisasi antara entitas dan pemain adalah dengan mengatur koneksi Segalanya ke Semua Orang.

Ini adalah pengaturan paling dasar yang harus diikuti. Namun, dengan bertambahnya jumlah entitas, bandwidth menjadi tidak efisien.

Dengan librg

Dengan librg, Anda dapat mengurangi penggunaan bandwidth secara signifikan dengan membangun relasi entitas berbasis radius & visibilitas. Entitas hanya akan disinkronkan dengan pemain yang dapat melihatnya.

Manfaat

• Dukungan untuk dunia 2d/3d dengan berbagai ukuran
• Dukungan dunia maya
• Metode visibilitas entitas kustom
• Kueri entitas tingkat lanjut
• Peristiwa untuk perubahan status entitas-ke-entitas
• Dukungan LOD jaringan (berdasarkan radius variabel)
• Lintas platform, ringan, satu header

Integrasi jaringan

Antarmuka keseluruhan perpustakaan dibuat dengan mempertimbangkan dukungan sebagian besar perpustakaan jaringan.

Perpustakaan jaringan harus mendukung:

1. Kemampuan untuk mengirim dan menerima buffer char *
2. Kemampuan untuk membaca atau mengatur ukuran buffer itu
3. Kemampuan untuk mengidentifikasi siapa penerima atau pengirim data dengan id bilangan bulat

Dan itu cukup banyak!

Daftar jenis perpustakaan apa yang didukung:

• ENet
• GameNetworkingSockets
• yojimbo
• SLikeNet
• KCP
• Raknet
• Websocket
• WebRTC
• Pustaka berbasis UDP atau TCP lainnya

Catatan: Anda dapat memeriksa contoh integrasi jaringan untuk enet.

Instalasi

librg adalah perpustakaan header tunggal, yang berarti untuk menggunakannya, Anda hanya perlu mendapatkan versi terbaru (atau spesifik) dari file header tersebut dari bagian rilis repositori ini, menambahkannya ke proyek Anda, dan mulai menikmati manfaatnya .

Alternatifnya, jika Anda merasa nyaman dengan CLI Anda, Anda dapat melakukan hal berikut;

curl -L https://github.com/zpl-c/librg/releases/latest/download/librg.h > librg.h

# OR

wget https://github.com/zpl-c/librg/releases/latest/download/librg.h -O librg.h

Pertanyaan Umum

1. Apakah ini perpustakaan jaringan?

   • Tidak juga, tidak. Ini dimaksudkan untuk digunakan dengan mempertimbangkan jaringan, tetapi tidak memiliki kemampuan jaringan sendiri.

2. Bisakah saya menggunakan perpustakaan jaringan apa pun dengannya?

   • Ya. Yang Anda perlukan hanyalah kemampuan membaca data ke dan dari buffer, yang didukung sebagian besar perpustakaan. Secara teoritis, ini bisa berupa apa saja serendah UDP murni, dan hingga WebSocket / WebRTC .

3. Repositori berisi banyak file *.h dan *.c , namun Anda menyarankan itu adalah perpustakaan header tunggal, bagaimana mungkin?

   • Pustaka tersebar ke dalam beberapa file sehingga lebih mudah untuk dikerjakan saat mengembangkannya, namun, setiap kali rilis baru dibuat, versi "paket" dari file header dibuat dan dikirim langsung ke halaman rilis.

4. Apakah librg menawarkan sistem entitas?

   • Tidak, perpustakaan tidak mengelola atau benar-benar membuat entitasnya sendiri, melainkan mengharapkan Anda menyediakan pegangan entitas/objek Anda sendiri untuk melampirkan beberapa data internal ke dalamnya, yang dalam konteks perpustakaan disebut "pelacakan".

5. Bagaimana cara mengemas data, apakah Anda menyediakan metode untuk itu?

   • Tidak, perpustakaan tidak menyediakan metode pengepakan data/serialisasi apa pun. Anda harus menggunakan beberapa perpustakaan yang ada untuk itu ( protobuf , flatbuffers , msgpack , dll.), atau membuat implementasi Anda sendiri.

6. Saya melihat Anda menyebutkan potongan, apakah ini berarti game/aplikasi saya harus berbasis potongan?

   • Tidak. Potongan hanya digunakan secara internal untuk membagi ruang dunia secara artifisial menjadi kotak/kubus berukuran statis sehingga kueri dapat bekerja secara efisien. Meskipun game Anda menggunakan potongan, jumlah/ukuran/offsetnya tidak diperlukan terlalu banyak dan harus sama.

Dokumentasi

Untuk membaca dokumentasi terperinci tentang perpustakaan, melihat contoh, dan panduan memulai cepat, silakan kunjungi halaman dokumentasi kami.

Selain itu, Anda dapat memeriksa folder kode/aplikasi untuk contoh kode sebenarnya.

Ilustrasi

Replikasi Dunia

Berikut adalah ilustrasi sederhana yang mencoba meniru cara kerja perpustakaan pada dunia 2D sederhana yang terdiri dari potongan 4x4. Untuk dunia 3D berukuran lebih besar, semuanya akan bekerja dengan cara yang sangat mirip, hanya dalam 3 dimensi.

_{(klik pada gambar untuk melihat ukuran penuh)}

Protokol Dunia

Dan gambar ini menunjukkan struktur protokol biner dasar yang digunakan untuk menyandikan dan mendekode data dari/ke. Buffer biner yang dihasilkan dapat dimasukkan ke buffer lain, disimpan ke disk sebagai file, atau dikirim melalui jaringan menggunakan metode apa pun yang tersedia. Menempatkan data khusus di samping setiap entitas dalam paket memungkinkan penyimpanan data yang bergantung pada konteks yang memperluas kemampuan dan memungkinkan replikasi entitas yang hemat memori dan bandwidth.

_{(klik pada gambar untuk melihat ukuran penuh)}

Migrasi

Jika Anda telah menggunakan perpustakaan sebelum versi v6.0.0 , disarankan untuk membaca panduan migrasi yang terdapat di sini.

Mendukung

Kami sedang menguji perpustakaan untuk berbagai platform. Tabel ini memberikan semacam deskripsi kompatibilitas. Jika Anda telah mengujinya, dan hasil Anda berbeda dengan tabel, silakan jelaskan masalahnya dalam terbitan tersebut.

Platform / Hasil	jendela	macOS	Linux	iOS	Android	Raspberry Pi	OpenBSD	FreeBSD	Ditulis
❔				dentang	dentang	gcc, dentang	gcc, dentang	gcc, dentang
✅	msvc, mingw	gcc, dentang	gcc, dentang						dll

Legenda:

• ❔ - Pustaka belum diuji pada platform/kompiler ini
• ✅ - Perpustakaan berhasil dikompilasi, dan semua pengujian dijalankan dengan benar

Perkembangan

Jika Anda ingin berkontribusi, menambahkan fitur baru, pengoptimalan, atau peningkatan secara keseluruhan, berikut petunjuk cara melakukannya:

1. Kloning repo, fe: git clone https://github.com/zpl-c/librg.git
2. Jalankan make untuk membangun semua proyek dan verifikasi semuanya berfungsi
3. Kembangkan fitur, tambahkan tes untuk itu dalam code/tests/
4. Dan akhirnya jalankan make test lagi untuk memeriksa

Jika Anda bekerja dari Windows , dan/atau tidak dapat menggunakan make , Anda juga dapat menggunakan file konfigurasi cmake bawaan untuk menghasilkan solusi Visual Studio, untuk melakukannya:

1. mkdir build
2. cd build
3. cmake ../misc -G"Visual Studio 16 2019" (atau konfigurasi apa pun yang Anda miliki)
4. cmake --open . (membuka VS dengan solusinya)
5. Dan ulangi langkah dari atas

Bagi pengembang, ini menawarkan manfaat bagus:

• kompilasi dan run-time dapat dikonfigurasi
• ditulis dalam C99 (alasan portabilitas)
• tidak ada ketergantungan eksternal
• cakupan pengujian unit bawaan