领域控制

Realm Control 为世界方块、结构与生物群系生成、信标区域以及传送授权提供可视化管理。用它来塑造整合包的未来地形、配置信标基础设施，并让玩家以受控方式访问传送命令。

安装与访问

当前构建目标：Minecraft 1.20.1、Forge 47.4.2+ 和 KineticCore 26.9.20+。 在多人游戏中使用时，请在客户端和服务端都安装 Realm Control 和 KineticCore。 可选：Jade 11.0.0+ 用于显示信标信息。 进入世界，按 F6，在 KineticCore 中选择 Realm Control。该按键可在控制中配置。 全局服务器设置和世界生成编辑器需要权限等级 2。单个信标控制也会在适用时强制检查所有权。

世界方块生成与替换

世界方块模块为生成禁用、固定替换和加权替换提供了专用编辑器。

生成禁用：选择确切的方块，或创建方块标签/模组规则，以在生成期间排除匹配的方块。 固定替换：选择一个或多个源方块，点击完成，然后选择最终目标方块。 加权替换：选择一个源方块和若干目标方块，然后为每个目标分配一个正权重。目标的份额为其权重除以总权重。 替换概率和目标权重用途不同：概率决定是否发生替换，而权重在一次成功的替换判定后选择目标。 在大型整合包中，使用源/目标组和搜索来管理重复的矿石或其他生成的方块。 例如，加权规则可以将源方块替换为石头和深板岩，权重分别为 3 和 1。在成功的替换中，它们的份额为 75% 和 25%；这些份额不会替代规则自身的替换概率设置。

已保存的方块规则会影响后续生成。现有地形仅由下文所述的独立已加载区块替换功能处理。

已加载区块中的可选一次性替换

固定替换和加权替换各自拥有独立的已加载区块开关。两者默认关闭。

启用任一开关仅在完整游戏/服务端进程重启后生效。保存或 /kt reload 无法实时注册或注销此功能。 在启动时启用后，旧区块会在加载时排队，并每刻最多处理一个区块。 每个区块处理完成后会被标记，固定替换和加权替换分别标记。更改规则不会自动重新扫描已完成该规则类型的区块。 该操作使用方块内容，而非方块是否由玩家放置的记录。因此，现有建筑中的匹配方块也可能被更改。 此功能不会重新生成结构或替换现有地形中已存储的生物群系。 当现有地形需要迁移时使用此开关，并在启用前根据世界检查源规则。如果启动时两个开关均关闭，则不会安装区块扫描处理器和处理队列。

结构

结构编辑器会读取当前活动服务器注册表，并显示每个结构可用的生成参数。

禁用单个结构或更改其在结构集中的权重。 更改生成频率和盐值。 对于随机散布放置，调整间距、间隔以及线性/三角形散布类型。 对于同心环放置，调整距离、散布和数量。 恢复从服务器注册表捕获的启动默认值。 使用编辑器的定位/传送工具检查已启用的结构；跨维度结构可能需要先切换维度。 放置设置属于共享的 StructureSet。编辑或恢复它们可能会影响同一集合中的同级结构。禁用一个候选项不会自动禁用其同级结构。

先点击全部保存，然后重新打开世界或重启服务器以应用生成更改。它们影响未来的区块；不会移动、移除或重新生成已存在的结构。刷新注册表列表会保留未保存的本地编辑。

生物群系

生物群系编辑器支持替换生物群系、替换由标签匹配的生物群系、移除匹配的气候条目，以及将规则限制到一个维度或所有维度。

源可以是生物群系 ID 或 #biome_tag；替换使用目标生物群系 ID。 规则可以针对特定维度，或使用 * 表示所有维度。 移除会将匹配条目从生物群系选择中排除，而不是将现有地形变为空白空间。 实现适用于 MultiNoiseBiomeSource 维度。它不适用于所有自定义生物群系源或原版独特的末地生物群系源。 如果移除操作会消除某个维度中的所有气候条目，该结果会被拒绝，而不是留下空的生物群系源。 保存生物群系规则并重新加载世界/重启服务器。新的生成会使用更新后的选择；已存储的区块生物群系保持生成时的状态。

