luanti API-Classes PlayerMetaData

发表于 分类于 阅读次数： 本文字数： 667 阅读时长 ≈ 1 分钟

PlayerMetaData

PlayerMetaData 是每个世界、每个玩家独立的持久化字符串键值存储，完全继承 MetaData 所有方法。

保存频率

数据保存间隔由服务器配置 map_save_interval 控制。

重要规范（必看）

PlayerMetaData 是所有模组共用的，为了避免键名冲突，必须给你的 key 加模组名前缀。

例子：

  • 任务模组的分数 → fancy_quests:score
  • 生物模组的分数 → fancy_mobs:score

player:get_meta()

获取一个玩家的元数据对象。

注意

  • 必须传入在线玩家对象才能使用
  • 玩家离线时无法访问 PlayerMetaData
  • 如果你需要存离线玩家数据，请用 ModStorage，并把玩家名加进键名里

离线存储替代方案（ModStorage）

1
2
3
4
5
6
7
8
9
-- 把玩家数据存在 ModStorage 中，支持离线读取
local storage = core.get_mod_storage()
local player_name = player:get_player_name()

-- 存
storage:set_string(player_name .. ":score", "100")

-- 取
local score = storage:get_string(player_name .. ":score")

总结一句话

  • ModStorage：模组全局，世界维度，离线可读写
  • NodeMetaData：单个方块，带界面、带背包
  • PlayerMetaData：单个玩家，在线才能读写