Primeros Pasos¶

Esta página cubre todo lo que necesitas para instalar y configurar NexusPrism en tu servidor.

Requisitos¶

Requisito	Versión
Servidor Minecraft	Paper / Spigot 1.21+
Java	17 o más reciente
Dependencia opcional	PlaceholderAPI (recomendado)
Dependencia opcional	LuckPerms (recomendado)
Dependencia opcional	SkinsRestorer (opcional)

Aviso para Servidores Crackeados

Si tu servidor funciona en modo offline (crackeado), el sistema de autenticación del módulo Security es obligatorio. Las cuentas premium son detectadas automáticamente mediante la API de Mojang y omiten la pantalla de inicio de sesión.

Instalación¶

Descarga el NexusPrism.jar más reciente desde la página de GitHub Releases.
Coloca el JAR en la carpeta plugins/ de tu servidor.
Inicia el servidor una vez para generar todos los archivos de configuración predeterminados.
Detén el servidor, edita las configuraciones generadas (ver abajo) y reinicia.

plugins/
└── NexusPrism/
    ├── config.yml
    ├── items.yml
    ├── machines.yml
    ├── lang/
    │   ├── en_US.yml
    │   ├── es_ES.yml
    │   └── ...
    ├── security/
    ├── clans/
    ├── economy/
    ├── discord/
    ├── votifier/
    └── ...

Configuración Principal (`config.yml`)¶

settings:
  language: es_ES         # en_US | pt_BR | es_ES | zh_CN
  debug: false
  auto-save-interval: 300 # segundos

database:
  type: SQLITE            # SQLITE o MYSQL

  mysql:                  # Solo cuando type: MYSQL
    host: localhost
    port: 3306
    database: nexusprism
    username: root
    password: contraseña
    pool-size: 10

resourcepack:
  enabled: false
  url: ""
  sha1: ""
  force: false
  send-on-join: true

energy:
  enabled: true
  max-transfer: 1000
  loss-percentage: 5
  tick-rate: 20

machines:
  enabled: true
  max-per-chunk: 50
  tick-rate: 20

Módulos Maven¶

NexusPrism es un proyecto Maven multi-módulo. Todos los módulos se empaquetan en el JAR final automáticamente.

Módulo	Descripción
`nexusprism-api`	API pública — interfaces para desarrolladores de addons
`nexusprism-core`	Gestores principales, registro PDC, sistema de idioma
`nexusprism-items`	Almacenamiento de ítems personalizados orientado a datos
`nexusprism-machines`	Definiciones de máquinas y motor de procesamiento
`nexusprism-systems`	Implementación de redes de energía
`nexusprism-integrations`	Hooks para PlaceholderAPI, LuckPerms, SkinsRestorer
`nexusprism-storage`	Persistencia de datos SQLite / PostgreSQL
`nexusprism-gui`	Framework de GUI (menús e interfaces)
`nexusprism-utils`	Utilidades auxiliares
`nexusprism-web`	Bridge de la tienda web, kits VIP, procesamiento de pagos
`nexusprism-plugin`	Punto de entrada principal, manejador de comandos
`nexusprism-discord`	Bot Discord JDA, webhooks, vinculación de cuenta
`nexusprism-chat`	Sistema de chat con 4 canales y moderación
`nexusprism-ae`	Almacenamiento en red estilo ME
`nexusprism-energy`	Generadores de energía y redes de cables
`nexusprism-waila`	Tooltips WAILA/HUD
`nexusprism-security`	Auth BCrypt, anti-bot, anti-lag, anti-dupe
`nexusprism-clanes`	Clanes, conquista de territorio, mejoras
`nexusprism-economy`	Dinero, créditos, /sell, /baltop
`nexusprism-essentials`	+40 comandos QoL
`nexusprism-crystaldefense`	Minijuego Crystal Defense por oleadas
`nexusprism-custommobs`	Jefes personalizados definidos en YAML
`nexusprism-dreams`	Sistema de cutscene de sueño
`nexusprism-protections`	Protección de regiones, banderas, sistema de duelo
`nexusprism-ss`	Soporte Silk Spawner
`nexusprism-votifier`	Servidor Votifier V1/V2 independiente
`nexusprism-twitch`	Integración Twitch (alertas en vivo, sorteos)

API para Desarrolladores (Jitpack)¶

Agrega NexusPrism como dependencia en tu addon o plugin usando Jitpack.

Dependencia solo de la API

Depende de nexusprism-api, no de nexusprism-plugin, para evitar traer la implementación completa a tu proyecto. Márcala como provided — el JAR del plugin ya está en el servidor en tiempo de ejecución.

MavenGradle (Kotlin DSL)Gradle (Groovy)

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.github.O-Tiger.NexusPrism</groupId>
        <artifactId>nexusprism-api</artifactId>
        <version>TAG</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

repositories {
    maven("https://jitpack.io")
}

dependencies {
    compileOnly("com.github.O-Tiger.NexusPrism:nexusprism-api:TAG")
}

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    compileOnly 'com.github.O-Tiger.NexusPrism:nexusprism-api:TAG'
}

Reemplaza TAG con la versión del release (ej: 2.0.0-BETA) o un hash de commit para snapshots.

Dependencia en `plugin.yml`¶

# Dependencia obligatoria — tu plugin no carga sin NexusPrism
depend: [NexusPrism]

# Dependencia opcional — carga después de NexusPrism si está presente
softdepend: [NexusPrism]

Primeros Pasos Después de Instalar¶

Configura tu idioma en config.yml → settings.language
Configura el módulo Security (security/auth.yml) si tu servidor es offline/crackeado
Configura el módulo Economy (economy/sell-prices.yml) con los precios de los ítems
Configura Discord (discord/config.yml) con tu token de bot e IDs de canales
Configura Votifier (votifier/config.yml) con tus enlaces de votación y recompensas
Otórgate nexusprism.admin.* o usa LuckPerms para asignar grupos de permisos

Comando de recarga

Después de cambiar cualquier archivo de configuración, ejecuta /nexusprism reload para aplicar los cambios sin reiniciar el servidor.