Beta Plug-in Hybrid Swap 1.0.1

Plug-in Hybrid Swap turns five vanilla cars (seven configurations) into plug-in hybrids: a 1.4 turbo petrol engine (115 kW) and an 85 kW electric motor between the engine and a 6-speed dual-clutch gearbox, with a clutch that lets the engine stop and start while you drive. The battery sits under the rear seat (behind the front seats in the coupe), the petrol tank stays (smaller, to make room for the pack).

The drivetrain is calibrated on a real plug-in hybrid estate car: drive logs, the workshop manual and published data. Engine start and stop, the torque split, regeneration, brake blending and the warm-up all follow what the real car does.



Cars and configurations
Seven new configurations on five vanilla cars. The ETK cars keep rear-wheel drive, the others front-wheel drive.

• ETK 800 wagon and sedan: PHEV_ETK_wagon, PHEV_ETK_sedan (rear-wheel drive)
• ETK K-Series coupe: PHEV_ETKC_coupe (rear-wheel drive)
• Cherrier Vivace (FCV) and Ardente: PHEV_FCV, PHEV_Ardente (front-wheel drive)
• Hirochi Sunburst sedan and wagon: PHEV_Sunburst, PHEV_Sunburst_wagon (front-wheel drive)

You can also fit the parts to a configuration of your own: engine, gearbox, hybrid module and battery in the parts selector.

Features

• Three drive modes: Electric (engine off), Hybrid (the car decides) and Boost (engine and motor together, full system power).
• Charge mode: in Hybrid, the engine charges the battery while you drive or stand still, up to the top of the usable window, then it holds. In P or N about 11 kW at 1,800 rpm; in D at a standstill about 2 kW, without creeping.
• Regeneration when you lift off and when you brake, blended with the friction brakes. B position for stronger lift-off regeneration.
• Kickdown at full pedal (99 %); with keyboard throttle, hold full throttle for 2 s. It can be switched off.
• Battery sizes of 10, 13 and 18 kWh in the parts selector, each with its own mass. The petrol tank is reduced for the battery.
• Battery management: the charge is shown as the usable part only, in kWh and % (0 % empty, 100 % full: 6.75, 8.8 and 12.15 kWh usable on the 10, 13 and 18 kWh packs). The charge never goes above 100 %, whatever charges it (regeneration, the engine, a career charging station: the charger stops there and bills only the energy the pack took).
• Battery temperature: the pack starts at 20 °C with the game's "start preheated" setting, otherwise 5 °C above the outside temperature. A cold or hot pack gives and takes less power.
• Traction control follows the drive mode: Electric and Hybrid keep wheel slip low, Boost allows more.
• Brakes and springs adjusted per car for the extra mass, so the car keeps its ride height and brakes at least as strongly as before at the same pedal.
• Emergency stop signal: the brake lights flash under full braking from high speed, the hazard lights come on near a standstill.
• No engine start while the engine's air intake is under water.
• Plug-in Hybrid Monitor UI app: drive mode, engine and clutch state, motor and battery power, charge level. It shows only on a car with this drivetrain.

How to use

1. Put the zip in your mods folder (or subscribe) and start the game.
2. Spawn one of the PHEV configurations listed above, or fit the parts to your own configuration (engine, gearbox, hybrid module, battery).
3. Pick the battery size in the parts selector (10, 13 or 18 kWh).
4. Add the Plug-in Hybrid Monitor app in the UI apps menu if you like.

Drive modes and keys (change them in Options > Controls, category vehicle):

• G: Electric mode on / off
• T: Boost mode on / off
• U: B position (stronger lift-off regeneration)
• K: kickdown on / off
• Next drive mode and Charge mode have no default key: bind them if you want them.

Battery sizes

• 10, 13 and 18 kWh, each with its own mass; the petrol tank gets smaller to make room for the pack.
• Usable charge 6.75, 8.8 and 12.15 kWh, shown as 0-100 %. The charge is capped at 100 %, also at career chargers.
• Charge mode charges up to the top of the usable window.

Known limits

• The standstill charge figures (about 11 kW in P or N, about 2 kW in D) are provisional.
• Lifting off coasts more freely than with engine braking: regeneration takes its place.
• In the K-Series coupe, the battery slot stays empty after you swap its transmission to a vanilla part and back, until you pick a K-Series battery pack again.
• The mod ships one shared Lua folder (lua/vehicle). If your game version does not find it there, the repository README describes a fallback: copy the three Lua files into each car's own folder.

For mod authors
The hybrid parts and Lua are shared, so other vehicle mods can use them with a few small adapter parts. A guide is in the repository (see Additional Information).

Credits and licence

• The ETK, K-Series, Cherrier and Hirochi cars, their meshes and materials are BeamNG's own; the mod uses the vanilla meshes (the battery box is hidden in the rear seat base, behind the front seats in the K-Series coupe) and contains no copied vehicle meshes or textures.
• Licence: MIT, except the gearbox shift logic (shiftLogic-phevDct.lua), a modified copy of BeamNG's dual-clutch shift logic, which stays under the bCDDL 1.1 with its header kept: http://beamng.com/bCDDL-1.1.txt