Comandos de FreeMinecraftModels

registerCraftingRecipes en config.yml vale true por defecto. Cámbialo a false y reinicia para una economía de solo compras: las recetas siguen visibles en los menús y la tienda, pero se eliminan las recetas de fabricación de Bukkit. Las instrucciones de fabricación de esta página requieren true.

Usa /freeminecraftmodels o /fmm.

Configuración y Gestión de Contenido

Comando	Propósito
/fmm	Abre el menú de objetos fabricables para jugadores (consulta Menú de Objetos Fabricables más abajo)
/fmm admin	Abre el explorador de contenido de administrador — explora paquetes instalados, carpetas, modelos y objetos personalizados (permiso: freeminecraftmodels.admin)
/fmm setup	Abre el menú de gestión de contenido / configuración inicial solo para jugadores (el comando al que se dirige a los jugadores en el primer arranque)
/fmm recommendedplugins	Muestra plugins complementarios que combinan bien con FreeMinecraftModels (abre un menú de catálogo para jugadores, imprime una lista para la consola)
/fmm downloadall	Descarga la última actualización del plugin y todo el contenido oficial disponible. Si el contenido cambió, FMM recarga para aplicarlo; el jar del plugin descargado sigue requiriendo un reinicio del servidor. Si el paso de actualización del plugin falla por falta de un token de Nightbreak o por un fallo de autenticación, el paso de contenido se omite por completo
/fmm downloadallcontent	Descarga todo el contenido oficial disponible (solo contenido, sin actualizar el jar del plugin) y recarga si al menos un paquete cambió
/fmm updatecontent	Descarga actualizaciones para el contenido oficial desactualizado y recarga si al menos un paquete cambió (alias: /fmm updateallcontent)
/fmm downloadpluginupdate	Descarga únicamente la última actualización del jar del plugin (se aplica tras el siguiente reinicio del servidor)
/fmm forcereinstallcontent <package|all>	Comando de reparación — vuelve a descargar el contenido que ya tienes, incluso cuando los números de versión dicen que está al día. Autocompleta all más el slug de cada paquete de Nightbreak. all cubre todos los paquetes detectados como descargados; si los archivos de un pack faltan por completo, indica su slug directamente. Recarga después (permiso: freeminecraftmodels.*)
/fmm reload	Reimporta el contenido y regenera la salida del pack
/fmm version	Muestra la versión del plugin (no requiere permiso — cualquiera puede ejecutarlo)
/fmm stats	Muestra estadísticas de los modelos cargados

Comandos Compartidos de Nightbreak

Estos los registra MagmaCore y no FreeMinecraftModels en sí, así que son comandos de nivel superior, no subcomandos de /fmm.

Comando	Propósito
/nightbreaklogin <token>	Guarda el token compartido de la cuenta de Nightbreak para este servidor, desbloqueando las descargas de contenido oficial y las actualizaciones del plugin (permiso: nightbreak.login, predeterminado: op). Se registra una vez por servidor — el plugin de Nightbreak que cargue primero es su propietario
/nightbreaklogout	Borra de este servidor el token guardado de la cuenta de Nightbreak (permiso: nightbreak.login, predeterminado: op). Acepta tanto jugadores como consola
/freeminecraftmodelschangelog [dismiss|disable]	Muestra las notas de versión de FreeMinecraftModels no leídas (lanzamientos del plugin y paquetes de contenido rastreados). dismiss marca como leídas las notas mostradas actualmente; disable oculta permanentemente los recordatorios de changelog para ti. Solo para jugadores y solo para administradores — un jugador necesita freeminecraftmodels.*, uno de los permisos de setup/admin, u OP. Si otro plugin ya es propietario de la etiqueta /freeminecraftmodelschangelog, el comando se registra bajo un respaldo con espacio de nombres como /freeminecraftmodels:freeminecraftmodelschangelog

A los administradores que tengan notas de versión sin leer se les avisa en el chat al entrar con un aviso pulsable [VIEW CHANGELOG]; la vista de resumen ofrece los botones Dismiss These Updates y Never Show Changelogs, que hacen lo mismo que los dos subcomandos. El estado de lectura por jugador vive en plugins/FreeMinecraftModels/nightbreak-changelogs.yml.

