Disable Dimensions

Disable Dimensions

Труднообходимое, устойчивое к гриферству решение для запрета игрокам входить в Nether, The End и любые другие кастомные измерения, с опциональными условиями для каждого измерения.

Позволяет отключать измерения, перехватывая все известные способы входа в измерение и мгновенно возвращая игроков обратно. Каждое измерение можно отдельно включить или отключить, с опциональными условиями, которые переопределяют этот статус.

Идеально для ванильных и модифицированных мультиплеерных серверов, где вы хотите отключить дальнейшие измерения, чтобы игроки не прогрессировали слишком быстро.

Зачем использовать этот датапак/мод?

1. Единственное полное решение: Ни один другой датапак на данный момент не отключает The Nether, The End и другие кастомные измерения с опциональными условиями для каждого измерения для текущих версий Minecraft. Все старые устарели, сломаны или не имеют столько возможностей.
2. Всесторонний охват: Работает в любой ситуации. Для игроков во всех режимах игры, команд телепортации, эндер-жемчугов, вагонеток и многого другого. Игроки могут войти в порталы или телепортироваться, но мгновенно телепортируются обратно. Из Nether — к точке входа с запасным вариантом в виде спавна мира, а из The End — к точке возрождения или спавну мира. См. Особые случаи для нескольких сценариев, требующих ручной очистки.
3. Задуманная ванильная награда: Игроки, пытающиеся сменить измерение, всё равно получат ванильное достижение «вход в измерение» (для Nether или The End). Это сделано намеренно и служит небольшой наградой за попытку. И вы узнаете, кто пытался, проверив их достижения. Не волнуйтесь, их безопасно телепортирует обратно!
4. Атмосферная обратная связь: При телепортации обратно игроки видят короткое сообщение в action bar, слышат лёгкий звуковой сигнал и получают эффект замедления, делая опыт понятным и отзывчивым, но не навязчивым.
5. Гибкость и совместимость: Работает как глобальный мод или как датапак для конкретного мира, включает встроенную поддержку языков и полностью совместим с ванильными, модифицированными и кастомными настройками измерений прямо из коробки.
6. Готов к серверу: Создан надёжным, устойчивым к гриферству и полностью пассивным, без дополнительных накладных расходов через проверки по тикам. Идеально для публичных или полупубличных мультиплеерных серверов.
7. Динамическая конфигурация: Можно настраивать в реальном времени через игровую панель конфигурации, без перезагрузок и перезапусков.

TL;DR: Стабильный и лёгкий способ остановить нежелательные путешествия по измерениям, созданный просто работать.

Установка

После добавления датапака/мода в ваш мир или на сервер вы сможете открыть панель «о моде», полностью управляемую мышью:

/function disable_dimensions:about

Поддержка языков

Переведённый текст доступен для поддерживаемых языков. Это в основном предназначено для администраторов серверов, поскольку настраиваемые сообщения, показываемые игрокам, можно изменить в любом случае.

• Мод в одиночной игре: Включён автоматически и работает из коробки.
• Датапак или серверная установка: Переводы на стороне клиента. Для выделенного сервера, использующего только датапак, администратору нужен либо мод на своём клиенте, либо отдельный ресурспак, чтобы видеть переведённый текст интерфейса.

Чтобы добавить новые переводы, обратитесь к этому README.

Конфигурация

Откройте панель конфигурации следующей командой:

/function disable_dimensions:config

![config_panel](showcase/screenshots/config_panel.png)

Отсюда можно:

