BotanicPupPatch 1.10.13

Zusatzmod für PUP FPS, der Kollisions- und Statikprobleme beim Laden von Clustern und bei Besitzerwechseln im Multiplayer abfangen soll.

Funktionen

• Hält Carts, Tiere und Monster an, solange benötigte Cluster-Kollision fehlt.
• Pausiert Gebäudestatik, solange die benötigte Kollision noch nicht bereit ist.
• Zusätzlicher Schutz bei Mob-Besitzerwechseln mit FiresGhettoNetworking (FGN).
• Mit FGN bleibt PUPs konkurrierende Server-Netzwerkoptimierung aus; Cluster und Kollisionsschutz bleiben aktiv.
• Schließt normale Kristallwände vom Clustern aus, damit ihr ursprüngliches Aussehen erhalten bleibt.

Funktionsweise

Der Mod prüft die benötigte Kollision vor Ort. Solange sie fehlt, warten Bewegung, AI beziehungsweise Statik. Sobald sie bereit ist, läuft das normale Verhalten weiter. Benötigte Kollision bleibt auch außerhalb von PUPs normalem Spieler-Abstand aktiv.

Fertige Prüfungen werden wiederverwendet und bei relevanten Änderungen erneuert. Nicht mehr benötigte Prüfdaten werden freigegeben. Keine zusätzlichen Welt-Scans oder Warte-Timer. Eigene Logs sind standardmäßig aus.

Optional: BotanicServerAuthority

Für Authority schützt PupPatch zusätzlich Besitzerwechsel: offenes Inventar, ausstehende Inventarantworten, Reiten/Steuern/Ziehen und bekannte laufende Aktionen verhindern die Übergabe. Der bisherige Besitzer übergibt selbst; fehlende Antworten erlauben keine erzwungene Übernahme. Das Ziel bestätigt seine lokal geladenen Collider. Bestehende Collider- und Statik-Guards bleiben aktiv.

Authority kommt nur auf den Dedicated Server; PupPatch auf Server und alle Clients. Authority 2.1.11 benötigt serverseitig das neue Übergabemodul aus PupPatch 1.10.13. Die Netzwerkpakete dieses Übergabemoduls sind unverändert gegenüber 1.10.11. Ohne Authority entstehen keine Übergabeanfragen. Das Zusatzmodul hat keinen eigenen Timer oder Update-Aufruf. Bereits erkannte Inventar-/Nachfüllsperren vermeiden zusätzliche Aktionsscans; vor Freigabe greifen sämtliche Prüfungen wieder. Neu erfasste physische Objekte verwenden bei Bedarf den bestehenden Physik-Guard.

Nachfüllen: Material, Brennstoff oder Munition per Interaktion startet zehn Sekunden Schutz vor Authority-Besitzerwechseln; jedes weitere Nachfüllen verlängert ihn. Gilt für Smelter-basierte Öfen/Meiler/Mühlen, Kochstellen, Feuerstellen, Gärfässer, Schildgeneratoren und Geschütztürme. Automatische Brennstoffverbrauchs-Updates verlängern den Schutz nicht. Bei einem getrennten oder nicht mehr verfügbaren Besitzer bleibt die native Wiedervergabe möglich; kein Warten auf diese zehn Sekunden. Vanilla prüft im vorhandenen Takt (ungefähr zwei Sekunden), FGN kann bei einer neuen Stationsinteraktion früher übernehmen. Alle Collider-/Inventar-Guards bleiben bestehen.

1.10.13: In erkannten Authority-Sitzungen leiten Clients erfolgreiche native Aufhebebesitz-Zusagen sofort mit der vorhandenen ZDO-Übertragung weiter. Bodenitem-Besitz und Inventar bleiben nativ. Übergabe-Timeouts drosseln nur das konkrete Objekt. Neue Zielprüfungen stoßen die benötigte Besitzerrevision einmalig an; unveränderte Wiederholungen senden sie nicht erneut. In erkannten Authority-Sitzungen werden erfolgreiche Inventarantworten nach fünf Sekunden als native Ablehnung behandelt: kein minutenaltes Öffnen/Stapeln/Alles-nehmen. Die tatsächliche Antwort beendet die ausstehende Sperre; offene Inventare bleiben bis zum Schließen geschützt. Ohne Authority-Anfragen bleibt die native Antwortbehandlung erhalten. Collider-/Statik-/Kampfziel-Guards bleiben unverändert.

Optional: FGN-Kampfziel-Besitz

Bei vorhandener FGN-Installation standardmäßig an. Auf Server und allen Clients dieselbe Einstellung verwenden; Änderungen erfordern Neustart. Datei: BepInEx/config/botanic.pup.patch.cfg.

