StructureRampart.setPublic() 怎么安全切换通行状态

StructureRampart.setPublic(isPublic) 会改变己方 Rampart 是否允许其他玩家的 Creep 通过。

本文只解决一个问题：怎样对一座已经人工确认的 Rampart 切换公开状态，同时避免把“公开”误解成盟友白名单。

最重要的安全边界

rampart.setPublic(true)

不是“只允许朋友通过”。公开状态会让其他玩家的Creep能够通过，包括你没有加入盟友列表的玩家。

setPublic(false)会恢复私有通行状态。

公开状态不会：

转移Rampart所有权；
自动修改其他Rampart；
开启Safe Mode；
建立按玩家区分的白名单；
判断进入者是否有攻击意图；
替代Tower和防御Creep。

因此不能把玩家名单直接传给 setPublic()，API只接受一个布尔值。

先做只读查询

const room = Game.rooms.W1N1;

if (room) {
  const ramparts = room.find(FIND_MY_STRUCTURES, {
    filter: structure =>
      structure.structureType === STRUCTURE_RAMPART
  });

  console.log(ramparts.map(rampart => ({
    id: rampart.id,
    roomName: rampart.pos.roomName,
    x: rampart.pos.x,
    y: rampart.pos.y,
    isPublic: rampart.isPublic,
    hits: rampart.hits,
    hitsMax: rampart.hitsMax
  })));
}

先确认ID、位置和当前状态，再写入操作请求。

目标绑定确认词

请求结构：

Memory.rampartPublicRequest = {
  enabled: true,
  rampartId: '替换为Rampart ID',
  roomName: 'W1N1',
  x: 20,
  y: 20,
  public: true,
  confirmation: 'SET_RAMPART_PUBLIC_W1N1_20_20'
};

确认词应与目标状态绑定：

function buildRampartConfirmation(
  roomName,
  x,
  y,
  shouldBePublic
) {
  const state = shouldBePublic
    ? 'PUBLIC'
    : 'PRIVATE';

  return `SET_RAMPART_${state}_${roomName}_${x}_${y}`;
}

请求从公开改成私有、坐标改变或房间改变后，旧确认词都会失效。

可离线测试的计划函数

function evaluateRampartRequest(input) {
  const { request, rampart, owned } = input;

  if (!request || request.enabled !== true) {
    return { ready: false, reason: 'disabled' };
  }

  if (
    typeof request.rampartId !== 'string'
    || typeof request.roomName !== 'string'
    || !Number.isInteger(request.x)
    || !Number.isInteger(request.y)
    || request.x < 0
    || request.x > 49
    || request.y < 0
    || request.y > 49
    || typeof request.public !== 'boolean'
  ) {
    return { ready: false, reason: 'invalid-request' };
  }

  const expectedConfirmation = buildRampartConfirmation(
    request.roomName,
    request.x,
    request.y,
    request.public
  );

  if (request.confirmation !== expectedConfirmation) {
    return { ready: false, reason: 'confirmation-mismatch' };
  }

  if (!rampart) {
    return { ready: false, reason: 'rampart-missing' };
  }

  if (!owned) {
    return { ready: false, reason: 'not-owner' };
  }

  if (rampart.structureType !== STRUCTURE_RAMPART) {
    return { ready: false, reason: 'type-mismatch' };
  }

  if (rampart.pos.roomName !== request.roomName) {
    return { ready: false, reason: 'room-mismatch' };
  }

  if (
    rampart.pos.x !== request.x
    || rampart.pos.y !== request.y
  ) {
    return { ready: false, reason: 'position-mismatch' };
  }

  if (rampart.isPublic === request.public) {
    return { ready: false, reason: 'state-already-matches' };
  }

  return { ready: true, reason: 'ready' };
}

完整示例

代码放入现有 main 模块。

