Skip to content

Latest changelog

Loading the latest changelog…

How to set up FreeMinecraftModels

FreeMinecraftModels Plugin Setup

  1. Place FreeMinecraftModels in your plugins folder and start the server (Java 21+, Minecraft 1.21.4+).
  2. (Optional & Recommended) Add ResourcePackManager so players get the resource pack automatically.
  3. Run /fmm initialize and choose Recommended Setup.

FreeMinecraftModels Content Setup

  1. Run /nightbreaklogin in game or from the console. It gives you a link and a short code.
  2. Open the link, sign in or make a free Nightbreak account, and approve the server. It connects right away, with no token to copy and no restart.
  3. Install packs from /fmm setup, or run /fmm downloadallcontent to get everything your account can access.

Manual Content Setup

  1. Download the content you want from the list below.
  2. Put the zip in plugins/FreeMinecraftModels/imports. Do not unzip it.
  3. Restart the server (recommended) or run /fmm reload.
  4. Open /fmm setup to check that it installed correctly.

Updating content

Run /fmm updatecontent, or turn on Automatic Updates in /fmm setup. For manual installs, repeat the steps above with the new zip. No need to uninstall anything!

Resource pack

Players need the resource pack to see models. FMM generates it at plugins/FreeMinecraftModels/output/FreeMinecraftModels.zip and ResourcePackManager can send it to players for you. Without ResourcePackManager, you need to host it yourself.

The full guide is in the docs