Generación y Colocación de Modelos

Comando	Propósito
/fmm spawn static <id>	Genera un modelo estático
/fmm spawn dynamic <id>	Genera un modelo dinámico
/fmm spawn prop <id>	Crea una entrada de prop persistente y la genera. Se rechaza con A prop of that model already exists on this block. si ya hay un prop del mismo modelo cargado en ese bloque
/fmm itemify <id> <material>	Crea un objeto colocable que genera el modelo elegido como un prop
/fmm mount <id>	Genera una montura montable experimental usando un caballo disfrazado
/fmm giveitem <item>	Da un objeto FMM personalizado al jugador (permiso: freeminecraftmodels.admin)
/fmm craftify <id>	Abre un constructor interactivo de recetas — coloca ingredientes en una cuadrícula 3×3 y haz clic en la salida para guardar una receta de fabricación para ese prop

Disfraces de Jugador

Comando	Propósito
/fmm disguise <modelID> [player]	Disfraza a un jugador como un modelo cargado. Sin argumento de objetivo, disfraza al emisor. Con un objetivo, requiere freeminecraftmodels.disguise.self + freeminecraftmodels.disguise.others y funciona desde la consola
/fmm undisguise [player]	Elimina el disfraz. Sin objetivo, quita el disfraz al emisor. Con un objetivo, requiere freeminecraftmodels.disguise.self + freeminecraftmodels.disguise.others y funciona desde la consola
/fmm disguiselist	Lista los jugadores actualmente disfrazados y el modelo bajo el que está disfrazado cada uno (permiso: freeminecraftmodels.disguise.others)

Comportamiento del disfraz:

• Disfrazar reemplaza limpiamente cualquier disfraz previo en ese jugador.
• Los jugadores disfrazados se hacen invisibles para otros jugadores, de modo que solo se ve el modelo. La invisibilidad persiste a través de cubos de leche y otras interacciones que eliminan efectos.
• Los plugins de terceros pueden controlar los disfraces a través de la DisguiseAPI pública (ver API y Guía para Desarrolladores).

Tienda de Muebles

Comando	Propósito
/fmm shop	Abre la tienda de muebles opcional respaldada por Vault donde los jugadores pueden comprar props fabricables con moneda del juego (permiso: freeminecraftmodels.shop, predeterminado: true)

La tienda está deshabilitada por defecto y solo se registra cuando:

• enabled: true en shop_config.yml
• Vault está instalado
• Hay un proveedor de economía compatible con Vault registrado

Cuando falta cualquiera de estos, /fmm shop queda sin registrar (o muestra el mensaje configurable de "tienda deshabilitada" si se fuerza la deshabilitación en runtime). Consulta Configuración para las claves de configuración de la tienda y los campos shopEnabled / shopPrice por receta.

Utilidades

Comando	Propósito
/fmm hitbox visualize [duration]	Visualiza las hitboxes para depuración
/fmm location	Comando de diagnóstico — informa cuántos detectores de mazmorras y proveedores de protección están registrados con LocationAPI, y prueba ambos predicados contra tu ubicación actual (permiso: freeminecraftmodels.*)
/fmm debug <bedrock|props> [on|off]	Conmutadores en tiempo de ejecución para los flujos de logs de diagnóstico de FMM. bedrock activa o desactiva el flujo [FMM-BedrockDebug], que diagnostica el pipeline de visualización de Bedrock; props activa o desactiva el escaneo de props apilados, que hace que cada carga de chunk informe de cualquier par de props a menos de 0,1 bloques de distancia como STACKED PROPS DETECTED. Omite el argumento de estado para informar del estado actual sin cambiarlo. Se aceptan tanto on/true/enable/enabled como off/false/disable/disabled. Ambos conmutadores siempre se restablecen a OFF al recargar el plugin — intencionalmente no son claves de configuración para que no se puedan dejar activados por accidente. Acepta tanto jugadores como consola (permiso: freeminecraftmodels.*)
/fmm packetdebug [ticks]	Diagnóstico puntual de carga de paquetes. Muestrea el tráfico de paquetes de entidades modeladas durante los siguientes [ticks] ticks del reloj de modelos (predeterminado 1, limitado a 200) e informa de paquetes lógicos por tick, paquetes realmente entregados por tick incluyendo la difusión por espectador, el peor jugador/tick individual, un desglose por tipo de paquete y los espectadores más pesados. Autocompleta 1, 5, 20, 60. Ejecútalo mientras estás en la zona con lag. Los conteos de paquetes son exactos; las cifras de bytes son estimaciones. Expira con una advertencia si no llega ninguna muestra (no hay entidades modeladas cargadas, o NMS está desactivado). Acepta tanto jugadores como consola (permiso: freeminecraftmodels.*)
/fmm deleteall [radius]	Elimina todas las entidades modeladas cargadas y los props persistentes. Sin argumento limpia todo; un [radius] opcional (solo para jugadores) limita la eliminación a las entidades dentro de esa cantidad de bloques alrededor del jugador

