Phrase Express Macros for Realm Works

[MNBlockHead]

Based on discussions on other threads, there is some interest in discussing how to use Phrase Express to help automate tasks in RealmWorks.

PhraseExpress is a text expander and universal-macro program that is free for personal use.

http://www.phraseexpress.com/freeware.htm

There are other tools out there like this. ActiveWords is a good one that I used for many years and there are some open-source options like AutoHotKeys. I've just found PhraseExpress to offer the most powerful set of tools in a fairly user-friendly interface (there is a learning curve to the advanced stuff, but still easier than much of the competition, IMO).

This thread is a place where folks can share tips and macros for using PE with RW as well as a place to introduce alternatives.

[MNBlockHead]

REVEAL TOPIC AND ALL SNIPPETS

One annoyance in RW is that if I want to reveal a topic and ALL of its snippets, I either must click on all the little circles to the left of each snippet, or click through the conent-page-options. The following script will automat that for you. I associated mine with the hotkey combo CNTRL+ALT+F12, but you can assign any hotkey or create a phrase.

THE SCRIPT:

{#CTRL {#SHIFT -chars r}}{#F7}{#DOWN -count 7}{#RIGHT}{#ENTER}

[Vargr]

Interesting - I think I will be looking into phraseexpress.

Until then, I am afraid I have little to contribute with :-)

Addition
Installed - your version is the full version with mouse recording etc?

[MNBlockHead]

I use it for work as well, so I bought the full version, but I'm out of maintenance and have not upgraded to the newest version. I'll probably wait until there is something I feel my current version lacks that I really want. For now, it does everything I want and I'm barely scratching the surface of how to use it.

The mouse macros are neat, but I really don't use them that much. You have to make sure that the window will be size the same and I also find that I have to fiddle around alot with timing, creating sufficient delays for the program to respond before clicking the next item.

Thinks work much better if you can find a keyboard way of getting somewhere.

[JustinThomason]

Phrase Express is something I picked up for work. Mostly I have used it to automatically complete phrases I find myself typing in emails all the time. It is actually a pretty great program that I feel like I have never really taken full advantage of. I eagerly await any tips or ideas to help integrate it into Realm Works.

[MNBlockHead]

COLLAPSE ENTIRE HIERARCHY AND ALL GROUPS AT THE SAME TIME
I don't know why, but I like to start with all groups and subgroups in the navigation pan collapsed. Currently, you have to first go to the World Almanac Options, click on the toolbar icon, and then select collapse entire hierarchy to collapse all the sub-groups. Then you have to click on the tool icon on one of the groups and select "collapse all groups."

I created the following macro to do it all at once using the hotkey [CNTL][-]
("control minus"). I also selected the option to only use this macro in Realm Works, since that hot key is used for other purposes in other applications I use.

{#F6}{#DOWN -count 9}{#ENTER}{#mouseposition -x 160 -y 192}{#LEFTMOUSEBUTTON}{#DOWN -count 3}{#ENTER}

Note that you could switch it and put

{#mouseposition -x 160 -y 192}{#LEFTMOUSEBUTTON}{#DOWN -count 3}{#ENTER}

in the front. You can still collapse the entire hierarchy with the groups already collapse, but I like to watch everything quickly collapse in order. Just my preference.

One trick with this macro is that you need to know the X/Y coordinates of your mouse cursor, so PhraseExpress knows where the tool icon on one of the groups is. I recommend the top one (Sources) since it should always be there, both in topic (e.g. "world almanac") and article ("mechanics") view. I always use RW with the window fully expanded to take up my entire screen. The macro won't work with the window sized down.

Also I do often use an additional monitor with my laptop, but rarely use RW in it, otherwise I would need a separate macro for that screen. Unfortunately, I don't know of a way to open the group menu tools just by using the keyboard.

Note that this macro does NOT require the mouse recorder. You just need the X and Y coordinates. How to get them? There is a tiny program you can get here that will show the exact coordinates of you mouse cursor: http://www.adminsehow.com/2012/03/re...-monitor-tool/ You need .NET framework installed in order for it to work.

When I use the code markup, it formats it so you have to scroll horizontally to see it. Below, I'm just pasting the code text without marking it as code:

{#F6}{#DOWN -count 9}{#ENTER}{#mouseposition -x 160 -y 192}{#LEFTMOUSEBUTTON}{#DOWN -count 3}{#ENTER}

[Bobifle]

Is there any way to expand some text into formated text in a snippet ?

ultimately something like "stats" expanded into a table with force dex con etc ...

Suggestion for this thread:

It could be easier for everyone if macro were gathered at the begining of the thread (the first 2 posts) so that discussions on these do not hinder the this thread main objective : provide phrase express macros.

[MNBlockHead]

Yes. Phrase Express supports rich-text formatting. You can also use it to paste document into other documents. Right now, the way I use it, I have two statblock templates, one with lables and headers for all the things I might ever want in a stat block (for use with important, reoccuring NPCs, and another that is just the basics (for monster encounters in scene topics). Both have the same trigger work (statblock).

I type the word "statblock" into the snippet and a popup prompts me to select which one I want to use. I select the one I want and it pastes a nicely formatted statblock table with cell color fills, bold and italic text, etc. But I still have to go and type in the stats, so:

I'm currently working on a macro where a form prompts me for AC, hit dice, etc. and then it will generate the fully formatted stat table and paste it into the active snippet. Also, it will automatically calculate the modifiers based on the attributes you enter.

It would be pretty easy to add randomly generated stats, but usually for frequently encountered opponents (bandits, certain monster types), I just use a standard stat block. Same with NPCs, I generally go with default stats from the Monster Manual for commoner, bandit, noble, etc., unless they are a particularly important NPC, in which case I wouldn't likely randomize their stats.

[Bobifle]

Could you please post the macro so we get a better idea on how to do it (in other words we'd like to steal your stuff )

[MNBlockHead]

Originally Posted by Bobifle

Could you please post the macro so we get a better idea on how to do it (in other words we'd like to steal your stuff )

Well, it really isn't a macro. It is a sraight up text replacement. See the attached screenshot, which shows a very simple 5e statblock.

It is difficult to show how to build a form in one screen shot. I would need to make a step-by-step tutorial. First, I want to complete and test the one I'm building, and second, it would take some time to write up. Also, while I like to dig into the macros and understand how to type them out in plan text, it is MUCH easier to use the Macro menubar in PhraseExpress. You simply put your cursor where you want to fill in text, and go to Macro—>Form—>Text Input box. And fill in your parameters. Where it gets more complicated is when you want to calculate values based on inputs or use conditional logic (IF...THEN...ELSE). For that you need to know how to set and get temporary values. Look at the #settemp and #gettemp maco commands.

One of the best things about the newest version of Phrase Express is the check text/value tool under Macro—>Programming, that give a GUI for creating macros that use the #check command, which compares a value to something else and outputs text based upon the comparison.

Anyway, I'll try to post a form walkthrough when I find some free time.

ScreenClip.png