librg下载 - librg源码下载

librg

C/C++

Release 7.3.0

下载

自 2017 年以来，让多人游戏开发变得更加简单。纯 C99 中的单头跨平台世界复制。

_{使用zpl充满爱心地构建 • 由 @inlife、@zpl-zak 和其他贡献者为您提供}

介绍

librg是一个轻量级库，充当数据传输库（网络、文件流等）和核心应用程序/游戏逻辑之间的中间件。

图书馆的主要职责包括：

实体跟踪（跟踪哪个实体属于哪个世界以及它们拥有什么状态）
所有者跟踪（跟踪哪个参与者拥有哪个实体）
兴趣管理区域（控制参与者可以看到和不可以看到的内容）
世界复制（在目标世界中重新创建对源世界中的参与者可见的内容的有限表示）

该库的诞生是为了解决设置和管理多人游戏和专用游戏服务器流程的复杂性。它在剥离非必要的东西方面取得了很大的进展，慢慢地塑造成现在的形式，您今天就可以看到和使用。

为什么你需要它

没有库

通常，网络游戏世界由一组网络玩家和一堆网络实体组成。在实体和玩家之间建立同步关系的典型变体是建立Everything-to-Everyone连接。

这是要遵循的最基本的设置。然而，随着实体数量的增加，带宽效率变得相当低下。

没有库的世界

与库

使用 librg，您可以通过构建基于半径和可见性的实体关系来显着减少带宽使用。实体将仅与它们可见的玩家同步。

世界与库

好处

支持各种尺寸的 2d/3d 世界
虚拟世界支持
自定义实体可见性方法
高级实体查询
实体间状态更改的事件
联网 LOD 支持（基于可变半径）
跨平台、轻量级、单头

网络集成

图书馆的整体界面是考虑到大多数网络图书馆的支持而设计的。

网络库必须支持：

能够发送和接收char *缓冲区
能够读取或设置缓冲区大小
能够通过整数 id 来识别谁是数据的接收者或发送者

差不多就是这样了！

支持哪些类型的库的列表：

ENet
GameNetworkingSockets
yojimbo
SLikeNet
KCP
Raknet
Websocket
WebRTC
任何其他基于UDP或TCP库

注意：您可以查看 enet 的网络集成示例。

安装

librg是一个单头库，这意味着要使用它，您只需从该存储库的releases部分获取所述头文件的最新（或特定）版本，将其添加到您的项目中，然后开始享受它的好处。

或者，如果您对 CLI 感到满意，则可以执行以下操作；

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

常问问题

这是一个网络图书馆吗？
- 不完全是，不。它旨在与网络一起使用，但它本身不具有任何网络功能。
我可以使用任何网络库吗？
- 是的。您所需要的只是能够从缓冲区读取数据，大多数库都支持这一点。理论上，它可以是低级别的任何东西，如纯UDP ，最高级别为WebSocket / WebRTC 。
存储库包含一堆*.h和*.c文件，但您却认为它是一个单标头库，这怎么可能？
- 该库分布在多个文件中，因此在开发时更容易使用它，但是，每次创建新版本时，都会创建头文件的“捆绑”版本并将其直接推送到版本页面。
librg 提供实体系统吗？
- 不，该库不管理也不实际创建自己的实体，而是希望您提供自己的实体/对象句柄以将一些内部数据附加到其上，这在库的上下文中称为“跟踪”。
我如何打包数据，你们提供方法吗？
- 不，该库不提供任何数据打包/序列化方法。您应该使用一些现有的库（ protobuf 、 flatbuffers 、 msgpack等），或者自行实现。
我看到你提到了块，这是否意味着我的游戏/应用程序应该基于块？
- 不会。块仅在内部使用来人为地将世界空间划分为静态大小的正方形/立方体，以便查询能够有效地工作。即使您的游戏确实使用了块，它们的数量/大小/偏移量也不需要太多，并且应该相同。

文档

要阅读有关该库的详细文档、查看示例和快速入门指南，请访问我们的文档页面。

此外，您可以检查 code/apps 文件夹以获取实际的代码示例。

插图

世界复制

这是一个简单的示例，尝试复制该库如何在 4x4 块的简单 2D 世界上工作。对于更大尺寸的 3D 世界，一切都会以非常相似的方式运行，只是在 3 维中。

_{（点击图片可查看大图）}

世界协议

这张图展示了用于编码和解码数据的底层二进制协议的结构。生成的二进制缓冲区可以插入到任何其他缓冲区中，作为文件保存到磁盘，或使用任何可用的方法通过网络发送。将自定义数据与数据包中的每个实体放在一起，可以实现上下文相关的数据存储，从而扩展功能并允许内存和带宽高效的实体复制。

_{（点击图片查看大图）}

迁移

如果您在v6.0.0版本之前使用过该库，建议阅读此处的迁移指南。

支持

我们正在针对各种平台测试该库。该表提供了某种兼容性描述。如果您测试过，结果与表中的结果不同，请在issues中描述问题。

平台/结果	视窗	macOS	Linux	iOS系统	安卓	树莓派	开放BSD	自由BSD	埃姆脚本
❔				铛	铛	海湾合作委员会，铿锵	海湾合作委员会，铿锵	海湾合作委员会，铿锵
✅	微软、明威	海湾合作委员会，铿锵	海湾合作委员会，铿锵						EMCC