离线玩家数据

警告

这些文档是为 SpongeAPI 7 编写的,可能已经过时。 如果你觉得你可以帮助更新它们,请提交一个 PR!

即使玩家离线,插件也可能需要访问玩家的数据。 你可能认为 Sponge.getServer().getPlayer() 返回的 Player 可以解决这个问题。但事实并非如此。由于 Player 仅仅代表一个在线的玩家,因此我们需要寻求另外的解决方案。

一些插件自己存储相关数据,并通过使用 GameProfileManager 来关联用户。但是实际上,我们不必为离线和在线用户编写不同的代码。 ServiceManager 本身提供一个名为 UserStorageService 的服务,它能够在 Player 离线时返回 User 的实例。因为 Player 接口继承了 User ,所以大多数调用 Player 的方法都可以使用。

例如:

  • 两个接口都支持 #hasPermission(String permission) 方法。

代码示例

这里是一个可以用于获取 User 类的实例的实用方法的示例:

import java.util.Optional;
import java.util.UUID;

import org.spongepowered.api.Sponge;
import org.spongepowered.api.entity.living.player.User;
import org.spongepowered.api.service.user.UserStorageService;

public Optional<User> getUser(UUID uuid) {
    Optional<UserStorageService> userStorage = Sponge.getServiceManager().provide(UserStorageService.class);
    return userStorage.get().get(uuid);
}

这段代码将从 ServiceManager 取得 UserStorageService 对象,然后从中获取 User 对象。

备注

UserStorageService 只能返回之前曾经进入过服务器的 User

备注

此方案不会返回 Player 实例。这样可以安全地存储返回的 User 对象,但您需要使用 User.getPlayer() 方法来获取在线的玩家实体。