Admin Portals
Create customizable portals that execute commands when players enter or interact with them
Описание
HiWire - AdminPortals
Пользовательский модуль управления порталом для однопользовательского и многопользовательского Hytale от HiWire Studio

Нужно ли телепортировать игроков в другой мир, когда они взаимодействуют с порталом? Проверьте наш другой мод - команда по умолчанию /tp не может этого сделать:
TP2World
Особенности
- Конфигурируемые порталы Размещайте портальные блоки, которые выполняют команды, когда игроки взаимодействуют с ними.
- Несколько портовых стилей Выбор между забытым храмом (синий) и пустым (пурпурный) вариантами портала
- Режимы выполнения команд Выполнять команды как сервер или как взаимодействующий плеер
- Динамические держатели - Используйте заполнители в командах для вставки данных о плеере/локации
- Маркеры карт - Опционально отображать порталы на карте мира с пользовательскими значками и этикетками
- многоязычный Поддерживает английский (en-US), немецкий (de-DE) и многие другие (если добавлено)
- настраиваемый Переопределить переводы, определения пользовательского интерфейса и активы
Требования
- Hytale или Hytale Server
- Java 25
установка
Использование CurseForge App
Самый простой способ установки модов - через Приложение CurseForge, который обрабатывает установку и обновления автоматически.
Ручная установка
- Скачать файл Mod JAR
- Поместите его в каталог модов:
- Windows:
%appdata%\Hytale\UserData\Mods - Мак:
• Библиотека/Поддержка приложений/Hytale/UserData/Mods - Linux (Flatpak):
~/.var/app/com.hypixel.HytaleLauncher/data/Hytale/UserData/Mods - Выделенный сервер:
Модыпапка в каталоге вашего сервера
- Windows:
- Перезагрузить игру или сервер
С тех пор 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

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

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

держатели мест
Используйте эти заполнители в командах портала. Они заменяются фактическими значениями при активации портала.
| владелец | Описание |
|---|---|
[Имя пользователя] |
Имя пользователя игрока, активирующего портал |
{PlayerUuid} |
UUID игрока, активирующего портал |
{PosX} |
X координата блока портала |
Позиция |
Y координата блока портала |
{PosZ} |
Z координата блока портала |
(Всемирное имя) |
Название мира, содержащее портал |
Примеры команд
Исполняется как сервер / отправитель команд:
tp {PlayerUsername} 100 64 200
Скажем, Player {PlayerUsername} ({PlayerUuid}) вошел на портал ({PosX}, {PosY}, {PosZ}) в мире {WorldName}
Выполнено в качестве игрока:
нерест
Портальные блоки

Портальные блоки можно найти в творческом инвентаре под Блоки > порталы.
Использование порталов
Игроки могут активировать настроенный портал двумя способами:
- Прогулка через Порталы Hitbox
- взаимодействующий с порталом с помощью интерактивного ключа

Если портал еще не настроен, игрок получит сообщение в чате, указывающее, что портал не настроен.
Портальная база (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
- Download the mod JAR file
- 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:
/modsfolder in your server directory
- Windows:
- 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

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 marker on the 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

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

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 padHiWire_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 portalHiWire_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 descriptionsChatMessages.lang- Chat notifications and command messagesUI.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 portalworld()- The world containing the portalpos()- The block position (Vector3i)portalConfig()- The portal's configurationitemStack()- The item used for interaction (nullable)interactionType()- The type of interactioninteractionContext()- 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
hiwire-adminportals-mod-0.4.0.jar
hiwire-adminportals-mod-0.3.0.jar
hiwire-adminportals-mod-0.2.1.jar
hiwire-adminportals-mod-0.2.0.jar
Информация
Авторы:
Категории:
Версии игры:
Создан: 19.01.2026