键值对存储 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。