This is an old revision of the document!
In the MUD implementation, an ALIAS
is a string containing a sequence of commands which are executed as a batch when the alias is executed. It is private to the character on which it is defined. There are two steps to using aliases:
ALIAS yourword instruction1 arg1 arg2; instruction2 arg 3
etc.;yourword
For some instructions, you can supply an argument (here “rat”) to a parameter (here $1
). For example:
alias q shoot $1 q rat
will cause your character to shoot a rat in your present Room. For other instructions, this doesn't work. For example:
alias q kill $1 q rat
will fail because kill
requires an argument consisting of at least four characters to unambiguously identify its target, and $1
is (naively) too short to qualify.
You can redefine aliases in-situ:
alias test echo yawns alias test echo roars test > FirstLast roars.
If the incoming alias definition fails validation, the original alias is still deleted but the new alias is not stored.
You can list aliases by executing ALIAS
in isolation. You can delete an alias by supplying its name to alias, with nothing — not even a space — after it: ALIAS TEST
.
Many characters have a list of ongoing effects they would like to keep active while playing, however these effects are often terminated when logging out, when picked up by DocWagon, when a copyover
takes place, etc.
A quick way to get back up to speed is to bundle them together into an alias that is uniquely tailored to your character. An example might be:
alias buff activate Quintessence; activate Pain Editor; spool 6 0 0; cast Levitate self; spool 0 0 6; cpool 0 10 0
Then you can type buff
to quickly restore a known state. (If DocWagon doesn't bring your equipment, you might not have all the items referred to in your alias and get some errors… this is an advantage to implanted augmentations that always come with you.)
Doors close periodically. You might open a door, complete an objective, and on the return journey find the door has closed and blocked your path. Although you can type N
, E
, S
, W
, etc. to move, you cannot type OPEN N
to open a door in that direction due to a bug in the interpreter first trying to match an item in your inventory before considering Exits from the Room (You can't open a Docwagon Modulator, etc.) Therefore this block of aliases are short and easy to type when encountering a closed Exit:
alias nn unlock north; open north; north alias ss unlock south; open south; south alias ee unlock east; open east; east alias ww unlock west; open west; west alias nne unlock northeast; open northeast; northeast alias sse unlock southeast; open southeast; southeast alias ssw unlock southwest; open southwest; southwest alias nnw unlock northwest; open northwest; northwest alias uu unlock up; open up; up alias dd unlock down; open down; down
Exits are reported in clockwise order starting with North. Some Exits are hidden until you SEARCH
. If you fail to unlock a locked door, you bump into it. If you cannot unlock an already unlocked door, you get an error for that step and move unimpeded.
Lifts start at Ground floor and go up to first storey, second storey etc. or down to Basement 1, 2, etc. Some Room descriptions are desynchronised from which storey they are actually located on. Pushing buttons quickly gets tedious so:
alias pb push button alias lp look panel
When you ENTER
a vehicle, it unlocks. You can write an Alias which locks it again.
alias bison enter my.bison; lock
When you finish using the Autonav to a GridGuide destination, you are not driving, so you can leave easily. But if you have been manually driving (eg to enter a (Garage)) you are instead told that you can't safely leave a moving vehicle. In theory, STOP
should stop your vehicle. In practice, this does the job:
alias ll wake; speed idle; lock; sheathe; leave; exits
This covers characters who sleep in their cars and ensures you don't step out of your vehicle directly into aggressing Lone Star by having a weapon wielded.
If you want to be able to Autonav directly to GridGuide coordinates:
alias gridref grid add temp $*; grid temp; grid del temp
Then you can execute gridref lat,long
directly.
Some checkpoints require you to show a visa object before you can proceed:
alias visa get visa backpack; show visa guard; put visa backpack; exits
When you wake in Seattle Doc Wagon at low health, you can try to First Aid yourself up; you may be able to cast Healing spells on yourself. You can also run to Splat! and use their Medical Shop which is better than your Medical Kit:
alias medlab holster; s; e; s; w; n; n; w; w; w; w; n; n; n; w; s; treat self
Once you explore / get rescued further afield, you won't have such convenient access to a Medical Shop and if DocWagon didn't manage to bring your stuff, you may even not have your Med Kit. An alias can't help you with that.
alias y say yes alias no say no alias done say done alias jcycle job; yes; endrun
If you're an adept:
alias done activate Kinesics; say Done; deactivate Kinesics
You may need to DEACTIVATE
something or POWERDOWN
entirely if you don't have enough headroom to fit Kinesics in.
Transfer nuYen from your cash to your credstick:
alias cred deposit $1; transfer $1 credstick; look credstick; balance
then use it for example, cred 1500
. If you forget to supply a value, 11 nuYen will be attempted.
Certain commands are less obvious to remember than they could be:
alias bribe availoffset $1
You can see which pieces of gear need to be repaired:
alias dmg EQUIP DAMAGED
You will inevitably loot large quantities of completely worthless garbage in your efforts to not miss looting something worthwhile but at some point having an inventory full of garbage blocks you from looting anything else. At this point, an alias can be defined (and continuously refined) to purge all the chaff:
alias gg get all all.corpse alias jj junk all.sweeper; junk all.green; junk all.davis; junk all.marten; junk all.suspender; junk all.iron; junk all.humanis
etc. et al. ad nauseam.
If you have something in your bags that matches such a keyword that you don't want junked, KEEP
it first to protect it.
You may find that certain items consist of a worthless heavy component and a valuable light component that's worth caching and selling. An alias can assist such a routine:
alias smart detach smartlink 1.predator; put smartlink backpack; junk 1.predator
You will need to adjust these aliases based on the size of your own pools as they grow.
The Combat Pool array is remembered and reinstated based on whether you're wielding something. This can be surprising to encounter while reading back through the scrollspam from the DocWagon recovery room. But consider this scenario:
CPool being adjusted automatically to adhere to the rules is a good thing but to help protect my cerebral wetware from surprises, I use aliases like these to equip my [m]êlée, [r]anged, or [gh] to loot everything and holster everything:
alias mm holster; draw pole; cpool 0 4 6; stand; activate Counterstrike alias rr sheathe; draw rifle; cpool 4 0 6; mode bf; reload; pockets alias gh cpool 0 10 0; holster; cpool 0 10 0; get all all.corpse; look; scan
In the above lines, draw pole
finds an equipped polearm strap
with a weapon inside it, and puts that weapon in your hands. If your weapon is in something else (like a boot knife sheath) you'll need to put the name of that container here. If you are not a Physical Adept, omit the Counterstrike power.
Likewise, draw rifle
finds an equipped rifle strap
with a weapon inside it, and puts that weapon in your hands. If your weapon is in something else (like a concealed shoulder holster) you'll need to put the name of that container here. Sometimes weapons can forget their firing mode, or maybe last time you used it you went PRONE
with a tripod and forgot you left it on FA-10, so the alias ensures next time you draw it, it's in an expected firing mode.
gh
here sets CPool to defence, twice: once with a weapon out, and once with no weapon out. That way when you walk into an ambush, you're Staging Down already, and when you automatically draw in response, you're still Staging Down.
As a houserule, the MUD implementation disallows Dodge while prone. Therefore to avoid inadvertently wasting CPool on Dodge, you could define an alias:
alias pro cpool 0 6 4; prone
When you first Astrally Project, your Pools are set to default and often not all your Pool dice are represented. These aliases set you up for resilience and reorientation.
alias pj project; cpool 0 12 0; spool 0 0 12; pools alias rt return; stand; status; penalt; exits
Begin projecting with pj
; return with rt
.
Remember to include @Z
in your PROMPT
to keep track of your Essence depleting over time.
When you jack in, you want a carefully curated set of Utilities LOAD
ed from your Deck's storage memory to your Icon's active memory without loading (so many) (unnecessary) Utilities that you have inadequate capacity for the essentials. But you don't want to work that out and type it in every single time!
alias jackin connect; load armour; load browse; load sleaze; load read; load analyze; load deception; load decrypt; load attack
When you jack out, you first want to attempt to gracefully log off and erase your trail so you can't be traced. If sentry software blocks your escape, you can forcibly disconnect anyway and wake up to a nosebleed.
alias jackout logoff; disconnect; stand; exits
Most Matrix commands like LOCATE
, DECRYPT
, DOWNLOAD
, et al. automatically run what needs to be run to get the job done. But not the Attack Utility! It's special!
alias atk run attack $*
While the Decrypt Utility provides the DECRYPT
command, the Defuse Utility provides the DISARM
command:
alias defuse disarm $*
If you're used to the standard spelling of analyse, an alias like this can perform the exotic regional dialect localisation for you:
alias tally analyze security
During a PRun, you may find you accidentally keep typing OOC
by force of habit when you mean to type OSAY
which is unfamiliar.
alias ooc osay $*
temporarily masks typing ooc
to cause the same effect as if you'd typed osay
.
You might be used to other environments using /me reads the newspaper
-type syntax to emote.
alias me em $*
You may find that you keep on losing your Cyberdeck Utilities and then spot them drifting loose through Matrix hosts unexpectedly. This is because LOAD
“uploads” a utility to your Icon but UPLOAD
“uploads” a file to your Host. So if you naively UPLOAD ATTACK
to re-arm yourself when a tarpit has crashed your Matrix weapon, what you're inadvertently doing is throwing it away into cyberspace.
alias uploadfile upload $* alias upload load $*
With this alias in place, if you do need to intentionally upload a file, you can uploadfile
or will have to delete the alias (with ALIAS UPLOAD
).