Skip to main content

FreeMinecraftModels Content Packages

Official FMM content is now exposed as managed Nightbreak packages.

Current Official Packages​

The current plugin defines three premade official packages:

  • Basic Furniture Pack
  • BetterStructures Prop Pack
  • EliteMobs Prop Pack

Each package has a local folder name, a Nightbreak slug, a version field, and an enabled/disabled state in content_packages.

What The Setup Menu Manages​

/fmm setup is the current source of truth for package state. The menu can distinguish between:

  • installed packages
  • downloaded but currently disabled packages
  • outdated packages
  • packages that require Nightbreak access

The setup menu also triggers background refreshes for package versions and access checks, so the menu is the right place to verify current package state.

Folder Behavior​

The plugin uses package-state folder moves for enabled and disabled content:

  • enabled model folders live in models/<folderName>
  • disabled model folders live in models_disabled/<folderName>
  • enabled script files live in scripts/
  • disabled script files live in scripts_disabled/

That means a package can be fully downloaded on disk without being active in the runtime model list. When a package is installed or uninstalled, both its model folder and any matching script files are moved together.

File Prefixes​

Each content package config has a contentFilePrefixes field and a scriptFilePrefixes field (both default to the package's folderName). Content files whose names start with any of the contentFilePrefixes and script files in the scripts/ folder whose names start with any of the scriptFilePrefixes are considered part of the package and are moved with it during install/uninstall.

Download and Install Lifecycle​

There are two distinct steps:

  1. Download the package content. Downloads go into plugins/FreeMinecraftModels/imports and then trigger a reload/import pass.
  2. Keep the package enabled or disabled. The setup menu installs and uninstalls packages by moving their folders between models and models_disabled.

Bulk operations follow the same model:

  • /fmm downloadall downloads every accessible package that is missing or outdated
  • /fmm updatecontent updates only outdated packages

Both bulk commands reload FreeMinecraftModels automatically after successful downloads so the newly downloaded content becomes available.

Admin Content Browser​

/fmm admin opens an in-game inventory GUI that lets admins browse all installed content at a glance. The browser shows:

  • all installed packages (with separate prop and item counts)
  • unpackaged model folders (with separate prop and item counts)
  • individual props (models without material: in their YML config)
  • custom items (models that have material: set in their YML config)

Props and items are displayed distinctly: props use yellow styling and a paper icon, while custom items use purple styling and show their configured material. A model that has material: set in its YML config appears only as a custom item, never as both a prop and an item.

Clicking any entry in the admin browser gives the player a copy of that item. For custom items, the given item includes the configured material, enchantments, lore, and the fmm_item_id PDC tag. This is the fastest way to obtain props, custom items, or model items for testing and building without needing to know the exact model ID or command syntax.