Clean & Repair Anywhere V1.07

Keep your vehicles in pristine condition as you traverse the streets of Los Santos. Say goodbye to the hustle of finding repair shops and car washes. With Clean & Repair Anywhere, you can repair and wash your vehicle anywhere, anytime.

Features:
Vehicle Repair: At the press of a button, repair your vehicle and get back on the road in no time. (Button set to the ContextKey – Default is ‘E’ unless you have binded it to something else).
Vehicle Washing: Keep your car sparkling clean wherever you go with the easy-to-use wash function. (Button set to the VehicleHeadlightKey – Default is ‘H’ unless you have binded it to something else).
Real-Time Animation: Enjoy immersive animations for both repair and cleaning actions, adding a touch of realism to your gameplay.
INI file to adjust settings like refuelling on repair and time it takes to repair/wash vehicle.

Installation:
To install “Clean & Repair Anywhere”, simply drag and drop the files into your ‘scripts’ folder located within the GTA V main directory. If the folder doesn’t exist, create one.

Requirements:
Before you dive in, make sure to have the following installed.

ScriptHookV
ScriptHookVDotNet

Bugs:
No known bugs.

Changelog:

1.07
New Features:
– Introduced a Flip Vehicle Button: Flip your vehicle back to its wheels if it’s turned over.

– Flip Vehicle Hold Duration: Customizable time duration for holding the flip vehicle button.

– Countdown Display for Vehicle Flip: Option to display a countdown timer for the flip vehicle function for added suspense or strategy.

– Engine Repair Value Setting: Configure the engine health value to which the vehicle will be repaired. For seamless integration,
make sure to set ‘RepairBodyDamage’ to ‘false’. This feature synergizes perfectly with my other mod,
‘Vehicle Explosion Control,’ specifically with its engine degradation feature, when ‘RepairBodyDamage’ is ‘false’ it will repair only the engine to a predetermined value,
leaving the body damage untouched. This simulates a realistic experience where your vehicle can be in a state that requires frequent stops for engine repairs until you can reach a full-service garage. (Pay & Spray)

Configuration Tweaks:
– Time Units Update: Converted the Repair/Clean duration settings from milliseconds to seconds for easier user configuration in the INI file.

Bug Fixes:
– Resolved an issue where props would not clear if the task was interrupted by entering a vehicle during the cleaning/repairing process.

1.06
This update introduces the ExplosionControl setting, providing users with the option to prevent vehicles from exploding due to excessive body damage, with exceptions for specific high-impact events.
When set to true, vehicles will become undrivable but not explode from excessive body damage.
Exceptions to this rule include explosions or high-impact events (e.g., falling from high heights or train collisions).
By default, this setting is false, allowing standard vehicle explosions.

1.05
I am really busy as of recently and will be for the next few weeks at minimum. However, please be assured that user suggestions remain an integral part of the development focus. This release, although limited in scope, features important contributions from users, particularly in .wav file selections and spanner positioning. I hope this update illustrates my ongoing dedication to refining the mod based on your invaluable suggestions, feedback and contributions and this will be ongoing.
As soon as my schedule allows, I’ll be turning my attention to addressing the remaining user recommendations. While I can’t assure that every suggestion will be implemented, each will receive my full consideration and best efforts.

1. Spanner Position Perfected: A special thanks to Peter Badoingy for helping us recalibrate the spanner’s position.

2. Expanded Audio Selection: We’ve Enriched the ‘CARA Audio’ folder with additional .wav files. Special thanks to Peter Badoingy and wvssuptokyo for creating and providing these new sound effects for us all.

3. Enhanced Error Logging & Language Support: Now, instead of directing error logs to the console, they will be saved to a dedicated CARA.log file with more details within the scripts folder. Also, I have solved some issues arising from non-English system languages—specifically, the complications tied to languages that use a comma as a decimal separator and a period as a thousands separator.

4. Core Logic Enhancements: Significant updates have been made to the underlying logic of the script, improving both performance and reliability.

1.04:
1. New Sound Effect:
– Added an option in CleanAndRepairAnywhere.ini for enabling/disabling a cleaning sound effect.
– Included a new folder with the corresponding .wav file; place it in the scripts folder.
You are able to change the Cleaning.wav if you find a better one just name it the same.
– You are all advised to go into the ‘CARA Audio’ folder and rename ;).wav to Cleaning.wav and then rename the original Cleaning.wav to something else.
adjust WashDuration to 13000 for this .wav like so – WashDuration = 13000
You can all thank Peter Badoingy for finding and creating this .wav :L

2. Visual Enhancements:
– Introduced new objects for a more immersive experience.
– Added a Spanner object for the repairing process.
– Included a Rag object for the cleaning process.

3. Customization Options:
– Expanded configuration options in CleanAndRepairAnywhere.ini:
– You can now define the position and rotation of Repairing and Cleaning Objects.
– Fine-tune their placement to your liking.
(I’ve made it as close as I have the patience for, I was struggling with the rotation for the spanner.
If I happen to figure out the exact settings first, I’ll implement them.
Alternatively, if you or someone else discovers the precise settings before me,
please let me know and I’ll incorporate them).

4. Blood Stain Removal:
– Enhanced cleaning functionality to remove blood stains effectively.

5. Bug Fixes:
– Implemented various fixes to improve overall functionality.

1.03
1. Customizable Interaction Distance: You can now adjust the distance at which you can repair or clean a vehicle.

2. Repair Body Damage Option: Added an option to control whether the script repairs both the vehicle’s engine health and physical body damage (such as dents and broken windows) during the repair process. Setting this option to ‘True’ will repair both, while setting it to ‘False’ will only restore the vehicle’s engine health, leaving body damage unchanged.

3. Customizable Repair and Clean Controls: You can now specify your preferred repair and clean controls using the Control Enum corresponding to your keybinds. To find the Control Enums for your keybinds, refer to this link: https://nitanmarcel.github.io/scripthookvdotnet/scripting_v2/GTA.Control.html. For example, you can set your repair control to ‘Context’ and your clean control to ‘VehicleHeadlight.’ These controls will adapt to your keybindings, making it easy to use the script with your preferred keys.

Example Configuration:
RepairEnumControl = Context
CleanEnumControl = VehicleHeadlight

All instructions and links can also be found in CleanAndRepairAnywhere.ini

1.02
1. You will now cancel the animation and repair/clean process if you enter the vehicle while
cleaning/repairing.
2. Added new options to CleanAndRepairAnywhere.ini:

; Repair duration in milliseconds (Default is 20 seconds).
RepairDuration = 20000

; Wash duration in milliseconds (Default is 20 seconds).
WashDuration = 20000

; Set to ‘true’ to refuel the vehicle to 100% when repairing, ‘false’ to retain the current fuel level.
RefuelWhenRepairing = false

; Set to ‘true’ to allow repairing on destroyed vehicles, ‘false’ to disable it.
AllowRepairOnDestroyedVehicles = false

; Set to ‘true’ to require the engine to be off for repairing, ‘false’ to allow repairing with the engine on.
RepairsRequireEngineOff = true

; Set to ‘true’ to require the engine to be off for cleaning, ‘false’ to allow cleaning with the engine on.
CleaningRequireEngineOff = false

1.01
The dll & Ini was just renamed to remove spaces.