persona
ARES System Manual: persona Application

persona: shows current persona status and lists available personas
persona <name>|default: loads the specified persona
persona .<action>: generates a suitable chat message
persona set <field> <value>: sets a persona trait

The ARES persona system is a roleplay enhancement tool that allows the unit to enter into special personality 'modes' or states of mind on command.

Persona files (which use the .p extension) typically specify a speech marker (chat sound), an #RLV outfit folder to load (typically stored in #RLV/~ARES/persona) and an arbitrary number of preset messages. These are called persona traits.

As persona files in ARES are implemented as shell scripts, each line that sets up a trait must be prefixed appropriately, e.g.:

persona set marker <neuter> <female> <male> specifies the UUIDs for each gender's speech marker (see gender)
persona set path $rlv/persona/<folder-name> specifies the #RLV folder to load while in the persona
persona set action {}: clears the list of preset messages (recommended at the start of each persona)
persona set action.<action> <message>: sets a persona preset message

Persona preset messages can be called directly by typing .<action> (as described on the input manual page.) This is a convenient way to convey the gist of a persona in roleplay, and the unit's only way of chatting when its mind is turned off.

Many persona messages sound more natural if the unit is able to refer to itself with the correct pronouns. To do this optimally, use the say command, as in these examples:

persona set action.use? @say This unit offers \$pm.refl to assist.
persona set action.mind @say This unit cannot comply while \$pm.gen cortex is disabled.

These examples use \$pm.refl and \$pm.gen to substitute the reflexive and genitive pronouns (see gender) at time of invocation (see input). Had the persona simply specified:

persona set action.use? This unit offers $pm.refl to assist.
persona set action.mind This unit cannot comply while $pm.gen cortex is disabled.

...then the pronoun values would be fixed when the persona was loaded, slightly inconveniencing anyone who wants to roleplay gender-shifting during a scene.


Embedding Commands

Since a .p file is technically a shell script, any system command can be embedded in it - just strip off the @ sign from the start. For example, a persona might change color schemes:

id color load pastels

Or change power settings:

power optics off

Or simply send a message:

say The S-Blade has a Hackblood charge!

However, remember that there is no script that gets executed when a persona is removed, so if you modify a persona to include a state change, you will want to add counterparts to the rest of your personas as well.