Primeiros Passos¶

Esta página cobre tudo o que você precisa para instalar e configurar o NexusPrism no seu servidor.

Requisitos¶

Requisito	Versão
Servidor Minecraft	Paper / Spigot 1.21+
Java	17 ou mais recente
Dependência opcional	PlaceholderAPI (recomendado)
Dependência opcional	LuckPerms (recomendado)
Dependência opcional	SkinsRestorer (opcional)

Aviso para Servidores Cracked

Se o seu servidor roda em modo offline (cracked), o sistema de autenticação do módulo Security é obrigatório. Contas premium são detectadas automaticamente via API Mojang e ignoram a tela de login.

Instalação¶

Baixe o NexusPrism.jar mais recente na página de GitHub Releases.
Coloque o JAR na pasta plugins/ do seu servidor.
Inicie o servidor uma vez para gerar todos os arquivos de configuração padrão.
Pare o servidor, edite as configurações geradas (veja abaixo) e reinicie.

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

Configuração Principal (`config.yml`)¶

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

database:
  type: SQLITE            # SQLITE ou MYSQL

  mysql:                  # Usado apenas quando type: MYSQL
    host: localhost
    port: 3306
    database: nexusprism
    username: root
    password: senha
    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 é um projeto Maven multi-módulo. Todos os módulos são empacotados no JAR final automaticamente.

Módulo	Descrição
`nexusprism-api`	API pública — interfaces para desenvolvedores de addons
`nexusprism-core`	Gerenciadores principais, registro PDC, sistema de idioma
`nexusprism-items`	Armazenamento de itens personalizados orientado a dados
`nexusprism-machines`	Definições de máquinas e motor de processamento
`nexusprism-systems`	Implementação de redes de energia
`nexusprism-integrations`	Hooks para PlaceholderAPI, LuckPerms, SkinsRestorer
`nexusprism-storage`	Persistência de dados SQLite / PostgreSQL
`nexusprism-gui`	Framework de GUI (menus e interfaces)
`nexusprism-utils`	Utilitários auxiliares
`nexusprism-web`	Bridge da loja web, kits VIP, processamento de pagamentos
`nexusprism-plugin`	Ponto de entrada principal, handler de comandos
`nexusprism-discord`	Bot Discord JDA, webhooks, vinculação de conta
`nexusprism-chat`	Sistema de chat com 4 canais e moderação
`nexusprism-ae`	Armazenamento em rede estilo ME
`nexusprism-energy`	Geradores de energia e redes de cabos
`nexusprism-waila`	Tooltips WAILA/HUD
`nexusprism-security`	Auth BCrypt, anti-bot, anti-lag, anti-dupe
`nexusprism-clans`	Clãs, conquista de território, melhorias
`nexusprism-economy`	Dinheiro, créditos, /sell, /baltop
`nexusprism-essentials`	+40 comandos QoL
`nexusprism-crystaldefense`	Minijogo Crystal Defense por ondas
`nexusprism-custommobs`	Chefes personalizados definidos em YAML
`nexusprism-dreams`	Sistema de cutscene de sono
`nexusprism-protections`	Proteção de regiões, flags, sistema de duelo
`nexusprism-ss`	Suporte a Silk Spawner
`nexusprism-votifier`	Servidor Votifier V1/V2 independente
`nexusprism-twitch`	Integração Twitch (alertas ao vivo, sorteios)

API para Desenvolvedores (Jitpack)¶

Adicione o NexusPrism como dependência no seu addon ou plugin usando o Jitpack.

Dependência somente da API

Dependa de nexusprism-api, não de nexusprism-plugin, para evitar puxar a implementação completa para o seu projeto. Marque como provided — o JAR do plugin já está no servidor em tempo de execução.

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'
}

Substitua TAG pela versão do release (ex: 2.0.0-BETA) ou um hash de commit para snapshots.

Dependência no `plugin.yml`¶

# Dependência obrigatória — seu plugin não carrega sem o NexusPrism
depend: [NexusPrism]

# Dependência opcional — carrega após o NexusPrism se presente
softdepend: [NexusPrism]