Skip to content
This repository has been archived by the owner on Nov 23, 2021. It is now read-only.

ACTION parameter

Galactic Cat edited this page Oct 25, 2018 · 7 revisions

Quick Info

Property Description
Optional No
Key "action"
Values Dependent on TYPE parameter

Description

The ACTION parameter indicates what action to take if START, CONDITIONAL, DELAY and FORS are all passed.
Most of the time ACTION is non optional. It works in tandem with the TYPE parameter.
It's value depends on whatever TYPE value is chosen. Most ACTION values are only in effect until the UNTIL parameter is met.
This does not apply if the UNTIL parameter is not given, "instant" or "end".
This effect is called 'clean' and can be negated by defining the CLEAN parameter as "false".

Values

Because the ACTION values are dependent on what TYPE parameter is chosen they will be sorted as such.

TYPE is "chastity"

This TYPE value toggles chastity and the ACTION values work as follows:

ACTION value Description
"true" Enables the Chastity item and mutes the stroke ticker
"false" Disables the Chastity item and unmutes the stroke ticker

TYPE is "contact"

The ACTION value for the "contact" TYPE is long and complex. Therefore it was moved to this subpage.

TYPE is "ctc"

This TYPE value determines if the user may orgasm fully if at all.
The ACTION values are as follows:

ACTION value Description
"full" The user is free to orgasm fully.
"ruin" The user is allowed to orgasm. But they must ruin their orgasm.
"edge" The user is allowed to edge themselves, but may not orgasm.
"false" The user is not allowed to orgasm.

TYPE is "ignore"

This TYPE value indicates an instruction card of a certain type should be ignored.
The ACTION value determines the type of the instruction card to ignore.
The ignored card will always be the next of the specified type.
Example: the ACTION value "nice mistress" with this TYPE will cause the next 'Nice Mistress' card to be ignored.

TYPE is "instruction"

This TYPE value causes an instruction to appear on screen for the user to follow.
Whatever the instruction reads is provided in the ACTION parameter.
Therefor, the ACTION value should just be a string of text.

TYPE is "item"

This TYPE value causes an item to appear on screen in the item menu for the user to equip.
The ACTION value should be an array (square brackets) with the slot and itemname. Or simply, but rather not, simply the item name.
For instance when equipping a collar a correct value would be: ["neck", "Crazy cool collar"]
Whenever an item is equipped on a filled slot it replaces the item.
There's the following convention when it comes to item slots:

  • Head
  • Mouth
  • Neck
  • Chest
  • Arms
  • Wrists
  • Waist
  • Chastity (special for chastity belts)
  • Penis
  • Vagina
  • Urethra
  • Ass
  • Legs
  • Ankles

You can also unlock an item in a certain slot by providing "unlock" as the first item in the array, followed by the slot you wish to unlock. For instance ["unlock", "waist"].
Please keep in mind that equipping chastity belts can better be done by using the "chastity" TYPE. If you want to equip an item outside of a slot, you can do so by just supplying the item name as action value. For instance: "crazy cool collar".

TYPE is "key"

This TYPE value adds keys to the users pool.
The ACTION value provided determines how many.

This is the only TYPE parameter for which ACTION is optional. The default is "1".
The ACTION value should be any whole number. Even negative numbers (to subtract keys) are possible.

TYPE is "mood"

This TYPE value allows making the mood better or worse.
The ACTION value provided should either be "good" or "bad" to do this.
"good" will up the mood, whilst "bad" will worsen it.

TYPE is "on"

This TYPE value provides a method to wait for a specific event listened for by the FORS parameter.
The ACTION parameter is another action.
The following example display a card which waits for the player to cum, and then sets their strokecount to 5:

{
  "actions": [
    {
      "start": "draw", // Start only if the card has been drawn
      "type":  "on",
      "fors": "type:cum:any", // Trigger when the player cums
      "action": [
        {
          "start": "start", // Start this action immidiatly as it's created (when the upper FORS is met)
          "type": "strokecount", // Set the strokecount
          "fors": "instant", // No questions asked
          "action": "=5", // Set strokecount to 5
          "until": "instant" // That's all folks
        }
      ], // Don't forget the comma!
      "until": "type:cum:any" // Stop checking after the first cum.
    }
  ]
}

TYPE is "position"

The position TYPE value sets the position displayed on screen for the user.
This represents the position the user should be holding.
The actual position text is provided by the ACTION value.
Therefor, the ACTION value should provide a string of text. For instance: "On the floor".

TYPE is "setslide", "slidetime", or "strokecount"

These types all modify a numerical value. Namely:

  • The slide index
  • The time per slides in seconds
  • The amount of strokes per slide

They all can be adjusted using the same system.
This special adjustment system where the modifier and the factor are bundled together like this:

Modifier Example Description
Addition "+1" Adds to the current value (example: adds 1)
Subtraction "-1" Subtracts from the current value (example: subtracts 1)
Multiplication "*3" Multiplies the current value (example: multiplies by 3)
Division "/2" Devides the current value (example: devides by 2)
Setting "=4" Sets the value to something (example: sets value to 4)
Switching See below Cycles trough multiple modifiers (only slidetime and strokecount)

Switching (only for "slidetime" and "strokecount" TYPEs)
You can also cycle through multiple modifiers in order (one per slide), this is what switching is for.
For example: when wanting to switch between 5 en 15 strokes per slide, you can use "sw:5,15" or "sw:=5,=15".
But you can also do a 'two steps forward, one step back' kinda thing with "sw:+2,-1" or "sw:+1,+1,-1".
Please note that the order in which the modifiers are performed are kept.
Also note that using "fors": "instant" or "until": "instant", will result in only the first modifier being run.

TYPE is "skip"

The skip value sets the slide to the specified instruction card, in the future or past. How many instruction card it advances (or goes back) and to what instruction card it does, are defined by the ACTION value.
It's ACTION value is built up out of two componenets seperated by a ::

  • The 'distance' to skip
  • The type of instruction card to skip to

For instance, when skipping two Nice Mistresses ahead, you'd use "action": "2:nice mistress".
Skipping backwards is also possible, using a negative value, namely "action": "-2:nice mistress" skips back two mistresses.
Using zero won't accomplish anything.

TYPE is "stop"

The stop TYPE value modifies the users ability to quit the slide or it's penalisation.
This TYPE value is also used for quitting the tease. It all depends on the corresponding ACTION value:

ACTION value Description
"block" Blocks the user from quitting the tease until the UNTIL parameter is met.
"allow" Allows the user to quit the tease without being penalized for it until the UNTIL parameter is met.
"quit" Quits the tease.

TYPE is "sublevel"

Used to set the sublevel (or submission level) to a value between 5 and -5.
Here -5 is completely defiant and 5 is completely submissive.
The ACTION value is used to adjust the sublevel, by addition, subtraction or just plain setting:

Modifier Example Description
Addition "+1" Adds to the current value (example: adds 1)
Subtraction "-1" Subtracts from the current value (example: subtracts 1)
Setting "=4" or "4" Sets the value to something (example: sets value to 4)

Learn more

Next parameter: UNTIL
All parameters