FreeMinecraftModels Befehle

Verwende /freeminecraftmodels oder /fmm.

Einrichtung und Inhaltsverwaltung

Befehl	Zweck
/fmm	Öffnet das Menü craftbarer Items für Spieler (siehe Menü craftbarer Items unten)
/fmm admin	Öffnet den Admin-Inhaltsbrowser — durchsuche installierte Pakete, Ordner, Modelle und benutzerdefinierte Items (Berechtigung: freeminecraftmodels.admin)
/fmm initialize	Öffnet den spieler-exklusiven Ersteinrichtungs-Ablauf
/fmm setup	Öffnet das spieler-exklusive Inhaltsverwaltungsmenü
/fmm downloadall	Lädt alle derzeit zugänglichen offiziellen Inhalte herunter
/fmm updatecontent	Lädt Updates für veraltete offizielle Inhalte herunter
/fmm reload	Importiert Inhalte erneut und regeneriert die Paketausgabe
/fmm version	Zeigt die Plugin-Version (keine Berechtigung erforderlich — jeder kann diesen Befehl ausführen)
/fmm stats	Zeigt Statistiken zu geladenen Modellen

Modell-Spawning und -Platzierung

Befehl	Zweck
/fmm spawn static <id>	Spawnt ein statisches Modell
/fmm spawn dynamic <id>	Spawnt ein dynamisches Modell
/fmm spawn prop <id>	Erstellt einen persistenten Prop-Eintrag und spawnt ihn
/fmm itemify <id> <material>	Erstellt ein platzierbares Item, das das gewählte Modell als Prop spawnt
/fmm mount <id>	Spawnt ein experimentelles reitbares Reittier mit einem verkleideten Pferd
/fmm giveitem <item>	Gibt dem Spieler ein benutzerdefiniertes FMM-Item (Berechtigung: freeminecraftmodels.admin)
/fmm craftify <id>	Öffnet einen interaktiven Rezept-Builder — platziere Zutaten in einem 3×3-Gitter und klicke dann auf die Ausgabe, um ein Crafting-Rezept für diesen Prop zu speichern

Spieler-Verkleidungen

Befehl	Zweck
/fmm disguise <modelID> [player]	Verkleidet einen Spieler als geladenes Modell. Ohne Ziel-Argument wird der Sender verkleidet. Mit Ziel erfordert es freeminecraftmodels.disguise.others und funktioniert auch von der Konsole
/fmm undisguise [player]	Entfernt die Verkleidung. Ohne Ziel wird der Sender enthüllt. Mit Ziel erfordert es freeminecraftmodels.disguise.others und funktioniert auch von der Konsole
/fmm disguiselist	Listet derzeit verkleidete Spieler und das Modell auf, als das sie verkleidet sind (Berechtigung: freeminecraftmodels.disguise.others)

Verhalten der Verkleidung:

• Eine neue Verkleidung ersetzt eine vorhandene Verkleidung dieses Spielers sauber.
• Verkleidete Spieler werden für andere Spieler unsichtbar gemacht, sodass nur das Modell sichtbar ist. Die Unsichtbarkeit bleibt durch Milcheimer und andere effekt-entfernende Interaktionen erhalten.
• Drittanbieter-Plugins können Verkleidungen über die öffentliche DisguiseAPI steuern (siehe API- & Entwicklerhandbuch).

Möbelshop

Befehl	Zweck
/fmm shop	Öffnet den optionalen Vault-gestützten Möbelshop, in dem Spieler craftbare Props mit In-Game-Währung kaufen können (Berechtigung: freeminecraftmodels.shop, Standard: true)

Der Shop ist standardmäßig deaktiviert und registriert sich nur, wenn:

• enabled: true in shop_config.yml gesetzt ist
• Vault installiert ist
• Ein Vault-kompatibler Wirtschafts-Provider registriert ist

