Modding encounter choice

This page walks through the process of creating an encounter with a single choice. The focus is on getting something simple which you can see in the game, and adding more details later. The description and screenshots are current as of November 2019, early access version 0.10+98 Ryvio Wartmarch.

Prerequisite encounter

1. This is a brief summary of the prerequisite steps. If you have an example event already skip to the next section. For more details see Adding a wilderness encounter
2. Select "Tools" at the main game screen, then "Open Editor", then "Content and Comics Editor"
3. At the upper left, click "Mods", click "Create New Mod" in the browser, and fill in the form.
4. At the upper left, click "effects", then "New", and fill in the form. In the "Type" dropdown, select "Arrive at Hostile Site". The name field will fill in with auto-generated text.
5. On the targets line, add the default "hero" story role and a second story role "volunteer"
6. This is the most common mistake, causing a mod to not work! New events are disabled by default. Under abilities, set encounterEnabled to true

Adding the choice in the effect

1. Expand the choiceTarget line (click the plus sign to its left), hover over the options line, and click the "new target" button. In the "New Choice" dialog, you will see Choice Tag one, Outcome type simple. Leave these choices for now and just click "create".
2. Create a second new choice, which will be filled in with Choice Tag two. Additional elements in the outcomes list are automatically added. The effect panel should look similar to this. Notice the two options are called one and two, and each one has a "then description" in the outcome section.

Filling in the comic panels

1. The rest of the work is done in the comics panel. Select comics in the dropdown at the top left, and open your comic.
2. Setting up the encounter has created a number of panels for us:

• • Prompt, which displays when the encounter begins. You can add panels under this, before the choice.
  • Choose, the "left choice"
  • Choose, the "right choice"
  • Outcome 1 >> Chose 1. You can add panels under this, which will appear after the player selects the first choice.
  • Outcome 2 >> Chose 2. You can add panels here, for the second choice.

1. We'll fill in just a little, so that it will make sense when we see it in the game.
2. In the prompt panel, add the hero and the volunteer, and a question, "The path branches left and right". "Which way should we go?"
3. In the left choice, add the hero and the answer, "Left". In the right choice comic, add the hero and the answer "Right".
4. In outcome 1, "Thank goodness we went right". In outcome 2, "Thank goodness we went left".

Seeing the effect in game

1. If you haven't already done so, enable developer mode. (Save and exit before doing this.) In file explorer, create an empty file under steam\steamapps\common\Wildermyth called devmode.txt.
2. Start a new one chapter story. Choose your mod in the mod picklist, enable "pick events" so that you can choose your event to trigger, and enable "overland only" to skip all the fights.
3. When the game starts, you will get the first "pick event" dialog to choose which introductory story to use. Pick random and just click through it. Then choose any nearby territory and move your party to scout it. Most often, when scouting finishes, you will have an "assault" choice. In case you happened to pick a territory with only a station, choose another territory and move to it.
4. Save the game. Now as you work to refine the choice, you can immediately come back to the point where the mod is about to trigger.
5. When you click the assault button, you should immediately be able to pick your event.

Adding party selectors

Let's keep going. We will make this encounter one which tries to start up a romance. For this one, because I have in mind a title which requires a female, we will choose a female hero who does not already have any romance. Then for the volunteer, we will choose a character whose male/female preferences allow for a match. In case the party does not match the criteria, this will cause the event to be unpickable.

... in progress

Adding outcomes

... in progress