Comportamiento de Colocación de Props

Cuando un jugador hace clic derecho con un objeto de papel de prop (creado con /fmm itemify o fabricado con una receta de /fmm craftify), se aplica lo siguiente:

• Consumo de objeto: el objeto de papel se consume cuando se coloca el prop, salvo que el jugador esté en modo Creativo.
• Rotación: los props se colocan mirando hacia la dirección del jugador, ajustados a incrementos de rotación de 10 grados. Esto da a los jugadores control preciso sobre la orientación del prop simplemente ajustando hacia dónde miran antes de colocarlo.
• Un prop por modelo y bloque: la colocación se rechaza con A prop of that model already exists on this block. cuando ya hay un prop del mismo modelo cargado en ese bloque. El objeto no se consume en una colocación rechazada.
• Solo mano principal: solo la mitad de mano principal del evento de interacción coloca un prop, de modo que un único clic derecho ya no puede producir dos props.
• Limpieza de duplicados: al arrancar el servidor y en cada carga de chunk, FreeMinecraftModels busca armor stands de prop que compartan modelo y bloque, conserva uno y elimina el resto. Las eliminaciones se registran como [FMM Props] Removed N duplicate prop armor stand(s) ....

Menú de Objetos Fabricables

Ejecutar /fmm sin argumentos abre un menú de inventario para los jugadores que muestra todos los objetos fabricables que han sido configurados con recetas.

• Cada objeto en el menú representa un objeto FMM fabricable.
• Al hacer clic en un objeto se abre un submenú de detalle que muestra la cuadrícula de fabricación 3x3 espacial, una flecha y el objeto resultante — mostrando al jugador exactamente cómo fabricarlo en una mesa de fabricación.
• Requiere el permiso freeminecraftmodels.menu (predeterminado: true, disponible para todos los jugadores).

Explorador de Contenido de Administrador

Ejecutar /fmm admin abre un menú de inventario para que los administradores del servidor exploren:

• Paquetes de contenido instalados
• Carpetas y modelos individuales
• Objetos personalizados (modelos con material: establecido)

Requiere el permiso freeminecraftmodels.admin (predeterminado: op).

Constructor de Recetas

El comando /fmm craftify te permite crear una receta de mesa de fabricación vanilla para cualquier modelo de prop.

1. Ejecuta /fmm craftify <model_id> para abrir la UI del constructor de recetas.
2. Se abre un inventario personalizado con una cuadrícula de fabricación 3×3 y un objeto resultante prellenado.
3. Coloca los ingredientes de tu inventario en la cuadrícula con el patrón que quieras.
4. Haz clic en el objeto resultante (el objeto de papel del prop) para guardar la receta.
5. Partículas y un sonido confirman el guardado.
6. La receta se guarda en plugins/FreeMinecraftModels/recipes/<model_id>.yml y se registra inmediatamente.
7. Los jugadores ya pueden fabricar el objeto del prop en cualquier mesa de fabricación.
8. Presiona Escape para cancelar sin guardar — los ingredientes se devuelven a tu inventario.
9. Volver a ejecutar craftify para el mismo modelo sobrescribe la receta anterior.
10. Las recetas persisten a través de reinicios del servidor y recargas.

Formato del Archivo de Receta

isEnabled: true
model_id: "wooden_chair"
shape:
  - "L L"
  - "LLL"
  - "L L"
ingredients:
  L: OAK_LOG
shopEnabled: true
shopPrice: 250.0

