Dimension Bridge (Дименшен бридж)

Мод для Майнкрафт на Fabric, который вместе с плагином для Velocity безопасно переводит игроков между серверами сети. Он подходит для порталов, переходов между измерениями, лобби, меню и других механизмов на командных блоках: обычным игрокам не нужны команда /server и права на переход.

Возможности

• Переводит игроков с Fabric-сервера на зарегистрированный сервер Velocity по запросу командного блока, консоли или источника с уровнем команд не ниже 2.
• Проверяет сервер-источник, сервер назначения, версию протокола клиента, задержку между переходами и срок действия разрешения.
• Позволяет строить маршруты между серверами: например, из лобби отправлять в игровые миры, а из мира разрешить только возвращение в лобби.
• Ограничивает доступ к серверу по версии клиента. Игрок увидит и сможет использовать только подходящие для его протокола направления.
• Защищает серверы с параметром protected=true от прямого подключения через /server: попасть на них можно только одобренным переходом.

Как пользоваться

Для перевода используется команда:

/dimensionbridge transfer <цели> <имя_сервера_Velocity>

В командном блоке слеш не нужен. Пример перехода ближайшего игрока в сервер hauptwelt:

dimensionbridge transfer @p[distance=..3,limit=1,sort=nearest] hauptwelt

Пример возврата ближайшего игрока в лобби:

dimensionbridge transfer @p[distance=..3,limit=1,sort=nearest] lobby

Команду можно сочетать с селекторами, тегами и таблицами счёта: например, отправлять игроков только из зоны портала или не переводить участника боя. Для задержки перед переходом подойдут обычные командные блоки, эффекты частиц и значения scoreboard.

Административные команды Velocity:

• /dimensionbridge или /db — справка;
• /dimensionbridge reload — перечитать конфигурацию Velocity;
• /dimensionbridge info — показать загруженные направления;
• /dimensionbridge protocol <игрок> — узнать имя протокола клиента для настройки ограничений.

Настройки

На каждом Fabric-сервере укажите разрешённые назначения в config/dimensionbridge-fabric.properties:

allowed-destinations=lobby,hauptwelt,hardcore

Значение * разрешает все корректные имена, но для закрытой сети лучше перечислять серверы явно. После изменения этого файла требуется перезапуск Fabric-сервера.

Основной файл прокси — plugins/dimensionbridge/dimensionbridge.properties. В нём настраиваются:

• initial-servers — серверы, доступные при первом входе;
• destinations — список направлений;
• destination.<имя>.protected — защита сервера от прямого перехода;
• destination.<имя>.allowed-sources — серверы, с которых разрешён переход;
• destination.<имя>.allowed-protocols — допустимые протоколы клиентов;
• cooldown-ms — задержка между запросами одного игрока;
• authorization-window-ms — время действия разрешения на переход;
• deny-unlisted-targets — запрет серверов, не перечисленных в настройках.

Имена серверов должны точно совпадать с записями в velocity.toml. Конфигурацию Velocity можно перечитать командой /dimensionbridge reload.

Требования и совместимость

Нужны обе части дополнения: серверный мод Fabric на каждом подключаемом сервере и плагин для прокси Velocity. На Fabric-серверах также требуются Fabric Loader, Fabric API и включённые командные блоки в server.properties:

enable-command-block=true

Клиентский мод игрокам не требуется. Для управления правами можно использовать LuckPerms.

Право dimensionbridge.admin открывает административные команды. dimensionbridge.bypass обходит проверки направлений, источника, протокола и авторизации, поэтому его стоит выдавать только доверенным администраторам. Обычным игрокам можно запретить velocity.command.server, чтобы переходы работали только через порталы и другие разрешённые механизмы.