Corev2.0

RPX Core

Núcleo del ecosistema de roleplay. Gestiona personajes (ciudadanos), empleos, mobiliario, necesidades vitales, identidad IC y la API centralizada para todos los módulos RPX.

Introducción

RPX Core es el cimiento sobre el que se construye todo el ecosistema RPX. Proporciona la gestión de ciudadanos (personajes IC), empleos jerarquizados, mobiliario interactivo registrado, necesidades vitales y una API pública utilizada por todos los módulos adicionales.

Atención

Todos los módulos RPX (Economy, Health, Police, ClockIn, RealState, Gangs…) dependen de RPX Core. Debe cargarse primero.

Sistema multi-personaje por jugador (slots configurables vía LuckPerms)
Integración nativa con LuckPerms para permisos por rango/empleo
API pública RPXAPI para acceso desde cualquier módulo o plugin externo
CitizenManager, JobManager, ActiveCitizenManager y FurnitureManager centralizados

Sistema de Personajes

Cada jugador puede tener múltiples personajes (ciudadanos). Solo uno está activo a la vez. El modelo Citizen contiene el nombre IC (rolName), DNI, género, fecha de nacimiento y el empleo asignado.

Slots de personajes

El número máximo de personajes se controla con un permiso de LuckPerms. Por defecto es 1; los admins pueden ampliarlo con /rpx setlimit.

text

rpx.chars.limit.1   → 1 personaje (por defecto)
rpx.chars.limit.3   → 3 personajes
rpx.chars.limit.21  → 21 personajes (máximo)

DNI Físico

El comando /dni genera un ítem físico con los datos del personaje activo. El ítem lleva NBT 'rpx_dni' con el ID del ciudadano para que otros módulos puedan leerlo.

Consejo

Usa /dni show <id> para consultar el perfil de cualquier ciudadano sin necesidad de que esté conectado.

Chat Roleplay

RPX Core incluye cuatro comandos de chat IC que generan hologramas encima del jugador o mensajes de área. Todos requieren un personaje activo.

Comando	Permiso	Descripción
/me <mensaje>	rpx.chat.me	Muestra '* mensaje *' en cian como holograma encima del jugador (emote).
/do <mensaje>	rpx.chat.do	Describe el entorno o resultado de una acción.
/ooc <mensaje>	rpx.chat.ooc	Mensaje fuera de personaje con prefijo [OOC].
/entorno <mensaje>	rpx.chat.entorno	Describe el entorno a jugadores cercanos. Útil para eventos.

Información

Los hologramas de /me y /do se eliminan automáticamente tras unos segundos. La distancia visible es configurable en config.yml.

Empleos y Rangos

El JobManager define los empleos disponibles. Cada empleo tiene un ID único, nombre, salario base y una jerarquía de rangos con permisos propios.

yaml

# jobs.yml
policia:
  display-name: "Policía Nacional"
  salary-base: 1500.0
  ranks:
    - id: agente
      level: 1
      permission: rpxpolice.pda
    - id: inspector
      level: 3
      permission: rpxpolice.admin

medico:
  display-name: "Médico EMS"
  salary-base: 1800.0
  ranks:
    - id: enfermero
      level: 1
      permission: rpxhealth.ems

Atención

Los IDs de empleo deben coincidir exactamente con los usados en RPX ClockIn (/clockin <jobId>) y en los datáfonos de RPX Economy.

Necesidades Vitales

RPX Core rastrea hambre, sed y fatiga del personaje activo de forma independiente a la barra de hambre vanilla.

Hambre: se reduce con el tiempo y actividad física. Se recupera comiendo (integración xFoods).
Sed: requiere beber agua u otros líquidos. Afecta al rendimiento del personaje.
Fatiga: acumulada por no dormir. A nivel máximo puede causar efectos de debilidad.

Información

Los valores persisten en la base de datos junto al ciudadano y sobreviven a reinicios del servidor.

Comandos

Comando	Permiso	Descripción
/personaje	rpx.citizen.use	Abre el menú de selección y creación de personajes.
/rpx setlimit <jugador> <n>	rpx.admin	Establece el límite de personajes (1-21) vía LuckPerms.
/rpx reload	rpx.admin	Recarga la configuración sin reiniciar el servidor.
/dni	rpx.dni.use	Obtiene el DNI físico del personaje activo.
/dni show <id>	rpx.admin	Muestra el perfil de un ciudadano por su ID numérico.
/me <mensaje>	rpx.chat.me	Holograma de acción propia (emote IC).
/do <mensaje>	rpx.chat.do	Holograma de descripción de entorno/acción.
/ooc <mensaje>	rpx.chat.ooc	Mensaje fuera de personaje.
/entorno <mensaje>	rpx.chat.entorno	Descripción de entorno a jugadores cercanos.
/work	rpx.work.use	Abre el panel de trabajo del personaje activo.

Permisos LuckPerms

text

# Acceso general
rpx.admin               → Comandos administrativos
rpx.citizen.use         → Crear/seleccionar personajes
rpx.chat.me / .do / .ooc / .entorno → Comandos de chat IC
rpx.dni.use             → Obtener DNI físico
rpx.work.use            → Panel de trabajo

# Slots de personajes (asignar solo UNO por jugador)
rpx.chars.limit.1       → 1 personaje
rpx.chars.limit.2       → 2 personajes
rpx.chars.limit.5       → 5 personajes

Consejo

Asigna rpx.chars.limit.1 al grupo 'default' para que todos los jugadores puedan crear al menos un personaje.

AnteriorxCrops Addon SiguienteRPX Economy