Admin Portals

Admin Portals

Create customizable portals that execute commands when players enter or interact with them

1.1 тысяча загрузок
Обновлён 7 дней назад

Скриншоты

Описание

HiWire - AdminPortals

Пользовательский модуль управления порталом для однопользовательского и многопользовательского Hytale от HiWire Studio

 

Нужно ли телепортировать игроков в другой мир, когда они взаимодействуют с порталом? Проверьте наш другой мод - команда по умолчанию /tp не может этого сделать:

TP2World

Особенности

  • Конфигурируемые порталы Размещайте портальные блоки, которые выполняют команды, когда игроки взаимодействуют с ними.
  • Несколько портовых стилей Выбор между забытым храмом (синий) и пустым (пурпурный) вариантами портала
  • Режимы выполнения команд Выполнять команды как сервер или как взаимодействующий плеер
  • Динамические держатели - Используйте заполнители в командах для вставки данных о плеере/локации
  • Маркеры карт - Опционально отображать порталы на карте мира с пользовательскими значками и этикетками
  • многоязычный Поддерживает английский (en-US), немецкий (de-DE) и многие другие (если добавлено)
  • настраиваемый Переопределить переводы, определения пользовательского интерфейса и активы

Требования

  • Hytale или Hytale Server
  • Java 25

установка

Использование CurseForge App

Самый простой способ установки модов - через Приложение CurseForge, который обрабатывает установку и обновления автоматически.

Ручная установка

  1. Скачать файл Mod JAR
  2. Поместите его в каталог модов:
    • Windows: %appdata%\Hytale\UserData\Mods
    • Мак: • Библиотека/Поддержка приложений/Hytale/UserData/Mods
    • Linux (Flatpak): ~/.var/app/com.hypixel.HytaleLauncher/data/Hytale/UserData/Mods
    • Выделенный сервер: Моды папка в каталоге вашего сервера
  3. Перезагрузить игру или сервер

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


командование

Командование Описание исполнитель Разрешение
/админпорталы Корневая команда для AdminPortals Любой hiwire.adminportals.command.adminportals
/adminportals configmode Команды режима конфигурации Любой hiwire.adminportals.command.adminportals.configmode
/adminportals configmode toggle Режим настройки Toggle для себя Только игрок hiwire.adminportals.command.adminportals.configmode.toggle
/adminportals placeholder Команды по управлению держателями Любой hiwire.adminportals.command.adminportals.placeholder
/adminportals placeholder list Перечислить всех зарегистрированных владельцев Любой hiwire.adminportals.command.adminportals.placeholder.list

 

Разрешения

Чтобы получить разрешение, см. командование Стол сверху.

Разрешение Описание
hiwire.adminportals.portal.config.view Откройте UI конфигурации портала
hiwire.adminportals.portal.config.edit Сохранить изменения в конфигурации портала

 

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

Введите конфигурацию Режим

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

/adminportals configmode toggle

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

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

Portal Configuration UI

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

Вариант Описание
Тип Тип конфигурации. В настоящее время поддерживается только «командный» тип
Командование Команда для выполнения, когда игрок взаимодействует или проходит через портал
Исполнять как сервер - запускает команду как консоль / CommandSender; Игрок - запускает команду как взаимодействующий игрок
Map Marker Текст Факультативная этикетка, отображаемая на карте мира и компасе
Иконка Map Marker Имя файла иконки из активов сервера для маркера карты (по умолчанию: Warp-png)
Звук телепортации Идентификатор звукового эффекта для игры при активации портала. Оставьте пустой звук без звука (по умолчанию): SFX_Portal_Neutral_Teleport_Local)

 

Маркеры карт

Когда вы создаете портал с Map Marker ТекстПортал будет отображаться на карте мира и компасе, что облегчает поиск игроков.

Маркер портала на карте мира:

Portal on Map

Портальный маркер на компасе:

Portal on Compass


держатели мест

Используйте эти заполнители в командах портала. Они заменяются фактическими значениями при активации портала.

владелец Описание
[Имя пользователя] Имя пользователя игрока, активирующего портал
{PlayerUuid} UUID игрока, активирующего портал
{PosX} X координата блока портала
Позиция Y координата блока портала
{PosZ} Z координата блока портала
(Всемирное имя) Название мира, содержащее портал

 

