From 3741995d3a699ce33f7ed796b54a596ff983c169 Mon Sep 17 00:00:00 2001
From: Ryan Mroczenski <rmroc451@gmail.com>
Date: Sun, 17 Aug 2025 10:39:15 -0500
Subject: [PATCH] Update README.md for 2.0.0

---
 README.md | 151 ++++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 140 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 8911242..1158997 100644
--- a/README.md
+++ b/README.md
@@ -28,17 +28,146 @@ This mod requires Railloader by Zamu.
 ### What does this mod do?
 **PLEASE READ AS THE WAY THIS MOD FUNCTIONS HAS CHANGED FROM PRIOR VERSIONS**
 
-1. Car Inspector : Handbrake & Air Line Helper
- * Gives two buttons that will scan the current car's connections, including the whole consist, and automatically release hand brakes, set anglecocks and connect glad hands.
-2. Car Tag Updates
- * Shows an indication of which cars in the FOV have Air System or Handbrake issues. 
- * **hold SHIFT** to only show the tags in the FOV for cars with an issue!
-3. Discord Webhooks
- * Allows the console messages to post to a discord webhook. useful for those wanting to keep an eye on 24/7 hosted saves.
- * Locomotive messages grab the locomotive `Ident.RoadNumber` and check the `CTC Panel Markers` if they exist.  If found, they will use the red/green color and embed the locomotive as an image in the message.  If no marker is found, it defaults to blue.
- * Currently, One person per server should have this per discord webhook, otherwise you will get duplicate messages to the webhook.
- * **Multiple hooks**: Allows for many different webhooks per client to be setup, and filtered to the `Ident.ReportingMark` so you can get messages to different hooks based on what save/server you are playing on.
- * **Customizable** from the in-game Railloader settings, find `RMROC451.TweaksAndThings`
+Basically, this mod has a couple zones of focus. Caboose tweaks and other QOL things.  Some of those QOL things, I added the option for the cabeese to be required & charge you a "crew salary" to utilize, or pay a monetary penalty.
+
+I was disappointed the vanilla cabeese were largely for show, didn't provide any real reason to have them except for role playing.
+
+Enter Tweaks and Things.
+
+### QOL & Cabeese Modifications:
+<ul>
+  <li><b>A:</b> Adding a visual indication to the car's callout tag to indicate:
+        <ul>
+            <li><b>A1:</b> If a car is a participant in a disconnected air hose (currently uses the copy waybill icon)</li>
+            <li><b>A2:</b> If a car's hand brake is set (currently uses the handbrake icon)</li>
+            <li><b>A3:</b> Oiling Level/Hotbox Indication : pie chart or 🔥 icon
+                <ul>
+                    <li><b>A3a:</b> <u>On Rolling Stock:</u> Indicates the car's oiling level, if oiling feature is enabled</li>
+                    <li><b>A3b:</b> <u>On Locomotive:</u> Indicates the worst oiling level of a car from the connected consist (see <b>S1</b>)</li>
+                </ul>
+            </li>
+            <li><b>A4:</b> Adds a "+" on cabeese tags when on a track span that reloads their crew hours load (see <b>C</b>)</li>
+        </ul>
+  </li>
+  <li><b>C:</b> Cabeese Modifications
+        <ul>
+            <li><b>C1:</b> Adding `crew-hours` load to caboose type cars
+                <ul>
+                    <li><b>C1a:</b> Gives the cabeese a depletable resource that is used to simulate the crew that resided in the caboose.</li>
+                    <li><b>C1b:</b> When certain actions are utilized at a consist level, the depletion of this resource is used to simulate a crew's stamina for the day.</li>
+                    <li><b>C1c:</b> When a request to adjust the <b>crew-hours</b> below the remaining quantity, things start costing over time, if <b>S1b</b> is enabled (1.5x modifier).</li>
+                    <li><b>C1d:</b> This load/resource is utilized when <b>S1b</b> is enabled and for <b>S1e</b> integration.</li>
+                    <li><b>C1e:</b> See <b>S1b1/S1b2/S1b3</b> for what this is used for.</li>
+                </ul>
+            </li>
+            <li><b>C2:</b> Proximity Detection<br/>
+                Order of detection when requesting to adjust <b>crew-hours</b> for an action:
+                <ul>
+                    <li><b>C2a:</b> Car initiating the action is a caboose, if so use this caboose</li>
+                    <li><b>C2b:</b> Cabeese near the car that initiated the request:</li>
+                        <ul>
+                            <li><b>C2a:</b> Gather from consist of the requesting car.</li>
+                            <li><b>C2b:</b> Gather from <b>OpsController.Shared.ClosestArea</b> for cars that are in the same <b>Area</b>.</li>
+                        </ul>
+                    </li>
+                    <li><b>C2c:</b> Sort the found cars by:
+                        <ul>
+                            <li><b>C2c1:</b> Preference for cars with same <b>crew-id</b> as selected locomotive (engine controls, bottom left), still order by <b>C2c2</b></li>
+                            <li><b>C2c2:</b> Distance from the requesting car, ascending (pick closest one)</li>
+                        </ul>
+                    </li>
+                </ul>
+            </li>
+        </ul>
+  </li>
+  <li><b>D:</b> Discord Webhooks
+        <ul>
+            <li><b>D1:</b> Allows the console messages to post to a discord webhook. useful for those wanting to keep an eye on 24/7 hosted saves.</li>
+            <li><b>D2:</b> Locomotive messages grab the locomotive `Ident.RoadNumber` and check the `CTC Panel Markers` if they exist. If found, they will use the red/green color and embed the locomotive as an image in the message.  If no marker is found, it defaults to blue.</li>
+            <li><b>D3:</b> Currently, One person per server should have this per discord webhook, otherwise you will get duplicate messages to the webhook.</li>
+            <li><b>D4: Multiple hooks</b>: Allows for many different webhooks per client to be setup, and filtered to the `Ident.ReportingMark` so you can get messages to different hooks based on what save/server you are playing on.</li>
+            <li><b>D5: Customizable</b> from the in-game Railloader settings, find <b>RMROC451.TweaksAndThings</b> (see <b>S3</b>)</li>
+        </ul>
+  </li>
+  <li><b>M:</b> Miscellaneous
+        <ul>
+            <li><b>M1:</b> Repair tracks now require cars to be waybilled, or they will not be serviced/overhauled.<br/>They will report on the company window's location section as <b>'No Work Order Assigned'</b>.</li>
+            <li><b>M2:</b> Engine Roster Tweaks<br/>
+                <ul>
+                    <li><b>M2a:</b> MU'd locomotives will automatically be hidden unless they are <b>SELECTED</b> or <b>FAVORITED</b>.</li>
+                    <li><b>M2b:</b> Fuel Display in Engine Roster<br/>
+                    Will add reamaing fuel indication to Engine Roster (with details in roster row tool tip (see <b>S2c</b>))</li>
+                        <ul>
+                            <li><b>M2b1:</b> MU'd locomotives fuel information will combine with MU primary (see <b>S2c</b>).</li>
+                        </ul>
+                    </li>
+                </ul>
+            </li>
+            <li><b>M3:</b> MU Adjacency Restriction Removal <h3 style="color:red; display:inline">(USE AT OWN RISK)</h3></br>
+                Engines no longer are required to be adjacent to eachother to contribute to MU. They can be dispersed throughout the train.<br/>
+                The primary MU engine still acts as the main air reservoir, meaning train braking emits from that engine at this time.
+            </li>
+        </ul>
+  </li>
+  <li><b>S:</b> Settings
+         <ul>
+            <li><b>S1:</b> Caboose Mods</li>
+                <ul>
+                    <li><b>S1a:</b> Consist Oil Indication<br/>A caboose is required in the consist to report the lowest oil level in the consist in the locomotive's tag(see <b>A3b</b>) & roster entry(see <b>M2</b>).</li>
+                    <li><b>S1b:</b> Caboose Use / Enable End Gear Helper Cost
+                        <ul>
+                            <li><b>S1b1:</b> Will cost 1 minute of AI Brake Crew & Caboose Crew time per car in the consist when the new <b>inspector</b> or <b>shift context wheel</b> buttons are utilized.</li>
+                            <li><b>S1b2:</b> 1.5x multiplier penalty to AI Brake Crew cost if no sufficiently crewed caboose nearby (see <b>C2</b>).</li>
+                            <li><b>S1b3:</b> Caboose starts reloading `Crew Hours` at any Team or Repair track (no waybill), after being stationary for 30 seconds.</li>
+                            <li><b>S1b4:</b> <b>AutoOiler Update:</b> Increases limit that crew will oiling a car from 75% -> 99%, also halves the time it takes (simulating crew from lead end and caboose handling half the train).
+                            <li><b>S1b5:</b> <b>AutoOiler Update:</b> if <b>S1b</b> & <b>S1d</b> checked, when a caboose is present (see <b>C2</b>), the AutoOiler will repair hotboxes afer oiling them to 100%.
+                            <li><b>S1b6:</b> <b>AutoHotboxSpotter Update:</b> decrease the random wait from 30 - 300 seconds to 15 - 30 seconds (Safety Is Everyone's Job)</li>
+                            <li><b>S1b6:</b> <b>Costs from S1B1/S1B2:</b> added to financials at end of day with an entry of <b>AI Brake Crew</b>.</li>
+                        </ul>
+                    <li><b>S1c:</b> Refill / Crew Hours Load Option<br/>Select whether you want to manually reload cabeese via:
+                        <ul>
+                            <li><b>S1c1:</b> track method - (team/repair/passenger stop)</li>
+                            <li><b>S1c2:</b> daily caboose top off - refill to 8h at new day</li>
+                        </ul>
+                    </li>
+                    <li><b>S1d:</b> AutoAI Requirement (AI Hotbox\Oiler Requires Caboose)<br/>A caboose is required in the consist to check for Hotboxes and perform Auto Oiler, if checked.</li>
+                    <li><b>S1e:</b> Safety First!<br/>On non-express timetabled freight consists, a caboose with some crew-hours (see <b>C1</b>) is required in the consist to increase AE max speed > 20 in <b>ROAD</b>/<b>WAYPOINT</b> modes.</li>
+                </ul>
+            <li><b>S2:</b> UI
+                <ul>
+                    <li><b>S2a:</b> Enable Tag Updates<br/>
+                    Allows all tag updates from <b>A</b> to display.</li>
+                    <li><b>S2b:</b> Debt Allowance<br/>
+                    Will allow interchange service and repair shops to still function when you are insolvent, at a 20% overdraft fee.</li>
+                    <li><b>S2c:</b> Engine Roster Fuel/Info
+                        <ul>
+                            <li><b>S2c1:</b> Enable Fuel Display in Engine Roster<br/>
+                                Will add reamaing fuel indication to Engine Roster (with details in roster row tool tip). <br/>
+                                Select where to display:
+                                <ul>
+                                    <li><b>S2c1a</b> None/Off</li>
+                                    <li><b>S2c1b</b> Engine Column</li>
+                                    <li><b>S2c1c</b> Crew Column</li>
+                                    <li><b>S2c1d</b> Status Column</li>
+                                </ul>
+                            </li>
+                            <li><b>S2c2:</b> Always Visible?<br/>
+                                Always displayed, if you want it hidden and only shown when you care to see, uncheck this, and then you can press ALT for it to populate on the next UI refresh cycle.
+                            </li>
+                        </ul>
+                    </li>
+                </ul>
+            </li>
+            <li><b>S3:</b> Webhooks
+                <ul>
+                    <li><b>S3a:</b> Webhook Enabled<br/>Will parse the console messages and transmit to a Discord webhook.</li>
+                    <li><b>S3b:</b> Reporting Mark<br/>Reporting mark of the company this Discord webhook applies to.</li>
+                    <li><b>S3c:</b> Webhook Url<br/>Url of Discord webhook to publish messages to.</li>
+                </ul>
+            </li>
+         </ul>
+  </li>
+</ul>
 
 ### Does this work in Multiplayer?
 Yes, these are client side mods. Host doesn't need to have them.