AeternumCustomPortal

🌌 Configurable portals between dimensions, with automatic return portals and optional integration with 🌦️ AeternumSeasons.

Give your server portals their own identity

AeternumCustomPortal allows you to define how players access the worlds on your server. Choose the frame materials, activation item and activation method, authorized origin worlds, and destination through the portal-types.yaml file.

Create new portal types, enable or disable each one, and apply changes with /acp reload.

Mechanics

• Vertical portals with a complete 4×5 block frame, The corners can be ignored, just like a standard in-game portal.
• Horizontal portals with a 2×2 area of water or empty space can be surrounded by a border with flowers or other blocks/items.
• Activation by interaction item, projectile item, or dropped item, depending on the desired portal format.
• Automatic creation and linking of the return portal on the first traversal.
• Positioning based on corresponding coordinates and world scaling.
• Breakable structures: damaging the required blocks disables the portal.
• Protection checks with WorldGuard and GriefPrevention.
• Optional diagnostics for testing, restricted to server operators.

Examples that can be configured

Traditional:

🔥 Heat / Infernal Realm: Nether Wart Block frame, activated with flint and steel and linked to aeternum_heat.

Interaction item:

❄️ Frost Realm: A new Blue Ice frame, activated by interacting with quartz and linked to aeternum_frost. A way to require players to visit the Nether before accessing the dimension!

☁️ Aether-inspired: Glowstone frame activated with a water bucket, leading to a world chosen by the administrator.

Dropped item:

🌸 Twilight Forest-inspired: A water pool surrounded by moss blocks with flowers above them. Drop a diamond into the water to activate it. The water remains in place while particles indicate that the portal is active.

The examples depend on the configuration and require the destination world to already be loaded.

How does it work with AeternumSeasons?

This is an independent and unofficial addon. AeternumSeasons remains responsible for world generation, seasons, creatures, and the other gameplay systems. AeternumCustomPortal controls the portals and uses worlds that are already loaded.

The optional integration replaces portal handling performed by known AeternumSeasons listeners while preserving the other systems.

Future updates to the original plugin may require adjustments to this integration.

Portals can also be directed to worlds loaded by other world managers.

Languages

You can choose your language with /acp language <language>. The preference is saved individually for each player.

Available: en_US, es_ES, id_ID, it_IT, fr_FR, de_DE, pt_BR, ru_RU, pl_PL, vi_VN e tr_TR.

Installation

1. Place the JAR in the plugins folder and restart the server.

2. Configure the portals in plugins/AeternumCustomPortal/portal-types.yaml.

3. Make sure the destination worlds are already loaded.

4. Apply the changes with /acp reload.

By default, server operators can activate portals. To allow other players to activate them, grant aeternumcustomportal.portal.activate through your permissions manager.

Credits

Project created by Mrserluiz as an independent addon for AeternumSeasons.

The Aether and Twilight-style portal concepts are inspired by their respective mods.

Spoiler

Code developed with AI assistance.

AeternumCustomPortal

🌌Portais configuráveis entre dimensões, com retorno automático e integração opcional com 🌦️ AeternumSeasons.

Dê uma identidade própria aos portais do seu servidor

AeternumCustomPortal permite definir como os jogadores acessam os mundos do servidor. Escolha os materiais da estrutura, o item e a forma de ativação, os mundos de origem autorizados e o destino por meio do arquivo portal-types.yaml.

Crie novos tipos de portal, habilite ou desabilite cada um e aplique as alterações com /acp reload.

Mecânicas

• Portais verticais com moldura completa de 4×5 blocos, Os cantos podem ser ignorados como um portal normal do jogo.
• Portais horizontais com 2×2 blocos de água ou vazio podem ser cercados por uma borda com flores ou outros itens.
• Ativação por item de interação, item projétil ou item dropado, conforme o formato desejado.
• Criação e vinculação automática do portal de retorno na primeira travessia.
• Posicionamento baseado nas coordenadas correspondentes e na escala dos mundos.
• Estruturas quebráveis: danificar os blocos necessários desativa o portal.
• Verificações de proteção com WorldGuard e GriefPrevention.
• Diagnósticos opcionais para testes, restritos aos operadores.

Exemplos que podem ser configurados

Tradicional: 🔥 Heat / Infernal Realm: moldura de blocos de verruga do Nether, ativada com pederneira e direcionada para aeternum_heat.

Item de interação: ❄️ Frost Realm: nova moldura de gelo azul, ativada ao interagir com quartzo e direcionada para aeternum_frost. Uma forma de exigir que o jogador visite o Nether antes de acessar a dimensão!

☁️ Inspirado no Aether: moldura de glowstone ativada com um balde de água, levando a um mundo escolhido pelo administrador.

Item dropado: 🌸 Inspirado no Twilight Forest: piscina de água cercada por blocos de musgo com flores acima. Jogue um diamante na água para ativar. A água permanece no lugar, enquanto partículas indicam que o portal está funcionando.

Os exemplos dependem da configuração e de um mundo de destino já carregado.

Como funciona com AeternumSeasons?

Este é um addon independente e não oficial. O AeternumSeasons continua responsável pela geração dos mundos, estações, criaturas e demais sistemas de jogabilidade. AeternumCustomPortal controla os portais e utiliza os mundos que já estão carregados.

A integração opcional substitui o tratamento dos portais pelos listeners conhecidos do AeternumSeasons, preservando os demais sistemas. Atualizações futuras do plugin original podem exigir ajustes nessa integração.

Também é possível direcionar portais para mundos carregados por outros gerenciadores.

Idiomas

Pode escolher seu idioma com /acp language <idioma>. A preferência é salva individualmente.

Disponíveis: en_US, es_ES, id_ID, it_IT, fr_FR, de_DE, pt_BR, ru_RU, pl_PL, vi_VN e tr_TR.

Instalação

1. Coloque o JAR na pasta plugins e reinicie o servidor.
2. Configure os portais em plugins/AeternumCustomPortal/portal-types.yaml.
3. Confirme que os destinos já estão carregados.
4. Aplique as alterações com /acp reload.

Por padrão, operadores podem ativar portais. Para permitir que outros jogadores os ativem, conceda aeternumcustomportal.portal.activate pelo seu gerenciador de permissões.

Créditos

Projeto criado por Mrserluiz, como complemento independente ao AeternumSeasons. Os conceitos dos portais Aether e Twilight são inspirados nos respectivos mods.

Spoiler

Código desenvolvido com assistência de IA.