These are sample shortcut-files for the Obsidian plugin Text Expander JS.
The easiest way to use these shortcut-files in your Obsidian vault is to click the "Import Full Library" button, near the top of the plugin settings, beside "Shortcut-files". This will download the full library into your vault, after which point you can remove shortcut-files as you wish.
To use an indiviual shortcut-file from this library in your Obsidian vault, you can copy the raw text of the shortcut-file and paste it into a note in your vault. Then:
- Make sure that Text Expander JS is installed in your vault.
- Open The Text Expander JS settings.
- Go to the first setting: "Shortcut-files".
- Click the "Add file reference" button. This adds a new textfield below the setting.
- Type the address of the vault-note into the new textfield. The textfield will be red until the address is recognized.
- Close the settings and type
;;help;
(!!help! on mobile) to review the new shortcuts.
- tejs_state
- tejs_lists
- tejs_varnotes
- tejs_mythicv2
- tejs_mythicgme
- tejs_une
- tejs_adventurecrafter
- tejs_rpgtools
- tejs_clips
- tejs_arrows
- tejs_lipsum
- tejs_support
This shortcut-file includes shortcuts that let the user manage a session state. Effectively allows saving and restoring data between sessions.
This shortcut file can be used by other shortcut-files to help them save/restore their states.
- reset state - Clear all state.
- state - Expands to a string representing the current state (for session saving).
- state {state} - Sets the current state based on {state}: a string created with the parameterless "state" shortcut.
Shortcuts for working with lists.
- reset lists - Clear all lists.
- lists - Show all list and all items for each list.
- lists list {list name} - Show all items in the list {list name}.
- lists pick {list name} - Get a random item from the list {list name}.
- lists add {list name} {item} - Add {item} to the list {list name}. Allows duplicate items.
- Can only add to basic lists and combo lists that contain basic lists.
- lists remove {list name} {item} - Remove an instance of {item} from the list {list name}.
- Can only remove from basic lists and combo lists that contain basic lists.
- lists removelist {list name} - Remove the entire list {list name}.
- lists addfolder {list name} {folder} - Create a folder-list named {list name} that is linked to the folder {folder}. A "folder-list" is a list who's items are the names of the notes in the linked folder.
- lists addcombo {list name} {sub list 1} {sub list 2}... - Create a combo-list named {list name} that is linked to the sublists given as {sub list 1}, {sub list 2}, etc. A "combo-list" is a list who's items are all of the items of its linked sublists.
Setup and manage variables within notes. Can be used by other shortcut-files for working with data in notes.
- reset varnotes - Removes all stored varnotes from the session state.
- varnotes - Lists all varnotes and the files they are connected to.
- varnotes vars {varnote name} - Lists all the vars for the varnote named {varnote name} (a required name property).
- varnotes add {varnote name} {file address} - Adds a varnote named {varnote name} (a required name parameter) that is attached to the file at {file address} (a required file address parameter).
- varnotes remove {varnote name} - Removes the varnote {var name} (a required name parameter).
- varnotes get {varnote name} {var name} - Gets the value of the var named {var name} (a required name parameter) in the varnote named {varnote name} (a required name parameter). Alternative shortcut: vn {varnote name} {var name}.
- varnotes set {varnote name} {var name} {value} - Sets the var named {var name} (a required name parameter) to {value} (a required text parameter), in the varnote named {varnote name} (a required name parameter). Alternative shortcut: vnset {varnote name} {var name} {value}.
- varnotes refresh - Get the latest vars from all varnotes and store it all.
- varnotes refresh {varnote name} - Pull the vars from varnote {varnote name} (a required "name" parameter).
(disabled by default, due to incompatibility with tejs_mythicgme)
Shortcuts for Mythic Variations 2. This is an excellent "GM emulator" system for solo and GM'less gaming. You can find more info about Mythic Variations 2 at wordmill games.
Incompatible with tejs_mythicgme. If tejs_mythicgme comes before tejs_mythicv2 in the shortcut-list, then tejs_mythicv2 will be disabled.
- reset mythicv2 - Reset mythic state to defaults and displays scene heading.
- mythicv2 details {state} - If {state} is given (must be "y" or "n"), assigns it to the mythicv2 "details" mode. Otherwise, displays the current "details" mode.
- detail - Make a detail check.
- event - Make an event check.
- fate {odds} {wanted} - Make a fate check based on {odds}: an optional value defaulting to 0 {50/50}. It can be from -4 (impossible) to 4 (has to be). It can also be the specific text of the odds, such as "impossible", "sure thing", etc. This shortcut is also based on {wanted}: an optional value of either 'n' or 'y', defaulting to 'y'. The value {wanted} specifies the direction of the chaos modifier. Alternative shortcut: f {odds} {wanted}.
- meaning action - Roll on the action meaning table. Alternative shortcut: meaning.
- meaning description - Roll on the description meaning table.
- scene - Show the current scene.
- scene {chaosAdjust} - Shift the chaos value by {chaosAdjust} (1, 0 or -1), then increment the current scene and run a scene check.
- chaos - Show the current chaos value.
- chaos-- - Decrease the chaos value by 1 (minimum of 3).
- chaos++ - Increase the chaos value by 1 (maximum of 6).
- chaos={value} - Set the chaos value to {value}, an integer from 3 to 6.
- descriptor - Generates a personality and activity descriptor for an NPC.
- disposition {descriptor count} - Rolls for an NPC's disposition, modified by {descriptor count}: a required parameter representing the total of the NPC's activated descriptors (integer from -3 to 3).
- Example: 2 positively activated descriptors and 1 negatively activated descriptor would make a {descriptor count} of 1+1+(-1) = 1.
- disposition {base} {descriptorCount} - Displays the NPC disposition determined by the {base} disposition, modified by {descriptorCount}. See "disposition {descriptor count}" for an explanation of {descriptor count}.
- action {dispositionAdjust} - Makes an NPC behavior check, modified by {dispositionAdjust}, the modifier of the NPC's disposition.
Shortcuts for Mythic Game Master Emulator. Mythic GME is an excellent "GM emulator" system for solo and GM'less gaming. It was designed by Tana Pigeon. You can find more info about Mythic GME at wordmill games.
Incompatible with tejs_mythicv2. If tejs_mythicv2 comes before tejs_mythicgme in the shortcut-list, then tejs_mythicgme will be disabled.
- reset mythicgme - Reset mythic state to defaults and displays scene heading.
- fate {odds} - Make a fate check based on {odds}: an optional value defaulting to 0 (50/50). It can be from -4 (impossible) to 6 (has to be). It can also be the specific text of the odds, such as "impossible", "sure thing", etc. Alternative shortcut: f {odds}.
- scene - Show the current scene.
- scene {chaosAdjust} - Shift the chaos value by {chaosAdjust} (1, 0 or -1), then increment the current scene and run a scene check.
- event - Make an event check.
- meaning - Roll on the meaning tables.
- chaos - Show the current chaos value.
- chaos-- - Decrease the chaos value by 1 (minimum of 1).
- chaos++ - Increase the chaos value by 1 (maximum of 9).
- chaos={value} - Set the chaos value to {value}, an integer from 1 to 9.
Shortcuts for UNE: The Universal NPC Emulator. UNE is an excellent character generation system for tabletop role playing and general storytelling. It was designed by Zach Best. You can find more info about UNE at its drivethrurpg page.
- une {randomness} {relationship to pc} {demeanor} - Runs "une character" and "une interact" together. {randomness} is an optional value for "une character". {relationship to pc} and {demeanor} are optional values for "une interact".
- une character {randomness} - Runs "identity", "power" and "motive" together. {randomness} is an optional value for "power".
- une interact {relationship to pc} {demeanor} - Runs "mood", "bearing" and "focus" together. {relationship to pc} is an optional value for "mood". {demeanor} is an optional value for "bearing".
- une identity - Generates a 2-word description for a character.
- une power {randomness} - Generates a character's power level relative to pc's power level, based on {randomness}: an optional number from 1 (order), to 5 (chaos), defaulting to 3 (standard).
- une motive - Generates three 2-word descriptions for a character's motivations.
- une mood {relationship to pc} - Generates a character's willingness to socialize for this interaction, based on {relationship to pc}: an optional number from 1 (love), to 7 (hate), defaulting to 4 (neutral).
- une bearing {demeanor} - Generate a character's attitude for this interaction, based on {demeanor}: an optional number from 1-8, defaulting to random and meaning one of the following: 1 - sceming 2 - insane 3 - friendly 4 - hostile 5 - inquisitive 6 - knowing 7 - mysterious 8 - prejudiced
- une focus - Generate a character's primary interest for this interaction.
Shortcuts for Adventure Crafter. Adventure Crafter is a system to create coherent story beats through randomization and tables. You can find more info about Adventure Crafter at wordmill games.
- reset adventurecrafter - Reset adventurecrafter state to defaults.
- turning point - Get a list of five plot points to represent a major milestone in a plotline.
- plot point - Get a single plot point, generated from the plot points table.
- themes pick - Pick a weighted random theme, as per the Adventure Crafter rules.
- themes - Show the ordered list of themes.
- themes fill - Fills the remaining open theme slots with random themes.
- themes roll - Fills the next open theme slot with a random theme.
- themes add {theme id} - If {theme id} (an optional number from 1 to 5) is NOT included, this shortcut shows the options for {theme id}. If {theme id} IS included, this shortcut fills the next open theme slot with the theme of {theme id}. {theme id} can be one of these options: 1 (Action), 2 (Tension), 3 (Mystery), 4 (Social), 5 (Personal).
- themes clear - Clear all theme slots.
- ac chars gen - Generate a new character description, as per the Adventure Crafter rules.
- ac chars pick - Pick a random char, as per the Adventure Crafter rules.
- ac chars - List the character entries.
- ac chars add {character} - Add the given {character} (required text) to the list of character entries.
- ac plots dupe {character index} - If {character index} (an optional, positive integer) is NOT included, this shortcut shows the options for {character index}. If {character index} IS included, this shortcut duplicates the character that is indexed by {character index}.
- ac chars remove {character index} - If {character index} (an optional, positive integer) is NOT included, this shortcut shows the options for {character index}. If {character index} IS included, this shortcut removes one entry of the character that is indexed by {character index}.
- ac plots pick - Pick a random plotline, as per the Adventure Crafter rules.
- ac plots - List the plotline entries.
- ac plots add {plotline} - Add the given {plotline} (required text) to the list of plotline entries.
- ac plots dupe {plotline index} - If {plotline index} (an optional, positive integer) is NOT included, this shortcut shows the options for {plotline index}. If {plotline index} IS included, this shortcut duplicates the plotline that is indexed by {plotline index}.
- ac plots remove {plotline index} - If {plotline index} (an optional, positive integer) is NOT included, this shortcut shows the options for {plotline index}. If {plotline index} IS included, this shortcut removes one entry of the plotline that is indexed by {plotline index}.
Shortcuts to help in playing tabletop rpgs, either group or solo.
- tbl twist - Random table: a plot twist. Source.
Shortcuts that let the user manage clips of text. A "clip" is a bit of named text that can be quickly added to your note. Similar to a shortcut, but simplistic and tied to the session state.
- reset clips - Remove all clips.
- clips - Lists all stored clips.
- clips get {name} - Expands to the value stored in clip {name} (a required name string). Alternative shortcut: cg {name}.
- clips add {name} {value} - Creates a clip named {name} (a required name string) that stores the string {value} (a required text).
- clips expansion {name} - Creates a clip named {name} (a required name string) that stores the previous expansion.
- clips remove {name} - Removes the clip named {name} (a required name string).
Shortcuts for writing various arrows:
- →←↑↓
- ▶◀▲▼
- ⇒⇐⇑⇓
- ↔↕⇔⇕⇄⇅
- ↗↘↖↙
- ↪↩↻↺↝↜
A decent Lorum Ipsum generator.
- lipsum {paragraph count} - Generates a lorem ipsum text with {paragraph count} paragraphs. If {paragraph count} is omitted, it defaults to 1.
Various helper shortcuts of minimal category.
- rngseed {seed} - Sets Math.random to a custom random number generator with a seed of {seed} (a non-zero integer). Useful for testing. If {seed} is omitted, random number generator is returned to javascript default.