BXR Lightning Shock 1.25.0.53
Author: B O X E R

MAGYAR
=======

Áttekintés
----------
A BXR Lightning Shock dinamikus, időjárásvezérelt villámrendszert ad a Farming
Simulator 25-höz. A villám nem egyszerű képernyőeffekt: célpontot keres, fényt
bocsát ki, dörög, járművet és infrastruktúrát találhat el, valamint területi
áramszünetet okozhat.

Automatikus villámlás
---------------------
- Március elejétől október végéig működik, bármilyen érzékelt esőben vagy
  jégesőben.
- Az alkalmas időjárás kezdetét követő első csapás 5-45 másodpercen belül
  készül elő.
- A további csapások 30-150 másodperces véletlen időközzel érkeznek, ezért
  három percen belül legalább egy villámlás történik.
- Egy automatikus esemény 50 százalékos eséllyel második, külön időzített
  csapást indít 4-35 másodperccel később.

Villám megjelenése
------------------
- A főcsatorna 96 spline-vezérpontból és 520 szegmensből épül fel.
- A csatorna gyorsan halad lefelé, sűrű, simított irányváltásokkal.
- A pontos vonalmagot kiegészítő, 96 újrahasznosított glow-mesh szegmens követi.
- A főcsatorna, az oldalágak, az alágak és a gyermekágak mély, telített
  sötétkék színt kapnak.
- 24-30 hosszú oldalág közel egyenletesen oszlik el a főcsatorna teljes hosszán.
- Az ágak sok rövid, lefelé kereső lépéssel, éles szögletek nélkül fejlődnek.
- Minden oldal-, al- és gyermekág utolsó kétharmada fokozatosan áttetszővé válik.
- Az ágnövekedés a két utolsó gyors visszavillanás végéig folytatódik.
- A sötét villogási fázisokban a geometria eltűnik, ezért nem jelenik meg fekete
  csatorna vagy fekete ág.
- A becsapódási fény folyamatos része rövid, az utolsó két visszavillanás gyors.

Célkeresés
----------
- A teljes célkeresési sugár 200 méter.
- Az aktív nézet járművének találati esélye 20 százalék. Nem számít, hogy a
  játékos vagy AI vezeti, illetve külső vagy belső kamera aktív.
- A többi aktív GIANTS AI-, CoursePlay- vagy AutoDrive-jármű külön 25 százalékos
  eséllyel lehet célpont.
- Ha egyik jármű sem nyeri meg a saját dobását, a környezeti célpont kiválasztása
  teljesen véletlenszerű. Nincs magassági, épülettípus- vagy toronyprioritás.
- A fa és minden felismerhető növényzeti objektum ki van zárva.
- A környezeti lista térben deduplikált, így egy sok részből álló objektum nem
  kap aránytalanul több esélyt.
- Járműtalálatnál a villám a fülkét keresi. Tető vagy épület alatt álló jármű
  nem választható.

Járműtalálat hatása
-------------------
- Leáll az aktív AI-munka, CoursePlay vagy AutoDrive vezérlés.
- Leáll a motor, a tempomat és a teljes kapcsolt szerelvény világítása.
- A becsapódás nem fagyasztja be a játékost, a kamera- vagy járművezérlés
  továbbra is használható.

Becsapódási részecskék és hang
-----------------------------
- 280 apró, aranysárga, olvadt részecske robban kifelé.
- Az első visszapattanás megközelítőleg egy méteres lehet.
- Két-három fokozatosan gyengülő pattanás után a részecskék apró gömbként
  kihunynak, megnyúlás nélkül.
- A dörgés öt hangmintás, véletlen sorrendű készletből szól. Egy teljes körön
  belül nincs ismétlés, és az új kör első hangja sem egyezhet az előző kör
  utolsó hangjával. Hangereje a korábbi érték fele.
- Zárt belső fülkenézetben tompított hangminta használható.