- Включать и выключать каждое измерение (`enabled` / `disabled`)
- Редактировать сообщение и цвет при возврате
- Добавлять и удалять условия, подробнее см. [Условия](#conditions)
- Добавлять свои измерения, руководство см. [Свои измерения](#custom-dimensions)
- Удалять записи измерений
- Сбрасывать записи измерений к значениям по умолчанию
- Задавать World Spawn, поддерживается любое измерение

> World Spawn по умолчанию существует, но перед использованием в продакшене **стоит** один раз задать его в нужном месте: встаньте туда и нажмите `Replace`.

### Условия

Условия могут перезаписывать текущий статус, если они истинны. С их помощью можно частично включать/отключать перемещение между измерениями после определённого времени, для конкретного игрового режима и так далее.

Каждое условие требует:

- `name`: Уникальное имя условия.
- `type`: Определяет, с чем сравнивается значение.
  - `advancement`: Проверяет достижения игрока. Значение — ID достижения.
  - `day`: Проверяет счётчик игровых дней. Значение — точное число дня.
  - `gamemode`: Проверяет текущий игровой режим игрока. Значение может быть `survival`, `creative`, `adventure` или `spectator`.
  - `gametime`: Проверяет, сколько времени работает мир. Значение указывается в тиках, так что используйте формулу вроде `day_count * 24 * 60 * 60 * 20` для дней. Это время идёт только пока мир запущен, поэтому простои сервера влияют на точность.
  - `item`: Проверяет предметы в инвентаре игрока. Значение — ID предмета с необязательным фильтром по компонентам, например `minecraft:diamond[count=64]`.
  - `score`: Проверяет очки игрока на табло. Значение использует формат `objective_name=score_value`, например `nether_entries=5`.
  - `tag`: Проверяет теги игрока. Можно выдавать игрокам свои теги, например `enter_nether`.
  - `team`: Проверяет команду игрока. Значение — имя команды, например `red_team`.
- `value`: Конкретное значение для проверки. Его формат зависит от выбранного типа.
- `disabled`: Значение `disabled`, которое перезаписывает текущий статус, если условие срабатывает.

> Если у вас несколько условий, достаточно, чтобы сработало только одно, чтобы перезаписать текущий статус.

> Избегайте условий, которые могут отменять друг друга, например двух условий, которые оба применяются к текущему игроку, при этом одно включает перемещение, а другое выключает. Это может привести к неожиданному поведению.

Вот три примера условий для `minecraft:the_nether`:

**Включить через три дня**

```mcfunction
/function disable_dimensions:config/dimension/condition/add {id:"minecraft:the_nether",name:"3d Enable",type:"gametime",value:"5184000", disabled:"false"}

Включить для creative

/function disable_dimensions:config/dimension/condition/add {id:"minecraft:the_nether",name:"Allow Creative",type:"gamemode",value:"creative", disabled:"false"}

Отключить через 7 игровых дней

/function disable_dimensions:config/dimension/condition/add {id:"minecraft:the_nether",name:"7d Disable",type:"day",value:"7", disabled:"true"}

Свои измерения

Чтобы заблокировать своё измерение, добавьте новую запись через панель конфигурации.

Каждая запись требует:

• name: Отображаемое имя записи. Используется для отображения в панели конфигурации и не должно быть пустым.
• id: Игровой идентификатор измерения, должен совпадать с идентификатором своего измерения.

• type: Определяет, как и куда игрок будет отправлен обратно.

  • nether_entered_pos: Отправляет игрока на позицию последнего входа в Nether. Действует только для The Nether.
  • respawn: Отправляет игрока на точку возрождения или на World Spawn, если она не задана. Используется для The End и других своих измерений.
• message_color: Цвет сообщения, показываемого игроку при возврате, используйте допустимые цвета текстовых компонентов.
• message_text: Текст сообщения, показываемого игроку при возврате.

Вот два примера добавления пользовательского измерения:

The Aether

/function disable_dimensions:config/dimension/add {name: "The Aether", id: "aether:the_aether", type: "respawn", message_color: "aqua", message_text:"A radiant force from the heavens bars your ascent..."}

ATM10 - The Other

/function disable_dimensions:config/dimension/add {name: "The Other", id: "allthemodium:the_other", type: "respawn", message_color: "dark_purple", message_text:"A mysterious force from The Other prevents your entry..."}

Только для сервера

Панель конфигурации будет доступна только когда вы физически подключены к серверу и имеете op.

Чтобы настроить датапак/мод, вы можете использовать команды конфигурации, применяемые панелью конфигурации, напрямую в терминале сервера следующим образом:

• Измерения

  • Добавить запись: function disable_dimensions:config/dimension/add {name: "", id: "", type: "", message_color: "", message_text:""}
  • Включить: function disable_dimensions:config/dimension/enable {id: ""}
  • Отключить: function disable_dimensions:config/dimension/disable {id: ""}
  • Изменить сообщение: function disable_dimensions:config/dimension/message {id: "", message_color: "", message_text:""}
  • Удалить запись: function disable_dimensions:config/dimension/remove {id: ""}
  • Сбросить записи: function disable_dimensions:config/dimension/reset

• Условия

  • Добавить: function disable_dimensions:config/dimension/condition/add {id:"",name:"",type:"",value:"", disabled:"false"}
  • Включить: function disable_dimensions:config/dimension/condition/enable {id:"", name:""}
  • Отключить: function disable_dimensions:config/dimension/condition/disable {id:"", name:""}
  • Изменить: function disable_dimensions:config/dimension/condition/edit {id:"", name:"", type:"", value:""}"
  • Удалить: function disable_dimensions:config/dimension/condition/remove {id:"", name:""}

• Точка возрождения мира:

  • Установить: Невозможно, так как требуется физическое присутствие в нужном месте

id — это идентификатор измерения из игры. Для The Nether это {id: "minecraft:the_nether"}, а для The End — {id: "minecraft:the_end"}.

Особые случаи

Этот датапак/мод намеренно построен на событиях, и есть несколько редких переходов, требующих ручной очистки или приводящих к поведению, отличному от ожидаемого:

1. Возрождение в отключённом измерении: Если точка возрождения, установленная через якорь возрождения или команду spawnpoint, находится внутри измерения, которое позже было отключено, игрок продолжит возрождаться там, пока точка возрождения не будет очищена или сброшена.
2. Уже внутри при отключении: Игроки, которые уже находятся в The Nether, The End или пользовательском измерении в момент его отключения, останутся там, пока не сменят измерение. При необходимости телепортируйте их наружу.
3. Ограничения возрождения в пользовательских измерениях: Пользовательские измерения вроде The Aether могут добавлять новые механики возрождения, но они отклоняются, так как зависят от пользовательских измерений или блоков.

Демонстрация

«Прохождение» через портал в Nether

Бросок эндер-жемчуга в портал в Nether

Телепортация в The Nether

«Прохождение» через портал в End

Бросок Ender Pearl в End Portal

Телепортация в The End

Участие и проблемы

Я рад:

• Сообщениям об ошибках
• Предложениям по функциям
• Pull request'ам

Пожалуйста, открывайте issues или PR на GitHub.

Лицензия

Этот проект распространяется под лицензией LGPLv3. Подробности см. в LICENSE.