Disable Dimensions Reimagined

禁用维度重构版

一种无缝且抗恶意破坏的解决方案，可阻止玩家进入下界、末地以及其他自定义维度，并可为每个维度设置可选的条件。

通过拦截传送，无缝阻止玩家和实体进入已禁用的维度。每个维度都可以独立enabled或disabled，并可设置可选的条件来覆盖该状态。

这是Disable Dimensions数据包/模组的官方后继版本，充分运用了 Minecraft 模组开发的全部能力。

非常适合需要禁用更多维度、防止玩家过快推进游戏进度的模组多人服务器。

为什么使用这个模组？

1. 高效：所有逻辑都直接以 Java 实现，并采用事件驱动方式，因此性能开销极低。
2. 全面覆盖：适用于所有玩家和实体（包括末影珍珠）、传送命令等。少数需要手动清理的情形请参阅边缘情况。
3. 沉浸式反馈：拦截传送时，玩家会看到简短的快捷栏消息、听到轻微的提示音，并受到缓慢效果，让整个过程清晰且响应及时。
4. 兼容灵活：开箱即用，全面兼容各种模组和自定义维度配置，并内置多语言支持。
5. 丰富的配置选项：可通过重载和切换命令实时调整，无需重启。也可以使用配置命令查看当前生效的配置。

简而言之：一种稳定、轻量、即装即用的方案，可阻止不需要的维度旅行。

工作原理

禁用维度后，模组会在传送发生前拦截传送事件。玩家或实体不会真正传送到被禁用的维度，玩家也会收到维度已被封锁的提示。

判断维度是否已禁用，依据的是配置中的disabled标记，以及可能覆盖该标记的可选条件。玩家或实体尝试传送时，模组会评估这些条件。

为确保抗恶意破坏能力和兼容性，模组还设有备用机制，会在玩家进入维度后触发。与前代版本类似，该机制会将玩家传送回出生点或进入位置（仅适用于下界）。

安装

将模组添加到世界或服务器后，你应该就能打开介绍面板，并可完全使用鼠标进行操作：

/ddr about

或

/disabledimensionsreimagined about

语言支持

支持的语言均提供了对应的翻译文本。这主要面向服务器管理员，因为向玩家显示的消息可以自定义。语言文件已打包在模组中，因此客户端也必须安装该模组，才能看到已翻译的命令文本。

如需添加新翻译，请参阅此 README。

配置

配置文件创建于：

./config/disable-dimensions-reimagined.json

默认内容：

{
  "dimensions": {
    "minecraft:the_nether": {
      "disabled": true,
      "message": {
        "text": "A sinister presence denies your passage...",
        "color": "dark_red"
      },
      "conditions": []
    },
    "minecraft:the_end": {
      "disabled": true,
      "message": {
        "text": "The End rejects your presence...",
        "color": "light_purple"
      },
      "conditions": []
    }
  }
}

这会默认禁用下界和末地，并为两者设置自定义消息。

结构

• dimensions：以维度标识符为键，以对应配置为值。

维度

添加格式为 namespace:id 的维度标识符后，可使用以下字段：

• disabled：该维度是否已禁用。
• message：玩家尝试进入该维度时显示的消息。
• conditions：条件数组，可覆盖 disabled 标记。

以下是两个自定义维度的示例：

天境

"aether:the_aether": {
  "disabled": true,
  "message": {
    "text": "A radiant force from the heavens bars your ascent...",
    "color": "aqua"
  },
  "conditions": []
}

ATM10 – The Other

"allthemodium:the_other": {
  "disabled": true,
  "message": {
    "text": "A mysterious force from The Other prevents your entry...",
    "color": "dark_purple"
  },
  "conditions": []
}

消息

消息包含以下字段：

• text：玩家尝试进入该维度时显示的文本。
• color：玩家尝试进入该维度时显示文本的颜色。颜色可以是任何有效的文本组件颜色。

条件

如果条件成立，就可以覆盖当前状态。你可以利用这些条件，在特定时间、特定游戏模式等情况下，部分启用或禁用维度传送。

每个条件都需要以下字段：

• type：指定要检查的值类型。
  • ADVANCEMENT：检查玩家的进度。值为进度 ID。
  • DAY：检查游戏内天数。值为至少需要达到的天数。
  • GAMEMODE：检查玩家当前的游戏模式。值可以是 survival、creative、adventure 或 spectator。
  • GAMETIME：检查世界已运行的时长。值以秒为单位，因此可以使用类似 day_count * 24 * 60 * 60 的公式来表示天数。只有在世界运行期间，这段时间才会增加，因此服务器停机时间会影响准确性。
  • ITEM：检查实体物品栏中的物品。值为物品 ID，可选地附带物品组件筛选条件，例如 minecraft:diamond[count=64]。
  • PLAYTIME：检查玩家的游戏时长。值以秒为单位，因此可以使用类似 hours * 60 * 60 的公式来表示小时数。只有玩家在线时，这段时间才会增加，因此离线时间不计入。
  • SCORE：检查实体的记分板分数。值采用 objective_name=score_value 格式，例如 nether_entries=5。
  • TAG：检查实体的标签。你可以为玩家添加自定义标签，例如 enter_nether。
  • TEAM：检查实体所属的队伍。值为队伍名称，例如 red_team。
• value：要检查的具体值。格式取决于所选类型。
• disabled：如果条件成立，用于覆盖当前状态的禁用值。

如果有多个条件，顺序很重要。条件会从上到下依次评估，第一个符合的条件会覆盖当前状态。

以下是三个条件示例：

三天后启用

{
  "type": "GAMETIME",
  "value": "259200",
  "disabled": false
}

创造模式下启用

{
  "type": "GAMEMODE",
  "value": "creative",
  "disabled": false
}

游戏内七天后禁用

{
  "type": "DAY",
  "value": "7",
  "disabled": true
}

当前配置

可以在游戏中使用以下命令查看当前配置：

/ddr config

或

/disabledimensionsreimagined config

截图显示了上面列出的默认配置。

重新加载

编辑配置文件后，无需重启即可通过运行以下命令应用更改：

/ddr reload

或

/disabledimensionsreimagined reload

如果配置无效，命令会报告错误，并保持之前有效的配置继续生效。

切换

每个已配置维度条目的基础状态可以在游戏内通过以下命令切换：

/ddr toggle <dimension_id>

或

/disabledimensionsreimagined toggle <dimension_id>

边缘情况

该模组主要拦截传送，但少数罕见的转换需要手动清理，或者可能表现得与预期不同：

1. 在已禁用维度中重生：如果通过重生锚、spawnpoint命令或世界出生点设置的重生点位于之后被禁用的维度内，玩家会继续在那里重生，直到重生点被清除或相应更新。
2. 禁用时已在其中：如果玩家在维度被禁用时已经身处下界、末地或自定义维度中，他们会留在那里，直到切换维度。如有需要，请将他们传送出去。

贡献与问题

我热烈欢迎：

• Bug 报告
• 功能请求
• 拉取请求

请在 GitHub 上提交 issue 或 PR。

许可证

本项目采用 LGPLv3 许可证授权。详情请参阅 LICENSE。