Примеры команд

Исполняется как сервер / отправитель команд:

tp {PlayerUsername} 100 64 200
Скажем, Player {PlayerUsername} ({PlayerUuid}) вошел на портал ({PosX}, {PosY}, {PosZ}) в мире {WorldName}

Выполнено в качестве игрока:

нерест


Портальные блоки

All Portal Types

Портальные блоки можно найти в творческом инвентаре под Блоки > порталы.

Использование порталов

Игроки могут активировать настроенный портал двумя способами:

  • Прогулка через Порталы Hitbox
  • взаимодействующий с порталом с помощью интерактивного ключа

Portal Interact Prompt

Если портал еще не настроен, игрок получит сообщение в чате, указывающее, что портал не настроен.

Портальная база (Two-Piece Setup)

База портала — это декоративная площадка, которая служит основой для портальных эффектов. Портальные базовые порталы вертикально смещены, чтобы идеально сидеть поверх базы.

  • HiWire_AdminPortals_PortalBase - Базовая площадка
  • HiWire_AdminPortals_PortalBase_Portal_ForgottenTemple Синий эффект портала (предназначен для сидения на базе)
  • HiWire_AdminPortals_PortalBase_Portal_Void Фиолетовый эффект портала (предназначен для сидения на базе)

Автономные порталы

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

  • HiWire_AdminPortals_StandalonePortal_ForgottenTemple - Синий автономный портал
  • HiWire_AdminPortals_StandalonePortal_Void - Пурпурный автономный портал

кастомизация

Мод поддерживает переопределения пользователей для переводов, определений пользовательского интерфейса и активов. Поместите свои настройки в папку данных мода под /overrides.

Файлы перевода

Мод использует файлы перевода, расположенные в /Server/Languages/{language}/HiWire/AdminPortals/:

  • Пункты.lang - Названия и описания элементов портала
  • ChatMessages.lang - Уведомления чата и командные сообщения
  • UI.lang - Ярлыки пользовательского интерфейса

Файлы перевода со всеми ключами создаются и автоматически обновляются. mods/HiWire_AdminPortals/override/Server/Languages/{language}/HiWire/AdminPortals/. Редактируйте эти файлы для настройки переводов без изменения исходных файлов модов.

Пользовательские держатели

Разработчики модов могут регистрировать пользовательские заполнители, получая доступ к менеджер по месту размещения:

