Leon K
📎 1 file 9,233 chars
📄
pasted-code-1794750047967.txt
txt 95 lines
▶
Ultimativer Prompt

Rolle: Du bist ein erfahrener Minecraft-Mod-Entwickler (Fabric, Java, Mixins, Gradle) und kennst den Quellcode von Litematica und MaLiLib (masa) genau, vor allem SchematicWorldHandler, RayTraceUtils, WorldUtils, InventoryUtils und Easy Place.

Ziel: Entwickle eine rein clientseitige Fabric-Mod „LitematicaSmartSwitcher“ für Minecraft 26.2, die mit Litematica zusammenarbeitet. Sie wechselt sofort auf den richtigen Hotbar-Slot, bevor der Spieler den Block setzt. Optional kann sie den Block auch automatisch setzen (Look-to-Place). Alle Einstellungen sind über Mod Menu erreichbar.

Versionen (vor dem Coden prüfen, nichts raten): Minecraft 26.2, Fabric Loader [Version], Fabric API [Version], Litematica [exakte Build-ID], MaLiLib [Version], YACL [Version], Mod Menu [Version], Java [Version]

0. Grundregeln für dich als Entwickler
Prüfe jede API, Klasse, Methode und Mapping gegen Minecraft 26.2 und die tatsächlich installierte Litematica-Version. Erfinde keine Methoden, Pakete oder Netzwerkfunktionen.
Erfolgreiches Kompilieren heißt nicht, dass es zur Laufzeit funktioniert. Benenne jede Stelle, die du nicht in-game testen konntest, ausdrücklich als ungetestet.
Ist eine Litematica-API nicht kompatibel, schaltet sich das Feature sicher ab (kein Crash, nur Logeintrag).
Litematica ist zur Compile-Zeit optional (reflexions- oder Soft-Dependency-basiert). Der Mod startet auch ohne Litematica fehlerfrei und tut dann nichts.
1. Hauptfunktion: Auto-Switch (Priorität 1)
Schaut der Spieler auf eine Stelle, an der laut aktiver Schematic ein Block benötigt wird, wird der passende Slot sofort ausgewählt.
Zielposition = Platzierungszelle, nicht der angeschaute Block:
Ist die getroffene Zelle ersetzbar (Gras, Wasser, Schnee usw.), ist sie die Zielzelle.
Sonst ist die Zielzelle die angrenzende Zelle auf der getroffenen Seite (blockPos.relative(face)).
Das Schematic wird an genau dieser Zelle abgefragt, in Litematicas echten Platzierungskoordinaten (Offset, Rotation, Mirror, Placement-Origin berücksichtigen).
Hintergrund: Wird die Stützfläche geprüft, wechselt der Mod erst nach dem Platzieren, weil sich dann erst das Ziel ändert.
Ignorieren (kein Wechsel): Luft im Schematic, bereits korrekt platzierte Blöcke, Blöcke ohne Item-Form.
Exaktes Item-Matching hat Vorrang (Block → Item inkl. Sonderfälle: Slabs, Treppen, Türen, Betten, Eimer, Items mit abweichendem Drop). Blockstates werden berücksichtigt, soweit sie vom Item abhängen.
Kein Zurückwechseln auf den vorherigen Slot. Bei jedem neuen Ziel wird der Slot neu bestimmt.
Keine unnötigen Wechsel: Passt der ausgewählte Slot bereits, passiert nichts (weder Paket noch Neuberechnung).
2. Wechsel VOR dem Platzieren (kritisch)

Bekanntes Problem: Wird der Slot erst im Use-Callback gewechselt, ist das Slot-Paket schon gesendet, und die Platzierung geschieht mit dem alten Slot.

Lösung, beides umsetzen:

