Formaquestion

❓ Formaquestion

Formaquestion is the help window. You can ask it a question, search this guide and read each guide page. The guide is part of the app, so the search and the pages work with no network and no AI.

📱 On a mobile-size screen, Formaquestion opens as a full-screen sheet. See On Mobile.

How to Open Formaquestion

1. Select the Help tab on the edge of the screen, or press F1.
2. To close the window, select Close at its top right. On Android, you can also use the back action.

The window stays open when you go to a different screen or open a dialog. You can use the dialog and the window together. Escape closes the dialog and leaves the window open.

How to Ask a Question

1. Open Formaquestion.
2. Select the Ask tab. In the wide layout, the conversation is on the right.
3. Type your question in Ask a Question.
4. Select Send, or press Enter.
5. To read where the answer came from, select a section under Sources.

Your AI writes the answer from the guide sections that match your question. To end an answer early, select Stop. The text so far stays. See Ask.

How to Ask a Follow-Up Question

1. Ask a question.
2. After the answer, type your next question in Ask a Question, such as "and then?".
3. Select Send.

The AI gets your earlier questions and its answers, so you do not have to say the topic again. To start again on a new topic, select Clear above the conversation.

How to Ask About a Screenshot

1. Turn on Image Attachments. See Settings.
2. Open Formaquestion and select the Ask tab.
3. Paste a screenshot into Ask a Question, drop it on the field, or select Attach images and pick a file.
4. Type your question, such as "what is this?".
5. Select Send.

Your model must read images. The screenshot goes with that question only. A follow-up does not send it again.

How to Search the Guide

1. Open Formaquestion.
2. Select the Search tab.
3. Type two or more letters in Search the Guide.
4. Select a result to read its section.

The best matches are first. Each result shows the section, its page and the start of its text.

How to Read a Guide Page

1. Open Formaquestion.
2. Select the Guide tab.
3. Select a page to see its sections.
4. Select a section.

To go back to the list of pages, select Contents above the section.

How to Get Help for the Screen You Have Open

1. Open the screen, dialog or tab that you need help with.
2. Open Formaquestion.
3. Select the row under Help for This Screen.

The row is the first item on the Search tab and on the Guide tab. It names the guide section for the screen, the dialog and the tab that you have open. It changes when you open a different one. A screen with no guide section shows no row. The row does not show while you search.

How to Move and Resize the Window

1. Drag the title bar to move the window.
2. Drag the bottom right corner to change its size.

To see the contents and a section side by side, select Wide View in the title bar. Select it again to go back.

How to Move the Help Tab

1. Drag the Help tab along the edge of the screen. It goes to the nearest of the four edges.
2. Release it.

With the keyboard, press Tab until the Help tab has focus. Then press the arrow keys.

---

The Window

Formaquestion is one window for the whole app. It shows above every dialog, and it keeps its conversation, its search text and its open section while the app is open.

Control	What it does
Title bar	Drag it to move the window
Formaquestion Settings	Opens the settings of Formaquestion. See Formaquestion Settings
Wide View	Changes between the narrow and the wide layout
Close	Closes the window
Bottom right corner	Drag it to change the size of the window

F1 does one of three things:

When you press F1	Result
The window is closed	The window opens
The window is open, and you are typing somewhere else	The cursor goes to the window
The cursor is in the window	The window closes

• The window stays whole on the screen. When the browser window gets smaller, Formaquestion moves back inside it.
• This device keeps the place and the size of the window. They are not in a backup or an export.
• The narrow layout shows one tab at a time. The wide layout shows the search field and the contents on the left, and the conversation or a section on the right. Back to Conversation, above a section, shows the conversation again. The layout changes at a width of 560 pixels, so the corner changes it too.
• While the welcome animation plays, the Help tab does not show and F1 does nothing.

Ask

The Ask tab sends your question to your AI, together with the guide sections that match it. The answer shows as the AI writes it.