PluginManager.get(.getPlugin) (новый PluginIdentifier("HiWire", "AdminPortals"));
если (пример плагина AdminPortalsPlugin) {
Final var placeholderManager = adminPortalsPlugin.getPlaceholderManager();

// Зарегистрируйте простой заполнитель. Можно использовать с {ServerName}
placeholderManager.register («Имя сервера», ctx -> «Мой сервер»);

// Регистрация заполнителя с использованием контекстных данных
placeholderManager.register("PlayerHealth", ctx ->) {
Финальный вар игрок Ref = ctx.playerRef();
Окончательное состояние здоровья = // Здоровье игрока через игрока Ref
Возвращение String.valueOf (здоровье);
}
?

The PlaceholderКонтекст обеспечивает доступ к:

  • PlayerRef() - Игрок активирует портал
  • Мир() - Мир, содержащий портал
  • Пос() Положение блока (Vector3i)
  • PortalConfig() - Конфигурация портала
  • itemStack() - Элемент, используемый для взаимодействия (отменяемый)
  • Взаимодействие Тип() - Тип взаимодействия
  • ВзаимодействиеКонтекст() Дополнительный контекст взаимодействия

Лицензия

МТИ Лицензия

Авторское право 2026 HiWire Studio

Настоящим предоставляется бесплатно любому лицу, получающему копию этого программного обеспечения и связанных с ним файлов документации («Программное обеспечение»), для работы с Программным обеспечением без ограничений, включая без ограничений права на использование, копирование, изменение, слияние, публикацию, распространение, сублицензию и / или продажу копий Программного обеспечения, и разрешать лицам, которым предоставляется Программное обеспечение, делать это при соблюдении следующих условий:

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

ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ОБЕСПЕЧЕНИЕ ОБЕСПЕЧЕНИЕ ОБЕСПЕЧЕНИЕ ОБЕСПЕЧЕНИЕ ОБЕСПЕЧЕНИЕ ОБЕСПЕЧЕНИЕ ОБЕСПЕЧЕНИЕ ОБЕСПЕЧЕНИЕ ОБЕСПЕЧЕНИЕ ОБЕСПЕЧЕНИЕ ОБЕСПЕЧЕНИЯ В ЛЮБОЙ ДЕЯТЕЛЬНОСТИ, ВКЛЮЧЕНИЕ НО НЕ ОГРАНИЧЕНИЕ ВО ВРАЖЕНИЯХ ВЕРХОВНОСТИ, ДОСТУПНОСТИ ДЛЯ ЧАСТОЧНОЙ ЦЕЛЬ И НЕПРЕСТУПЛЕНИЯ. Ни при каких обстоятельствах государственные служащие или законные служащие не должны быть подсудны какому-либо преступлению, преследованию или иной ответственности, независимо от того, осуществляется ли договор, договор или иное действие, исходящее из или в связи с программным обеспечением или использованием или другими сделками в программном обеспечении.


Поддержка

  • Автор: HiWire-Nick
Показать оригинальное описание (English)

HiWire - AdminPortals

A custom portal management mod for Hytale single- and multiplayer by HiWire Studio

 

Need to teleport players to another world when they interact with a portal? Check out our other mod — the default /tp command can't do that:

TP2World

Features

  • Configurable Portals - Place portal blocks that execute commands when players interact with them
  • Multiple Portal Styles - Choose between Forgotten Temple (blue) and Void (purple) portal variants
  • Command Execution Modes - Execute commands as the server or as the interacting player
  • Dynamic Placeholders - Use placeholders in commands to insert player/location data
  • Map Markers - Optionally display portals on the world map with custom icons and labels
  • Multilingual - Supports English (en-US), German (de-DE) and many more (if added)
  • Customizable - Override translations, UI definitions, and assets

Requirements

  • Hytale or Hytale Server
  • Java 25

Installation

Using CurseForge App

The easiest way to install mods is via the CurseForge App, which handles installation and updates automatically.

Manual Installation

  1. Download the mod JAR file
  2. Place it in the mods directory:
    • Windows: %appdata%\Hytale\UserData\Mods
    • Mac: ~/Library/Application Support/Hytale/UserData/Mods
    • Linux (Flatpak): ~/.var/app/com.hypixel.HytaleLauncher/data/Hytale/UserData/Mods
    • Dedicated Server: /mods folder in your server directory
  3. Restart the game or server

Since Hytale uses a server internally for both singleplayer and multiplayer, this mod works in both modes.


Commands

Command Description Executor Permission
/adminportals Root command for AdminPortals Any hiwire.adminportals.command.adminportals
/adminportals configmode Configuration mode commands Any hiwire.adminportals.command.adminportals.configmode
/adminportals configmode toggle Toggle configuration mode for yourself Player only hiwire.adminportals.command.adminportals.configmode.toggle
/adminportals placeholder Placeholder management commands Any hiwire.adminportals.command.adminportals.placeholder
/adminportals placeholder list List all registered placeholders Any hiwire.adminportals.command.adminportals.placeholder.list

 

Permissions

For command permissions, see the Commands table above.

Permission Description
hiwire.adminportals.portal.config.view Open the portal configuration UI
hiwire.adminportals.portal.config.edit Save changes to the portal configuration

 

Configuration

Entering Configuration Mode

To configure portals, you must first enter configuration mode by running:

/adminportals configmode toggle

While in configuration mode, interacting with a portal block using the interact key will open the configuration UI. Run the command again to exit configuration mode.

Configuration UI

Portal Configuration UI

The configuration UI allows you to set the following options:

Option Description
Type The config type. Currently only the "Command" type is supported
Command The command to execute when the player is interacting with or walking through the portal
Execute As Server - runs the command as console / CommandSender; Player - runs the command as the interacting player
Map Marker Text Optional label displayed on the world map and compass
Map Marker Icon Icon filename from server assets for the map marker (default: Warp.png)
Teleport Sound Sound effect ID to play when the portal is activated. Leave empty for no sound (default: SFX_Portal_Neutral_Teleport_Local)

 

Map Markers

When you configure a portal with a Map Marker Text, the portal will be displayed on the world map and compass, making it easy for players to locate.

Portal marker on the world map:

Portal on Map

Portal marker on the compass:

Portal on Compass


Placeholders

Use these placeholders in portal commands. They are replaced with actual values when the portal is activated.

Placeholder Description
{PlayerUsername} Username of the player activating the portal
{PlayerUuid} UUID of the player activating the portal
{PosX} X coordinate of the portal block
{PosY} Y coordinate of the portal block
{PosZ} Z coordinate of the portal block
{WorldName} Name of the world containing the portal

 

Example Commands

Executed as server / command sender:

tp {PlayerUsername} 100 64 200
say Player {PlayerUsername} ({PlayerUuid}) has entered a portal at ({PosX}, {PosY}, {PosZ}) in world {WorldName}

Executed as player:

spawn


Portal Blocks

All Portal Types

Portal blocks can be found in the creative inventory under Blocks > Portals.

Using Portals

Players can activate a configured portal in two ways:

  • Walking through the portals hitbox
  • Interacting with the portal using the interact key

Portal Interact Prompt

If a portal has not been configured yet, the player will receive a chat message indicating that the portal is not configured.

Portal Base (Two-Piece Setup)

The Portal Base is a decorative pad that serves as a foundation for portal effects. The portal base portals are vertically offset to sit perfectly on top of the base.:

  • HiWire_AdminPortals_PortalBase - The base pad
  • HiWire_AdminPortals_PortalBase_Portal_ForgottenTemple - Blue portal effect (designed to sit on the base)
  • HiWire_AdminPortals_PortalBase_Portal_Void - Purple portal effect (designed to sit on the base)

Standalone Portals

Self-contained portal blocks that are aligned with the world grid. The bottom of the portal aligns with the block boundary, so they sit flush on the ground without floating like portals on top of a base.:

  • HiWire_AdminPortals_StandalonePortal_ForgottenTemple - Blue standalone portal
  • HiWire_AdminPortals_StandalonePortal_Void - Purple standalone portal

Customization

The mod supports user overrides for translations, UI definitions, and assets. Place your customizations in the mod's data folder under /overrides.

Translation Files

The mod uses translation files located in /Server/Languages/{language}/HiWire/AdminPortals/:

  • Items.lang - Portal item names and descriptions
  • ChatMessages.lang - Chat notifications and command messages
  • UI.lang - User interface labels

Translation files with all keys are created and automatically updated at mods/HiWire_AdminPortals/override/Server/Languages/{language}/HiWire/AdminPortals/. Edit these files to customize translations without modifying the original mod files.

Custom Placeholders

Mod developers can register custom placeholders by accessing the PlaceholderManager:

final var plugin = PluginManager.get().getPlugin(new PluginIdentifier("HiWire", "AdminPortals"));
if (plugin instanceof AdminPortalsPlugin adminPortalsPlugin) {
    final var placeholderManager = adminPortalsPlugin.getPlaceholderManager();

    // Register a simple placeholder. It can be used with {ServerName}
    placeholderManager.register("ServerName", ctx -> "My Server");

    // Register a placeholder using context data
    placeholderManager.register("PlayerHealth", ctx -> {
        final var playerRef = ctx.playerRef();
        final var health = // Get player health via playerRef
        return String.valueOf(health);
    });
}

The PlaceholderContext provides access to:

  • playerRef() - The player activating the portal
  • world() - The world containing the portal
  • pos() - The block position (Vector3i)
  • portalConfig() - The portal's configuration
  • itemStack() - The item used for interaction (nullable)
  • interactionType() - The type of interaction
  • interactionContext() - Additional interaction context

License

MIT License

Copyright (c) 2026 HiWire Studio

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


Support

  • Author: HiWire-Nick

Последние версии

hiwire-adminportals-mod-0.4.1.jar

Early Access 27.01.2026 71.9 КБ
Скачать

hiwire-adminportals-mod-0.4.0.jar

Early Access 22.01.2026 71.9 КБ
Скачать

hiwire-adminportals-mod-0.3.0.jar

Early Access 21.01.2026 70.5 КБ
Скачать

hiwire-adminportals-mod-0.2.1.jar

Early Access 20.01.2026 64.8 КБ
Скачать

hiwire-adminportals-mod-0.2.0.jar

Early Access 19.01.2026 65.4 КБ
Скачать