Zum Hauptinhalt springen

FreeMinecraftModels Konfiguration

Diese Seite behandelt die aktuellen config.yml-Einstellungen, die die Einrichtung, das Rendering und die Spielerinteraktion wesentlich beeinflussen.

Dateispeicherort​

plugins/FreeMinecraftModels/config.yml

Aktuelle verifizierte Einstellungen​

setupDone​

  • Standard: false
  • Steuert, ob die Ersteinrichtungs-Anleitung als abgeschlossen gilt
  • Spieler mit umfassenden FreeMinecraftModels-Berechtigungen werden daran erinnert, /fmm initialize auszuführen, solange dies false bleibt
  • Der Einrichtungsablauf setzt diesen Wert für dich um; du musst ihn während des normalen Onboardings nicht manuell bearbeiten

useDisplayEntitiesWhenPossible​

  • Standard: true
  • Weist FreeMinecraftModels an, Display-Entity-Rendering zu bevorzugen, wenn der Server- und Client-Pfad dies unterstützt
  • Das Plugin fällt zurück, wenn Display-Entities nicht verfügbar sind
  • Bedrock-Clients sind ein Sonderfall, daher sollte nicht davon ausgegangen werden, dass dies für jeden Spieler denselben Rendering-Pfad erzwingt

maxModelViewDistance​

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

maxInteractionAndAttackDistance​

  • Standard: 3
  • Gilt für statische und dynamische modellierte Entities
  • Wird von den Laufzeit-Interaktions- und Treffererkennungsprüfungen verwendet

maxInteractionAndAttackDistanceForProps​

  • Standard: 6
  • Gilt für Prop-Entities
  • Dies ist getrennt von der Interaktionsdistanz für 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 zurück, sofern eine existiert
  • Wenn du dies aktivierst, stelle sicher, dass dein Bedrock/Geyser/Floodgate-Ressourcenpaket-Pfad tatsächlich für diese Clients bereit ist

Betriebshinweise​

  • /fmm reload importiert Inhalte erneut und generiert das Ausgabepaket neu, sodass Konfigurationsänderungen, die das Rendering-Verhalten betreffen, am einfachsten nach einem Reload validiert werden können
  • FreeMinecraftModels generiert nur das Ressourcenpaket; es hostet es nicht selbst
  • ResourcePackManager ist weiterhin der empfohlene Übermittlungsweg für Java-Clients und der sicherste dokumentierte Weg für gemischte Setups

Wann diese Werte geändert werden sollten​

Verwende diese Konfiguration für die Anpassung des Laufzeitverhaltens, nicht für die Inhaltspaketverwaltung.

  • Verwende /fmm initialize, /fmm setup, /fmm downloadall und /fmm updatecontent für die Lebenszyklusverwaltung offizieller Pakete
  • Verwende den imports-Ordner für manuelle .bbmodel- oder andere lokale Inhaltsimporte
  • Verwende config.yml, wenn du den Rendering-Modus, die Sichtweite, die Interaktionsdistanz oder das Bedrock-Verhalten anpassen musst

Bekannte Einschränkungen​

  • Das lokale Repository hat Versionsmetadaten-Abweichungen zwischen plugin.yml und pom.xml, daher dokumentiert diese Seite absichtlich Verhalten statt eine feste öffentliche Versionszeichenfolge festzulegen
  • Das Bedrock-Verhalten hängt sowohl von dieser Konfiguration als auch von deinem gesamten Floodgate/Geyser/Ressourcenpaket-Setup ab, daher sollten Aussagen konservativ gehalten werden, es sei denn, du hast deinen genauen Stack getestet