> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/zh/docs/tools-and-integrations/cong-nakama-bu-shu.md).

# 从 Nakama 部署

将 Nakama 与 Edgegap 配对，为从独立游戏项目到 AAA 大作提供稳定的在线多人体验。

多人游戏玩家无论是在纽约还是在雅加达游玩，都期望从独立游戏到 3A 游戏获得同样高质量的在线体验。

对于游戏开发者而言，这一标准需要 **可扩展的后端服务，与其游戏服务器托管协同工作** 以确保无缝的终端用户体验，让用户即时上线并在具有实时性能的游戏服务器上游玩。

为热门游戏引擎或自定义引擎部署专用游戏服务器，并与 Nakama 开源的玩家数据和游戏服务完全集成，提供便捷的一体化解决方案。

{% hint style="success" %}
这是一项与独立合作伙伴共同维护的已验证解决方案 - [Heroic Labs](https://heroiclabs.com).
{% endhint %}

## 🚀 开始使用

Nakama（由 Heroic Labs 提供）与 Edgegap 之间的集成旨在简化部署可扩展、低延迟游戏服务器的过程。以下是其工作原理概述：

1. **使用 Nakama 进行匹配和玩家管理**: [Nakama 处理用户账户、匹配和玩家数据管理](https://heroiclabs.com/docs/nakama/getting-started/index.html)，采用强大的架构支持玩家之间的实时交互。一旦 Nakama 确定应开始一场对局，它就会在 Edgegap 上触发一个游戏实例。
2. **使用 Edgegap 进行动态服务器部署**：Edgegap 接收来自 Nakama 的请求并 [在最佳位置部署服务器实例](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md) 根据实时数据（例如玩家位置和设备信息）进行部署。这确保游戏服务器靠近玩家，最大限度降低延迟，并创造流畅的游戏内体验。
3. **实时通信**：该集成实现了 Nakama 的游戏后端与 Edgegap 的部署网络之间的无缝通信。Nakama 提供匹配、大厅系统和通用元游戏玩法功能，而 Edgegap 则确保核心游戏循环（使用 Unity 等无头游戏引擎运行）无论玩家身在何处都能尽可能高效地运行。Edgegap 与 Nakama 之间的连通性意味着玩家可以更好地相互匹配，并与运行在 Edgegap 上的现有或新对局进行匹配。
4. **可扩展性和负载管理**：Edgegap 的系统会根据玩家需求动态扩展或缩减资源，而 Nakama 可扩展到容纳数百万用户，即使在高峰期也是如此。这种组合使开发者能够在流量激增时保持稳定性能，而无需过度预留资源。

<figure><img src="https://3334189208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FeeqFSOPBIvtytnPI2neT%2Fimage.png?alt=media&amp;token=96127320-d7bd-4a66-a5df-cea0cf886d25" alt=""><figcaption></figcaption></figure>

## ⚡ 集成

{% hint style="info" %}
**Nakama 版本**： [nakama-edgegap 插件](https://github.com/edgegap/backend-nakama-edgegap-plugin) 支持 **Nakama 3.41.0**。使用以下内容构建你的 Go 模块 `heroiclabs/nakama-pluginbuilder:3.41.0` 和 `github.com/heroiclabs/nakama-common v1.48.0` （Go 1.27.1），即 Nakama 3.41.0 所需的版本。
{% endhint %}

☑️ **安装并配置 Nakama**: [首先将 Nakama 设置为你游戏的后端](https://heroiclabs.com/docs/nakama/getting-started/install/)。将其配置为处理用户账户、匹配、多人会话以及其他游戏逻辑：

* 以便 [Heroic Cloud](https://heroiclabs.com/heroic-cloud/), [创建一个新的 Builder](https://heroiclabs.com/docs/heroic-cloud/concepts/builders/) 使用 [nakama-edgegap 插件仓库](https://github.com/edgegap/backend-nakama-edgegap-plugin),
* 以便 [自托管的 Nakama](https://docs.edgegap.com/zh/learn/advanced-features/managed-clusters.md#nakama-by-heroic-labs), [按照插件使用说明在本地构建你的镜像](https://github.com/edgegap/backend-nakama-edgegap-plugin?tab=readme-ov-file#usage)

☑️ **注册 Edgegap**: [注册 Edgegap 网页平台](https://app.edgegap.com/auth/register) 以上传你的专用服务器镜像，并获取下一步所需的 API 密钥和机密。Edgegap 的托管在开发期间通过免费试用可免费使用，其无需承诺、极具竞争力的按分钟计费定价可确保工作室只在玩家活跃时付费，无需预付费用或固定月费：

* [服务器入门（Unity）](https://docs.edgegap.com/zh/unity.md),
* [服务器入门（Unreal Engine）](https://docs.edgegap.com/zh/unreal-engine.md).

☑️ **将 Nakama 连接到 Edgegap**：使用 Nakama 的 FleetManager 实现连接到 Edgegap 的部署服务。请遵循 [Heroic Labs 集成指南](https://heroiclabs.com/docs/nakama/guides/concepts/edgegap-integration/) 来配置这两项服务，并查看 [插件 README](https://github.com/edgegap/backend-nakama-edgegap-plugin?tab=readme-ov-file#nakama-setup) 了解每个环境变量。

🙌 恭喜你已将 Nakama 与 Edgegap 部署集成！

{% hint style="success" %}
**自动化游戏服务器集成** 使用 [适用于 Unity 的 Edgegap Server Nakama 插件](https://github.com/edgegap/backend-nakama-unity-template-model).
{% endhint %}

{% hint style="success" %}
请参见 [Nakama Fish Game](https://docs.edgegap.com/zh/docs/sample-projects/godot/nakama-fish-game.md) 有关 **完整的 Godot 4 示例** 以及 Nakama 匹配。
{% endhint %}

## 🚨 故障排除

{% hint style="info" %}
如果你需要帮助， [请通过 Discord 联系我们](https://discord.gg/MmJf8fWjnt)。关于实时游戏支持，请查看我们的 [工单系统](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}