• Sources, under an answer, lists the guide sections that the AI got. Select one to read it.
• Thinking, above an answer, shows how the AI reasoned, when your model reasons. It starts closed. Open or close one, and later answers start the same way.
• When the guide does not cover your question, the AI answers from general knowledge. A note above the answer says that it is not from the guide and can be wrong about Formamorph. Nearest Sections then takes the place of Sources and lists the guide sections closest to your question.
• The request holds your question and those guide sections. It holds nothing from your worlds or your saves.
• The request also holds your last four questions and the AI's answers to them, as text. It does not hold their guide sections again. History Length sets how many.
• Before the answer, the app sends one more short request, while AI Picks is on. In it, your AI gets the list of every guide heading and picks the sections that answer your question. The answer then uses those picks together with the sections that the search finds. When that request fails or picks no section, the answer uses the search alone.
• The search for a follow-up also uses your previous question, so a short question such as "and then?" finds the same topic.
• With Image Attachments on, a question can carry up to 4 images, the same as an action. Attach images shows next to the field, and a paste or a drop on the field adds an image. The images go with that question only, and the app does not store them.
• Clear removes every question and answer, and ends an answer that is coming in.
• While a game turn generates, Send waits. Search and Guide still work.
• The answer is in your AI Language. Control names stay as the guide writes them. See Settings.
• Enter sends the question. Shift+Enter starts a new line.
• Stop ends an answer and keeps its text.
• With no AI connected, Send shows the guide sections that match your question. The Demo AI always counts as connected.
• When the AI does not answer, an error message shows, and the guide sections that match your question show in place of the answer. Text that came before the failure stays.
• The conversation stays while the app is open, also when you close the window or go to a different screen. The app does not store it, so a reload or a restart empties it.
• The answer comes from the Answer Endpoint, with the Reasoning setting. See Formaquestion Settings.

An answer can be wrong. Use Sources to check it against the guide.

Search

The Search tab finds sections by the words you type. It needs no network and no AI.

• A search starts at two letters.
• A word in a section's heading counts more than a word in its text.
• A section that has more of your words is higher in the list than a section that repeats one word.
• A plural finds the singular: "blueprints" finds Blueprint.
• Guide sections are higher in the list than changelog sections.
• A question such as "what's new?" or "what changed?" lists the newest release first. Name a version, such as "what changed in 3.1.1?", to see that release first.
• No sections match shows when no word matches.

The search reads each page of this guide, the Glossary, the World Format page and the newest releases in the Changelog.

In the wide layout, the results replace the contents on the left while the search field has two or more letters.

Guide

The Guide tab lists each page of this guide. Select a page to show or hide its sections.

• Introduction is the text at the top of a page.
• A long section is in parts. Each part has a number, such as (Part 2).
• On This Page, under a section, lists the other sections of the same page.
• A link to a guide page opens that section in the window.
• A link to a website opens in your browser.

Formaquestion Settings

Formaquestion Settings opens from the gear in the Formaquestion title bar. It has four tabs: General, Endpoint, Prompts and Tools.

• The Formaquestion window stays above the settings, so you can change a setting and ask a question to see the effect.
• This device keeps each setting. The settings are not in a backup or an export.

General

The General tab sets how your AI answers, how a question finds its guide sections, and what the request holds.

Setting	Default	What it does
Reasoning	Off	Lets your AI reason before it answers, so answers take longer. The levels and the budget come from the Answer Endpoint. Global follows Native Reasoning under Settings → Output. The AI Picks request never reasons. For a model that cannot reason, a note shows in place of the control.
Answer Reveal	Fade	Sets how each answer appears as it streams. Choose reveal animation… opens the same dialog as Narration Reveal, with its own values: a change to one never changes the other. With every effect off, answers show with no animation.
Keyword Search	On	Finds the guide sections that have the words of your question
AI Picks	On	Sends one more request for each question, in which your AI picks guide sections from the list of headings
Semantic Search	Off	Finds guide sections by meaning, with a small model on your device. The first time you turn it on, the app downloads the model and shows the progress. If the download fails, the switch goes off and Retry starts it again. Until the model is ready, questions use the other sources.
Use the Open Screen	On	Sends the screen you have open and its guide section
History Length	4	Sets how many earlier questions and answers each request holds, from 0 to 20. 0 sends each question alone.