如需手动编辑文件，条目使用 dimension|source|target，例如 minecraft:overworld|minecraft:desert|minecraft:plains。目标为 null 表示移除；可视化编辑器会为你处理此格式。

信标区域

打开活动信标的界面，配置其区块加载和生成阻止控制，然后点击应用设置。

启用区块加载并在信标等级限制内选择半径。半径 0 覆盖 1×1 区块；半径 1 覆盖 3×3。本地值 -1 选择当前等级的最大值。 设置单独的生成阻止半径，并将目标设为所有实体、敌对实体或被动实体。 将拦截代码留空以使用全局规则，或为特定生成来源提供代码。 全局列表允许或阻止选定的实体 ID。在适用的保护区域/目标类别中，允许列表会先于阻止列表检查。 全局和可选的按所有者配额会统计跨维度的唯一强制加载区块。 离线设置控制缺席所有者的信标何时失去效果、区块加载或生成阻止。 范围渲染、配额信息和可选的 Jade 详情有助于检查信标覆盖范围。 拦截代码：A 自然，B 转换，C 命令，D 蛋/桶/发射器，E 刷怪笼，F 召唤，G 事件/增援，H 繁殖。如果没有本地代码或针对实体的全局规则，默认拦截为自然生成。

生成的默认值使用等级半径 [0, 1, 2, 3]、全局限制 500 个区块，以及离线超时 4320 分钟。每玩家配额最初禁用。超时 0 表示立即；-1 禁用超时。已保存的拦截规则会立即更新；已加载的信标半径、配额和离线状态可能需要更新信标或重新加载世界。

传送授权与命令

传送模块更改原版 /tp 和 /teleport。FREE 模式允许玩家无限制使用；AUTHORIZED 模式需要剩余使用次数或未过期的定时授权。主开关可禁用该修改。受这些限制约束的已授权玩家可以传送自己，而非其他实体。

管理员绕过通常豁免权限等级 2+。如果禁用，等级 2 也需要授权；等级 3 和 4 仍然绕过。自定义拒绝消息支持 & 颜色和 {player}。

命令 用途 / 访问权限 /kt world help 结构命令帮助 /kt world structure 检查玩家所在位置的结构 /kt world list-structures 列出已注册的结构；等级 2 /kt tpd 检查你自己的传送授权 /kt tpd help 传送授权帮助 /kt tpd allow count <players> <amount> 添加传送使用次数；等级 2 /kt tpd allow time <players> <seconds> 添加定时授权；等级 2 /kt tpd check <player> 检查另一名玩家的授权；等级 2 /kt tpd clear <players> 清除使用次数和定时授权；等级 2 /kt reload 重新加载已注册的模块配置；等级 2 例如，/kt tpd allow count Alex 3 添加三次使用，/kt tpd allow time Alex 300 授予五分钟。次数会添加到现有使用次数中；时间会在当前过期时间尚未过期时延长。定时授权使用实际经过时间。

文件与应用范围

config/kineticcore/ 下的文件 内容 / 应用 worldblock.json 方块禁用、固定/加权目标、概率、仅启动时生效的已加载区块开关 worldblock.old.json 世界方块规则的配套备份 worldgen.toml 结构和生物群系规则；在世界/服务器启动时应用 beacon.toml 全局信标行为、配额和离线规则 teleport.toml 传送模式、绕过、主开关和拒绝消息 世界数据存储信标区块加载状态和一次性区块重写标记。传送授权是玩家数据。/kt reload 会重新加载已注册的方块、世界生成和传送配置；它不会重新创建已运行世界的生成设置，也不能替代已加载区块模式的完整重启。

项目

模组 ID：realmcontrol。作者：XYAT。许可证：LGPLv3。实现：源码。声明的依赖：mods.toml。