Frühe Auswahl: Die Zielprüfung läuft im HUD-Render-Callback bzw. Frame-Callback (nicht erst am Tick-Ende). So ist der Slot passend, sobald ein neues Ziel im Fadenkreuz liegt.
Pre-Use-Absicherung: Ein Mixin am Anfang der Item-Use-Methode (vor dem Senden des Selected-Slot-Pakets und vor interactBlock) prüft die Platzierungszelle erneut. Ist der Slot falsch, wird er dort gewechselt und das Slot-Paket sofort synchronisiert, bevor die Interaktion läuft. Prüfe in 26.2 die tatsächliche Reihenfolge (Slot-Sync vs. Use-Callback) und belege sie im Quellcode, bevor du den Mixin-Punkt wählst.
3. Hotbar- und Inventarsystem
Alle 9 Hotbar-Slots werden durchsucht, der passende wird direkt ausgewählt.
Inventarsuche (optional, Default AUS):
Fehlt das Item in der Hotbar, wird das restliche Inventar durchsucht.
Das Item kommt nur über normale Container-Interaktionen (clickSlot/Swap-Klick mit Hotbar-Slot) in die Hotbar, ohne Direktplatzierung aus dem Inventar und ohne erfundene Pakete.
Der Tausch wird einmal angefordert und erst weiterverarbeitet, wenn der Client den tatsächlichen Inventarzustand bestätigt (kein Spam, keine Doppelklicks).
Erfolglose Vollinventarsuchen werden kurz gecacht (z. B. 100 ms), damit nicht jeden Frame neu gesucht wird.
Keine Anti-Cheat-Umgehung, nur normale Slot- und Inventarmechaniken.
4. Look-to-Place (optional, Default AUS)

Nur aktiv, wenn separat eingeschaltet. Nach dem Wechsel wird der Block auch gesetzt, ohne dass der Spieler Rechtsklick drückt.

