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 entradas válidas y habilitadas permanecen en el catálogo de la tienda, pero se eliminan de la fabricación de Bukkit y del menú de objetos fabricables /fmm de los jugadores. Las instrucciones de fabricación siguientes 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 entra en vigor tras un reinicio, tras /fmm applypluginupdate o según lo que indique nightbreak.applyPluginUpdatesWithoutRestart. 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. Entra en vigor tras el siguiente reinicio, salvo que ejecutes /fmm applypluginupdate o configures nightbreak.applyPluginUpdatesWithoutRestart
/fmm applypluginupdate	Aplica una actualización del plugin ya descargada sin reiniciar el servidor. FMM y todos los plugins de MagmaGuy habilitados que dependen de él (con depend o softdepend) se deshabilitan, se sustituye el jar y se vuelven a cargar y habilitar. Se rechaza cuando no hay ninguna actualización más reciente esperando o cuando un plugin de otro autor depende de FMM. Si el nuevo jar no logra habilitarse, se vuelve a cargar el jar anterior y la actualización queda preparada para el siguiente reinicio. Acepta jugadores y consola (permiso: freeminecraftmodels.*)
/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	Importa y valida objetos, encantamientos y recetas de props definidos por los autores; si tiene éxito, reinicializa por completo configuraciones, recetas, modelos y salida del pack. La validación puede rechazar la recarga y conservar activo el catálogo actual
/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]	Vincula este servidor a tu cuenta de Nightbreak, desbloqueando las descargas de contenido oficial y las actualizaciones del plugin. Sin token imprime un enlace de nightbreak.io para aprobar; con uno guarda ese token (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
/nightbreak plugins	Muestra el catálogo de plugins de Nightbreak, como un menú para los jugadores y como una lista en el chat en la consola (permiso: nightbreak.plugins, predeterminado: op). Se registra una vez por servidor, igual que /nightbreaklogin. Consulta Configuración de Nightbreak y gestión de contenido
/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 sobre el bloque apuntado, mediante un trazado de bloques de hasta 300 bloques
/fmm spawn dynamic <id>	Genera un modelo sobre un cerdo oculto encima del bloque apuntado, con el mismo trazado de 300 bloques
/fmm spawn prop <id>	Genera un prop persistente en la posición actual del jugador. 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 de colocación con el material Bukkit indicado. Usa el nombre de su enumeración en mayúsculas, como PAPER. El objeto toma el name y el lore del .yml del prop cuando están definidos. No crea un objeto de mano definido por el autor
/fmm mount <id> [scale]	Genera una montura montable experimental: un caballo domado y ensillado que lleva el modelo, que montas y diriges. La escala opcional, mayor que 0 y hasta 16, define el tamaño del caballo y de su modelo; el autocompletado ofrece 1.0, 2.0 y 3.0. Consulta modelos personalizados montables
/fmm giveitem <item>	Entrega un objeto FMM registrado definido por el autor; los ID no distinguen mayúsculas y minúsculas (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

Los comandos de generación directa no ejecutan las comprobaciones de protección ni de espacio libre del objeto de colocación. Deja una casilla libre para itemify y giveitem: estos controladores ignoran los objetos que no caben en el inventario, en lugar de soltarlos.

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 y su equipo se ocultan a los observadores. Si el disfraz añadió el efecto de invisibilidad, lo restaura después de beber leche, eliminar efectos o reaparecer. Este mecanismo no controla ni restaura una invisibilidad que ya existía antes del disfraz.
• Los plugins de terceros pueden controlar los disfraces a través de la DisguiseAPI pública (ver API y Guía para Desarrolladores).

Mascotas

Comando	Propósito
/fmm pets	Abre tu menú de mascotas, donde llevas mascotas contigo o las mandas a casa (permiso: freeminecraftmodels.pets)
/fmm petadmin mode [creatures|cosmetic]	Muestra el modo de mascotas, o lo cambia y lo guarda en pets.yml (permiso: freeminecraftmodels.pets.admin)
/fmm petadmin list	Lista las especies de mascotas cargadas con su archivo, modelo, cuerpo, comida de domesticación y comida de cría (permiso: freeminecraftmodels.pets.admin)
/fmm petadmin spawn <species>	Genera una mascota salvaje de la especie sobre el bloque al que miras, hasta a 12 bloques de distancia. Solo funciona en el modo CREATURES (permiso: freeminecraftmodels.pets.admin)
/fmm petadmin give <species>	Añade un adulto de la especie a tu propia colección de mascotas (permiso: freeminecraftmodels.pets.admin)
/fmm petmigrate [species]	Envía ahora una bandada migratoria nocturna sobre ti, sea cual sea la hora o el cielo (permiso: freeminecraftmodels.pets.admin)

Consulta Mascotas para los archivos de especie, pets.yml y los dos modos de mascotas.

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

Si falta alguno, /fmm shop no se registra. Una tienda habilitada sin Vault o proveedor de economía registra una advertencia. Un controlador registrado puede devolver el mensaje configurado de desactivación si la configuración o la conexión en caché indica ese estado; no detecta continuamente la eliminación del proveedor. Consulta Configuración para las claves de la tienda y los campos shopEnabled / shopPrice por receta.

Utilidades

Comando	Propósito
/fmm hitbox visualize [duration]	Visualiza las hitboxes de modelos a menos de 10 bloques en el mismo mundo y muestra sus entidades subyacentes. La duración va en ticks y por defecto es 100 (cinco segundos); los valores no positivos o no numéricos usan 100 y los superiores a 1200 usan 1200
/fmm location	Informa de los detectores de mazmorras y proveedores de protección registrados y consulta is_in_dungeon / is_protected en tu posición. Estos predicados de ubicación no son la comprobación de colocación de props que considera al jugador (permiso: freeminecraftmodels.*)
/fmm debug <bedrock|props> [on|off]	Activa o desactiva los registros [FMM-BedrockDebug] o el análisis STACKED PROPS DETECTED de pares de props a 0,1 bloques durante las pasadas de limpieza. Sin un estado, informa de si ese indicador está activado. También acepta true/enable/enabled y false/disable/disabled. Ambos aceptan jugadores y consola (permiso: freeminecraftmodels.*)
/fmm packetdebug [ticks]	Muestrea el tráfico de entidades modeladas durante el número indicado de ticks del reloj de modelos, 1 por defecto, limitado a 1–200 (enteros inválidos usan 1). Informa de paquetes lógicos y entregados por tick, distribución por observador, peor jugador/tick, tipos de paquete y observadores con mayor carga. Autocompleta 1, 5, 20, 60. Ejecútalo en la zona afectada. Los conteos son exactos para el tráfico instrumentado; los bytes son estimaciones. Solo se ejecuta una muestra a la vez. Avisa tras 400 ticks del servidor sin una muestra nueva. Acepta jugadores y consola (permiso: freeminecraftmodels.*)
/fmm filmic [on|off]	Activa o desactiva temporalmente el modo fílmico para grabar vídeos con ReplayMod. Así, cada jugador recibe todos los modelos cargados en sus chunks cargados, aunque estén fuera de su vista, y los modelos siguen animándose. No se recomienda fuera de las grabaciones: consume mucho ancho de banda y rendimiento del servidor. Nunca edita config.yml; el ajuste dura hasta que el servidor se reinicia o hasta que se cambia filmicMode en config.yml y FMM se recarga. Sin argumento, informa del estado actual y de si procede del comando o de config.yml. Acepta jugadores y consola (permiso: freeminecraftmodels.*)
/fmm boneglide [ticks]	Establece temporalmente riddenBoneInterpolationTicks, el número de ticks que tardan los clientes de Java en deslizar un hueso de modelo montado hasta su siguiente pose. 0 salta de golpe. Acepta de 0 a 59 y autocompleta de 0 a 3. Sin argumento, informa del valor actual. Nunca edita config.yml; el valor de config.yml vuelve cuando FMM se recarga. Acepta jugadores y consola (permiso: freeminecraftmodels.*)
/fmm deleteall [radius]	Elimina todas las entidades modeladas actualmente cargadas en todos los mundos y elimina permanentemente los props cargados. No busca props descargados. Un radio entero positivo solo puede usarse por jugadores y limita la eliminación a su mundo y distancia

Los indicadores de depuración no se guardan en disco, pero /fmm reload no los restablece. Desactiva los registros expresamente después de recoger las pruebas; un nuevo arranque del servidor inicializa ambos desactivados.

Comportamiento de colocación de elementos decorativos

Cuando un jugador hace clic derecho con un objeto de colocación de modelos obtenido mediante itemify, fabricación o tienda, se aplica lo siguiente. Los objetos de mano definidos por autores quedan excluidos de este controlador.

• Consumo: se consume un objeto tras una colocación correcta, salvo en modo Creativo.
• Objetivo: pulsar un bloque usa el bloque y la cara del evento. Pulsar el aire traza hasta cinco bloques. Los props libres usan el centro de la cara; los voxelizados usan el bloque adyacente y un volumen alineado a la cuadrícula
• Rotación: los props miran hacia la posición del jugador respecto al punto de colocación, no simplemente hacia el ángulo de su mirada. La colocación libre usa pasos de 10 grados; la voxelizada, de 90 grados
• 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.
• Mano principal y espera: solo coloca la mano principal. Los intentos tienen una espera de 500 ms, incluidos los que después fallan en la validación
• Protección y espacio: la consulta de protección configurada comprueba la casilla adyacente. Los props voxelizados comprueban después el espacio libre y la protección del volumen rotado. El permiso de omisión evita las consultas de protección. Consulta Configuración para los límites de integración y cobertura de colisión
• Limpieza de duplicados: al iniciar, en los eventos de carga de entidades y antes de generar props directamente, FMM busca soportes 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ú para jugadores con las entradas de modelos cargados cuyas recetas de fabricación están realmente registradas.

• 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. Al guardar correctamente se emiten partículas, un sonido y un mensaje de éxito. Si falla el guardado o registro, el menú permanece abierto, los ingredientes quedan en la cuadrícula y el jugador recibe un error. FMM intenta restaurar la receta registrada anteriormente; revisa la consola si también falla la restauración.
6. La receta se guarda en plugins/FreeMinecraftModels/recipes/<model_id>.yml; el registro Bukkit depende de registerCraftingRecipes.
7. Si el registro tiene éxito y la fabricación está habilitada, los jugadores pueden fabricar el objeto de papel en una mesa.
8. Pulsa Escape antes de guardar para cancelar y recuperar los ingredientes, soltando a tus pies lo que no quepa. Guardar elimina las pilas completas de ingredientes de la cuadrícula; la receta solo conserva materiales y patrón, no cantidades ni metadatos.
9. Repetir craftify para el mismo modelo sustituye la receta y restablece los campos de activación y tienda a sus valores predeterminados, incluido el precio.
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	no (predeterminado true)	Ponlo en false para retirar el registro de la receta sin borrar el archivo
model_id	sí	El modelo que coloca el objeto de papel fabricado. Un sufijo de estado de arco/ballesta se resuelve al ID base solo si ese modelo base tiene un modelo de visualización registrado
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 Bukkit es freeminecraftmodels:prop_recipe_<model_id> y el resultado siempre es el objeto de papel para colocar el modelo, no un objeto de mano definido por su material y encantamientos. Repetir /fmm craftify sustituye el archivo e intenta registrarlo con la misma clave cuando la fabricación está habilitada.

FMM lee todos los .yml de recipes/, incluidas las subcarpetas, y los carga como un único catálogo. Cada model_id solo puede tener un archivo de receta habilitado. Un segundo archivo habilitado para el mismo model_id, o un archivo con un error de sintaxis YAML, hace que /fmm reload se rechace conservando las recetas actuales e indica a quien lo ejecutó que revise la consola. En el arranque, el mismo problema rechaza solo el catálogo de recetas: FMM termina de iniciarse sin recetas de props ni entradas de la tienda de muebles hasta que corrijas el archivo y ejecutes /fmm reload. Busca Prop recipe catalog rejected, Duplicate recipe model o Cannot prepare prop recipes en la consola.

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, freeminecraftmodels.bypassregionprotection y freeminecraftmodels.pets.admin. 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 filmic, /fmm boneglide, /fmm location, /fmm setup, /fmm initialize, /fmm recommendedplugins, /fmm downloadall, /fmm downloadallcontent, /fmm updatecontent, /fmm downloadpluginupdate, /fmm applypluginupdate 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	Omite las consultas de protección de FMM para colocar props e interactuar con ellos, incluida preventPropPlacementInProtectedRegions. Las comprobaciones de espacio libre siguen aplicándose
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.

Permisos de mascotas

Permiso	Predeterminado	Descripción
freeminecraftmodels.pets	true	Acceso a /fmm pets (disponible para todos los jugadores)
freeminecraftmodels.pets.admin	OP	Hijo del comodín; acceso a /fmm petadmin y /fmm petmigrate

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
nightbreak.plugins	OP	Requerido por el comando compartido /nightbreak plugins. 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, shop, pets, petadmin y petmigrate son comandos solo para jugadores. /freeminecraftmodelschangelog también es solo para jugadores.
• reload, stats, recommendedplugins, downloadall, downloadallcontent, updatecontent, downloadpluginupdate, applypluginupdate, forcereinstallcontent, packetdebug, debug, filmic, boneglide, deleteall, /nightbreaklogin, /nightbreaklogout y /nightbreak plugins 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.