Skip to content

LDAPI

LDAPI 为 PLand 导出的 API

LDAPI 的本质是一个宏,值为 __declspec(dllimport)
头文件中,标记 LDAPI 的函数您都能访问、调用

class 指南

由于 PLand 尚未进入 v1.0.0 内部API变化频繁,本文档无法实时更新,请以 SDK 为准

类名描述备注
LandRegistryLandRegistry 核心类(负责存储、查询)-
Land领地代理类(提供对原始数据的封装 API)
PriceCalculate价格公式解析、计算 (formula 价格表达式)-
Config配置文件-
EconomySystem经济系统 (已封装对接双经济)-
EventListener事件监听器(监听拦截 Mc 事件)-
LandPos坐标基类 (负责 JSON 序列化)-
LandAABB领地坐标 (一个领地的对角坐标)-
LandSelector领地选区器(负责圈地、修改范围)-
DrawHandle绘制管道 (管理领地绘制, 每个玩家都独立分配一个 DrawHandle)-

⚠️:当您需要长期持有 Land 时建议使用 std::weak_ptr<Land> 弱引用。

RAII 资源

插件中许多资源采用了 RAII 机制,它们由 PLand 主入口类管理。
当您有需要时,可以从 PLand 获取它们

internal 相关

internal 命名空间 / 文件夹 下的文件、方法、API 为内部 API
PLand 默认不导出这些API的符号,也不推荐访问、修改 internal 下的内容

service 相关

v0.18+ 版本开始,PLand 重构了许多代码,引入了 service 模式

您可以通过 PLand::getInstance().getServiceLocator() 获取 ServiceLocator

所有 Service 都受 ServiceLocator 管理,您可以通过 ServiceLocator 获取它们

AGPL-3.0 Licensed