With Keyword Search, AI Picks and Use the Open Screen all off, no guide section can reach your AI. The request then holds your question alone, and the answer has no note that it is not from the guide.

When a search runs and finds no section, the answer still gets that note.

Endpoint

The Endpoint tab sets where help questions go. Help can use a different AI than your game.

Setting	Default	What it does
Answer Endpoint	Use Active Endpoint	Sends your questions to this endpoint for answers
Pick Endpoint	Same as Answer	Sends the AI Picks request to this endpoint. A small, fast model works well here.

• Use Active Endpoint follows the endpoint you pick in Settings → AI Endpoints.
• A preset you choose shows whether it answers. Select Recheck to check again.
• If you delete a preset that a setting names, that setting goes back to its default.
• The Ask tab says when your AI is not connected. It checks the Answer Endpoint.

Under the two settings is the same preset editor as Settings → AI Endpoints, on the same presets.

• Its preset list chooses the preset to edit. It does not change where the game or help sends requests.
• Add New Preset adds a copy of the preset you are editing, and opens it in the editor.
• A change to a preset applies everywhere that preset is used, the game included.

How to send help to a different AI:

1. Open Formaquestion Settings, then the Endpoint tab.
2. In the editor, select Add New Preset, and enter the endpoint, token and model of the other AI.
3. Set Answer Endpoint to the new preset.

Prompts

The Prompts tab holds the help prompts: the text that tells your AI how to answer. The prompts are in a preset, apart from the prompt presets of your game. A change to the game's preset never changes help.

Prompt	What it does
Answer	Tells your AI how to answer from the guide sections in the request
Picks	Tells your AI how to pick guide sections from the list of headings, for the AI Picks request
Lookup	Tells your AI how to answer when it can read more sections through the lookup function

• Default is read-only. Its text comes from the app, so each release updates it.
• Duplicate & Edit in the notice above a Default prompt makes a copy of the preset and opens it for edits. The Duplicate button beside the preset list does the same. Add New Preset… in the list asks for a name first.
• A custom preset has Rename and Delete beside the list. When you delete the preset in use, help goes back to Default.
• Reset to Default above a custom prompt returns that one prompt to the text of this release. A custom preset does not get the updates of a release on its own.
• Compare to Default above a custom prompt opens a diff of your text against the text of this release. Text you added is tinted. Text you removed is struck through. Raw shows your text as it is. The button is off for a prompt that equals the default.
• This device keeps the presets, with the other Formaquestion settings.

Each prompt editor is a chip editor, as in Settings → Prompts. The chips are the parts the app reads back or names elsewhere:

Chip	In	What it sends
Not in Guide Marker	Answer, Lookup	The line your AI writes first when the guide does not cover the question. The app reads that line and shows the notice above the answer.
Lookup Function	Lookup	The name of the function your AI calls to read more guide sections
Pick Limit	Picks	The most sections one pick reply names. The app reads that many picks at most, whatever the prompt says.
Reply Format	Picks	The rule for how the pick reply is written, so the app can read the picks

A chip sends its text, and no chip sends nothing. Remove the Not in Guide Marker chip from a custom Answer prompt, and your AI is not told to mark an answer that is not from the guide. The guide sections and your question are not in a prompt: the app builds that part of the request.

The Answer prompt has an Options row under it in the list of prompts:

Option	Default	What it does
Max Output	800 tokens	Sets how long an answer can run
Custom Temperature	0.2	Sets how freely the answer words its steps
Custom Repetition Penalty	1	Sets how hard the answer avoids repeated words

Each preset has its own options, and a copy of a preset takes them. Default shows them read-only, so each release updates them. A box that is off uses the default. The Picks request keeps its own values.

How to change a help prompt:

1. Open Formaquestion Settings, then the Prompts tab.
2. Select Duplicate & Edit, or Add New Preset… in the preset list.
3. Select Answer, Picks or Lookup, and edit the text. Keep the chips the app reads back.
4. Close the settings and ask a question. The next request uses the new text.