Áramszünet
----------
- Nem járművet érő csapás 300 méteres körzetben áramszünetet okoz.
- Kialszanak a szabványos és nem szabványos fényforrások, emisszív felületek,
  digitális karakterek, LED-ek, kijelzők és kompatibilis kültéri lámpák.
- A projektált talajfények, light poolok, fénykúpok, fénycsóvák, light plane-ek,
  illumination/light-map/fake-light mesh-ek, flare-ek és fénydecalok is
  kikapcsolnak.
- A fizikai lámpatest, tábla, épület és kijelzőház látható marad.
- Az égbolt, Nap, Hold, csillagok, felhők és járműfények nem tartoznak a
  területi áramszünethez.
- A termelő üzemek, gyárak, szárítók és kompatibilis feldolgozók a saját
  épületük áramszüneti idejére leállnak.

Visszakapcsolási idők
---------------------
- LED-panelek és információs táblák: 10 másodperc.
- Porták, telephelyi sorompók, kapuk és mérlegházak: 20 másodperc.
- Vasúti átjárók és sorompóik: 20 másodperc.
- Minden más épület: 30 másodperc.
- Közvilágítás és reklámtáblák: 40 másodperc.
- Minden kategória két gyors felvillanás után tér vissza.

Sorompók és vasúti átjárók
-------------------------
- Az Újrét térkép Rolltor-alapú ipari sorompói áramszünetkor az aktuális
  helyzetükben megállnak.
- A PlaceableTrainSystem RailroadCrossing objektumai szintén megállnak.
- A piros oldalsó markerek, váltakozó vasúti jelzőfények és kapcsolódó valós
  fényforrások kialszanak, és az áramszünet alatt kikapcsolva maradnak.
- Húsz másodperc után, a két visszakapcsolási villanással együtt az eredeti
  vezérlőfüggvények helyreállnak.

Kijelző-kompatibilitás
----------------------
- Az FS25_BXRLedBoard és FS25_BXRInfoBoard külön specializációként támogatott.
- Áramszünetkor eltűnnek a karakterek, animált zöld nyilak, jelölők,
  információs sorok és láblécelemek.
- Más információs, ár-, eredmény-, üzenet- és reklámtáblák emisszív elemeit is
  megpróbálja felismerni.

Teljesítmény
------------
- A fő világ-fénycache egyszer készül el; a később létrejövő placeable-ek
  képkockánként egyesével, létrejöttük után egyszer kerülnek külön cache-be.
- Játék közben nincs időszakos teljes scene-bejárás.
- Becsapódás előtt nincs teljes világfény-keresés.
- A glow mesh előre betöltött, újrahasznosított szegmens-poolt használ.

Telepítés
---------
- A kiadás `build-manifest.json` fájlja SHA-256 lenyomatot tartalmaz minden
  modfájlról. A `build-manifest.sig` Ed25519 aláírását a mellékelt
  `BXR_PUBLIC_KEY.pem` nyilvános kulccsal lehet ellenőrizni.
- A szerzői azonosító és a buildazonosító minden aláírt kiadás eredetét és
  pontos tartalmát igazolja. A magánkulcs nem része a modcsomagnak.
Helyezd az FS25_BXRLightningShock.zip fájlt ide:
Documents/My Games/FarmingSimulator2025/mods
Ezután engedélyezd a modot a mentés betöltésekor.


ENGLISH
=======

Overview
--------
BXR Lightning Shock adds a dynamic, weather-driven lightning system to Farming
Simulator 25. Lightning is not only a screen effect: it searches for targets,
emits light, produces positional thunder, can strike vehicles and infrastructure,
and can cause a regional power outage.

Automatic lightning
-------------------
- Runs from early March through the end of October during any detected rain or
  hail intensity.
- The first strike is prepared 5-45 seconds after suitable weather begins.
- Later strikes arrive at random 30-150 second intervals, preserving at least
  one strike inside every three-minute window.
- Each automatic event has a 50 percent chance of a separately timed second
  strike after 4-35 seconds.