[FGN AI Ownership]
EnableAIOwnership = true
ServerFallbackPingMs = 200
ServerFallbackRadius = 6

• FGN bevorzugt das aktive Spielerziel der KI statt des letzten Schadensverursachers. Normaler Ping- und Übergabeschutz bleibt erhalten.
• FGNs bestehende Zwei-Sekunden-Prüfung aktiviert Zielmeldungen nur bei mindestens zwei geeigneten Spielern im aktiven Bereich. Echte Zielwechsel lösen dann direkt eine Übergabeprüfung aus; unveränderte Ziele erzeugen keine Meldungen. Ein neues Nichtspielerziel löst keine direkte Übergabe aus.
• Verschwundene Spielerziele werden ebenfalls per Ereignis verworfen, auch wenn die KI ihre zerstörte Zielreferenz noch behält. Wechsel zwischen Nichtspieler-Zielen erzeugen keine Meldungen.
• Ziel-Ping über dem Grenzwert und anderer geeigneter Spieler aus FGNs bestehender Kandidatenliste höchstens sechs Meter vom Mob entfernt: Server übernimmt nach Collider-Freigabe. Der Mob muss zusätzlich innerhalb dessen ursprünglichem 3×3-Suchbereich liegen.
• Kein anderer geeigneter Spieler so nah: Das KI-Ziel behält/erhält den Mob auch bei hohem Ping. Diese gewünschte Ausnahme geht vor FGNs relativem Kampf-Ping-Schutz.
• Entfällt die Ausnahme, geht Besitz zurück zum aktuellen KI-Ziel; ohne Spielerziel an einen geeigneten Spieler.
• Distanz/Grenzwert sind serverseitig einstellbar. ServerFallbackPingMs = 0 nutzt 250 ms Abstand zum besten anderen aktiven FGN-Kandidaten. Unbekannter Ping löst keine Server-Übernahme aus.
• EnableAIOwnership = false: keine FGN-/Besitz-/KI-Hooks dieser Zusatzfunktion. Eine einmalige Verbindungsabfrage bestätigt den Server-Modus; keine laufende Abfrage. Clients mit fehlender/abgeschalteter Funktion behalten FGNs ursprüngliche Auswahl. Vorhandene Config-Werte werden nicht überschrieben.

Mit FGN 1.5.36 und 1.5.41 geprüft, serverseitig Balance Creature Ownership = true; für Server-Übernahme zusätzlich SSS aktiv. Beide FGN-Optionen Server ZDO Ownership Transfer müssen aus sein. Gezähmte, gerittene/gesteuerte Mobs und Bosse bleiben außerhalb dieser Regel. ServerBuildings ist dafür nicht erforderlich.

Keine laufende Zielbeobachtung pro KI-Update. Zieländerungen eines markierten Mobs werden nach dem laufenden KI-Aufruf zusammengefasst; Übergaben warten weiterhin auf FGNs Schutzregeln und fertige Collider. Ping, Abstand, Markierungen und ausstehende Übergaben werden im bestehenden Zwei-Sekunden-Takt geprüft. Kein zusätzlicher Timer oder Zielscan. Fehlende Erstmeldungen werden nur während der Aktivierung erneut angefordert.

Server und Clients auf 1.10.13 aktualisieren; auch FGN überall auf denselben Stand bringen. Die Angriffsende-Meldung benötigt das neue Zusatzmodul-Protokoll. Bei älteren/fehlenden Zusatzmodulen bleibt die originale FGN-Auswahl bestehen.

Besitzerwechsel prüfen: In der F5-Konsole botanic_ai_status ausführen. Zeigt bis zu sechs wilde Mobs innerhalb von 30 Metern samt Besitzer, KI-Ziel und Regel. Nur das KI-Ziel beim aktuellen Besitzer ist autoritativ; andere Clients erhalten dessen Markierung nicht. Gezähmte Tiere und Bosse sind aus dieser Statusliste ausgeschlossen; ihre Besitzverwaltung bleibt unverändert.

1.10.5 behebt gelöschte Client-Markierungen: FGNs Balance-Aufruf läuft auch auf Clients. Unser Hook führte dort fälschlich Server-Aufräumarbeiten aus und entfernte die für Zielereignisse benötigte Markierung. Diese Aufräumarbeiten laufen jetzt ausschließlich auf dem Dedicated Server. Gezähmte Tiere, ServerAuthority und die Übergabeschutzregeln bleiben unverändert.