Campo	Obligatorio	Notas
isEnabled	sí (predeterminado true)	Ponlo en false para desregistrar la receta sin borrar el archivo
model_id	sí	El modelo que coloca el objeto de papel fabricado. Un ID de modelo que lleve un sufijo de estado de arco/ballesta se reescribe automáticamente al ID de modelo base
shape	sí	Hasta tres filas de hasta tres caracteres. Un espacio significa "casilla vacía"
ingredients	sí	Mapa de un único carácter de la forma a un nombre de material de Bukkit. Los materiales no reconocidos se descartan en silencio
shopEnabled	no (predeterminado true)	Si la receta aparece listada en /fmm shop
shopPrice	no (predeterminado defaultPrice de shop_config.yml)	Coste en la moneda de Vault dentro de la tienda

La clave de la receta de Bukkit registrada es freeminecraftmodels:prop_recipe_<model_id>, y la salida es siempre el objeto de papel de colocación del modelo. Volver a ejecutar /fmm craftify para el mismo modelo sobrescribe el archivo y lo vuelve a registrar bajo la misma clave.

Permisos

Registrados en plugin.yml

Permiso	Predeterminado	Descripción
freeminecraftmodels.*	OP	Comodín que otorga freeminecraftmodels.admin, freeminecraftmodels.deleteall, freeminecraftmodels.disguise.self, freeminecraftmodels.disguise.others y freeminecraftmodels.bypassregionprotection. La cadena del comodín es también el permiso literal requerido por /fmm reload, /fmm stats, /fmm spawn, /fmm itemify, /fmm craftify, /fmm mount, /fmm hitbox visualize, /fmm debug, /fmm packetdebug, /fmm location, /fmm setup, /fmm initialize, /fmm recommendedplugins, /fmm downloadall, /fmm downloadallcontent, /fmm updatecontent, /fmm downloadpluginupdate y /fmm forcereinstallcontent
freeminecraftmodels.admin	OP	Acceso a /fmm admin (el explorador de contenido de administrador) y /fmm giveitem
freeminecraftmodels.deleteall	OP	Hijo del comodín; acceso a /fmm deleteall
freeminecraftmodels.disguise.self	OP	Permite /fmm disguise y /fmm undisguise apuntando solo al emisor
freeminecraftmodels.disguise.others	OP	Permite /fmm disguise <model> <player>, /fmm undisguise <player> y /fmm disguiselist
freeminecraftmodels.bypassregionprotection	OP	Permite colocar e interactuar con props en cualquier lugar donde otro plugin bloquearía la colocación normal de bloques, incluso cuando preventPropPlacementInProtectedRegions está habilitado
freeminecraftmodels.menu	true	Acceso al menú de objetos fabricables /fmm (disponible para todos los jugadores)
freeminecraftmodels.shop	true	Acceso a /fmm shop (disponible para todos los jugadores cuando la tienda está habilitada)

Los comandos disguise y undisguise con un jugador objetivo requieren tanto freeminecraftmodels.disguise.self como freeminecraftmodels.disguise.others. disguiselist solo requiere .others.

Registrados por MagmaCore

Permiso	Predeterminado	Descripción
nightbreak.login	OP	Requerido por los comandos compartidos /nightbreaklogin y /nightbreaklogout. Lo registra una vez por servidor el plugin de Nightbreak que cargue primero

Notas sobre el emisor

• initialize, setup, spawn, itemify, mount, giveitem, craftify, hitbox visualize, location, admin y shop son comandos solo para jugadores. /freeminecraftmodelschangelog también es solo para jugadores.
• recommendedplugins, downloadall, downloadallcontent, updatecontent, downloadpluginupdate, forcereinstallcontent, packetdebug, debug, deleteall, /nightbreaklogin y /nightbreaklogout aceptan tanto jugadores como consola (el radio de deleteall es solo para jugadores).
• disguise y undisguise aceptan un jugador objetivo y pueden ejecutarse desde la consola siempre que se proporcione un objetivo.
• version no tiene restricción de permiso y puede ser ejecutado por cualquiera (jugadores o consola).
• /fmm initialize abre el menú de configuración inicial para jugadores con freeminecraftmodels.*. Usa /fmm setup para gestionar el contenido a diario.