Skip to main content

FreeMinecraftModels Content Packages

Official FMM content is now exposed as managed Nightbreak packages.

Current Official Packages​

The current plugin defines two premade official packages:

  • 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 now uses package-state folder moves for enabled and disabled content:

  • enabled package folders live in models/<folderName>
  • disabled package folders live in models_disabled/<folderName>

That means a package can be fully downloaded on disk without being active in the runtime model list.

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.