📚 Creating a Keyword Book

A Keyword Book lets you organize the settings a character references during conversations by keyword. You can manage the information together like a single book and use it as Basic Keywords or Shortcut Keywords.

Basic Keywords: When a registered word or phrase appears in the conversation, its associated information is loaded automatically. Use these to write background information such as characters, locations, organizations, items, and world rules.

Shortcut Keywords: You can write a shortcut name and the content the AI should reference in a single entry. You can also add a one-line description if needed.

You can write and manage both types in the Basic and Shortcut tabs within the same Keyword Book.

Select Create on the Keyword Book management page to create a new Keyword Book. To edit an existing Keyword Book, select its name in the list.

First, enter a Keyword Book name and select a folder if needed. The name and folder apply to the entire Keyword Book. You can then write keyword entries in either the Basic or Shortcut tab.

Enter a name that will help you identify the Keyword Book.

The name can contain up to 20 characters and will appear when selecting a Keyword Book to apply to a character.

Name examples

• Arcadia World Setting

• Royal Academy Character Information

• Mystery Case Files

• Magic Item Compendium

Select a folder in which to store the Keyword Book.

Folders can help you organize Keyword Books by genre, series, or character. You can also create a Keyword Book without assigning it to a folder.

When creating a new Keyword Book, you can write and save Basic Keywords and shortcuts together. If you edit both tabs in an existing Keyword Book, select Save in each tab.

On the Keyword Book management page, you can organize and edit your Keyword Books by folder.

• Select a Keyword Book’s name to edit its content.

• Use the More menu to duplicate or delete a Keyword Book.

• Use Create Folder to organize Keyword Books by series or genre.

• There is no limit to the total number of Keyword Books you can create.

Editing a Keyword Book applied to a published character may affect active players’ conversations. Test your changes thoroughly before applying them.

Go to the character creation or editing page.

You can select the Keyword Book you want to apply under Episode tab (bottom) → Keyword Book Settings. If the Keyword Book settings are not visible, enable Expert Mode.

Create or edit a character
→ Enable Expert Mode
→ Bottom of the Episode tab
→ Keyword Book Settings
→ Select a Keyword Book
→ Save

After selecting the Keyword Book, save your changes on the character editing page as well.

To remove the Keyword Book from the character, select No Keyword Book and save your changes.

A Basic Keyword is a keyword type that automatically loads its associated information when a specific word or phrase is detected in the conversation.

When a registered sub-keyword appears in the character’s previous dialogue or in the player’s current message, the connected content is included in the prompt for the AI to reference.

• Each Keyword Book can contain up to 150 Basic Keyword entries.

• Up to 10 matching Basic Keyword entries can be loaded during a conversation.

• When multiple entries match, they are inserted into the prompt from top to bottom according to the order shown on the Keyword Book screen.

• If you change and save the order using Edit Order, the saved order will be applied.

• Basic Keyword sub-keywords are not translated automatically.

You can write Basic Keyword entries in the Basic tab of the Keyword Book.

A single Basic Keyword entry consists of the following two parts:

• One or more sub-keywords that trigger the content

• Content that the AI references when a keyword matches

Even when multiple sub-keywords are registered, they count as one Basic Keyword entry if they are connected to the same content.

1 Basic Keyword entry

Sub-keywords: Love, Trust, Hope
Content: Information the AI will reference when one of these keywords appears

Each Keyword Book can contain up to 150 Basic Keyword entries.

Sub-keywords are words or phrases that trigger the content of a Basic Keyword entry.

Enter a keyword, then press Enter or select Add to register it. Each sub-keyword can contain up to 50 characters.

You can register multiple names, aliases, abbreviations, or other expressions referring to the same subject within a single Basic Keyword entry.

Example

Goblet of Fire
Chalice of Flame
firecup

If any of these keywords appears in the conversation, the content connected to the same Basic Keyword entry will be loaded.

To add multiple keywords at once, separate them with |.

love|trust|hope

After entering the keywords, press Enter or select Add. Each word will be registered as a separate sub-keyword.

Register expressions that players are likely to use during actual conversations.

Lumen Empire|Lumen|the Empire

Elena Armand|Elena|Lady Armand

Red Room Incident|Incident 17|Case No. 17

Sub-keywords are not translated automatically. To trigger the same content in multiple languages, register the necessary keywords for each language manually.

불의 잔|Goblet of Fire|炎の杯

In the Content field, write the information that the AI should reference when a registered sub-keyword is detected in the conversation.

