Expression 2
This page will be focused on bringing to you the list with all Expression 2 custom functions which ACE has.
Is it possible to find all functions in game?
- Yes, you just have to open Expression 2 editor, which you can find on top right of the window(look at the picture).
- Once editor is open, enter acf in the search bar and all functions are going to appear.
Notes
- if function has e inside of parenthesis, then it requires(takes) entity as an input
Example: acfActive(e:)
- if function has e:n inside of parenthesis, then it requires(takes) number from entity as an input
Example: acfActive(e:n)
- Some commands could have a name / functionality change in future updates. This will be marked by [/].
General
- acfIsEngine - Returns 1 if the entity is an ACF engine.
- acfIsGearbox - Returns 1 if the entity is an ACF gearbox.
- acfIsGun - Returns 1 if the entity is an ACF gun.
- acfIsRack - Returns 1 if the entity is an ACF rack. Added as git 488
- acfIsRadar - Returns 1 if the entity is an ACF radar. Added as git 488
- acfIsAmmo - Returns 1 if the entity is an ACF ammo crate.
- acfIsFuel - Returns 1 if the entity is an ACF fuel tank.
- acfActive(e:) - Returns whether an ACF engine, ammo crate, or fuel tank is active.
- acfActive(e:n) - Sets whether an ACF engine, ammo crate, or fuel tank is active.
- acfHitClip - Returns 1 if hitpos is on a clipped part of prop.
- acfNameShort - Returns the short name of an ACF entity. Improved as git 488
- acfName - Returns the full name of an ACF entity. Improved as git 488
- acfType - Returns the type of ACF entity. Improved functionality in the dev branch.
- acfLinkTo - Link various ACF components together.
- acfUnlinkFrom - Unlink various ACF components.
- acfCapacity - Returns the capacity of an ACF ammo crate or fuel tank.
- acfInfoRestricted - Returns 1 if functions returning sensitive info are restricted to owned props.
- acfLinks - Returns all the entities which are linked to this entity through ACF.
- acfGetLinkedWheels - Returns any wheels linked to this engine/gearbox or its children links.
- acfDragDiv - Returns current ACF drag divisor.
- acfHeat - Returns heat of an ACF entity
- acfVersion - Returns latest git version of acf
- acfCurVersion - Returns current version of acf
- acfWindVector - Returns acf wind direction as a vector
Armor
- acfPropHealth - Returns the current health of an entity.
- acfPropHealthMax - Returns the max health of an entity.
- acfPropArmor - Returns the current armor of an entity.
- acfPropArmorMax - Returns the max armor of an entity.
- acfPropDuctility - Returns the ductility of an entity.
- acfEffectiveArmor - Returns the effective armor of a given nominal armor value and angle, or from a trace hitting an entity.
- acfPropMaterial - Returns the material of an entity.
- acfPropArmorData - Returns a table with armor data of the prop. Keys: Curve = [N], Effectiveness = [N], HEATEffectiveness = [N], Material = [S]
Engines
- acfMaxTorque - Returns the maximum torque (in N/m) of an ACF engine.
- acfMaxPower - Returns the maximum power (in kW) of an ACF engine.
- acfMaxTorqueWithFuel - Returns the maximum torque (in N/m) of an ACF engine with fuel linked.
- acfMaxPowerWithFuel - Returns the maximum power (in kW) of an ACF engine with fuel linked.
- acfIdleRPM - Returns the idle RPM of an ACF engine.
- acfPowerbandMin - Returns the powerband minimum of an ACF engine.
- acfPowerbandMax - Returns the powerband maximum of an ACF engine.
- acfRedline - Returns the redline RPM of an ACF engine.
- acfRPM - Returns the current RPM of an ACF engine.
- acfTorque - Returns the current torque (in N/m) of an ACF engine.
- acfFlyInertia - Returns the inertia of an ACF engine's flywheel.
- acfFlyMass - Returns the mass of an ACF engine's flywheel.
- acfPower - Returns the current power (in kW) of an ACF engine.
- acfInPowerband - Returns 1 if the ACF engine RPM is inside the powerband.
- acfThrottle(e:) - Gets throttle (0-100) for an ACF engine.
- acfThrottle(e:n) - Sets throttle (0-100) for an ACF engine.
- acfFuelRemaining - Returns the amount of fuel remaining for an ACF engine, in litres or kilowatt-hours.
- acfGetFuelTanks - Returns a list of all the fuel tanks of an ACF Engine. Added as git 488
Gearboxes
- acfGear - Returns the current gear of an ACF gearbox.
- acfNumGears - Returns the number of gears of an ACF gearbox.
- acfFinalRatio - Returns the final ratio of an ACF gearbox.
- acfTorqueRating - Returns the maximum torque (in N/m) an ACF gearbox can handle.
- acfIsDual - Returns 1 if an ACF gearbox is dual clutch.
- acfShiftTime - Returns the time in ms an ACF gearbox takes to change gears.
- acfInGear - Returns 1 if an ACF gearbox is in gear.
- acfTotalRatio - Returns the total ratio (current gear * final) of an ACF gearbox.
- acfGearRatio - Returns the ratio of a specified gear of an ACF gearbox.
- acfTorqueOut - Returns the current torque output (in N/m) an ACF gearbox. A bit jumpy due to how ACF applies power.
- acfCVTRatio - Sets the gear ratio of a CVT. Passing 0 causes the CVT to resume using target min/max rpm calculation.
- acfShift - Shift to the specified gear for an ACF gearbox.
- acfShiftUp - Set an ACF gearbox to shift up.
- acfShiftDown - Set an ACF gearbox to shift down.
- acfBrake - Sets the brake for an ACF gearbox. Sets both sides of a dual clutch gearbox.
- acfBrakeLeft - Sets the left brake for an ACF gearbox. Only works for dual clutch.
- acfBrakeRight - Sets the right brake for an ACF gearbox. Only works for dual clutch.
- acfClutch - Sets the clutch for an ACF gearbox. Sets both sides of a dual clutch gearbox.
- acfClutchLeft - Sets the left clutch for an ACF gearbox. Only works for dual clutch.
- acfClutchRight - Sets the right clutch for an ACF gearbox. Only works for dual clutch.
- acfSteerRate - Sets the steer ratio for an ACF double differential gearbox.
- acfHoldGear - Set to 1 to stop ACF automatic gearboxes upshifting.
- acfShiftPointScale - Sets the shift point scale for an ACF automatic gearbox.
Weapons
- acfIsReloading - Returns 1 if an ACF weapon is reloading.
- acfReady - Returns 1 if an ACF weapon is ready to fire.
- acfMagSize - Returns the magazine capacity of an ACF weapon.
- acfMagReloadTime - Returns time it takes for an ACF weapon to reload magazine.
- acfReloadTime - Returns time to next shot of an ACF weapon.
- acfReloadProgress - Returns number between 0 and 1 which represents reloading progress of an ACF weapon. Useful for progress bars.
- acfSpread - Returns the spread of an ACF weapon.
- acfFireRate - Returns the rate of fire of an ACF weapon.
- acfSetROFLimit - Sets the rate of fire limit of an ACF weapon.
- acfFire - Sets the firing state of an ACF weapon. Kills are only attributed to gun owner. Use wire inputs on gun if you want to properly attribute kills to driver.
- acfUnload - Causes an ACF weapon to unload.
- acfReload - Causes an ACF weapon to reload.
- acfMagRounds - Returns the rounds remaining in the magazine of an ACF weapon.
- acfAmmoCount - Returns the number of rounds in active ammo crates linked to an ACF weapon.
- acfTotalAmmoCount - Returns the number of rounds in all ammo crates linked to an ACF weapon.
- acfGetAmmoCrates - Returns a list of all the ammo crates of an ACF Weapon. Added as git 488
- acfGetCrew - Returns a list of all the crew seats of an ACF Entity. Added as git 488
Ammunition
- acfRounds - Returns the number of rounds in an ACF ammo crate.
- acfAmmoType - Returns the type of ammo in an ACF ammo crate or ACF weapon.
- acfRoundType - Returns the type of weapon the ammo in an ACF ammo crate loads into.
- acfCaliber - Returns the caliber of the weapon or ammo.
- acfMuzzleVel - Returns the muzzle velocity of the ammo in an ACF ammo crate or weapon.
- acfProjectileMass - Returns the mass of the projectile in an ACF ammo crate or weapon.
- acfFLSpikes - Returns the number of projectiles in a flechette round.
- acfFLSpikeRadius - Returns the radius (in mm) of the spikes in a flechette round.
- acfFLSpikeMass - Returns the mass of a single spike in a FL round in a crate or gun.
- acfPenetration - Returns the penetration of an AP, APHE, HEAT or FL round in an ACF ammo crate or weapon. Improved as git 488
- acfBlastRadius - Returns the blast radius of an HE, APHE, or HEAT round in an ACF ammo crate or weapon.
- acfDragCoef - Returns the drag coefficient of ammo in an ACF ammo crate or weapon.
Sensors
- acfRadarData() - Returns a table containing the outputs you'd get from an ACF tracking radar, missile radar, or IRST. Check radar wire outputs for key names.