Platziert wird ausschließlich auf das, was der Spieler real anschaut. Der BlockHitResult stammt aus dem echten Vanilla-Raycast und wird nicht verändert (keine Hitbox-Erweiterung, keine gefälschte Seite oder Hit-Position).
Nur Vanilla-Reichweite (Survival 4,5 / Creative 5), freie Sichtlinie, keine Rotation oder Look-Packets, keine Zusatz- oder Fake-Pakete.
Ausführung über denselben Weg wie ein normaler Rechtsklick (interactionManager.interactBlock plus Arm-Swing).
Maximal 1 Block pro Tick, konfigurierbares Mindestintervall (Default = normale Vanilla-Platziergeschwindigkeit). Nie schneller als ein Spieler mit gehaltener Rechtstaste.
Platziert wird nur, wenn die Vanilla-Platzierung an dieser Stelle möglich wäre und die Ausrichtung stimmt (Easy-Place-Logik regelkonform nutzen). Falsche Blöcke werden nur bei aktivierter Option behandelt.
Nach Server-Rollback wird die Position für wenige Ticks gesperrt, damit kein Spam entsteht.
Optional: nur aktiv, solange eine Taste gehalten wird.
Konflikt-Check mit Litematicas Easy Place (keine Doppelplatzierung).
5. Performance
Keine unnötige Tick-Berechnung. Ist Ziel (Zelle + Blickseite) unverändert und der Slot bereits passend, werden Schematic-Abfrage und Inventarprüfung übersprungen.
Der Raycast läuft höchstens einmal pro Frame bzw. Tick, mit frühem Abbruch ohne geladenes Schematic oder bei offenem Screen.
Effizientes Caching: Block → Item-Zuordnung, letztes Ziel, letzte Slot-Entscheidung.
Das Aktualisieren der Schematic-Daten pro Frame ist standardmäßig aus und einstellbar.
Kein eigener Thread, keine Reflection im Hot Path (Methoden/Felder einmal beim Start auflösen).
6. Keybinds (im Minecraft-Menü „Steuerung“ änderbar)
G Auto-Switch an/aus
H Inventarsuche an/aus
J HUD an/aus
K Debug an/aus
L Auswahllogik wechseln
Frei belegbar: Look-to-Place an/aus (Default ungebunden)
7. Mod Menu + YACL-Konfiguration
ModMenuIntegration implements ModMenuApi mit ConfigScreenFactory auf einen YACL-Screen. Der Screen funktioniert auch im Hauptmenü ohne Welt.
Mod Menu und YACL sind optional: in der fabric.mod.json unter suggests, in Gradle modCompileOnly bzw. modLocalRuntime. Ohne Mod Menu startet der Mod fehlerfrei (kein ClassNotFound).
Kategorien: Allgemein (Mod an/aus, Look-to-Place), Auswahl/Abgleich (Matching-Strenge, Logik, Frame- statt Tick-Update), Inventar (Inventarsuche, Cache-Dauer), HUD (Anzeige, Position, Debug).
Persistente Speicherung in einer Config-Datei, automatisch beim Schließen, ohne Neustart.
Tooltips und Lang-Dateien en_us.json und de_de.json. Icon, Beschreibung und Autoren in der fabric.mod.json.
8. HUD und Debug
HUD zeigt den benötigten Block (Icon + Name), den gewählten Slot und den Status (An/Aus, Inventar an/aus).
Debug-Modus: Zielzelle, Schematic-Blockstate, ermitteltes Item, Slot-Entscheidung und Grund für „kein Wechsel“ (z. B. „bereits korrekt“, „kein Item“, „Luft“) in HUD und Log.
9. Edge Cases
Layer-Modus und mehrere Schematics: nur sichtbare/aktive Layer berücksichtigen.
Spectator-/Adventure-Modus, offener Container, Chat oder anderer Screen: keine Aktion (Ausnahme: die bewusst angeforderte Inventarsuche).
Kein passendes Item: kein Wechsel, optional Hinweis in der Actionbar.
Multiplayer-Latenz: Nicht erneut wechseln oder platzieren, bevor der Server den vorherigen Schritt bestätigt hat.
Geladenes Schematic wird entladen oder gewechselt: Caches leeren.
10. Abnahmekriterien
Ein neuer Zielblock im Fadenkreuz führt vor dem Rechtsklick zum richtigen Slot, und der erste Platzierungsversuch nutzt bereits den richtigen Slot.
Bei bereits passendem Slot werden weder Pakete gesendet noch Schematic-Abfragen wiederholt.
Air, fertige Positionen und Blöcke ohne Item lösen nie einen Wechsel aus.
Die Zielzelle entspricht der echten Platzierungsposition (Test mit Rotation, Offset und Mirror des Placements).
Look-to-Place (falls an) setzt nie schneller als Vanilla, nie außerhalb der Reichweite und nie ohne echten Blick auf das Ziel. Im Packet-Log erscheinen nur normale Slot-, Inventar- und Interaktionspakete.
Inventartausch passiert genau einmal pro Anforderung, ohne Klick-Spam.
Mod Menu zeigt den Mod mit Zahnrad, alle Einstellungen bleiben nach dem Neustart erhalten, und ohne Mod Menu/YACL/Litematica startet der Mod fehlerfrei.
Kein FPS-Einbruch, im Idle-Zustand praktisch keine CPU-Last durch den Mod.
11. Ausgabeformat
Dateibaum des vollständigen Gradle-Projekts (build.gradle, gradle.properties, fabric.mod.json, Mixin-JSON)
Vollständiger, kompilierbarer Sourcecode aller Klassen
Liste der geprüften APIs mit Quelle (Klasse/Methode in 26.2 bzw. Litematica-Version) und eine Liste dessen, was nicht verifiziert werden konnte
Kurze Erklärung der Hook-Punkte (Frame-Callback, Pre-Use-Mixin, Inventarbestätigung)
Teststeps für Singleplayer und Multiplayer
Kodari AI
KodariNov 15 at 1:42 pm 1
LitematicaSmartSwitcher
A client-side Fabric mod that integrates with Litematica to automatically select the correct hotbar slot before placing blocks in schematic builds. It determines the target placement cell using Litematica's placement coordinates (accounting for offset, rotation, mirror), matches the required block to the correct item in the hotbar, and switches slots proactively via frame callbacks and a pre-use mixin. Optional features include full inventory searching with normal container interactions, look-to-place functionality that respects vanilla reach and raycast, and a configurable HUD showing target block and slot status. All settings are accessible through Mod Menu with YACL configuration screens, with German and English language support.

Dieses Projekt ist ein Minecraft-Server-Plugin; angefordert ist eine rein clientseitige Fabric-Mod für Minecraft 26.2. Kodari unterstützt diese Projektart.

Switch to Fabric 26.2

Kodari can make mistakes. Review important code before using.
Files

No files in this session

Code