Fehlt eines davon, wird /fmm shop nicht registriert (oder zeigt die konfigurierbare „Shop deaktiviert"-Nachricht, falls zur Laufzeit zwangsweise deaktiviert). Siehe Konfiguration für die Shop-Konfigurationsschlüssel und die Felder shopEnabled / shopPrice pro Rezept.

Werkzeuge

Befehl	Zweck
/fmm hitbox visualize [duration]	Visualisiert Hitboxen zum Debuggen
/fmm location	Diagnose-Befehl — meldet, wie viele Dungeon-Detektoren und Schutzanbieter mit LocationAPI registriert sind, und testet beide Prädikate an deinem aktuellen Standort (Berechtigung: freeminecraftmodels.*)
/fmm debug bedrock [on|off]	Laufzeit-Schalter für den [FMM-BedrockDebug]-Logstream, der die Bedrock-Display-Pipeline diagnostiziert. Lässt du das Statusargument weg, wird gemeldet, ob das Logging derzeit aktiv ist. Wird beim Plugin-Reload immer auf OFF zurückgesetzt — bewusst kein Config-Schlüssel, damit es nicht versehentlich aktiviert bleibt. Akzeptiert sowohl Spieler als auch Konsole (Berechtigung: freeminecraftmodels.*)
/fmm deleteall	Entfernt alle derzeit geladenen modellierten Entitäten

Verhalten bei Prop-Platzierung

Wenn ein Spieler mit einem Papier-Prop-Item rechtsklickt (erstellt über /fmm itemify oder gecraftet über ein /fmm craftify-Rezept), gilt Folgendes:

• Item-Verbrauch: Das Papier-Item wird beim Platzieren des Props verbraucht, außer der Spieler befindet sich im Kreativmodus.
• Rotation: Props werden in Blickrichtung des Spielers platziert, eingerastet auf 10-Grad-Rotationsschritte. Das gibt Spielern feine Kontrolle über die Prop-Ausrichtung, einfach indem sie ihre Blickrichtung vor dem Platzieren anpassen.

Menü craftbarer Items

Das Ausführen von /fmm ohne Argumente öffnet ein Inventarmenü für Spieler, das alle craftbaren Items zeigt, für die Rezepte konfiguriert wurden.

• Jedes Item im Menü repräsentiert ein craftbares FMM-Item.
• Ein Klick auf ein Item öffnet ein Detail-Untermenü, das das räumliche 3x3-Crafting-Gitter, einen Pfeil und das Ausgabe-Item anzeigt — und dem Spieler so genau zeigt, wie es in einem Crafting-Tisch hergestellt wird.
• Erfordert die Berechtigung freeminecraftmodels.menu (Standard: true, für alle Spieler verfügbar).

Admin-Inhaltsbrowser

Das Ausführen von /fmm admin öffnet ein Inventarmenü, in dem Server-Administratoren Folgendes durchsuchen können:

• Installierte Inhaltspakete
• Ordner und einzelne Modelle
• Benutzerdefinierte Items (Modelle mit gesetztem material:)

Erfordert die Berechtigung freeminecraftmodels.admin (Standard: op).

Rezept-Builder

Mit dem Befehl /fmm craftify kannst du ein vanilla Crafting-Tisch-Rezept für jedes Prop-Modell erstellen.

1. Führe /fmm craftify <model_id> aus, um die Benutzeroberfläche des Rezept-Builders zu öffnen.
2. Ein benutzerdefiniertes Inventar mit einem 3×3-Crafting-Gitter und einem vorausgefüllten Ausgabe-Item öffnet sich.
3. Platziere Zutaten aus deinem Inventar in das Gitter in einem beliebigen Muster.
4. Klicke auf das Ausgabe-Item (das Papier-Item des Props), um das Rezept zu speichern.
5. Partikel und ein Sound bestätigen das Speichern.
6. Das Rezept wird unter plugins/FreeMinecraftModels/recipes/<model_id>.yml gespeichert und sofort registriert.
7. Spieler können das Prop-Item nun in jedem Crafting-Tisch herstellen.
8. Drücke Escape, um abzubrechen, ohne zu speichern — Zutaten werden in dein Inventar zurückgegeben.
9. Wenn du craftify für dasselbe Modell erneut ausführst, wird das vorherige Rezept überschrieben.
10. Rezepte bleiben nach Server-Neustarts und -Reloads erhalten.

Gespeicherte Rezeptdateien enthalten die Felder shopEnabled (Standard true) und shopPrice (Standardwert aus shop_config.yml), die steuern, wie das Rezept gegenüber /fmm shop freigegeben wird.

Berechtigungen

In plugin.yml registriert

Berechtigung	Standard	Beschreibung
freeminecraftmodels.*	OP	Wildcard, die freeminecraftmodels.admin, freeminecraftmodels.disguise.self und freeminecraftmodels.disguise.others gewährt. Der Wildcard-String ist gleichzeitig auch die wörtliche Berechtigung, die für /fmm reload, /fmm stats, /fmm spawn, /fmm itemify, /fmm craftify, /fmm mount, /fmm hitbox visualize, /fmm debug bedrock, /fmm location, /fmm setup, /fmm initialize, /fmm downloadall und /fmm updatecontent erforderlich ist
freeminecraftmodels.admin	OP	Zugriff auf /fmm admin (den Admin-Inhaltsbrowser) und /fmm giveitem
freeminecraftmodels.disguise.self	OP	Erlaubt /fmm disguise und /fmm undisguise, die nur auf den Sender abzielen
freeminecraftmodels.disguise.others	OP	Erlaubt /fmm disguise <model> <player>, /fmm undisguise <player> und /fmm disguiselist
freeminecraftmodels.menu	true	Zugriff auf das /fmm-Menü craftbarer Items (für alle Spieler verfügbar)
freeminecraftmodels.shop	true	Zugriff auf /fmm shop (für alle Spieler verfügbar, wenn der Shop aktiviert ist)

Von Befehlen erzwungen

Berechtigung	Standard	Beschreibung
freeminecraftmodels.deleteall	OP	Zugriff auf /fmm deleteall (wird zur Laufzeit geprüft, nicht in plugin.yml registriert)

• initialize, setup, spawn, itemify, mount, giveitem, craftify, hitbox visualize, location und shop sind ausschließlich Spielerbefehle.
• disguise und undisguise akzeptieren einen Ziel-Spieler und können von der Konsole aus ausgeführt werden, solange ein Ziel angegeben ist.
• version hat keine Berechtigungseinschränkung und kann von jedem ausgeführt werden (Spieler oder Konsole).