Lightning appearance
--------------------
- The main channel uses 96 spline control points and 520 rendered path segments.
- It travels downward quickly with dense, smoothed direction changes.
- A pool of 96 reusable glow-mesh segments supplements the precise line core.
- Main, side, secondary and child branches use a deeply saturated dark-blue color.
- 24-30 long side branches are distributed approximately evenly along the full
  main-channel length.
- Branches grow through many short downward-searching steps without hard corners.
- The final two-thirds of every side, secondary and child branch progressively
  fade to transparency.
- Branch growth continues until the final two fast return flashes have ended.
- Geometry disappears during dark pulse phases, preventing black channels.

Target selection
----------------
- The complete target radius is 200 metres.
- The active-view vehicle has a 20 percent strike chance regardless of player or
  AI control and regardless of interior or exterior camera view.
- Other active GIANTS AI, CoursePlay and AutoDrive vehicles have a separate
  25 percent chance.
- If no vehicle wins its dedicated roll, the environmental target is selected
  completely at random. There is no height, building-type or tower priority.
- Trees and recognized vegetation objects are excluded.
- Environmental candidates are spatially deduplicated so a multi-part object
  does not receive disproportionate probability.
- Vehicle strikes aim for the cab; roof-covered vehicles are protected.

Vehicle impact
--------------
- Active GIANTS AI, CoursePlay or AutoDrive work is stopped.
- Engine, cruise control and lights across the complete attached consist stop.
- Impact never freezes player movement, camera control or vehicle controls.

Impact particles and thunder
----------------------------
- 280 compact golden-yellow molten particles burst outward.
- The first rebound can reach approximately one metre.
- Two or three progressively weaker bounces follow before each particle fades
  as a tiny sphere without stretching.
- Positional thunder uses a shuffled five-sample pool. Every sample plays once
  before the pool is reshuffled, and a new cycle cannot begin with the sample
  that ended the previous cycle. It plays at half the earlier volume. A muffled
  sample is used in a closed interior cab view when available.

Power outage
------------
- A non-vehicle strike causes a power outage within 300 metres.
- Standard and non-standard lights, emissive surfaces, digital characters,
  LEDs, displays and compatible outdoor lamps switch off.
- Projected ground-light pools, cones, beams, light planes, illumination meshes,
  light maps, fake lights, flares and light decals are included.
- Physical lamp housings, signs, buildings and display bodies remain visible.
- Sky, Sun, Moon, stars, clouds and vehicle lights are excluded.
- Production points, factories, dryers and compatible processors stop for the
  outage duration assigned to their building.

Restoration timing
------------------
- LED panels and information boards: 10 seconds.
- Gates, industrial barriers, gatehouses and weigh houses: 20 seconds.
- Railroad crossings and their barriers: 20 seconds.
- All other buildings: 30 seconds.
- Public street lighting and advertising boards: 40 seconds.
- Every category restores after two quick electrical flashes.

Barriers and railroad crossings
-------------------------------
- Rolltor-based industrial barriers on the Ujret map freeze at their current
  position during an outage.
- PlaceableTrainSystem RailroadCrossing objects freeze as well.
- Red side markers, alternating railroad signals and linked real lights remain
  dark throughout the outage.
- Original controller functions are restored after twenty seconds and the two
  restoration flashes.

Display compatibility
---------------------
- FS25_BXRLedBoard and FS25_BXRInfoBoard are supported independently.
- Characters, animated green arrows, markers, information rows and footer
  elements are suppressed during an outage.
- Emissive elements of other information, price, score, message and advertising
  displays are detected where their scene nodes expose compatible controls.

Performance
-----------
- The main world-light cache is built once. Placeables created later are cached
  once after they appear, one placeable per frame during map startup.
- No periodic full-scene traversal runs during gameplay.
- No complete world-light search runs immediately before impact.
- Glow geometry uses a preloaded reusable segment pool.

Installation
------------
- `build-manifest.json` contains a SHA-256 digest for every signed mod file.
  Its Ed25519 signature is stored in `build-manifest.sig` and can be verified
  with the included `BXR_PUBLIC_KEY.pem` public key.