function buildRampartConfirmation(
  roomName,
  x,
  y,
  shouldBePublic
) {
  const state = shouldBePublic
    ? 'PUBLIC'
    : 'PRIVATE';

  return `SET_RAMPART_${state}_${roomName}_${x}_${y}`;
}

function evaluateRampartRequest(input) {
  const { request, rampart, owned } = input;

  if (!request || request.enabled !== true) {
    return { ready: false, reason: 'disabled' };
  }

  if (
    typeof request.rampartId !== 'string'
    || typeof request.roomName !== 'string'
    || !Number.isInteger(request.x)
    || !Number.isInteger(request.y)
    || request.x < 0
    || request.x > 49
    || request.y < 0
    || request.y > 49
    || typeof request.public !== 'boolean'
  ) {
    return { ready: false, reason: 'invalid-request' };
  }

  const expectedConfirmation = buildRampartConfirmation(
    request.roomName,
    request.x,
    request.y,
    request.public
  );

  if (request.confirmation !== expectedConfirmation) {
    return { ready: false, reason: 'confirmation-mismatch' };
  }

  if (!rampart) {
    return { ready: false, reason: 'rampart-missing' };
  }

  if (!owned) {
    return { ready: false, reason: 'not-owner' };
  }

  if (rampart.structureType !== STRUCTURE_RAMPART) {
    return { ready: false, reason: 'type-mismatch' };
  }

  if (rampart.pos.roomName !== request.roomName) {
    return { ready: false, reason: 'room-mismatch' };
  }

  if (
    rampart.pos.x !== request.x
    || rampart.pos.y !== request.y
  ) {
    return { ready: false, reason: 'position-mismatch' };
  }

  if (rampart.isPublic === request.public) {
    return { ready: false, reason: 'state-already-matches' };
  }

  return { ready: true, reason: 'ready' };
}

function handleRampartPublicRequest() {
  const request = Memory.rampartPublicRequest;

  if (!request || request.enabled !== true) {
    return;
  }

  const rampart = typeof request.rampartId === 'string'
    ? Game.getObjectById(request.rampartId)
    : null;
  const owned = Boolean(
    rampart
    && Game.structures[rampart.id]
  );
  const plan = evaluateRampartRequest({
    request,
    rampart,
    owned
  });

  if (!plan.ready) {
    request.enabled = false;
    request.status = `precheck-${plan.reason}`;
    request.checkedAt = Game.time;
    return;
  }

  request.enabled = false;
  request.status = 'submitted';
  request.submittedAt = Game.time;
  request.snapshot = {
    rampartId: rampart.id,
    roomName: rampart.pos.roomName,
    x: rampart.pos.x,
    y: rampart.pos.y,
    beforePublic: rampart.isPublic,
    requestedPublic: request.public
  };

  const result = rampart.setPublic(request.public);

  request.result = result;
  request.resultAt = Game.time;
  request.status = result === OK
    ? 'accepted'
    : 'failed-review-required';

  console.log({
    type: 'rampart-public-result',
    rampartId: rampart.id,
    roomName: rampart.pos.roomName,
    x: rampart.pos.x,
    y: rampart.pos.y,
    requestedPublic: request.public,
    result
  });
}

module.exports.loop = function () {
  handleRampartPublicRequest();
};

为什么状态已经一致时也关闭请求

如果Rampart已经处于目标状态，再次调用没有业务价值。

请求可能来自旧配置，也可能已经被其他模块处理。示例记录：

precheck-state-already-matches

并停止继续执行，避免每tick重复检查。

为什么调用前关闭请求

公开Rampart可能让陌生玩家Creep进入原本受阻的区域。请求必须只消费一次。

示例在调用前将 enabled 设为 false，无论返回成功还是失败，下一tick都不会自动重复。失败后必须人工检查Rampart、目标状态和返回值，再明确提交新请求。

官方返回值

返回值	官方含义	优先检查
`OK`	状态切换已安排	下一tick重新读取 `isPublic`
`ERR_NOT_OWNER`	Rampart不是自己的	ID、`Game.structures`与所有权

