FreeMinecraftModels Befehle

registerCraftingRecipes in config.yml ist standardmäßig true. Setze es für eine reine Kaufwirtschaft auf false und starte neu: Rezepte bleiben in Menüs und Shop sichtbar, ihre Bukkit-Crafting-Rezepte werden jedoch entfernt. Die Crafting-Anleitungen auf dieser Seite setzen true voraus.

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 setup	Öffnet das spieler-exklusive Inhaltsverwaltungs-/Ersteinrichtungsmenü (der Befehl, auf den Spieler beim ersten Start hingewiesen werden)
/fmm recommendedplugins	Zeigt Begleit-Plugins, die gut mit FreeMinecraftModels zusammenpassen (öffnet ein Katalogmenü für Spieler, gibt eine Liste für die Konsole aus)
/fmm downloadall	Lädt das neueste Plugin-Update und alle verfügbaren offiziellen Inhalte herunter. Haben sich Inhalte geändert, führt FMM einen Reload durch, um sie anzuwenden; das heruntergeladene Plugin-Jar erfordert weiterhin einen Server-Neustart. Schlägt der Plugin-Update-Schritt mangels Nightbreak-Token oder wegen eines Auth-Fehlers fehl, wird der Inhaltsschritt vollständig übersprungen
/fmm downloadallcontent	Lädt alle verfügbaren offiziellen Inhalte herunter (nur Inhalte, kein Plugin-Jar-Update) und führt einen Reload durch, wenn sich mindestens ein Paket geändert hat
/fmm updatecontent	Lädt Updates für veraltete offizielle Inhalte herunter und führt einen Reload durch, wenn sich mindestens ein Paket geändert hat (Alias: /fmm updateallcontent)
/fmm downloadpluginupdate	Lädt nur das neueste Plugin-Jar-Update herunter (wird nach dem nächsten Server-Neustart angewendet)
/fmm forcereinstallcontent <package|all>	Reparaturbefehl — lädt bereits vorhandene Inhalte erneut herunter, selbst wenn die Versionsnummern sagen, sie seien aktuell. Tab-vervollständigt all sowie jeden Nightbreak-Paket-Slug. all deckt jedes als heruntergeladen erkannte Paket ab; fehlen die Dateien eines Pakets vollständig, gib stattdessen dessen Slug direkt an. Führt anschließend einen Reload durch (Berechtigung: freeminecraftmodels.*)
/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

Gemeinsame Nightbreak-Befehle

Diese werden von MagmaCore registriert und nicht von FreeMinecraftModels selbst, es sind also Befehle der obersten Ebene, keine /fmm-Unterbefehle.

Befehl	Zweck
/nightbreaklogin <token>	Speichert das gemeinsame Nightbreak-Konto-Token für diesen Server und schaltet damit offizielle Inhalts-Downloads und Plugin-Updates frei (Berechtigung: nightbreak.login, Standard: op). Wird einmal pro Server registriert — das zuerst geladene Nightbreak-Plugin besitzt ihn
/nightbreaklogout	Löscht das gespeicherte Nightbreak-Konto-Token von diesem Server (Berechtigung: nightbreak.login, Standard: op). Akzeptiert sowohl Spieler als auch Konsole
/freeminecraftmodelschangelog [dismiss|disable]	Zeigt ungelesene FreeMinecraftModels-Release-Notes (Plugin-Releases und verfolgte Inhaltspakete). dismiss markiert die aktuell angezeigten Notizen als gelesen; disable blendet Changelog-Erinnerungen für dich dauerhaft aus. Nur für Spieler und nur für Admins — ein Spieler benötigt freeminecraftmodels.*, eine der Setup-/Admin-Berechtigungen oder OP. Besitzt bereits ein anderes Plugin das Label /freeminecraftmodelschangelog, registriert sich der Befehl unter einem Namespace-Fallback wie /freeminecraftmodels:freeminecraftmodelschangelog