- The author ID and build ID identify the origin and exact contents of every
  signed release. The private signing key is never included in the mod archive.
Place FS25_BXRLightningShock.zip in:
Documents/My Games/FarmingSimulator2025/mods
Enable the mod when loading the savegame.


DEUTSCH
=======

Übersicht
---------
BXR Lightning Shock ergänzt Farming Simulator 25 um ein dynamisches,
wettergesteuertes Blitzsystem. Der Blitz sucht Ziele, erzeugt Licht und
räumlichen Donner, kann Fahrzeuge sowie Infrastruktur treffen und einen
regionalen Stromausfall auslösen.

Automatische Blitze
-------------------
- Aktiv von Anfang März bis Ende Oktober bei jeder erkannten Regen- oder
  Hagelintensität.
- Der erste Einschlag wird 5-45 Sekunden nach Beginn geeigneten Wetters vorbereitet.
- Weitere Einschläge folgen zufällig alle 30-150 Sekunden, sodass innerhalb von
  drei Minuten mindestens ein Blitz entsteht.
- Jedes Ereignis hat eine 50-prozentige Chance auf einen zweiten, separat nach
  4-35 Sekunden ausgelösten Einschlag.

Darstellung des Blitzes
-----------------------
- Der Hauptkanal besteht aus 96 Spline-Kontrollpunkten und 520 Pfadsegmenten.
- Er bewegt sich schnell abwärts und besitzt dichte, geglättete Richtungswechsel.
- 96 wiederverwendbare Glow-Mesh-Segmente ergänzen den präzisen Linienkern.
- Hauptkanal, Seiten-, Unter- und Kinderäste sind tief gesättigt dunkelblau.
- 24-30 lange Seitenäste verteilen sich annähernd gleichmäßig über die gesamte
  Länge des Hauptkanals.
- Viele kurze, abwärts suchende Schritte vermeiden harte Ecken.
- Die letzten zwei Drittel jedes Astes werden stufenlos transparent.
- Das Wachstum läuft bis zum Ende der letzten zwei schnellen Rückblitze weiter.
- In dunklen Pulsphasen verschwindet die Geometrie vollständig, sodass keine
  schwarzen Linien entstehen.

Zielauswahl
-----------
- Der vollständige Suchradius beträgt 200 Meter.
- Das Fahrzeug in der aktiven Ansicht hat eine Trefferchance von 20 Prozent,
  unabhängig von Spieler/KI und Innen-/Außenkamera.
- Andere aktive GIANTS-KI-, CoursePlay- und AutoDrive-Fahrzeuge besitzen eine
  separate Chance von 25 Prozent.
- Gewinnt kein Fahrzeug seine Auslosung, wird das Umgebungsziel vollständig
  zufällig gewählt. Es gibt keine Höhen-, Gebäude- oder Turmpriorität.
- Bäume und erkannte Vegetationsobjekte sind ausgeschlossen.
- Räumliche Deduplizierung verhindert Mehrfachchancen für mehrteilige Objekte.
- Fahrzeugeinschläge zielen auf die Kabine; überdachte Fahrzeuge sind geschützt.

Auswirkungen auf Fahrzeuge
--------------------------
- Aktive GIANTS-KI-, CoursePlay- oder AutoDrive-Arbeit wird beendet.
- Motor, Tempomat und Beleuchtung des gesamten angehängten Gespanns stoppen.
- Spielerbewegung, Kamera und Fahrzeugsteuerung werden nicht eingefroren.

Partikel und Donner
-------------------
- 280 kompakte goldgelbe Schmelzpartikel brechen nach außen aus.
- Der erste Rücksprung kann ungefähr einen Meter erreichen.
- Nach zwei bis drei schwächer werdenden Sprüngen erlöschen sie als kleine
  Kugeln, ohne sich vor dem Erlöschen zu strecken.
