Virtual teacher and classroom board
Give an IAMX Studio character a teaching board for formulas, notes, questions and diagrams. Choose Beside the character for a whiteboard next to your character that visitors can draw on, or Chalkboard in the scene for a 3D chalkboard inside the character's scene. Test the spoken lesson and the board together, then publish.
Set up Teacher mode
- Open the character. On Characters, select it and choose Open studio.
- Open Teacher mode. Choose Teacher mode at the bottom of the editor's right dock, below Channels. It opens its own panel. While Teacher mode is on, its dock icon shows a small mark.
- Turn on Teacher mode. Teaching questions and explanations then go to the board automatically.
- Choose the board. Under Board, choose Beside the character (a whiteboard next to your character) or Chalkboard in the scene (a 3D chalkboard inside the scene). A character that already used the classroom chalkboard keeps Chalkboard in the scene until you change it.
- Beside the character: set the board features. Under Board features, Learner drawing lets visitors draw on the board with a pen and an eraser. Check my drawing lets them send the board and their drawing to the character for feedback; it needs Learner drawing. Diagrams lets the character draw simple diagrams: lines, arrows, shapes and labels. All three are on for a new board beside the character.
- Chalkboard in the scene: set up the classroom. Under Classroom environments, choose Classic classroom, Bright classroom, Library seminar or Science lab. Each set includes a working chalkboard. You can also use the chalkboard with another background from Scene & motion › Background. Set the Board position (X, Y and Z), Width (m) and Height (m); Animate chalk writing turns the writing effect on or off. Turning on the chalkboard frames the board and the character together, and Frame board and character fits the camera to both again; in the editor it updates the desktop camera and keeps your other saved views.
- Test it. Choose Test conversation below Teacher mode in the right dock and ask a real teaching question. Changing Teacher mode, the board or a board feature starts a new preview conversation.
- Check the visitor's view. Open Channels › Publish preview. With Chalkboard in the scene, every size, Widget included, shows the chalkboard in the scene with the character. With Beside the character, its Desktop size (1024 × 640) shows the board with the Board and Character tabs, and its Mobile size (390 × 720) shows the character on top and the board below it (scroll inside the preview to reach the board and the conversation), as visitors see the full-page embed in windows of those sizes. Its Widget size shows the Floating Companion template, which has no board beside the character. To see that board and the character side by side, open the full-page embed in a browser window wider than about 1,030 pixels (see the layout table).
- Publish. Choose Publish in the editor toolbar. Then open the published scene or your installed embed and start a fresh conversation to verify what visitors see.
Both boards are part of IAMX's web views: the editor, Test conversation, Publish preview (for the board beside the character, its Desktop and Mobile sizes) and the website embed. An Unreal Engine client shows a board only if its scene contains the IAMX Board widget (see the help text of Teacher Mode (classroom board)). Pixel Streaming, LiveFace and the IAMX Live mobile app do not show the board beside the character. The kiosk page shows the character through the website embed, so the board appears there as well, but it shows only what the embedded view's own conversation writes: questions asked with the kiosk's microphone button do not change it. Studio cannot add a visible board to another custom client.
The board beside the character
With Beside the character, the character's stage area is split: the whiteboard takes the larger part and the character stands next to it, as in an IAMX Academy lesson room, and the board looks like the Academy lesson-room board. In the editor, Test conversation and the full-page embed, the board and the character stand on a classroom photo; while both are shown together, the character's side carries a lesson status label and, where there is room, a name card. The character's own scene background, scene objects, logo and hotspots are not shown there. Website templates keep the character's own scene. The layout follows the size of that stage area, not the size of the page or the screen. In the full-page embed on a computer, the conversation takes a column of its own beside the stage; in windows 820 pixels wide or narrower it moves below the stage, and in windows 600 pixels wide or narrower, such as phones, the page scrolls from the character and the board down to the conversation.
| Where | Layout |
|---|---|
| A stage area wider than 600 pixels: Test conversation on a computer screen, the editor on a computer screen with no panel open (with a panel open, only in windows wider than about 1,260 pixels; see below the table), the full-page embed in browser windows wider than about 1,030 pixels, and the full-page embed in windows between about 620 and 820 pixels wide that are tall enough, such as a tablet held upright | The board and the character side by side; the board gets about three fifths of the width. In right-to-left languages the two columns swap sides. The board keeps its page layout: each line starts at the board's left edge, and right-to-left lines keep their reading order. |
| A stage area 600 pixels wide or less and at least 640 pixels tall, for example the editor with a panel open on a smaller screen, the full-page embed in a window between about 820 and 1,030 pixels wide and at least about 785 pixels tall, and phones (the full-page embed in windows up to 600 pixels wide, as in the Mobile size of Publish preview) | The character on top and the board below it. On a phone the board keeps a full page, with its title and labelled tools, and the page scrolls past it to the conversation. |
| The full-page embed in windows between about 600 and 620 pixels wide, larger phones held sideways (for example 932 × 430), other stage areas too narrow for side by side and too short for the stacked layout, and small frames, such as the Portrait Card, Scene Window, Conversation Panel, Voice Companion and Scene Concierge website templates | Board and Character tabs show one at a time. A dot on Board marks new board content while the character is shown. In a Conversation Panel at least 440 pixels tall and 266 pixels wide, the board and character area takes about half of the frame and the conversation history keeps the rest. On a short board the title and the hint are hidden and the drawing tools show as icons: point at a tool to see its name, or open the reading view for the whole board. When the board has several pages, the page buttons and the narration button sit in the board's top corner, so the page keeps its full height. |
| Frames too small for a usable board, such as the Scene Window, Voice Companion and Scene Concierge templates at the Balanced widget size, a Conversation Panel less than 440 pixels tall or 266 pixels wide, or the full-page embed on a smaller phone held sideways (for example 844 × 390) | The character alone, shown as for any other character. The board appears when the frame is large enough, for example with a larger Widget size. The conversation works as usual. |
| The Portrait Bubble, Floating Companion and Compact Guide templates and the compact corner widget | No board in this version. The Compact Guide keeps its small character picture. The conversation works as usual. |
In the full-page embed, a window 820 pixels wide or narrower that is also short, such as a small phone held sideways (for example 740 × 360), leaves the stage almost no height once the conversation moves below it, so neither the board nor the character can be used there. Held upright, the phone shows the character and the board again.
In the editor, the board and the character use only the part of the stage that the docks and the open panel leave free, so the panel does not cover the character and the editor's camera and view controls stay off the board. With a panel open in a window up to about 1,260 pixels wide, that part can be 600 pixels wide or narrower, and the editor then shows the stacked layout or the tabs. Close the panel, or use Test conversation, to see the board and the character side by side.
A character with the board beside it shows no 3D chalkboard in its scene. Pixel Streaming and LiveFace embeds keep their usual layout without the board.
What can appear on the board
| Content | How it is used |
|---|---|
| Formulas | Short equations, fractions, roots and exponents. Test complex notation with the examples you plan to teach. |
| Notes and headings | Definitions, givens and short numbered explanation steps. |
| Questions | An open question or a question with two to six choices. The character is instructed not to reveal a new exercise's solution before the student tries. |
| Highlights and results | An emphasized result, or a highlighted answer choice after the answer has been discussed. |
| Diagrams | On the board beside the character, with Diagrams on: simple drawings made of lines, arrows, shapes and short labels, such as a triangle with named sides or a number line. Clearing the board for a new problem removes the diagram. The chalkboard in the scene shows no diagrams. |
| Your drawing | On the board beside the character, with Learner drawing on: visitors draw with a blue, navy, red or green pen, erase lines, undo the last step or clear their drawing on the page. The drawing stays in the visitor's browser; it reaches the character only with Check my drawing. |
| Pictures | Not in this version. The board does not show photos or lesson pictures, and Teacher mode does not search for or generate images. Prepared lesson visuals are part of IAMX Academy lessons. |
Questions, explanations and speech
With Teacher mode on, teaching questions and explanations are meant to reach the board automatically; the student does not need to say “write it on the board” each time. A short greeting, acknowledgement or clarifying question can stay conversational without changing the board.
In standard conversation mode, IAMX uses the accepted board question or explanation as the source of the spoken teaching content, which keeps the written example and the spoken explanation together. Realtime voice models (Gemini Live, OpenAI Realtime) use board actions alongside their own generated audio, so test that combination separately; they write text, formulas and questions but draw no diagrams, cannot check drawings and do not get the reading instructions for question photos. Both paths depend on the selected model producing a valid teaching response.
The character is instructed to keep steps short, clear the board for a new problem, explain notation in spoken language and not reveal a new question's answer before the student tries. Treat these as teaching instructions to test, not a guarantee of mathematical correctness or perfect timing.
Check my drawing
On the board beside the character, a visitor can work on an exercise with the pen and choose Check my drawing. The board and the visitor's drawing are sent to the character as one PNG image, and the character answers with feedback in the conversation.
- It needs a model that accepts images. Choose an image-capable model on Mind & knowledge › Core AI. Otherwise the visitor sees “This character's AI model cannot look at images, so it cannot check drawings.” With a realtime voice model (Gemini Live, OpenAI Realtime) the board shows no Check my drawing button and the Teacher mode panel says why; visitors can still draw.
- It needs image uploads on in Core AI. If Enabled or Images is off on the File & image attachments card of Core AI, the board shows no Check my drawing button and the Teacher mode panel says why.
- Each check is one image request. It is sent to the character's AI model and counted like a message with an attached image.
- Feedback leaves the board as it is. The visitor's drawing stays visible; the character changes the board only when the visitor asks it to write or correct something on the board.
- Question photos are read with care. In standard conversation mode, when a visitor attaches a photo of a question, a teacher with the board beside it is instructed to read signs, fractions and exponents exactly before solving. Realtime voice models (Gemini Live, OpenAI Realtime) receive the photo without these reading instructions. Photos use the character's normal image uploads.
Read a long explanation
Content that does not fit on one board is divided into pages. Use the arrows below the board to move between them (on a short board beside the character, they sit in the board's top corner), or open the larger reading view (on the chalkboard, click the board or Read board) to read the current text, formulas and questions, and the diagram on the board beside the character.
On the board beside the character, the pages follow the reply that writes the board: once that reply's audio has arrived, the board moves to the page being explained. Other replies, such as a greeting or the feedback on a drawing check, leave the page where it is. Selecting a page yourself pauses following; Follow the narration resumes it. The next explanation that writes on the board or changes it starts following again. An explanation that only goes back over the board as it is does not move the pages, so use the page arrows or the reading view to keep up with it. Page changes follow audio progress approximately, not individual words. The chalkboard in the scene, in the editor and in the website embed, does not follow the narration; it keeps the page arrows and the reading view.
Prepare and test your teaching character
- Write the persona as a teacher, not an encyclopaedia. In Identity › Background / Persona, "You teach ninth-grade maths. You are patient, you ask before you explain, and you never give the answer before the student has tried" produces a different character from "You are a helpful maths assistant".
- Add the curriculum to the Knowledge Base. Upload the syllabus, worked examples and marking guidance in Knowledge › Knowledge Base or directly on the character's Mind & knowledge › Knowledge Base tab, and make sure each file is switched on for the character. Test that it uses those sources correctly.
- Ask for short steps. One definition or equation at a time is easier to read and review than a full page of prose.
- Test a complete exchange. Ask for an exercise, answer it incorrectly, ask for an explanation, then change topics. Check the board as well as the speech. On the board beside the character, also draw an answer and choose Check my drawing.
- Inspect the destination view. Use Test conversation, then Channels › Publish preview, then the published embed at desktop and phone sizes. Tests are real conversations and can use your plan's quota units.
If the board is missing or unchanged
| Symptom | What to check |
|---|---|
| The test shows a board, but the embed does not. | Choose Publish, then start a new conversation. A saved draft does not replace the public scene. The Portrait Bubble, Floating Companion and Compact Guide templates and the compact corner widget show no board beside the character. A website frame too small for the board shows the character alone; choose a larger Widget size, or the Portrait Card or Conversation Panel template. |
| The chalkboard or the character is outside the view. | Use Frame board and character, check the result in Channels › Publish preview at each size, then publish. |
| The character speaks but the board does not change. | Check that Teacher mode is on, start a new test conversation and ask a concrete teaching question. A plain greeting need not update the board. If a teaching response still fails, check the conversation error before changing the scene. |
| Check my drawing is missing. | On the Teacher mode panel, check that the board is Beside the character and that Learner drawing and Check my drawing are on. Check that image uploads are on in Core AI (File & image attachments: Enabled and Images). Realtime voice models (Gemini Live, OpenAI Realtime) show no Check my drawing button. The Portrait Bubble, Floating Companion and Compact Guide templates and the compact corner widget show no board. |
| The character's model cannot read images. | Choose an image-capable model on Mind & knowledge › Core AI, save it and start a new conversation. Realtime voice models do not check drawings. |
| The end of the explanation is missing. | Check the board's page count or open the reading view. On the board beside the character, choose Follow the narration if you changed pages manually. |
| I need assigned quizzes and student results. | Use the Academy teacher workflow. A conversational board question alone is not an assigned Academy quiz. |
Where to go next
Load the curriculum
Set the persona
Try it out
Updated 9 November 2026.