Tools

The Tools tab lists the functions your AI can call while it answers. It uses the layout of Settings → Tools: the list on the left, and the selected function on the right. Built-In holds the functions that ship with the app. My Tools holds the Tools you make for help questions.

Function	Default	What it does
read_guide	Off	The guide lookup. Your AI reads more guide sections when the sections in the request don't answer the question. It can search the guide by words or read sections by id.

• Enabled turns a function on or off. This device keeps the switches, for every help preset.
• Max Calls per Request sets how many times your AI can call the function for one question, from 1 to 20. Leave it blank for the default of 3.
• The panel also shows the text your AI reads about the function, and its parameters.
• The guide lookup is part of the app. You can't edit, copy or delete it.
• The Tools switch under Settings → Output does not apply to Formaquestion.

A function goes out only when the Answer Endpoint takes function calls. If it doesn't, or the app hasn't confirmed it yet, the tab shows a note, and each question goes out as one request with no function. The default cloud endpoint takes no function calls.

How to let your AI read more of the guide:

1. Set Answer Endpoint to a model that takes function calls, such as a local model.
2. Open the Tools tab, select read_guide, and turn on Enabled.
3. Ask a question. Your AI reads more sections when it needs them, and the answer lists them under Sources.

My Tools. Make your own Tools for help questions, and Formaquestion can work as a chat assistant for the world you have open. They are a list of their own: a Tool you make here never goes to a game prompt, and a Tool from Settings → Tools does not show here.

• New Tool opens the same editor as Settings → Tools. See The Tool Editor. A Tool can't take the name of a built-in function, such as read_guide.
• Enabled turns a Tool on or off. A Tool you save here starts on, and an imported Tool is off until you turn it on. This device keeps the switches.
• Max Calls per Request caps the calls for one question. Leave it blank for the default of 4. There is no Offered To, because one request takes every Tool that is on.
• Edit and Delete act on the selected Tool. Delete can't be undone.
• Try It runs the Tool on the world you have open in the game or the World Editor, else on a sample world.

A Tool that's on reads the world you have open, so text from that world can go to your Answer Endpoint. The tab says so under the list. In the game, a Tool reads the playthrough as a game Tool does. In the World Editor, it reads the world as you have it, unsaved edits included. With the World Editor open from the game, a Tool reads the editor's world until you close it. On the Main Menu, a Tool reads no world and returns its empty result.

How to make a Tool for help questions:

1. Open the Tools tab and select New Tool under My Tools.
2. Fill in Definition, Parameters and Handler, then select Save Tool. The new Tool is on.
3. Open a world in the game or the editor, and ask a question that needs it. Your AI calls the Tool when the question needs what it returns.

How to share Tools with the game's list:

1. Next to My Tools, select Export Tools to save tools.json, or Import Tools to add Tools from a file.
2. The file is the same Tool pack as Settings → Tools, so a pack from one list opens in the other. An import skips a Tool you already have, and names it. A file with a Script Tool shows a warning, because a script runs code when the AI calls it.

On Mobile

On a screen narrower than 768 pixels, Formaquestion fills the screen. It has the Ask, Search and Guide tabs of the narrow layout.

• The sheet slides in from the edge that holds the Help tab. The tab hides while the sheet is open.
• The sheet opens above an open dialog. When you close the sheet, the dialog is as you left it.
• The keyboard does not open until you select a field. With the keyboard open, the sheet fits the space above it.
• The sheet has no Wide View, and you cannot move it or change its size.
• Formaquestion Settings fills the screen, so the sheet hides while it is open. When you close the settings, the sheet shows again as you left it, and an answer that was coming in continues.
• On Android, the back action closes the sheet first, before a dialog under it.

The Help Tab

The Help tab opens and closes Formaquestion. It starts on the right edge of the screen, at the middle.

• The tab stays flat against one of the four edges. Its text turns with the edge.
• A press with no move opens the window. A drag moves the tab.
• This device keeps the place of the tab.
• The window opens from the tab and closes into it. If your system reduces motion, the window shows and hides at once.