1.10.6 schützt vor veralteten Spieler-Übergaben: Der aktuelle Besitzer prüft beim Ausführen eines FGN-Auftrags nochmals sein echtes KI-Spielerziel. Passt das gewünschte Spielerziel nicht mehr, wird die Übergabe abgelehnt. Die Server-Ausnahme bei hohem Ping und FGNs bestehende Schutzregeln bleiben erhalten. Prüfung nur bei einer tatsächlichen Übergabe, kein zusätzlicher laufender Zielscan.

Mit der aktuellen Version auf dem Server erscheinen zusätzlich SERVER-Zeilen: Kandidatenzahl, geeignete Spieler am Mob, Besitzer-Protokoll, Filter und Server-Markierung. reported target peer zeigt den Besitzer des gemeldeten Spielerziels; transfer pending und cooldown zeigen ausstehende beziehungsweise vorübergehend gesperrte Übergaben. observer bedeutet, dass der abfragende Client den Mob nicht besitzt; dessen lokales KI-Ziel ist eine Replik. Bitte die vollständige lokale Mob- und SERVER-Zeile bei weiterhin falschem Besitzer mit angeben. Die Abfrage liest nur vorhandenen Zustand und sendet höchstens sechs Diagnoseanfragen pro Aufruf. Keine automatischen Abfragen, Dauerlogs oder neuen Timer.

Nach einem Spawn kann der Spawner zunächst Besitzer bleiben. Die Aktivierung läuft über den vorhandenen Zwei-Sekunden-Scan. 1.10.11: Ein wegen eines laufenden Angriffs abgelehnter Wechsel wird nach dessen nativem Ende einmalig erneut versucht, auch bei unverändertem Spielerziel. Erst außerhalb des laufenden KI-/Angriff-Aufrufs wird das aktuelle Ziel erneut geprüft. Verspätete Ablehnungsantworten werden berücksichtigt; alte Besitzerrevisionen und Sitzungen verworfen. Andere FGN-Ablehnungen, ausstehende Übergaben, Ping-/Collider-Schutz und Übergabelimits bleiben erhalten. Keine neue Abfrage pro Frame, Physiktakt oder KI-Update. Ohne blockierten Angriff entsteht keine neue Meldung; der Angriffsende-Hook kehrt normalerweise sofort zurück.

Die Übergabe benötigt weiterhin Netzwerkzeit. Beginnt schon der nächste Angriff oder verhindert ein anderer Schutz die Übergabe, bleibt FGNs vorhandener Zwei-Sekunden-Check als Rückfall erhalten. Auch abgebrochene Angriffe mit noch laufender Angriffsanimation können darauf warten. Angriffe werden weder angehalten noch durch erzwungene Besitzerwechsel unterbrochen.

1.10.4 behebt den Installationsabbruch Ambiguous match found. Nach Update und Neustart soll hooks=True erscheinen; bei aktivem Dedicated-Server-Modus zusätzlich clientseitig server confirmed=True und Current session=True. Besitzregeln, Ping-/Collider-Schutz und Config bleiben erhalten. Ein Treffer kann bei einem Mob ohne Ziel den Angreifer als echtes KI-Ziel setzen; dann ist die Übergabe beabsichtigt.

1.10.10 – FGN-Updates: Neue Versionsnummern schalten die Zusatzfunktion nicht mehr ab. Beim Start werden einmalig die tatsächlich benötigten Methoden, Felder, Zeit-/Übergabelimits und Ziel-Hooks geprüft. Eine echte Inkompatibilität stoppt nur das optionale KI-Modul; die Collider-/Statik-Guards bleiben aktiv. Von FGN als direkt spielergesteuert markierte Mobs bleiben auch bei unserer Server-Ausnahme außerhalb der Besitzregel. Keine zusätzlichen Timer, Scans oder laufenden Versionsprüfungen.

Abhängigkeiten

• BepInExPack Valheim 5.4.2351
• PUP FPS 1.0.33 – andere Versionen sind nicht unterstützt.
• Optional: FiresGhettoNetworking; Kampfziel-Funktion mit 1.5.36 und 1.5.41 geprüft, bisherige Guards zusätzlich mit 1.5.28. Keine Sperre anhand der FGN-Versionsnummer oder des DLL-Hashes.

Installation

1. Spiel und Server beenden.
2. ZIP im Modmanager importieren oder BotanicPupPatch.dll nach BepInEx/plugins/BotanicPupPatch/ kopieren.
3. Auf Dedicated Server und allen Clients dieselbe Version installieren, dann neu starten. Vorige Zusatz-DLL ersetzen.

Bereits geclusterte Kristallwände müssen mit PUP wiederhergestellt und neu geclustert werden. Für die Kollisionsfixes ist kein Cache-Reset nötig.

Bereits zerstörte Objekte werden nicht wiederhergestellt. Automatisiert geprüft; echter Dedicated-Spieltest der neuen Funktion steht aus.