Back
apolo
Apolo is Essentials plugin from Minecraft server
0 stars0 forksJavaJuly 1, 2026
README
Apolo
Plugin de utilidades para Spigot 1.8.8+ que incluye economía, teletransporte, warps, vuelo, modo dios, reparación, mensajería privada y herramientas de administración. Soporta sincronización entre servidores vía Redis PubSub.
Requisitos
| Requisito | Versión mínima | |-----------|----------------| | Java | 11 | | Spigot / Paper | 1.8.8 | | MongoDB | 7.0 | | Redis | 7.2 | | Vault (opcional) | 1.7.1 |
Instalación
1. Infraestructura
Levanta MongoDB y Redis con Docker Compose:
docker compose up -d
2. Compilar
./gradlew clean shadowJar
El JAR generado se encuentra en apolo-plugin/build/libs/apolo-plugin.jar.
3. Instalar
Copia el JAR a la carpeta plugins/ de tu servidor y reinícialo. El plugin genera config.yml y messages.yml en plugins/Apolo/ al primer inicio. En reinicios posteriores, las claves nuevas se agregan automáticamente al config.yml existente sin pisar los valores ya configurados.
Configuración
plugins/Apolo/config.yml
server-id: "lobby" # Identificador único de este servidor (para cross-server)
redis:
host: "localhost"
port: 6379
password: ""
database: 0
pool:
max-total: 10
max-idle: 5
min-idle: 1
mongodb:
uri: "mongodb://localhost:27017"
database: "apolo"
connection-timeout: 5000
socket-timeout: 10000
max-pool-size: 10
tpa:
request-timeout: 30 # Segundos antes de que expire una solicitud TPA
cooldown: 10 # Cooldown en segundos entre solicitudes
repair:
cooldown: 60 # Cooldown en segundos entre reparaciones
fly:
restore-on-join: true # Restaura el estado de vuelo al reconectarse
godmode:
restore-on-join: true # Restaura el modo dios al reconectarse
warps:
per-page: 6 # Warps por página en /warps
cooldown: 5 # Cooldown en segundos entre usos de /warp
economy:
starting-balance: 500.0
currency-symbol: "$"
currency-name-singular: "Dólar"
currency-name-plural: "Dólares"
decimal-digits: 2
max-balance: 1000000000.0
min-transfer-amount: 1.0 # Monto mínimo permitido en /pay
cache:
balance-ttl: 300 # TTL del caché de saldo en Redis (segundos)
user-ttl: 600 # TTL del caché de usuario en Redis (segundos)
messages-file: "messages.yml"
Los mensajes se personalizan en plugins/Apolo/messages.yml. Todos soportan códigos de color con & y el placeholder {prefix}.
Comandos y Permisos
Economía
| Comando | Alias | Descripción | Permiso |
|---------|-------|-------------|---------|
| /balance [jugador] | bal, money | Ver el saldo propio o de otro jugador | — |
| /pay <jugador> <cantidad> | transfer | Transferir dinero a otro jugador | — |
| /baltop | balancetop | Ver el ranking de saldos | — |
| /eco set <jugador> <cantidad> | economy | Establecer saldo de un jugador | apolo.eco |
| /eco give <jugador> <cantidad> | | Depositar dinero a un jugador | apolo.eco |
| /eco take <jugador> <cantidad> | | Retirar dinero de un jugador | apolo.eco |
/payrechaza montos menores al valor deeconomy.min-transfer-amountconfigurado.
Teletransporte
| Comando | Alias | Descripción | Permiso |
|---------|-------|-------------|---------|
| /tpa <jugador> | | Solicitar teletransporte hacia un jugador | apolo.tpa |
| /tphere <jugador> | | Solicitar que un jugador venga a tu posición | apolo.tphere |
| /tpaccept | | Aceptar la solicitud de TPA pendiente | — |
| /tpadeny | | Rechazar la solicitud de TPA pendiente | — |
| /tpacancel | | Cancelar tu propia solicitud de TPA enviada | apolo.tpa |
El cooldown entre solicitudes puede saltarse con el permiso
apolo.tpa.bypass-cooldown.
Warps
| Comando | Alias | Descripción | Permiso |
|---------|-------|-------------|---------|
| /warp <nombre> | | Teletransportarse a un warp | apolo.warp |
| /warps [página] | | Listar warps (click para teletransportarse) | apolo.warp |
| /setwarp <nombre> | | Crear un warp en tu posición actual | apolo.warp.set |
| /delwarp <nombre> | | Eliminar un warp | apolo.warp.delete |
El listado de
/warpsmuestra entradas clickeables que ejecutan/warp <nombre>directamente.
El cooldown entre teleports puede saltarse con el permisoapolo.warp.bypass-cooldown.
Vuelo y Modo Dios
| Comando | Alias | Descripción | Permiso |
|---------|-------|-------------|---------|
| /fly [jugador] | | Activar/desactivar el vuelo | apolo.fly / apolo.fly.others |
| /godmode [jugador] | god | Activar/desactivar el modo dios | apolo.godmode / apolo.godmode.others |
Reparación
| Comando | Alias | Descripción | Permiso |
|---------|-------|-------------|---------|
| /repair | | Reparar el ítem en mano | apolo.repair |
| /repair armor | | Reparar la armadura equipada | apolo.repair.armor |
| /repair all | | Reparar mano y armadura | apolo.repair.all |
El cooldown entre reparaciones puede saltarse con el permiso
apolo.repair.bypass-cooldown.
Modo de Juego
| Comando | Alias | Descripción | Permiso |
|---------|-------|-------------|---------|
| /gamemode <modo> [jugador] | gm | Cambiar modo de juego | apolo.gamemode / apolo.gamemode.others |
Modos válidos: survival, creative, adventure, spectator (también acepta 0–3). Permiso por modo: apolo.gamemode.<modo>.
Mensajería Privada
| Comando | Alias | Descripción | Permiso |
|---------|-------|-------------|---------|
| /msg <jugador> <mensaje> | message, tell, whisper | Enviar mensaje privado (funciona cross-server) | — |
| /reply <mensaje> | r | Responder al último mensaje recibido | — |
| /socialspy | ss | Activar/desactivar la escucha de mensajes privados | apolo.socialspy |
| /commandspy | cs | Activar/desactivar el espionaje de comandos | apolo.commandspy |
Permisos completos
| Permiso | Descripción |
|---------|-------------|
| apolo.gamemode | Cambiar modo de juego propio |
| apolo.gamemode.others | Cambiar modo de juego de otros |
| apolo.gamemode.<modo> | Usar un modo específico (survival, creative, adventure, spectator) |
| apolo.tpa | Enviar solicitudes TPA |
| apolo.tpa.bypass-cooldown | Saltarse el cooldown de TPA |
| apolo.tphere | Enviar solicitudes TPHere |
| apolo.warp | Usar warps y listarlos |
| apolo.warp.set | Crear warps |
| apolo.warp.delete | Eliminar warps |
| apolo.warp.bypass-cooldown | Saltarse el cooldown de /warp |
| apolo.fly | Vuelo propio |
| apolo.fly.others | Vuelo de otros jugadores |
| apolo.godmode | Modo dios propio |
| apolo.godmode.others | Modo dios de otros jugadores |
| apolo.repair | Reparar ítem en mano |
| apolo.repair.armor | Reparar armadura |
| apolo.repair.all | Reparar mano y armadura |
| apolo.repair.bypass-cooldown | Saltarse el cooldown de /repair |
| apolo.eco | Administrar balances (admin) |
| apolo.socialspy | Espiar mensajes privados |
| apolo.commandspy | Espiar comandos en la red |
Funcionalidades cross-server
El plugin sincroniza los siguientes eventos entre servidores de la misma red a través de canales Redis:
| Canal | Función |
|-------|---------|
| apolo:events:economy-update | Sincroniza cambios de saldo entre servidores |
| apolo:events:private-message | Entrega mensajes privados a jugadores en otros servidores |
| apolo:events:command-spy | Distribuye eventos de CommandSpy entre servidores |
Cada servidor debe tener un server-id único en config.yml.
Arquitectura
El proyecto está organizado en módulos Gradle independientes:
apolo/
├── apolo-api # Interfaces, modelos, eventos y MessageKey
├── apolo-core # Implementaciones de servicios (Tpa, Fly, God, Repair, Warp...)
├── apolo-database # MongoDB: repositorios, mappers, codecs
├── apolo-redis # RedisManager y RedisPlayerStateRepository
├── apolo-economy # Vault hook, use cases de economía, sincronización
├── apolo-messaging # MessageService y resolución de placeholders
├── apolo-commands # Implementaciones de comandos
├── apolo-listeners # Listeners de Bukkit
└── apolo-plugin # Bootstrap, DI (Guice), configuración y ensamblaje final
Las dependencias entre módulos son unidireccionales: apolo-plugin depende de todos los demás; ningún módulo inferior conoce a apolo-plugin.
La inyección de dependencias se gestiona con Google Guice. Las implementaciones internas (MongoDB, Redis, Guava) están reubicadas en el JAR con Shadow para evitar conflictos con otros plugins.
Compilación para desarrollo
# Compilar
./gradlew clean shadowJar
# Solo compilar sin empaquetar
./gradlew compileJava
# Levantar infraestructura local
docker compose up -d
# Detener infraestructura
docker compose down