Módulo Core¶

⚠️ Traducción desactualizada (marcada 2026-08-06). La versión en inglés de esta página fue reescrita: el registro de ítems, mochilas, energía e investigación fueron eliminados (código muerto) y ahora pertenecen a NexusATS. Esta traducción aún describe el sistema antiguo — revisar modules/core.md (inglés) o modules/core.pt.md (portugués).

El módulo Core es la base de NexusPrism. Gestiona el registro de ítems personalizados, el sistema de etiquetado PDC (PersistentDataContainer), el motor de máquinas, el árbol de investigación, mochilas y puntos de viaje.

Sistema de Ítems Personalizados¶

Todos los ítems personalizados se definen en plugins/NexusPrism/items.yml. El plugin incluye más de 500 ítems de fábrica.

Ejemplo de `items.yml`¶

COPPER_DUST:
  category: DUST
  tier: BASIC
  display-name: "&fCopper Dust"
  lore:
    - "&7A fine copper powder."
  material: PAPER
  custom-model-data: 1001
  glow: false
  stackable: true
  max-stack: 64

NEXUS_PICKAXE:
  category: TOOL
  tier: ADVANCED
  display-name: "&bNexus Pickaxe"
  lore:
    - "&7Mines at incredible speed."
    - "&8Tier: Advanced"
  material: DIAMOND_PICKAXE
  custom-model-data: 2005
  glow: true
  enchantments:
    EFFICIENCY: 5
    UNBREAKING: 3

Categorías de Ítems¶

Categoría	Descripción
`DUST`	Polvos de crafteo (cobre, estaño, plata…)
`INGOT`	Lingotes de metal procesados
`TOOL`	Herramientas y armas personalizadas
`MACHINE`	Bloques de máquina colocables
`COMPONENT`	Placas de circuito, engranajes, etc.
`RESOURCE`	Recursos crudos de crafteo
`ENERGY`	Componentes de energía
`BACKPACK`	Ítems de mochila

Tiers de Ítems (`NexusTier`)¶

Tier	Descripción
`BASIC`	Tier inicial — sin investigación requerida
`ADVANCED`	Requiere investigación básica
`INFINITY`	Tier final — requiere pergaminos

Sistema PDC¶

NexusPrism usa el PersistentDataContainer de Minecraft para etiquetar ítems personalizados, máquinas y datos de jugadores. Cada ítem de NexusPrism lleva una clave PDC nexusprism:id que lo identifica de forma única.

Clases principales:

CustomItemRegistry — registra y resuelve todos los ítems personalizados
NexusItemIdResolver — resuelve IDs de ítems desde PDC
NexusItemMigrator — migra ítems legados a nuevos IDs

Sistema de Investigación¶

Los jugadores desbloquean ítems y máquinas gastando XP en investigación. La investigación está escalonada — Básica → Avanzada → Infinity.

# researches.yml
COPPER_PROCESSING:
  tier: BASIC
  xp-cost: 10
  display-name: "&fCopper Processing"
  description: "Unlock copper dust, copper ingots, and basic machines."
  unlocks:
    - COPPER_DUST
    - COPPER_INGOT
    - BASIC_CRUSHER

Permiso	Descripción
`nexusprism.research`	Usar el sistema de investigación (por defecto: true)
`nexusprism.research.all`	Desbloquear toda la investigación instantáneamente (OP)

Mochilas¶

Las mochilas son contenedores de almacenamiento portátiles. Los jugadores comienzan con una mochila básica y pueden actualizarla.

Comandos¶

Comando	Uso	Permiso
`/backpack open`	Abrir tu mochila	`nexusprism.essentials.backpack`
`/backpack open <id>`	Abrir una mochila específica	`nexusprism.essentials.backpack`
`/backpack list`	Listar todas las mochilas	`nexusprism.essentials.backpack`

Permisos¶

Permiso	Descripción
`nexusprism.backpack.create`	Crear mochilas (por defecto: true)
`nexusprism.backpack.upgrade`	Actualizar mochilas (por defecto: true)
`nexusprism.backpack.unlimited`	Ranuras ilimitadas de mochila (OP)

Puntos de Viaje¶

Los puntos de viaje son puntos de viaje rápido personales guardados por el jugador.

Comandos de Puntos de Viaje¶

Comando	Uso	Permiso
`/waypoint create <nombre>`	Crear un punto de viaje	`nexusprism.essentials.waypoint`
`/waypoint delete <nombre>`	Eliminar un punto de viaje	`nexusprism.essentials.waypoint`
`/waypoint list`	Listar todos los puntos de viaje	`nexusprism.essentials.waypoint`
`/waypoint tp <nombre>`	Teletransportarse a un punto de viaje	`nexusprism.essentials.waypoint`
`/waypoint info <nombre>`	Mostrar detalles del punto de viaje	`nexusprism.essentials.waypoint`

Alias: /wp

Permisos de Límite de Ranuras¶

Permiso	Ranuras
`nexusprism.essentials.waypoints.1`	1 (por defecto)
`nexusprism.essentials.waypoints.5`	5
`nexusprism.essentials.waypoints.25`	25
`nexusprism.essentials.waypoints.unlimited`	Ilimitado (OP)

Comandos Principales del Plugin¶

Comando	Uso	Permiso
`/nexusprism help`	Mostrar ayuda	`nexusprism.command`
`/nexusprism info`	Información del plugin	`nexusprism.command`
`/nexusprism reload`	Recargar todas las configuraciones	`nexusprism.admin.reload`
`/nexusprism give <jugador> <item>`	Dar un ítem personalizado	`nexusprism.admin.give`
`/nexusprism guide`	Abrir la guía de ítems	`nexusprism.command`
`/nexusprism modules`	Listar módulos cargados	`nexusprism.command`
`/nexusprism machine info <id>`	Información de la máquina	`nexusprism.command`
`/nexusprism machine list`	Listar máquinas	`nexusprism.command`
`/nexusprism energy info <loc>`	Información del nodo de energía	`nexusprism.command`
`/nexusprism energy network`	Vista de la red de energía	`nexusprism.command`

Alias: /ns, /nexus, /slime, /nslime

Soporte de Idiomas¶

NexusPrism incluye cuatro archivos de idioma:

Archivo	Idioma
`lang/en_US.yml`	Inglés (por defecto)
`lang/pt_BR.yml`	Portugués Brasileño
`lang/es_ES.yml`	Español
`lang/zh_CN.yml`	Chino (Simplificado)

Establece el idioma activo en config.yml:

settings:
  language: en_US