FreeMinecraftModels

FreeMinecraftModels ist sowohl eine Laufzeitumgebung für benutzerdefinierte Modelle als auch eine API für Entwickler.

Das Plugin bietet:

• einen Ersteinrichtungs-Ablauf und eine Erinnerung beim Beitritt, bis die Einrichtung als abgeschlossen markiert ist
• ein Nightbreak-gestütztes Einrichtungsmenü für offizielle Modellpaket-Installationen und -Updates
• einen generierten Ressourcenpaket-Ordner unter plugins/FreeMinecraftModels/output/FreeMinecraftModels
• ein gezipptes Paket-Artefakt unter plugins/FreeMinecraftModels/output/FreeMinecraftModels.zip
• eine erweiterte Befehlsoberfläche für Einrichtung, Inhaltsaktualisierungen, Spawning, Verkleidungen, Props und Debugging
• Mount-Point-Bones — Bones, deren Name mit m_ beginnt, erzeugen reitbare Sitzpunkte an einem Modell, sodass Spieler benutzerdefinierte Entitäten reiten können
• Benutzerdefiniertes Display-Modell-JSON — platziere eine begleitende .json-Datei (Blockbench-Display-Item-Export) neben einer .bbmodel-Datei, um das In-Game-Aussehen des Items zu überschreiben (erfordert 1.21.4+)
• Benutzerdefinierte Items und magische Waffen — gehaltene Modelle mit Verzauberungen, deren Namen einen Namespace enthalten, sowie eigens definierte Zauberstäbe und Stäbe
• Blockbench-Partikel — Partikel-Keyframes in den Animationen eines Modells werden auf benutzerdefinierten Entitäten, Props und gehaltenen Items abgespielt, für Java- und Bedrock-Spieler. Siehe Partikel
• Admin-Inhaltsbrowser (/fmm admin) — ein Inventarmenü für geladene Modelle und erfolgreich registrierte benutzerdefinierte Items, gruppiert nach aktiviertem Paket oder Ordner
• Spieler-Menü für craftbare Items (/fmm) — zeigt registrierte Prop-Rezepte mit 3x3-Raster und Ergebnis; Einträge ohne registriertes Rezept fehlen
• Spieler-Verkleidungssystem — /fmm disguise <model> [player], /fmm undisguise [player], /fmm disguiselist, mit einer öffentlichen DisguiseAPI für Drittanbieter-Plugins
• Möbelshop — optionaler Vault-gestützter /fmm shop zum Verkauf von Papier-Items zur Prop-Platzierung, konfigurierbar pro Rezept über shopEnabled / shopPrice; gültige Shop-Einträge können bei deaktivierter Rezeptregistrierung verfügbar bleiben
• Spieler-UI-API — Lua-Skripte können Boss-Bars, Action-Bars und Titel für Spieler anzeigen
• LocationAPI — Drittanbieter-Plugins können Dungeon-Detektoren und Schutzanbieter registrieren, die FMMs Lua-Prädikate em.location.is_in_dungeon und em.location.is_protected sowie die Prop-Platzierungsprüfung in geschützten Regionen antreiben
• Changelogs im Spiel — Admins werden beim Beitritt darauf hingewiesen, wenn ungelesene FreeMinecraftModels-Release-Notes vorliegen, und können sie mit /freeminecraftmodelschangelog durchsehen
• Inhalts-Reparatur — /fmm forcereinstallcontent <package|all> lädt Inhalte erneut herunter, die nominell aktuell sind, für den Fall, dass die Dateien eines Pakets beschädigt sind oder fehlen
• Plugin-Updates ohne Neustart — /fmm applypluginupdate oder die Einstellung nightbreak.applyPluginUpdatesWithoutRestart spielt ein heruntergeladenes Plugin-Jar ein, während der Server läuft. Siehe Konfiguration
• Filmic-Modus — /fmm filmic on|off oder filmicMode sendet für ReplayMod-Aufnahmen jedem Spieler jedes geladene Modell in seinen geladenen Chunks, auch außerhalb der Sichtlinie. Siehe Konfiguration

FreeMinecraftModels deklariert api-version: 1.21.4, Minecraft 1.21.4 ist also die minimal unterstützte Serverversion.

Hier starten

• Einrichtung

• Inhaltspakete

• Befehle

• Konfiguration

• Spieler-Verkleidungen

• Möbelshop

• Ressourcenpaket-Ausgabe

• Hinweise zur Modellerstellung

• Animationen

• API und Entwicklerhandbuch

• FAQ

• Lua: Erste Schritte

• Lua: Prop-API

• Lua: Beispiele

• Lua: Fehlerbehebung

Lua-Skripting

FreeMinecraftModels unterstützt Lua-Skripte für Props über die Skript-Engine von MagmaCore 2.0. Skripte befinden sich in plugins/FreeMinecraftModels/scripts/.

Aktive Prop-Hooks (8)

Prop-Skripte können auf folgende Hooks reagieren:

Hook	Auslöser
on_spawn	Prop wird in die Welt gespawnt oder mit seinem Chunk erneut geladen
on_game_tick	Jeden Spiel-Tick, während der Prop existiert
on_zone_enter	Ein Spieler betritt eine vom Skript erstellte überwachte Zone
on_zone_leave	Ein Spieler verlässt eine vom Skript erstellte überwachte Zone
on_destroy	Prop wird endgültig entfernt (nicht beim Entladen eines Chunks oder beim Neuladen)
on_left_click	Ein Spieler klickt den Prop links an
on_right_click	Ein Spieler klickt den Prop rechts an
on_projectile_hit	Ein Projektil trifft den Prop

Prop-Skripte erhalten eine context.prop-Tabelle mit Feldern wie model_id und current_location sowie Methoden wie play_animation(name) und stop_animation().

Item-Effekte

Lua-Skripte für ausgerüstete Items wurden eingestellt. Gehaltene Items verwenden jetzt selbst definierte Verzauberungen, Zauberstäbe und Stäbe verwenden Definitionen magischer Waffen. Füge einer Definition für ein gehaltenes Item kein scripts: hinzu.

Aktuelle Hinweise

• Offizielle Nightbreak-verwaltete Pakete, die ins Plugin integriert sind: Basic Furniture Pack, BetterStructures Prop Pack, EliteMobs Prop Pack, Craftenmine's Weapons Item Pack und Craftenmine Tools Item Pack.
• Eine erfolgreiche vollständige Initialisierung baut das Ressourcenpaket neu auf und plant FmmReloadedEvent 40 Ticks später ein, damit abhängige Plugins ihre Modelle erneut anhängen können. Wird das Neuladen während der Vorbereitung abgelehnt, bleibt die aktive Laufzeit erhalten.
• ResourcePackManager kann das erzeugte Paket automatisch verteilen. Prüfe die erzeugten Dateien und die tatsächliche Annahme durch den Client; eine abgeschlossene Einrichtung oder die Anzeige eines installierten Pakets beweist keine Zustellung.