FreeMinecraftModels Commands
Use /freeminecraftmodels or /fmm.
Setup and Content Management
| Command | Purpose |
|---|---|
/fmm | Opens the craftable items menu for players (see Craftable Items Menu below) |
/fmm admin | Opens the admin content browser — browse installed packs, folders, models, and custom items (permission: freeminecraftmodels.admin) |
/fmm initialize | Opens the player-only first-time setup flow |
/fmm setup | Opens the player-only content-management menu |
/fmm downloadall | Downloads all currently accessible official content |
/fmm updatecontent | Downloads updates for outdated official content |
/fmm reload | Re-imports content and regenerates the pack output |
/fmm version | Shows the plugin version (no permission required -- anyone can run this) |
/fmm stats | Shows loaded-model statistics |
Model Spawning and Placement
| Command | Purpose |
|---|---|
/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
| Command | Purpose |
|---|---|
/fmm disguise <id> | Disguises the player as a loaded model |
/fmm undisguise | Removes the player's disguise |
/fmm hitbox visualize [duration] | Visualizes hitboxes for debugging |
/fmm deleteall | Removes 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.menupermission (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.
- Run
/fmm craftify <model_id>to open the recipe builder UI. - A custom inventory opens with a 3×3 crafting grid and a pre-filled output item.
- Place ingredients from your inventory into the grid in whatever pattern you want.
- Click the output item (the prop's paper item) to save the recipe.
- Particles and a sound confirm the save.
- The recipe is saved to
plugins/FreeMinecraftModels/recipes/<model_id>.ymland registered immediately. - Players can now craft the prop item in any crafting table.
- Press Escape to cancel without saving — ingredients are returned to your inventory.
- Running craftify again for the same model overwrites the previous recipe.
- Recipes persist across server restarts and reloads.
Permissions
Registered in plugin.yml
| Permission | Default | Description |
|---|---|---|
freeminecraftmodels.* | OP | Most admin and spawn commands |
freeminecraftmodels.admin | OP | Access to /fmm admin content browser and /fmm giveitem |
freeminecraftmodels.menu | true | Access to /fmm craftable items menu (available to all players) |
Enforced by commands
| Permission | Default | Description |
|---|---|---|
freeminecraftmodels.deleteall | OP | Access to /fmm deleteall (checked at runtime, not registered in plugin.yml) |
initialize,setup,spawn,itemify,disguise,undisguise,mount,giveitem,craftify, andhitbox visualizeare player-only commands.versionhas no permission restriction and can be run by anyone (players or console).