👼Script: get/set ActorSimAttr directly - HAZARDOUS ⚠️

[ohlidalp]

Allows advanced users to set actor physics attributes directly, including some not accessible from .truck file format.

In AngelScript, the actor (BeamClass) got 2 new methods:

    void setSimAttribute(ActorSimAttr attr, float val);
    float getSimAttribute(ActorSimAttr attr);

The set* function always logs "[RoR|Actor] setSimAttribute: '{attr}' = {val}", where {attr} is the attribute name as string.

Currently, the available attributes only cover TractionControl:

    ACTORSIMATTR_TC_RATIO, //!< Regulating force, safe values: <1 - 20>
    ACTORSIMATTR_TC_PULSE_TIME, //!< Pulse duration in seconds, safe values <0.00005 - 1>
    ACTORSIMATTR_TC_WHEELSLIP_CONSTANT //!< Minimum wheel slip threshold, safe value = 0.25

Fixes #3188 - The wheel slip constant was hardcoded since 57dfbba but now it's adjustable again. Note that this is possibly not the final solution and other wheelslip coefs may need to be added, i.e. ACTORSIMATTR_TC_WHEELSLIP_CURSPEED_RATIO which would emulate the way it worked in earlier versions. This is open for experimenting.

Tip: To set this value automatically on each spawn, you can attach a script via .truck file format, see #3001 and enter this code:

void main() { thisActor.setSimAttribute(ACTORSIMATTR_TC_WHEELSLIP_CONSTANT, 0.2); }

Scripting reference manual is at https://developer.rigsofrods.org/d2/d42/group___script_side_a_p_is.html though it applies to previous stable release

[CuriousMike56]

Works nicely 👍