- Räumlicher Donner verwendet einen zufällig gemischten Vorrat aus fünf
  Klangmustern. Jedes erklingt einmal, bevor neu gemischt wird; auch an der
  Rundengrenze folgt nie dasselbe Klangmuster direkt aufeinander. Er nutzt die
  halbe frühere Lautstärke und wird in einer geschlossenen Innenkabine gedämpft.

Stromausfall
------------
- Ein Einschlag außerhalb eines Fahrzeugs verursacht im Umkreis von 300 Metern
  einen Stromausfall.
- Standard- und Sonderleuchten, emissive Flächen, digitale Zeichen, LEDs,
  Anzeigen und kompatible Außenlampen werden ausgeschaltet.
- Projizierte Bodenlichtflächen, Lichtkegel, Strahlen, Light-Planes,
  Illumination-Meshes, Light-Maps, Fake-Lights, Flares und Licht-Decals sind
  ebenfalls enthalten.
- Physische Lampengehäuse, Schilder, Gebäude und Anzeigekörper bleiben sichtbar.
- Himmel, Sonne, Mond, Sterne, Wolken und Fahrzeugleuchten sind ausgeschlossen.
- Produktionspunkte, Fabriken, Trockner und kompatible Verarbeiter stoppen für
  die Ausfalldauer ihres Gebäudes.

Wiederherstellungszeiten
------------------------
- LED-Panels und Informationstafeln: 10 Sekunden.
- Tore, Industrieschranken, Pförtnerhäuser und Wiegehäuser: 20 Sekunden.
- Bahnübergänge und ihre Schranken: 20 Sekunden.
- Alle anderen Gebäude: 30 Sekunden.
- Straßenbeleuchtung und Werbetafeln: 40 Sekunden.
- Jede Kategorie kehrt nach zwei schnellen elektrischen Lichtimpulsen zurück.

Schranken und Bahnübergänge
---------------------------
- Rolltor-basierte Industrieschranken der Ujret-Karte frieren in ihrer aktuellen
  Stellung ein.
- PlaceableTrainSystem-RailroadCrossing-Objekte werden ebenfalls angehalten.
- Rote Seitenmarker, wechselnde Bahnübergangssignale und verbundene reale
  Lichtquellen bleiben während des Ausfalls dunkel.
- Nach zwanzig Sekunden und den zwei Rückkehrimpulsen werden die ursprünglichen
  Steuerfunktionen wiederhergestellt.

Anzeigen-Kompatibilität
-----------------------
- FS25_BXRLedBoard und FS25_BXRInfoBoard werden unabhängig unterstützt.
- Zeichen, animierte grüne Pfeile, Marker, Informationszeilen und Fußzeilen
  verschwinden während des Stromausfalls.
- Emissive Elemente anderer Informations-, Preis-, Ergebnis-, Nachrichten- und
  Werbeanzeigen werden erkannt, sofern kompatible Scenegraph-Steuerungen vorliegen.

Leistung
--------
- Der Hauptcache für Weltlichter wird einmal erstellt. Später geladene
  Placeables werden beim Kartenstart nach ihrem Erscheinen einmalig und
  bildweise einzeln zwischengespeichert.
- Während des Spiels erfolgt keine periodische vollständige Scenegraph-Suche.
- Direkt vor dem Einschlag wird keine vollständige Weltlichtsuche ausgeführt.
- Die Glow-Geometrie nutzt einen vorgeladenen, wiederverwendbaren Segmentpool.

Installation
------------
- `build-manifest.json` enthält einen SHA-256-Prüfwert für jede signierte
  Moddatei. Die Ed25519-Signatur in `build-manifest.sig` kann mit dem
  beigefügten öffentlichen Schlüssel `BXR_PUBLIC_KEY.pem` geprüft werden.
- Autoren-ID und Build-ID belegen Herkunft und exakten Inhalt jeder signierten
  Ausgabe. Der private Signaturschlüssel ist nie im Modarchiv enthalten.
FS25_BXRLightningShock.zip hier ablegen:
Documents/My Games/FarmingSimulator2025/mods
Anschließend den Mod beim Laden des Spielstands aktivieren.
