ASL Cookbook

Practical examples on how to use the Arx Fatalis Scripting Language

Enabling the console in Arx Libertatis 1.2+

https://wiki.arx-libertatis.org/Script_console

Some useful commands

Heal the player / give mana

+25 HP for the player

specialfx heal 25

+25 mana for the player

specialfx mana 25

Add items to the player

The base command is inventory playeradd <folder name of * in graph/obj3d/interactive/items/*>/<subfolder in *>/<filename of asl file without extension>

Torch

inventory playeradd provisions/torch/torch

Lockpicking tools

inventory playeradd provisions/lockpicks/lockpicks

Health potion

inventory playeradd magic/potion_life/potion_life

Teleport the player

immediately teleport the player to level 15, no clicking on stair icon is needed "doesnt_matter" can be replaced by an entity id

teleport -nl 15 doesnt_matter

teleport player to level 18, rotate to 180deg with clicking on stair prompt "doesnt_matter" can be replaced by an entity id

teleport -al 180 18 doesnt_matter

Add gold

player gets 1000 gold

addgold 1000

Open any door

Open the door to akbaa in the bunker

sendevent open light_door_0038 nop

Open the door in the tavern

sendevent open light_door_0073 nop

Resize the player

make player 10% of it's original size - note that it doesn't change the scale of carried items

setscale 10

double the player's size

setscale 200

reset player's size back to default

setscale 100

Invulnerability

makes player be immunable to damages

invulnerability -p on

turns off player's invulnerability

invulnerability -p off

turn off Iserbius'/half Akbaa's invulnerability

akbaa_phase1_0001.invulnerability off

Arx equivalent of console.log

writes "hello" on top of the HUD

herosay "hello"

Change player model

Goblin

usemesh goblin_base/goblin_base.teo

Goblin lord

usemesh goblin_lord/goblin_lord.teo

Spawn stuff

Wall block at the player's feet

spawn item special/wall_block/wall_block player

One handed sabre at the player's feet

spawn item weapons/sabre/sabre player

Showing hidden entities

objecthide akbaa_phase_0002 no

Respawning

Respawn dead player (thanks @dscharrer)

setplayercontrols on specialfx heal ^player_maxlife

Respawn Lunshire, the human king

(after this the INITEND event will re-run)

human_base_0082.revive -i

Controlling a camera

Switch to viewing the world through camera_0020

cameraactivate camera_0020

Turning off any ongoing camera

cameraactivate none

Cinematics

Hiding HUD elements (healthbar, manabar, armor status)

playerinterface hide

Showing HUD elements (healthbar, manabar, armor status)

playerinterface show

Disable controls (keyboard, mouse)

setplayercontrols off

Enable controls (keyboard, mouse)

setplayercontrols on

Add items into player inventory

Adding full set of stealth armor

inventory playeradd armor/legging_leather_stealth/legging_leather_stealth

inventory playeradd armor/chest_leather_stealth/chest_leather_stealth

inventory playeradd armor/helmet_leather_stealth/helmet_leather_stealth

Jewels

inventory playeradd jewelry/ruby/ruby

inventory playeradd jewelry/diamond/diamond

Teleporting to different locations

Castle

teleport -l 0 marker_0338

City of Arx: entrance

teleport -l 11 marker_0222

City of Arx: market square

teleport -l 11 marker_0466

Tavern

teleport -l 12 marker_0549

Output: next to Ortiern

teleport -l 12 marker_0480

Teleport to the castle without prompt

teleport -ln 0 marker_0338

Crypt level 1

teleport -l 17 marker_0249

Crypt level 2

teleport -l 19 marker_0199

Crypt level 3

teleport -l 21 marker_0236

Crypt level 3: over Gladivir's puzzle

teleport -l 21 marker_0541

Crypt level 4

teleport -l 22 marker_0254

Crypt level 5

teleport -l 23 marker_0238

Crypt level 5: next to Poxellis' tomb

teleport -l 23 path_marker_0022

Goblin prison: intro spawn at the game start

teleport -l 1 marker_0495

Greu's place

teleport -l 1 marker_0494

Ice dragon's place

teleport -l 1 camera_0131

Goblin caves: before the exit

teleport -l 15 marker_0793

Troll's place

teleport -l 2 marker_0511

Goblin kingdom: main hall

teleport -l 2 flee_marker_0041

Crystal caverns

teleport -l 13 marker_0633

The underground lake

teleport -l 3 marker_0743

Rebel camp

teleport -l 16 marker_0864

Order of Edurneum

teleport -l 5 marker_0450

Temple of illusions

teleport -l 5 marker_0409

Ratmen's place

teleport -l 6 marker_0256

Dwarves' place

teleport -l 7 camera_0008

Harm an entity or player

Do 10 points of damage to the player

dodamage player 10

Do minimal damage to Lunshire (when in the castle)

dodamage human_base_0082 1

Collision

Go through the locked door in the Tavern by disabling collision

light_door_0073.collision off

Reverting back to the beta elevator at the goblin tunnels

See this in action

elevator_plateau_0002.usemesh elevator_plateau/elevator_plateau
elevator_plateau_0002.move 0 -10 20

Sources

• https://wiki.arx-libertatis.org/Arx_scripting_language
• https://wiki.arx-libertatis.org/Script:Variables
• https://wiki.arx-libertatis.org/Script:Events