Zum Hauptinhalt springen

FreeMinecraftModels Konfiguration

Diese Seite deckt die aktuellen config.yml-Einstellungen ab, die das Setup, das Rendering und die Spielerinteraktion wesentlich beeinflussen.

Dateipfad​

plugins/FreeMinecraftModels/config.yml

Aktuell verifizierte Einstellungen​

setupDone​

  • Standard: false
  • Steuert, ob die Erstkonfigurations-Hinweise als abgeschlossen gelten
  • Spieler mit breiten FreeMinecraftModels-Berechtigungen werden daran erinnert, /fmm initialize auszufuehren, solange dieser Wert false bleibt
  • Der Setup-Ablauf setzt diesen Wert selbst; waehrend des normalen Onboardings musst du ihn nicht von Hand bearbeiten

useDisplayEntitiesWhenPossible​

  • Standard: true
  • Sagt FreeMinecraftModels, dass wenn moeglich Display-Entity-Rendering bevorzugt werden soll, sofern Server und Client das unterstuetzen
  • Das Plugin faellt weiterhin zurueck, wenn Display Entities nicht verfuegbar sind
  • Bedrock-Clients sind ein Sonderfall, also gehe nicht davon aus, dass dies fuer jeden Spieler denselben Rendering-Pfad erzwingt

maxModelViewDistance​

  • Standard: 60
  • Begrenzt, wie weit modellierte Entities an Betrachter gesendet werden
  • Niedrigere Werte reduzieren Paket- und Client-Rendering-Last in dichten, modelllastigen Bereichen

maxInteractionAndAttackDistance​

  • Standard: 3
  • Gilt fuer statische und dynamische modellierte Entities
  • Wird von den Laufzeitpruefungen fuer Interaktionen und Treffererkennung verwendet

maxInteractionAndAttackDistanceForProps​

  • Standard: 6
  • Gilt fuer Prop-Entities
  • Dies ist getrennt von der Interaktionsdistanz fuer statische/dynamische Entities

sendCustomModelsToBedrockClients​

  • Standard: false
  • Steuert, ob FreeMinecraftModels versucht, benutzerdefinierte Modelle an Bedrock-Clients zu senden
  • Wenn deaktiviert, fallen Bedrock-Spieler auf die zugrunde liegende Vanilla-Entity zurueck, sofern eine vorhanden ist
  • Wenn du es aktivierst, stelle sicher, dass dein Bedrock-/Geyser-/Floodgate-Resource-Pack-Pfad fuer diese Clients wirklich bereit ist

Betriebshinweise​

  • /fmm reload importiert Inhalte erneut und erzeugt das Output-Pack neu, daher lassen sich Konfigurationsaenderungen, die das Rendering beeinflussen, nach einem Reload am einfachsten pruefen
  • FreeMinecraftModels erzeugt nur das Resource Pack; es hostet es nicht selbst
  • ResourcePackManager ist weiterhin der empfohlene Auslieferungsweg fuer Java-Clients und der am sichersten dokumentierte Weg fuer gemischte Setups

Wann du diese Werte aendern solltest​

Verwende diese Konfiguration fuer Laufzeit-Tuning, nicht fuer die Verwaltung von Content-Paketen.

  • Verwende /fmm initialize, /fmm setup, /fmm downloadall und /fmm updatecontent fuer den Lebenszyklus offizieller Pakete
  • Verwende den Ordner imports fuer manuelle .bbmodel- oder andere lokale Content-Importe
  • Verwende config.yml, wenn du Render-Modus, Sichtweite, Interaktionsdistanz oder Bedrock-Verhalten anpassen musst

Bekannte Einschraenkungen​

  • Das lokale Repo hat Versionsmetadaten-Drift zwischen plugin.yml und pom.xml, daher dokumentiert diese Seite bewusst Verhalten statt eine feste oeffentliche Versionsnummer festzulegen
  • Das Bedrock-Verhalten haengt sowohl von dieser Konfiguration als auch von deinem groesseren Floodgate-/Geyser-/Resource-Pack-Setup ab, daher sollten Aussagen konservativ bleiben, solange du deinen genauen Stack nicht getestet hast