setPublic()不消耗Energy，也没有距离要求。不要把Creep动作的资源或范围返回码复制到本文。

下一tick怎样核对

const rampart = Game.getObjectById(
  Memory.rampartPublicRequest.rampartId
);

console.log({
  rampartId: rampart?.id,
  isPublic: rampart?.isPublic
});

需要重新取得当前对象。不要继续使用上一tick保存的Rampart引用。

公开Rampart不等于安全访客通道

单个布尔状态无法表达：

只允许某个玩家；
只允许某个房间；
只允许没有战斗部件的单位；
只开放指定时间；
发现攻击行为后自动关闭；
与Safe Mode状态联动。

这些需求需要额外调度逻辑。最基础的安全做法是默认私有，仅在明确用途下临时公开，并把恢复私有作为单独任务。

与Rampart保护能力的关系

公开状态主要影响其他玩家Creep能否通过。它不会让Rampart变成其他玩家的建筑，也不会自动删除覆盖在同一格的己方结构保护关系。

但一旦允许通行，敌对单位可能进入原本无法到达的位置。是否公开属于防御策略，而不是纯UI设置。

离线模拟结果

构建检查覆盖：

请求未启用；
参数或确认词错误；
Rampart ID无法恢复；
对象不属于 Game.structures；
结构类型不是Rampart；
房间名不一致；
坐标不一致；
当前状态已经等于目标状态；
全部字段一致时允许提交。

离线模拟没有调用真实 setPublic()，也没有模拟其他玩家单位通行。

常见误区

把公开状态当成盟友名单

setPublic(true)不区分玩家。

只按房间找第一座Rampart

房间通常有很多Rampart，必须使用明确ID和位置。

每tick根据一个布尔配置重复调用

只在状态变化且请求经过确认时执行。

复制无关的Energy和距离检查

此方法只有所有权相关错误。

返回 `OK` 后同tick读取旧状态

应在下一tick重新取得对象。

公开后忘记恢复私有

临时通道应有独立关闭流程，不能依赖记忆。

适用边界

本文没有实现：

玩家级白名单；
访客时间窗口；
自动外交规则；
行为检测后关闭；
多Rampart通道编组；
Safe Mode联动；
路径级访问控制；
公开状态历史审计。

JavaScript语法和请求匹配离线模拟已经通过。真实状态切换和其他玩家通行仍待Screeps环境验证。

官方资料

资料核对日期：2026-07-22。离线请求匹配已通过；真实公开状态切换仍待Screeps环境验证。

StructureRampart.setPublic() 怎么安全切换通行状态

最重要的安全边界

先做只读查询

目标绑定确认词

可离线测试的计划函数

完整示例

为什么状态已经一致时也关闭请求

为什么调用前关闭请求

官方返回值

下一tick怎样核对

公开Rampart不等于安全访客通道

与Rampart保护能力的关系

离线模拟结果

常见误区

把公开状态当成盟友名单

只按房间找第一座Rampart

每tick根据一个布尔配置重复调用

复制无关的Energy和距离检查

返回 `OK` 后同tick读取旧状态

公开后忘记恢复私有

适用边界

相关站内内容

官方资料

这篇文章解决了你的问题吗？

继续学习建设与防御

最重要的安全边界

先做只读查询

目标绑定确认词

可离线测试的计划函数

完整示例

为什么状态已经一致时也关闭请求

为什么调用前关闭请求

官方返回值

下一tick怎样核对

公开Rampart不等于安全访客通道

与Rampart保护能力的关系

离线模拟结果

常见误区

把公开状态当成盟友名单

只按房间找第一座Rampart

每tick根据一个布尔配置重复调用

复制无关的Energy和距离检查

返回 OK 后同tick读取旧状态

公开后忘记恢复私有

适用边界

相关站内内容

官方资料

这篇文章解决了你的问题吗？

继续阅读

继续学习建设与防御

返回 `OK` 后同tick读取旧状态