stk-code/data/kart_characteristics.xml

<?xml version="1.0"?>
<!-- Format
    It is possible to give relative values (factors and more) for each property.

    The format as a regex is: ([+-*/](%d+|x))*
    An empty value means no change, a value without sign or with a '-' replaces
    the previous value. If an operator prefixes the string, e.g. *1.5 (- doesn't
    work because it's a sign). x will get replaced by the previous value which
    means *1.5 is equal to x*1.5. It's also possible to combine operations:
    +1.5*20 means "add 1.5 to the previous value and then multiply by 20".
    Note that it's computed sequentially from left to right and there is no
    operator precedence. Also whitespaces aren't allowed because they are used
    to split arrays.
    If you want to return the square of something use x*x or only *x.

    ATTENTION: '-' is a special case if it is the first character of a number-
    string. It means that the number is negative and NOT that the following
    float will be subtracted from the base value. So if x = 10 and the string
    "-5" is processed, the result will be -5 and not the same as "x-5", which
    would result in 10 - 5 = 5.
-->
<characteristics>
    <!-- The default values that can be modified by the difficulty, karts, etc.
        The values here should also be the values of the maximum difficulty. -->
    <characteristic name="base">
        <!-- ********** Physics ********** -->

        <!-- Suspension
            stiffness: kart's suspension stiffness.
            rest: Length of suspension when at rest.
            travel-cm: maximum movement of suspension - in cm!!
            exp-string-response: dampen the suspension spring reaction
                exponentially. See
                http://bulletphysics.org/Bullet/phpBB3/viewtopic.php?f=9&t=7369\&p=25236&hilit=vehicle#p25236
                for details.
            max-force: Maximum suspension force -->
        <suspension stiffness="280" rest="0.3" travel="0.29"
            exp-spring-response="false" max-force="32000" />

        <!-- Values related to stability of the chassis: damping, and reduced
                impact of roll.
            downward-impulse-factor: A speed proportional impulse applied each
                frame that pushes the vehicle onto the ground.
            track-connection-accel: An artificial force that pulls a wheel to
                the ground if its off ground. Reduces the affect if a kart loses
                contact with the ground (i.e. it then can't steer or accelerate
                anymore).
            angular-factor: Factor to change angular impulses. X and Z rotations
                are damped to avoid that karts in a collision are too easily pushed
                into a roll or pitch, which makes them topple over
            smooth-flying-impulse: apply a torque impulse to flying kart to keep
                them parallel to the ground. -->
        <stability roll-influence="0.3"
                   chassis-linear-damping="0.2"
                   chassis-angular-damping="0"
                   downward-impulse-factor="5"
                   track-connection-accel="2"
                   angular-factor="0.25 1.0 0.5"
                   smooth-flying-impulse="250" />

        <!-- Turning
            radius: The turn radius of the kart at
                a given speed. The actual steering angle is dependent on the
                wheel base of the kart: radius = wheel_base/sin(steering_angle).
                The values below define that at speed 0 the turn radius is 2, at
                speed 10 the radius is 7.5 etc.
                The actual turn radius is piece-wise linearly interpolated. This
                allows for tighter turning at lower speeds, and also avoids that
                the kart becomes too hard to control at high speed (speeds
                higher than 25 can only be reached with powerups).
            time-full-steer: This is the amount of change in steering depending
                on current steering. So if the steering is between 0 and 0.5,
                the time-for-steering-change is 0.15. If the current steering is
                between 0.5 and 1.0, the time-for-steering-change is 0.25.
                The speed is used as dt/time-for-steering-change.
                In short: steering at less than halfway is somewhat faster,
                which should avoid oversteering (by pressing the key for too long),
                but slower when you want to steer more. Overwall with the current
                settings the expected time-to-full-steer is:
                0.5 * 0.25 + 0.5 * 0.15 = 0.2 ... which is overall the same
                time we had previously. -->
        <turn radius="0:2.0 10:7.5 25:15 45:30"
              time-full-steer="0:0.17 0.5:0.17 0.5:0.28 1.0:0.28"
              time-reset-steer="0.1" />

        <!-- Speed and acceleration
            power: The power of the kart (the engine power needed to accelerate
                   at a given pace is proportional to mass)
            max-speed: The base maximum speed of the kart in m/s
            generic-max-speed: Must have the same value as max-speed. This
                       is the max speed independently of kart type and
                       of handicap, which is used by basket balls.
            brake-factor: Value used when braking.
            brake-time-increase: The brake force is multiplied by
                (1 + brake_time) * brake_time_increase - i.e. the longer the
                brake was pressed, the harder the kart will brake.
            max-speed-reverse-ratio is the percentage of max speed for reverse
                gear.
          -->
        <engine power="950" max-speed="25" generic-max-speed="25" brake-factor="15"
                brake-time-increase="6" max-speed-reverse-ratio="0.65" />

        <!-- Simulated gears
            switch-ratio defines at what ratio of the maximum
                speed what gear is selected, e.g. 0.25 means that if the speed is
                inferior or equal to 0.25 * maxSpeed then use gear 1, 0.5 means if
                the speed is inferior or equal to 0.5 x maxSpeed then gear 2.
                gear-power-increase contains the increase in max power (to simulate
                different gears), e.g. 2.5 as first entry means: 2.5 * maxPower in gear 1
                | first  | second |  third | . -->
        <gear switch-ratio="0.2 0.45 0.7 1 1.25"
              power-increase="2.5 2.1 1.7 1.4 1.2" />

        <!-- Mass of a kart -->
        <mass value="350" />

        <!-- Wheels
            damping-relaxation/compression: for bullet
            damping parameters
            Radius and width of wheel
            front-right, front-left, rear-right and rear-left give the
                position of the physics raycast wheels relative to the center of
                gravity. Default is to use the corners of the chassis to attach
                the wheels to. -->
        <wheels damping-relaxation="35"  damping-compression="15">
            <front-right position="0.38 0 0.6"   />
            <front-left  position="-0.38 0 0.6"  />
            <rear-right  position="0.38 0 -0.6"  />
            <rear-left   position="-0.38 0 -0.6" />
        </wheels>

        <!-- Friction of a kart when e.g. sliding along a wall. -->
        <friction kart-friction="0.0" />

        <!-- ********** Visuals ********** -->

        <!-- Skidding
            increase: multiplicative increase of skidding factor in each frame.
            decrease: multiplicative decrease of skidding factor in each frame.
            max: maximum skidding factor = maximum increase of steering angle.
            time-till-max: Time till maximum skidding is reached.
            visual: Additional graphical rotation of kart. The graphical rotation
                of the kart also determines the direction the kart is driving to
                when skidding is stopped.
            visual-time: How long it takes for the visual skid to reach maximum.
            revert-visual-time: how long it takes when stopping a skid to revert
                the visual skid and bring visuals and physics in sync again.
            min-speed: Minimum speed a kart must have before it can skid. Must be
                >0, otherwise the kart can skid at the start of the race.
            time-till-bonus: How long a kart needs to skid in order to get a bonus.
            bonus-force: A speedup applied to the kart whick skidded for a while.
            bonus-time: How long the bonus-force is applied.
            bonus-force: Additional engine force (this is used to offset the fact
                that turning after skidding (e.g. to correct direction) often uses
                up the skid bonus).
            post-skid-rotate-factor: a factor to be used to determine how much
                the chassis of a kart should rotate to match the graphical view.
                A factor of 1 is identical, a smaller factor will rotate the kart
                less (which might  feel better).
            physical-jump-time: Time for a physical jump at the beginning of a skid.
                graphical-jump-time: Time for a graphics-only jump at the beginning
                of a skid.
            reduce-turn-min/max: The steering done by the controller (which is in
                [-1,1]) is mapped to [reduce-turn-min, reduce-turn-max] when skidding
                is active (for left turn, right turn will use [-max, -min]). The
                effect is that while you skid (say left) you can adjust the direction
                of the turn the kart is doing somewhat by steering to the left and right,
                but you will always keep on doing a left turn, just more or less. -->
        <skid increase="1.05" decrease="0.95" max="2.5" time-till-max="0.5"
              visual="1.25" visual-time="0.7" revert-visual-time="0.7"
              min-speed="10"  time-till-bonus="1.0 3.0"
              bonus-speed="4.5 6.5" bonus-time="3.0 4.0"
              bonus-force="250 350"
              physical-jump-time="0" graphical-jump-time="0.4"
              post-skid-rotate-factor="1"
              reduce-turn-min="0.2" reduce-turn-max="0.8" enabled="true" />

        <!-- Camera
            Distance between kart and camera.
            forward-up-angle: Angle between camera and plane of kart (pitch)
                when the camera is pointing forward
            forward-smoothing: if true, use smoothing (forward-up-angle become relative to speed) when pointing forward
            backward-up-angle: Angle between camera and plane of kart (pitch)
                when the camera is pointing backwards. This is usually
                larger than the forward-up-angle, since the kart itself
                otherwise obstricts too much of the view. -->
        <camera distance="1.0"
                forward-up-angle="0" forward-smoothing="true"
                backward-up-angle="5" />

        <!-- Jump animation
            animation-time: only if the estimated time for a jump is larger
                than this value will the jump animation being
                shown. -->
       <jump animation-time="0.5" />

        <!-- Leaning related parameters, i.e. slightly leaning the karts when
             driving a fast curve.
            max: maximum leaning (i.e. when steering as much as possible at highest
                speed), in degrees.
            speed: Speed with which the leaning changes (in degree/second). -->
        <lean max="12.0" speed="12.0" />


        <!-- ********** Items ********** -->

        <!-- Anvil
            weight: The additional weight an anvil adds to a kart.
            speed-factor: The additional slowdown caused by the anvil.
            duration: The time an anvil is active. -->
        <anvil duration="2.0" weight="150"  speed-factor="0.2" />

        <!-- Parachute
            friction: The friction factor when a parachute is attached.
            duration: The time an attached parachute is active
            duration-other: Used when the parachute results from item use
            duration-rank-mult: The multiplier applied to the duration of the
            parachute on the 1st kart when affected by the item. Scale for
            intermediary ranks to 1.0 for the last affected.
            duration-speed-mult: Applied in all cases, multitplier to duration
            of the parachute at max-speed. Scale to 1.0 at 0 speed.
            lbound-fraction: The lower bound fraction of speed when lost will
                detach parachute. E.g. at nearly 0 speed, only 20% of speed
                need to be lost.
            ubound-fraction: The upper bound fraction of speed when lost will
                detach parachute. E.g. at max-speed 50% of speed must be lost.
            max-speed: A factor that decides the impact of rate of speed
                (distance between bounds) -->
        <parachute friction="5.0" duration="3" duration-other="2.5"
                   duration-rank-mult="1.5" duration-speed-mult="1.35"
                   lbound-fraction="0.5" ubound-fraction="0.3" max-speed="30" />
        <!-- Bubblegum
            duration: How long the bubblegum lasts.
            speed-fraction: To what fraction of top-speed the speed is reduced.
            torque: To rotate the kart somewhat.
            fade-in-time: How quick the slowdown takes effect.
            shield-duration: How long the bubblegum shield lasts -->
        <bubblegum duration="1" speed-fraction="0.3" torque="500" fade-in-time="0.01"
                   shield-duration="10.0" />

        <!-- Zipper
            duration: Time a zipper is active.
            force: Additional zipper force.
            speed-gain: One time additional speed.
            max-speed-increase: Additional speed allowed on top of the
                kart-specific maximum kart speed.
            fade-out-time: determines how long it takes for a zipper
                to fade out (after 'time'). -->
        <zipper duration="3.5" force="250.0" speed-gain="4.5" max-speed-increase="15"
                fade-out-time="1.0" />

        <!-- Swatter
            duration: How long can the swatter be active.
            distance: How close a kart or an item must be before it can be hit.
                      This is the square of the real distance to accelerate the
                      compution.
            squash-duration: How long a kart will remain squashed.
            squash-slowdown: Percentage of max speed that a kart is
                restricted to. -->
        <swatter duration="10" distance="9" squash-duration="5"
                 squash-slowdown="0.5" />

        <!-- Plunger and rubber band handling
            band-max-length: The maximum length of rubber band before it snaps.
            band-force: The force a plunger/rubber band applies to the kart(s).
            band-duration: The duration a rubber band acts.
            in-face-time determines how long it takes before a plunger
                in your face is removed. -->
        <plunger band-max-length="50" band-force="1500" band-duration="1"
                 band-speed-increase="7" band-fade-out-time="3"
                 in-face-time="4.5" />


        <!-- ********** Miscellaneous ********** -->

        <!-- Startup
            If a kart starts within the specified time after 'go',
            it receives the corresponding bonus from 'boost'. Those
            fields must have the same size, and must be sorted by
            increasing times. -->
        <startup time="0.3 0.5"
                 boost="8 4" />

        <!-- Rescue
            duration: How long it takes the kart to be raised.
            height: how height the kart will be raised before it is
                dropped back onto the track.
            vert rescue offset: used to raise karts a bit higher before
                releasing them on the ground after a rescue. Used to avoid
                resetting karts into the track. Not sure if this is still
                necessary. -->
        <rescue vert-offset="0.0" duration="1.2" height="2" />

        <!-- Explosion
            duration: how long it takes before the kart can drive again (this
                determines how height the kart is being thrown).
            invulnerability-time: how long a kart will be invulnerable
                after being hit by an explosion.
            radius: Kart closer to this value will be affected by
                an explosion as well.  -->
        <explosion duration="1.5" radius="6"
                   invulnerability-time="7" />

        <!-- Nitro
            engine-force: additional engine power
            engine-mult: multiply the total engine power by this
            consumption: nitro consumption - heavier characters can be set
                to need more nitro than lighter character.
            small-container: how much energy a small container gives.
            big-container: how much energy a big container gives.
            max-speed-increase: How much the speed of a kart might exceed
                its maximum speed (in m/s).
            duration: How long the increased speed will be valid after
                the kart stops using nitro (and the fade-out-time starts).
            fade-out-time: Duration during which the increased maximum
                speed due to nitro fades out.
            max: How much nitro a kart can store. -->
        <nitro engine-force="300" engine-mult="1.2" consumption="1"
               small-container="1" big-container="3"
               max-speed-increase="5" duration="1" fade-out-time="2.4" max="20" />

        <!-- Slipstream
            base-speed: the speed for which length and width are valid.
                They are upscaled when faster and downscaled when slower.
            length: How far behind a kart slipstream works
                (note : this helps OTHER karts)
            width: how wide slipstream works furthest away from the kart.
            inner-factor: The proportion of the slipstreaming area with
                twice faster slipstream "credits" collection.
            min-collect-time: How many seconds of sstream are needed to get a bonus
                it can be accumulated faster if in the inner quad)
            max-collect-time: How many seconds of sstream bonus can be accumulated at most
            add-power: Additional power due to sstreaming.
            min-speed: Minimum speed necessary for slipstream to take effect.
            max-speed-increase: How much the speed of the kart might exceed
                its normal maximum speed.
            duration-factor: A multiplicator to how long the higher speed lasts
                1 means it last as long the total time collected
            fade-out-time: How long the slip stream speed increase will
                gradually be reduced.  -->
        <slipstream base-speed="20" length="8" width="4" inner-factor="0.5"
                    min-collect-time="2.5" max-collect-time="8" add-power="300" min-speed="8"
                    max-speed-increase="3" duration-factor="1" fade-out-time="2" />
    </characteristic>

    <!-- The different difficulties (like easy, medium, hard) -->
    <difficulties>
        <characteristic name="easy">
            <engine power="*0.7" max-speed="*0.6" generic-max-speed="*0.6" />
            <plunger in-face-time="3" />
        </characteristic>
        <characteristic name="medium">
            <engine power="*0.83" max-speed="*0.8" generic-max-speed="*0.8" />
            <plunger in-face-time="4" />
        </characteristic>
        <characteristic name="hard">
            <engine power="*0.92" max-speed="*0.92" generic-max-speed="*0.92" />
        </characteristic>
        <!-- This doesn't need to be changed because the most fast/heavy/extreme
            values should also be the default ones. -->
        <characteristic name="best" />
    </difficulties>

    <!-- The different kart types, that can be specified in the kart.xml file -->
    <kart-types>
        <characteristic name="light">
            <turn radius="0:2.0 10:7.5 25:15 45:30" />
            <engine power="*0.8" max-speed="*0.95" brake-factor="*1"
                 max-speed-reverse-ratio="*0.8" />
            <gear switch-ratio="0.1 0.25 0.45 0.7 1.0 4.0"
                  power-increase="2.8 2.3 1.9 1.5 1.25 1.0" />
            <mass value="*0.6" />
            <startup boost="*1 *1" />
            <explosion time="*1" radius="*1" />
            <nitro engine-force="*0.6" max-speed-increase="*0.9" duration="*1" />
            <slipstream length="*0.9" collect-time="*0.9"
                        duration-factor="*1" fade-out-time="*1" />
        </characteristic>
        <characteristic name="medium">
            <turn radius="0:2.3 10:8.625 25:17.25 45:34.5" />
            <engine power="*0.875" max-speed="*1" brake-factor="*0.8"
                    max-speed-reverse-ratio="*0.75" />
            <gear switch-ratio="0.1 0.25 0.45 0.7 1 4"
                  power-increase="2.4 2 1.7 1.4 1.2 1" />
            <mass value="*0.75" />
            <startup boost="*0.8 *0.8" />
            <explosion time="*0.8" radius="*0.8" />
            <nitro engine-force="*0.75" consumption="*1.25" />
            <slipstream duration-factor="*0.8" fade-out-time="*1" />
        </characteristic>
        <characteristic name="heavy">
            <turn radius="0:2.6 10:9.75 25:19.5 45:39" />
            <engine power="*1" max-speed="*1.05" brake-factor="*0.6"
                    max-speed-reverse-ratio="*0.7" />
            <gear switch-ratio="0.1 0.25 0.45 0.7 1 4"
                  power-increase="2 1.7 1.5 1.3 1.15 1" />
            <mass value="*1" />
            <startup boost="*0.6 *0.6" />
            <explosion time="*0.6" radius="*0.6" />
            <nitro engine-force="*1" consumption="*1.67" max-speed-increase="*1.1" />
            <slipstream length="*1.1" collect-time="*1.1"
                   duration-factor="*0.6" fade-out-time="*1" />
        </characteristic>
    </kart-types>

    <!-- Per-player settings/handicaps (or boosts) -->
    <player-characteristics>
        <characteristic name="normal" />
        <characteristic name="handicap">
            <engine power="*0.9" max-speed="*0.9" brake-factor="*0.8" brake-time-increase="*0.85" max-speed-reverse-ratio="*0.8" />
            <skid time-till-bonus="*1.2 *1.0" bonus-speed="*0.9 *0.8" bonus-force="*0.9 *0.9" />
            <bubblegum duration="*1.5" torque="*1.5" />
            <zipper force="*0.8" speed-gain="*0.8" max-speed-increase="*0.8" />
            <swatter duration="*0.8" squash-duration="*1.3" />
            <plunger band-max-length="*0.8" band-speed-increase="*0.8" in-face-time="*1.3" />
            <startup time="*0.8 *0.8" boost="*0.8 *0.8" />
            <rescue duration="*1.5" />
            <nitro engine-force="*0.8" max-speed-increase="*0.9" max="*0.8" />
            <slipstream min-collect-time="*1.2" add-power="*0.9"
                        max-speed-increase="*0.9" duration-factor="*0.9" />
        </characteristic>
    </player-characteristics>
</characteristics>