HOW TO INSTALL — Dynamic Colour LED Strip (FS25)
================================================

SIMPLE STEPS


STEP 1 — Copy into your tractor mod
-----------------------------------
Copy this whole folder into your mod, for example:

  MyTractorMod/
    FS25_DynamicColourLED_Prefab/   ← this folder
      DynamicColourLED.i3d
      textures/
      scripts/
      examples/


STEP 2 — Put the strip on the tractor (GIANTS Editor)
-----------------------------------------------------
1. Open your tractor .i3d in GIANTS Editor
2. File → Import → choose DynamicColourLED.i3d
3. Drag dynamicColourLED onto the roof / grille / bumper
4. Move / rotate until it looks right
5. Rename it to something clear, e.g. dynamicColourLED_roof
6. Write down the Index Path (shown on the right), OR add an i3dMapping
7. Save the tractor .i3d

Note: If GE warns "non-binary indexed triangle sets", you can ignore it.
The strip still works. Optional: File → Save on the i3d later to convert.


STEP 3 — Add scripts to modDesc.xml
-----------------------------------
Open modDesc.xml and add these parts (merge with what you already have):

  <extraSourceFiles>
      <sourceFile filename="FS25_DynamicColourLED_Prefab/scripts/LEDLightController.lua" />
      <sourceFile filename="FS25_DynamicColourLED_Prefab/scripts/DynamicColourLED.lua" />
  </extraSourceFiles>

  <specializations>
      <specialization name="dynamicColourLED" className="DynamicColourLED"
          filename="FS25_DynamicColourLED_Prefab/scripts/DynamicColourLED.lua" />
  </specializations>

  <!-- Inside your tractor <type ...> list, add: -->
  <specialization name="dynamicColourLED" />

  <actions>
      <action name="CYCLE_DYNAMIC_COLOUR_LED" category="VEHICLE" axisType="HALF" />
  </actions>

  <inputBinding>
      <actionBinding action="CYCLE_DYNAMIC_COLOUR_LED">
          <binding device="KB_MOUSE_DEFAULT" input="KEY_lctrl KEY_l"
                   axisComponent="+" neutralInput="0" index="1" />
      </actionBinding>
  </inputBinding>


STEP 4 — Add to the tractor vehicle XML
---------------------------------------
Near the bottom of your tractor XML (same file that has <vehicle>), add:

  <i3dMappings>
      <i3dMapping id="dynamicColourLED_roof" node="0>0|5|0" />
  </i3dMappings>

  <dynamicColourLED>
      <settings defaultIndex="1" brightness="1.0" lightRange="4.5"
                syncAllInstances="true" showNotification="true" />
      <input action="CYCLE_DYNAMIC_COLOUR_LED" enabled="true" />
      <strip node="dynamicColourLED_roof" />
  </dynamicColourLED>

IMPORTANT:
  Replace node="0>0|5|0" with YOUR Index Path from GIANTS Editor.
  If you already have <i3dMappings>, only add the one new line inside it.


STEP 5 — Test in game
---------------------
1. Load the mod
2. Buy / spawn the tractor
3. Enter the tractor
4. Press Ctrl + L to change LED colour


TIPS
----
- More strips? Import again, rename (e.g. dynamicColourLED_grille),
  add another <strip node="..." /> line.
- Paths above assume this folder sits inside your mod as
  FS25_DynamicColourLED_Prefab/
  If you put scripts/ at the mod root instead, change the paths
  to scripts/LEDLightController.lua etc.
- Full examples: examples/prefabIntegration.xml
                 examples/prefabIntegration.lua
