PLand-LegacyRemoteCallApi

PLand 的 LegacyRemoteCall 实现，用于在 LegacyScriptEngine 中调用 PLand API。

项目地址：github.com/IceBlcokMC/PLand-LegacyRemoteCallApi

注意事项

• 本项目仅对 PLand C++ API 进行封装，不包含 PLand 的任何代码，请确保已经安装了 PLand
• 由于引擎限制，无法做到原生持有 Native 对象，因此采用了一些折衷方案（句柄），对于大型项目、高频调用相关接口存在性能问题，如果您有性能需求建议使用 C++ API

安装

需与 PLand 一起安装, 注意 <major>.<minor>.x 版本匹配。

lip install github.com/IceBlcokMC/PLand-LegacyRemoteCallApi

导入方式

接口导出时机

所有接口均在 onEnable (领地初始化完成后) 才会导出，请勿在 onLoad/全局作用域内调用。

按需导入 (自己处理相关返回值、参数处理)

提示

此方案为直接通过引擎的 ll.imports 导入 PLand-LRCA 提供的接口，不含高级封装，类 C 风格的 API(过程式/函数式)

• 导出命名空间：PLand_LDAPI
• 获取方式：ll.imports("PLand_LDAPI", "<函数名>")，例如：

const Land_getId = ll.imports("PLand_LDAPI", "Land_getId");
const id = Land_getId(2);

更多接口请查看 接口文档

---

全量导入 (使用 PLand-LRCA 提供的封装函数)

提示

此方案通过模块系统直接导入 PLand-LRCA 提供的封装函数，拥有基础的面向对象封装

语言限制

目前仅提供了 JavaScript 的封装，其它语言未提供封装，请自行使用 ll.imports 导入

从 0.8.0 版本开始，同时提供 ESM 和 CJS 两种导出方式，你可以根据自己的需求选择。

关于 quickjs ESM 的路径解析（引擎 Bug）

LSE 的 quickjs 后端在加载 入口模块（manifest.json 中指定的入口文件）时，相对 import 路径是相对于 服务器工作目录（CWD） 解析的，而不是脚本文件所在目录。

也就是说，在入口文件中写 import ... from "./xxx.js" 会指向 服务器根目录/xxx.js（通常不存在），导致加载失败。

应对方式：参考官方 LanguageSupport 文档，使用 bootstraps.js 引导文件规避：

1. 在 manifest.json 中把入口设为 bootstraps.js
2. bootstraps.js 中使用相对于服务器根目录的路径导入实际入口文件
3. 实际入口文件（非入口模块）内部的 import 遵循标准 ESM 规则，可用正常相对路径

推荐：bootstraps.js 引导模式

假设你的插件位于 plugins/my_plugin/，实际入口为 Test.js：

// bootstraps.js（manifest.json 的入口，位于 plugins/my_plugin/）
// 入口模块的 import.meta.url 为服务器 CWD，所以使用相对于服务器根目录的路径
import * as _ from "./plugins/my_plugin/Test.js";

// Test.js（实际入口，非入口模块，遵循标准 ESM 规则）
import { LandRegistry } from "../PLand-LegacyRemoteCallApi/lib/esm/imports/LandRegistry.js";
import { Land } from "../PLand-LegacyRemoteCallApi/lib/esm/imports/Land.js";
import { LDEvent } from "../PLand-LegacyRemoteCallApi/lib/esm/imports/LDEvents.js";

直接在入口模块中导入

如果你不想用引导文件，在入口模块中必须使用相对于服务器根目录的完整路径：

// 入口模块（相对于服务器 CWD 解析）
import { LandRegistry } from "./plugins/PLand-LegacyRemoteCallApi/lib/esm/imports/LandRegistry.js";

CommonJS 模块

const {
  LandRegistry,
} = require("../PLand-LegacyRemoteCallApi/lib/cjs/imports/LandRegistry.js");

快速示例

查询领地

// 假设这是你的实际入口文件（非入口模块，遵循标准 ESM 规则）
import { LandRegistry } from "../PLand-LegacyRemoteCallApi/lib/esm/imports/LandRegistry.js";
import { Land } from "../PLand-LegacyRemoteCallApi/lib/esm/imports/Land.js";

mc.listen("onServerStarted", () => {
  // 获取单个领地（未找到返回 null）
  const land = LandRegistry.getLand(2);

  // 获取所有领地
  const lands = LandRegistry.getLands();

  // 按维度 / 按玩家查询
  LandRegistry.getLands(0); // 主世界所有领地
  LandRegistry.getLands(playerUuid, true); // 某玩家的领地

  // 按坐标查询
  const landAt = LandRegistry.getLandAt(new IntPos(100, 64, 200, 0));
});

操作领地对象

LRCA 的 Land 类实际是一个句柄，只要知道领地 ID 就可以直接构造，无需查询：

// 直接通过 ID 构造领地句柄
const land = new Land(2);

// 读取领地信息
console.log(land.getLeaseState()); // 租赁状态
console.log(land.getLeaseEndAt()); // 租赁结束时间
console.log(land.getAABB()); // 领地范围
console.log(land.isBought()); // 是否买断

性能提示

脚本尽可能不要长期持有领地对象，因为 LRCA 提供的封装都是句柄。即使持有了，底层在玩家删除领地时也会释放领地指针。

监听领地事件

import { LDEvent } from "../PLand-LegacyRemoteCallApi/lib/esm/imports/LDEvents.js";

// 注册事件监听器
// 注意: LDEvent 级所有相关 API，在 onLoad 阶段调用会报错，因为此时 API 还未导出、PLand 未初始化完成
function setupListeners() {
  LDEvent.listen("PlayerEnterLandEvent", (player, landId) => {
    console.log(`${player.name} 进入了领地 ${landId}`);
  });
}

mc.listen("onServerStarted", () => {
  setupListeners();
});

主要 API

模块	说明
LandRegistry	领地注册表查询与操作（getLand、getLands、getLandAt、isOperator、createSnapshot 等）
Land	领地句柄（getAABB、getOwner、getMembers、租赁状态等）
LandAABB	领地范围工具类
LeasingService	租赁服务（forceFreeze、forceRecycle、toBought、toLeased 等）
LDEvent	事件监听（PlayerEnterLandEvent、PlayerBuyLandEvent、OwnerChangedEvent 等）