FrictionClutch

FrictionClutch

From BeamNG

Revision as of 02:28, 20 July 2018 by Capkirk (talk | contribs) (Added links to make wiki easier to navigate.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

The Friction Clutch (device name "frictionClutch") is a model of a sprung friction clutch. It improves on the old viscous clutch model from pre 0.7.2 by allowing angular locking of the engine to the powertrain, instead of constant slippage. In a Powertrain, it should be connected to a combustionEngine or electricMotor, and have a manualGearbox connected to it.

Jbeam Properties

Name Type Optional Default Value Description
lockSpring number true Autocalculated This value is calculated by looking at the downstream inertia in the powertrain and applying the most possible spring. Not recommmended to change. Going higher can cause instability.
lockTorque number true Autocalculated The torque limit after which the clutch will slip. This value is calculated by finding the torque required to stop the engine from redline in 1 second with full power. Not necessary to change unless you want very high peak forces from the clutch.
lockDamp number true =lockSpring/1000 A small amount of damping for stability. Not necessary to change.
clutchStiffness number true 1 This number can soften or stiffen the clutch angle integration. Not recommended to change.
coolingCoef number true 1 How effectively the clutch transmits heat to the bellhousing. Increase for better cooling.
maxClutchTemp number true 500 Maximum temperature of clutch (°C) before it is irreparably damaged and can no longer transmit torque.
warningTemp number true 200 Temperature of the clutch (°C) at which an onscreen warning is displayed.
maxSafeClutchTemp number true 300 Temperature of the clutch (°C) at which it begins to lose efficiency and begins slipping.
additionalEngineInertia number true 0 Sets the inertia of the clutch in kg*m^2. This will be added to the inertia of the engine.

Examples

Here is an example of the required powertrain section, along with the additional section for the properties.

    "powertrain": [
        ["type", "name", "inputName", "inputIndex"],
        ["frictionClutch", "clutch", "mainEngine", 1],
    ],
    "clutch": {},//you dont need to put anything here ;)