StarPortal Official Wiki
Wiki Oficial de StarPortal
Welcome to the technical documentation for StarPortal. This system provides a professional, player-managed portal network for your server, featuring balanced economy systems and high-tech defense mechanisms.
Bienvenido a la documentación técnica de StarPortal. Este sistema permite implementar una red de portales profesional gestionada por los propios jugadores, con sistemas de economía equilibrados y mecanismos de defensa avanzados.
Social Hub
Perfect for connecting communities.
Energy Based
Powered by Ender Pearls for a balanced economy.
Logística
Automated supply transport.
Portal Engineering
1. The Frame Construction
The frame is the structural backbone of the portal. It must be built exclusively using CRYING OBSIDIAN to ensure link stability.
El marco es el componente estructural del portal. Debe construirse exclusivamente con OBSIDIANA LLOROSA para garantizar la estabilidad del enlace.
2. The Central Core
Place a BEACON in the bottom-center of the 3x3 hole. To register the portal, simply RIGHT-CLICK the beacon once the frame is finished.
Coloca un BEACON (FARO) en el centro inferior del hueco 3x3. Para registrarlo, haz CLICK DERECHO una vez terminado el marco.
Dialing Device (DHD)
The DHD allows you to manage the destination and energy of the portal. Use a LECTERN (Atril) placed within 7 blocks of the Beacon.
El DHD permite gestionar el destino y la energía del portal. Usa un ATRIL (Lectern) colocado a menos de 7 bloques del Faro.
How to Link the DHD
- Ensure you have a registered portal (Beacon + Frame).
- Place a Lectern nearby.
- The system will automatically link it and message you: "DHD Linked".
- Right-click the Lectern to open the GUI.
- Asegúrate de tener un portal registrado (Faro + Marco).
- Coloca un Atril cerca.
- El sistema lo vinculará automáticamente y te dirá: "DHD vinculado".
- Haz clic derecho en el Atril para abrir el menú.
Iris Security System
The Iris is a dense protective shield that prevents entities and projectiles from crossing the portal event horizon.
El Iris es un escudo protector denso que evita que entidades y proyectiles crucen el horizonte de eventos del portal.
Installation
Requires 1 Netherite Block in your main hand. Accessible via the Portal Configuration Menu (Interact with the Beacon core).
Requiere 1 Bloque de Netherite en la mano principal. Accesible desde el Menú de Configuración del Portal (Interactúa con el Beacon/Núcleo).
Función
When active, the Iris pushes players back and deals contact damage. Entities are instantly disintegrated if damage is set high.
Cuando está activo, el Iris empuja a los jugadores y aplica daño por contacto. Las entidades son desintegradas al instante.
Admin Technical Reference (Config.yml)
This section provides a detailed technical breakdown of every variable in the config.yml. Use this to fine-tune your server's performance and economy.
Esta sección detalla el funcionamiento técnico de cada variable del archivo config.yml. Úsala para ajustar el rendimiento y el equilibrio económico del servidor.
| Config Key | Default | Technical Breakdown |
|---|---|---|
| SECTION: PORTAL SYSTEM | ||
language |
"en" |
Sets the global message file. |
charge-time-ticks |
60 |
Server ticks used for the sequence. |
duration-seconds |
120 |
Maximum operational window. |
dialing-cooldown-seconds |
30 |
Prevention mechanism for spam. |
periodic-interval-seconds |
30 |
Cycle time for energy checks. |
inactivity-shutdown-seconds |
10 |
Auto-kill link on inactivity. |
| SECTION: ECONOMY & COSTS | ||
initial-pearl-cost |
2 |
Upfront cost for same world links. |
periodic-pearl-cost |
1 |
Maintenance cost per cycle. |
interdimensional-initial-pearl-cost |
4 |
Penalty for cross-world links. |
max-pearl-balance |
64 |
Hard limit for energy storage. |
| SECTION: LIMITS & RADII | ||
lectern-distance |
7 |
Scanning radius for linking. |
min-distance |
20 |
Min blocks between cores. |
max-portals-per-player |
5 |
Ownership cap per player. |
| SECTION: IRIS SECURITY | ||
behavior-mode |
"NOTHING_PASSES" |
Teleportation behavior on Iris hit. |
contact-damage |
4.0 |
Hearts dealt on Iris contact. |
kill-damage |
1000.0 |
Damage for lethal teleportation. |
Personalización de Idiomas
All in-game messages, titles, and notifications are stored in plugins/StarPortal/languages/. You can customize en.yml or es.yml to translate the plugin to your own language or change the style of the messages.
Todos los mensajes, títulos y notificaciones del juego se encuentran en plugins/StarPortal/languages/. Puedes personalizar en.yml o es.yml para traducir el plugin a tu propio idioma o cambiar el estilo de los mensajes.
Interface Manual (GUI)
1. Panel de Control (DHD)
Datos de la Terminal
Marcado Manual
Destinos Guardados
Depósito Energía
Campo de Fuerza
2. Panel de Configuración (Núcleo)
Datos del Faro
Renombrar Portal
Sistema Iris
Lista Blanca Administrativa
Desmantelar Núcleo
Logistics & Entity Transport
StarPortal is designed for seamless inter-faction communication and supply management. The event horizon preserves the momentum and orientation of everything crossing it.
StarPortal está diseñado para la comunicación fluida entre facciones y la gestión de suministros. El horizonte de eventos preserva el impulso y la orientación de todo lo que lo cruza.
| Tipo de Entidad | Utilidad |
|---|---|
| Jugadores y Mobs | Viaje instantáneo. |
| Vagonetas (Todo tipo) | Líneas de suministros. |
| Proyectiles (Flechas/Perlas) | Interacción entre mundos. |
Permissions
| Permiso | Por Defecto | Descripción |
|---|---|---|
starportal.create |
ACTIVADO | Permite registrar y ser propietario de nuevos portales al interactuar con un Faro (Beacon). |
starportal.admin |
SOLO OP | Control administrativo total sobre todos los portales y configuraciones. |
starportal.list |
SOLO OP | Permite visualizar la lista de portales registrados mediante el comando. |
starportal.help |
SOLO OP | Permite el acceso a la interfaz de ayuda de comandos. |
starportal.reload |
SOLO OP | Habilidad para recargar la configuración y los mensajes del plugin. |
starportal.infinite |
DESACTIVADO | Ignora el límite máximo de portales por jugador. |
Privacy & Whitelist
StarPortal prioritizes your server's privacy. Connection and status messages are private by default, appearing only to the player initiating the link.
StarPortal prioriza la privacidad en tu servidor. Los mensajes de estado y marcado son privados por defecto, mostrándose únicamente al jugador que inicia la conexión.
Gestión de Lista Blanca
Matriz de Permisos
| Acción | General | Whitelist | Dueño |
|---|---|---|---|
| Marcar / Usar DHD | |||
| Recargar Energía (Perlas) | |||
| Configuración (Faro) | |||
| Renombrar Portal | |||
| Gestionar Iris / Protección | |||
| Gestión del DHD (Vincular/Romper) | |||
| Desmantelar Estructura | |||
| Gestionar Whitelist |
System Commands
/stp help - Show all available commands./stp list - List all existing addresses and their current pearl balance./stp reload - Reload plugin configuration and messages.Troubleshooting
Why can't I dial a portal?
Verify that the destination portal has a correctly linked DHD and enough Pearls.