The content of each Basic Keyword entry can contain up to 400 characters. Because this text is not shown directly to players, clearly describe the facts and behavioral guidelines that the AI needs to understand.

Examples

Keywords:

Goblet of Fire|Chalice of Flame|firecup

Content:

The Goblet of Fire is an ancient chalice sealed with fire magic. When a slip of paper bearing the name of a chosen person is placed inside it, the Goblet releases the name in a burst of blue flame. It is kept in the underground vault of the Royal Academy of Magic, and ordinary students are not permitted to access it.

Keywords:

Arcadia|Royal Capital|Imperial Capital

Content:

Arcadia is the capital of the Lumen Empire. The Imperial Palace and Mages’ Guild are located in the center. The eastern district is reserved for nobles, while the western district is the commercial quarter. A curfew is enforced from midnight until 5:00 a.m.

Select Add at the bottom of the page to create another Basic Keyword entry. Each Keyword Book can contain up to 150 Basic Keyword entries.

Use Edit Order to change the order of the entries. When multiple entries match during a conversation, they are inserted into the prompt from the top of the Keyword Book to the bottom. If you reorder the entries and save your changes, the new order will be applied.

Up to 10 matching Basic Keyword entries can be loaded during a conversation. If many entries may match at the same time, place the most important information closer to the top.

When you have finished, select Save in the Basic tab.

• Basic Keyword sub-keywords are not translated automatically.

• Keywords that are too general may trigger content in unintended situations.

• If the same information is already included in the character or world settings, check for duplicated or conflicting instructions.

Shortcut Keywords let you write instructions for the AI to reference and give each set of instructions a name.

You can enter and save a name, content, and one-line description in the Keyword Book’s Shortcut tab.

Each Keyword Book can contain up to 150 shortcut entries.

Shortcut entries are counted separately from Basic Keyword entries.

You can write shortcut entries in the Shortcut tab of the Keyword Book.

Each shortcut entry has the following three fields:

• Shortcut keyword: A name that identifies the shortcut

• Content: Instructions for the AI to reference

• One-line description: A brief explanation of what the shortcut does

The Shortcut keyword and Content fields are required. You can leave the One-line description blank.

A Shortcut keyword is the name used to identify each shortcut. It can contain up to 20 characters, and each shortcut entry can have one name.

Do not add / before the name. Names cannot contain /, {, }, line breaks, or tabs.

Examples

Make it rain
Summarize
Next day

In the Content field, write the instructions the AI should follow.

The content of each shortcut entry can contain up to 400 characters. Because this text provides instructions for the AI rather than being shown directly to players, clearly describe what the AI should do and which conditions it should maintain.

Write a brief explanation of the shortcut’s role in the One-line description field.

It can contain up to 30 characters. You can create a shortcut without a one-line description.

Examples

Add natural rain to this scene
Briefly recap the story so far

Shortcut keyword:

Make it rain

One-line description:

Add natural rain to this scene

Content:

Describe rain beginning naturally in the current scene. If indoors, convey it through rain sounds outside the window or the scenery getting wet. If it is already raining, continue the rain. Do not change the time, location, or relationships between characters, and do not decide the player’s actions or feelings for them.

Shortcut keyword:

Summarize

One-line description:

Briefly recap the story so far

Content:

Using only facts established in the current conversation, briefly summarize the location, characters, ongoing events, and remaining goals as separate items. Do not add unrevealed secrets or new settings. Do not advance the story or decide the player’s next action for them.

Select Add at the bottom of the page to create a new shortcut entry.

Select Copy on an entry to create a new entry with the same content. Use this to create a similar shortcut by changing its name and content. You can remove entries you no longer need with the delete button.

If there are two or more entries, you can change their order using Edit order. Drag the entries into the desired order, finish editing, then select Save in the Shortcut tab.

Select My shortcuts at the top to save shortcuts you use often and load them into the current Keyword Book.

Select the entries you want, then select Load. The selected shortcuts will be copied into the current Keyword Book. You can select several entries at once; the changes apply when you save the Keyword Book.

Shortcut keywords and one-line descriptions are translated automatically. After saving, you can view the translations for each language in Manage translations.

To edit a translated name or description, select Exclude from translation for that language, then enter your changes.

The prompt entered in Content is not translated automatically. You can write a translation for each language manually if needed. If no translation is provided, the original text is used.

After editing the translations, close the window and select Save in the Shortcut tab.