FreeMinecraftModels Setup

FreeMinecraftModels still supports manual .bbmodel imports, but the current setup flow is Nightbreak-aware and menu-driven.

Prerequisites

• A Java 21 runtime for the server
• FreeMinecraftModels installed and started once so it can generate its data folders
• A way to deliver the generated resource pack to players

ResourcePackManager is the recommended delivery path because FreeMinecraftModels only generates the pack; it does not host it by itself.

First-Time Flow

Command	Purpose
/fmm initialize	Player-only first-time onboarding menu
/fmm setup	Player-only content-management menu
/fmm downloadall	Bulk install helper for accessible Nightbreak packs
/fmm updatecontent	Bulk update helper for outdated Nightbreak packs
/nightbreaklogin <token>	Shared Nightbreak token registration

If config.yml still has setupDone: false, players with freeminecraftmodels.* get a login reminder telling them to run /fmm initialize.

Recommended Workflow

1. Install FreeMinecraftModels and start the server once.
2. Run /fmm initialize.
3. Link a Nightbreak token with /nightbreaklogin <token>.
4. Open /fmm setup to inspect available packs and current state.
5. Use /fmm downloadall if you want to install every official pack your token can access.
6. Use /fmm updatecontent later to refresh outdated official packs.
7. Make sure players receive the generated output/FreeMinecraftModels.zip pack, usually through ResourcePackManager.

Manual Model Imports

Direct model import still works through:

plugins/FreeMinecraftModels/imports

That path is still useful for:

• local development
• custom models you are not pulling from Nightbreak
• converting .bbmodel content into the current runtime format when you run /fmm reload

Manual imports and official package downloads both end up depending on a reload/import pass before the runtime model list and resource pack are rebuilt.

Official Content Packs

The current plugin ships with two premade Nightbreak-managed packages:

• BetterStructures Prop Pack
• EliteMobs Prop Pack

These appear inside /fmm setup, can be bulk-downloaded with /fmm downloadall, and can be updated with /fmm updatecontent.

Resource Pack Reminder

FreeMinecraftModels always needs its generated resource-pack output to reach the client one way or another.

See Resource pack output for the current output paths and ResourcePackManager integration.