维度分离器

维度分离器

Minecraft Forge 模组(1.20.1),面向模组包制作者——限制哪些模组可以与哪些维度交互。通过简单的 JSON 配置,按维度阻止生物生成、战利品表、世界生成和物品使用。

游戏机制

维度分离器

本模组旨在分离哪些内容可以出现在哪个维度中。 已在 Minecraft 1.20.1 和 Forge 47.1.3+ 上测试通过。

它有什么作用?

我想搭建一个 RP 服务器,出于剧情设定,主世界中禁止一切“魔法”,但我很难阻止某些结构出现在主世界,同时又想让它们仍然出现在我的自定义维度中。

因此我尝试制作了这个模组来帮助我实现这一点。

它目前仍处于测试阶段,但你可以使用一个简单的 JSON 配置文件来告诉模组你究竟希望在哪个维度中允许哪些内容出现。

对于每个维度,你可以通过黑名单或白名单的方式屏蔽以下模组命名空间的内容:

  • 世界生成特性(矿石、植物、结构……)
  • 生物生成
  • 战利品表(箱子、生物掉落物……)
  • 物品使用(右键点击方块、空中或实体)
  • 结构生成

配置

配置文件位于 config/dimensionseparator.json。~~~~ 以下是一个示例:

{
    "dimensions": {
        "minecraft:overworld": {
            "mode": "blacklist",
            "bypassLevel": 2,
            "namespaces": ["ars_nouveau", "iceandfire"],
            "blacklistedIds": ["minecraft:zombie"],
            "whitelistedIds": ["ars_nouveau:bookwyrm_familiar"],
            "features": true,
            "mobs": true,
            "loot": true,
            "items": true,
            "structures": true
        }
    }
}

字段说明

字段 类型 描述
mode string "blacklist" 表示屏蔽所列模组,"whitelist" 表示仅允许所列模组
bypassLevel int 允许使用 /summon 召唤被屏蔽实体的最低管理员等级(-1 或省略 = 不设绕过)
namespaces string array 根据 mode 屏蔽或允许的模组 ID
blacklistedIds string array 无论 mode 如何都始终屏蔽的特定 ID(例如 "minecraft:zombie")
whitelistedIds string array 无论 mode 如何都始终允许的特定 ID(例如 "ars_nouveau:bookwyrm_familiar")
features boolean 屏蔽所列模组的世界生成特性(矿石、植物……)
mobs boolean 屏蔽所列模组的生物生成
loot boolean 屏蔽所列模组的战利品表(箱子、生物掉落物……)
items boolean 屏蔽所列模组的物品使用(右键)
structures boolean 屏蔽所列模组的结构生成

将某个类别设为 false 会禁用该类别的屏蔽,即使命名空间已被列出。

已知限制

  • 对被屏蔽结构的 /locate 命令会无限搜索而无结果。这是原版 Minecraft 在该维度中不存在匹配结构时的行为。
  • 客户端按键绑定(例如使用自定义按键打开模组的 GUI)不会被屏蔽——仅覆盖右键交互。实际上,无法与维度交互时打开界面是无害的。
  • 通过自定义按键绑定使用物品属于客户端行为,无法在服务端拦截。

兼容性

本模组使用 Mixins 和事件处理器,应与大多数 Forge 模组兼容。如果遇到冲突,请提交 issue。

问题与贡献

发现 bug 或有建议?请在 GitHub 上提交 issue。