Skip to main content

FreeMinecraftModels Commands

Use /freeminecraftmodels or /fmm.

Setup and Content Management

CommandPurpose
/fmmOpens the craftable items menu for players (see Craftable Items Menu below)
/fmm adminOpens the admin content browser — browse installed packs, folders, models, and custom items (permission: freeminecraftmodels.admin)
/fmm initializeOpens the player-only first-time setup flow
/fmm setupOpens the player-only content-management menu
/fmm downloadallDownloads all currently accessible official content
/fmm updatecontentDownloads updates for outdated official content
/fmm reloadRe-imports content and regenerates the pack output
/fmm versionShows the plugin version (no permission required -- anyone can run this)
/fmm statsShows loaded-model statistics

Model Spawning and Placement

CommandPurpose
/fmm spawn static <id>Spawns a static model
/fmm spawn dynamic <id>Spawns a dynamic model
/fmm spawn prop <id>Creates a persistent prop entry and spawns it
/fmm itemify <id> <material>Creates a placeable item that spawns the chosen model as a prop
/fmm mount <id>Spawns an experimental rideable mount using a disguised horse
/fmm giveitem <item>Gives a custom FMM item to the player (permission: freeminecraftmodels.admin)
/fmm craftify <id>Opens an interactive recipe builder — place ingredients in a 3×3 grid then click the output to save a crafting recipe for that prop

Utilities

CommandPurpose
/fmm disguise <id>Disguises the player as a loaded model
/fmm undisguiseRemoves the player's disguise
/fmm hitbox visualize [duration]Visualizes hitboxes for debugging
/fmm deleteallRemoves all currently loaded modeled entities

Prop Placement Behavior

When a player right-clicks with a paper prop item (created via /fmm itemify or crafted via a /fmm craftify recipe), the following applies:

  • Item consumption: The paper item is consumed when the prop is placed, unless the player is in Creative mode.
  • Rotation: Props are placed facing the player's direction, snapped to 10-degree rotation increments. This gives players fine-grained control over prop orientation simply by adjusting where they are looking before placing.

Craftable Items Menu

Running /fmm with no arguments opens an inventory menu for players showing all craftable items that have been configured with recipes.

  • Each item in the menu represents a craftable FMM item.
  • Clicking an item opens a detail submenu that displays the spatial 3x3 crafting grid, an arrow, and the output item — showing the player exactly how to craft it in a crafting table.
  • Requires the freeminecraftmodels.menu permission (default: true, available to all players).

Admin Content Browser

Running /fmm admin opens an inventory menu for server administrators to browse:

  • Installed content packs
  • Folders and individual models
  • Custom items (models with material: set)

Requires the freeminecraftmodels.admin permission (default: op).

Recipe Builder

The /fmm craftify command lets you create a vanilla crafting-table recipe for any prop model.

  1. Run /fmm craftify <model_id> to open the recipe builder UI.
  2. A custom inventory opens with a 3×3 crafting grid and a pre-filled output item.
  3. Place ingredients from your inventory into the grid in whatever pattern you want.
  4. Click the output item (the prop's paper item) to save the recipe.
  5. Particles and a sound confirm the save.
  6. The recipe is saved to plugins/FreeMinecraftModels/recipes/<model_id>.yml and registered immediately.
  7. Players can now craft the prop item in any crafting table.
  8. Press Escape to cancel without saving — ingredients are returned to your inventory.
  9. Running craftify again for the same model overwrites the previous recipe.
  10. Recipes persist across server restarts and reloads.

Permissions

Registered in plugin.yml

PermissionDefaultDescription
freeminecraftmodels.*OPMost admin and spawn commands
freeminecraftmodels.adminOPAccess to /fmm admin content browser and /fmm giveitem
freeminecraftmodels.menutrueAccess to /fmm craftable items menu (available to all players)

Enforced by commands

PermissionDefaultDescription
freeminecraftmodels.deleteallOPAccess to /fmm deleteall (checked at runtime, not registered in plugin.yml)
  • initialize, setup, spawn, itemify, disguise, undisguise, mount, giveitem, craftify, and hitbox visualize are player-only commands.
  • version has no permission restriction and can be run by anyone (players or console).