Admins mit ungelesenen Release-Notes werden beim Beitritt im Chat mit einer anklickbaren [VIEW CHANGELOG]-Aufforderung darauf hingewiesen; die Übersicht bietet die Schaltflächen Dismiss These Updates und Never Show Changelogs, die dasselbe tun wie die beiden Unterbefehle. Der Lesestatus pro Spieler liegt in plugins/FreeMinecraftModels/nightbreak-changelogs.yml.

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. Wird mit A prop of that model already exists on this block. abgelehnt, wenn auf diesem Block bereits ein Prop desselben Modells geladen ist
/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.self + 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.self + 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|props> [on|off]	Laufzeit-Schalter für FMMs Diagnose-Logstreams. bedrock schaltet den [FMM-BedrockDebug]-Stream um, der die Bedrock-Display-Pipeline diagnostiziert; props schaltet den Scan gestapelter Props um, wodurch bei jedem Chunk-Laden je zwei Props im Abstand von unter 0,1 Blöcken als STACKED PROPS DETECTED gemeldet werden. Lässt du das Statusargument weg, wird der aktuelle Zustand gemeldet, ohne ihn zu ändern. on/true/enable/enabled und off/false/disable/disabled werden alle akzeptiert. Beide Schalter werden beim Plugin-Reload immer auf OFF zurückgesetzt — bewusst keine Config-Schlüssel, damit sie nicht versehentlich aktiviert bleiben. Akzeptiert sowohl Spieler als auch Konsole (Berechtigung: freeminecraftmodels.*)
/fmm packetdebug [ticks]	Einmalige Paketlast-Diagnose. Erfasst den Paketverkehr modellierter Entitäten für die nächsten [ticks] Modelluhr-Ticks (Standard 1, gedeckelt bei 200) und meldet logische Pakete/Tick, tatsächlich ausgelieferte Pakete/Tick einschließlich der Fan-out-Verteilung pro Betrachter, den schlimmsten einzelnen Spieler/Tick, eine Aufschlüsselung nach Pakettyp sowie die schwersten Betrachter. Tab-vervollständigt 1, 5, 20, 60. Führe ihn aus, während du im ruckelnden Bereich stehst. Die Paketzahlen sind exakt; die Byte-Angaben sind Schätzungen. Läuft mit einer Warnung ab, wenn keine Stichprobe zustande kommt (keine modellierten Entitäten geladen oder NMS deaktiviert). Akzeptiert sowohl Spieler als auch Konsole (Berechtigung: freeminecraftmodels.*)
/fmm deleteall [radius]	Entfernt alle geladenen modellierten Entitäten und persistenten Props. Ohne Argument wird alles entfernt; ein optionaler [radius] (nur für Spieler) beschränkt die Entfernung auf Entitäten innerhalb so vieler Blöcke um den Spieler

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.
• Ein Prop pro Modell pro Block: Die Platzierung wird mit A prop of that model already exists on this block. abgelehnt, wenn auf diesem Block bereits ein Prop desselben Modells geladen ist. Bei einer abgelehnten Platzierung wird das Item nicht verbraucht.
• Nur Haupthand: Nur die Haupthand-Hälfte des Interaktions-Events platziert einen Prop, sodass ein einzelner Rechtsklick nicht mehr zwei Props erzeugen kann.
• Duplikatbereinigung: Beim Serverstart und bei jedem Chunk-Laden sucht FreeMinecraftModels nach Prop-Armor-Stands, die sich Modell und Block teilen, behält einen und entfernt den Rest. Entfernungen werden als [FMM Props] Removed N duplicate prop armor stand(s) ... protokolliert.

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.

Format der Rezeptdatei

isEnabled: true
model_id: "wooden_chair"
shape:
  - "L L"
  - "LLL"
  - "L L"
ingredients:
  L: OAK_LOG
shopEnabled: true
shopPrice: 250.0

Feld	Erforderlich	Hinweise
isEnabled	ja (Standard true)	Auf false setzen, um das Rezept abzumelden, ohne die Datei zu löschen
model_id	ja	Das Modell, das das gecraftete Papier-Item platziert. Eine Modell-ID mit einem Bogen-/Armbrust-Zustandssuffix wird automatisch auf die Basis-Modell-ID umgeschrieben
shape	ja	Bis zu drei Zeilen mit bis zu drei Zeichen. Ein Leerzeichen bedeutet „leerer Slot"
ingredients	ja	Zuordnung eines einzelnen Formzeichens zu einem Bukkit-Materialnamen. Unbekannte Materialien werden stillschweigend verworfen
shopEnabled	nein (Standard true)	Ob das Rezept in /fmm shop gelistet wird
shopPrice	nein (Standard defaultPrice aus shop_config.yml)	Vault-Währungskosten im Shop

Der registrierte Bukkit-Rezeptschlüssel ist freeminecraftmodels:prop_recipe_<model_id>, und die Ausgabe ist immer das Papier-Platzierungs-Item des Modells. Ein erneutes Ausführen von /fmm craftify für dasselbe Modell überschreibt die Datei und registriert sie unter demselben Schlüssel neu.

Berechtigungen

In plugin.yml registriert

Berechtigung	Standard	Beschreibung
freeminecraftmodels.*	OP	Wildcard, die freeminecraftmodels.admin, freeminecraftmodels.deleteall, freeminecraftmodels.disguise.self, freeminecraftmodels.disguise.others und freeminecraftmodels.bypassregionprotection 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, /fmm packetdebug, /fmm location, /fmm setup, /fmm initialize, /fmm recommendedplugins, /fmm downloadall, /fmm downloadallcontent, /fmm updatecontent, /fmm downloadpluginupdate und /fmm forcereinstallcontent erforderlich ist
freeminecraftmodels.admin	OP	Zugriff auf /fmm admin (den Admin-Inhaltsbrowser) und /fmm giveitem
freeminecraftmodels.deleteall	OP	Kind der Wildcard; Zugriff auf /fmm deleteall
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.bypassregionprotection	OP	Erlaubt das Platzieren von und Interagieren mit Props überall dort, wo ein anderes Plugin normales Blocksetzen blockieren würde, selbst wenn preventPropPlacementInProtectedRegions aktiviert ist
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)

Gezielte disguise- und undisguise-Befehle benötigen sowohl freeminecraftmodels.disguise.self als auch freeminecraftmodels.disguise.others. disguiselist benötigt nur .others.

Von MagmaCore registriert

Berechtigung	Standard	Beschreibung
nightbreak.login	OP	Erforderlich für die gemeinsamen Befehle /nightbreaklogin und /nightbreaklogout. Wird einmal pro Server von dem zuerst geladenen Nightbreak-Plugin registriert

Hinweise zum Sender

• initialize, setup, spawn, itemify, mount, giveitem, craftify, hitbox visualize, location, admin und shop sind ausschließlich Spielerbefehle. /freeminecraftmodelschangelog ist ebenfalls nur für Spieler.
• recommendedplugins, downloadall, downloadallcontent, updatecontent, downloadpluginupdate, forcereinstallcontent, packetdebug, debug, deleteall, /nightbreaklogin und /nightbreaklogout akzeptieren sowohl Spieler als auch Konsole (ein deleteall-Radius ist nur für Spieler).
• 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).
• /fmm initialize öffnet das Ersteinrichtungsmenü für Spieler mit freeminecraftmodels.*. Verwende /fmm setup für die tägliche Inhaltsverwaltung.