玩家持久化

玩家持久化

!API MOD! 需要额外代码 一个简单的库,允许在多个服务器之间同步玩家数据,如物品栏、末影箱和位置

基础库

Player Persistence 模组

警告:此模组是一个 API,它需要可正常运行的 PostgreSQL 服务器以及额外的代码才能工作!它无法独立运行!

概述:Player Persistence 模组是一个轻量级库,专为 Minecraft 服务器开发者设计,旨在为玩家在服务器重启和世界切换之间提供无缝、持久的体验。此模组负责将玩家物品栏、末影箱内容和位置数据自动保存到数据库并从中加载,确保玩家状态被准确保留。

主要特性:

  • 针对 Docker 和 Kubernetes 部署优化:只需设置环境变量 DB_URL、DB_USER、DB_PASS,即可更改使用哪个数据库以及使用哪个用户。要在多个 ServerTypes 之间同步坐标,请将 SERVER_NODE 变量设置为你的服务器名称。

  • 物品栏持久化:自动将玩家物品栏(包括盔甲和副手物品)保存到数据库并从中加载。这可确保玩家物品在服务器会话之间保持一致且安全。

  • 末影箱持久化:与物品栏持久化类似,此功能会保存并加载玩家末影箱的内容,确保这些贵重物品不会丢失。

  • 玩家位置同步:在服务器重启甚至跨服务器切换之间保持精确的玩家位置和维度数据,让玩家能够从上次离开的地方继续他们的旅程。

  • PostgreSQL 数据库集成:此模组构建为与 PostgreSQL 数据库配合使用,非常适合需要持久数据存储的大型服务器网络或自定义服务器设置。

用法

此模组旨在作为服务器开发者的后端库使用,不会添加任何直接的游戏玩法功能。要使用此模组,只需将其集成到你的服务器模组设置中,配置数据库连接,然后让模组自动处理玩家数据持久化即可。

兼容性

此模组设计为与 Fabric API 配合使用,并兼容最新版本的 Minecraft。它也是模块化的,开发者可以自定义或扩展它,以满足特定的服务器需求。

如何使用

  • 将依赖添加到你的项目中: modApi("maven.modrinth:player-persistence:VERSION")?.let { include(it)}
  • 创建一个 PlayerPersistence 对象,例如 var pp = PlayerPersistence()
  • 按需使用这些方法

缺少某些功能?

如果你缺少某些功能,请在 GitHub 上提交 issue,我们会处理。