Skip to content
iPlugin

键值对存储 API

提供管理玩家键值对(Key-Value)数据,用于存储和检索自定义数据

方法

获取玩家所有数据

获取玩家所有键值对数据。

fun getStorage(playerUUID: UUID): Map<String, String>

参数:

  • playerUUID: 玩家的唯一标识符。

返回:

  • 返回一个 Map<String, String>,其中包含玩家的所有存储数据。

获取玩家指定数据

根据键获取玩家存储的数据。

fun getStorage(playerUUID: UUID, key: String): String?

参数:

  • playerUUID: 玩家的唯一标识符。
  • key: 数据的键。

返回:

  • 返回键对应的 String 值。如果数据不存在,则返回 null。

存储或更新数据

为玩家存储或更新一个键值对。

fun setStorage(playerUUID: UUID, key: String, value: String)

参数:

  • playerUUID: 玩家的唯一标识符。
  • key: 数据的键。
  • value: 数据的值。

功能:

  • 将键值对存储到玩家数据中。如果键已存在,则更新其值。

删除指定数据

删除玩家的指定键值对。

fun deleteStorage(playerUUID: UUID, key: String): Boolean

参数:

  • playerUUID: 玩家的唯一标识符。
  • key: 要删除的数据键。

返回:

  • 如果数据成功删除,则返回 true;如果数据不存在,则返回 false。

删除所有数据

删除玩家的所有键值对数据。

fun deleteAllStorage(playerUUID: UUID): Boolean

参数:

  • playerUUID: 玩家的唯一标识符。

返回:

  • 如果数据成功删除,则返回 true;如果玩家没有数据,则返回 false。

检查数据是否存在

检查玩家是否拥有某个键值对。

fun hasStorage(playerUUID: UUID, key: String): Boolean

参数:

  • playerUUID: 玩家的唯一标识符。
  • key: 要检查的键。

返回:

  • 如果玩家拥有该键值对,则返回 true,否则返回 false。