> For the complete documentation index, see [llms.txt](https://docs.mirai.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mirai.fun/creator/create.md).

# Creator Guide

{% stepper %}
{% step %}

### Auto Generation

<figure><img src="/files/WF3d2RfTfp3OGzMuF2gw" alt=""><figcaption></figcaption></figure>

* You can enter prompts of up to 8,000 characters.
* You can attach up to 5 reference images.
* Based on the prompt and images, the AI automatically generates the content.
* When reference images are included, five emotion-based character images are generated automatically
  * (Default / Smiling / Sad / Angry / Embarrassed).
* Review the result and click **Register** to complete the process.
  {% endstep %}

{% step %}

### Manual Creation

You can choose **Skip** to manually create content without auto-generation.

#### Profile

<figure><img src="/files/VYt7I5CxSDl4xPQc09C3" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

#### Upload Thumbnail Image

* Upload an image cropped to a **square aspect ratio**.
  {% endstep %}

{% step %}

#### Enter Content Name

* Enter the title of your content.
  {% endstep %}

{% step %}

#### Enter Description

* Write a brief introduction about the content.
  {% endstep %}

{% step %}

#### Enter Tags

* Select tags that match the content’s mood or genre.
  {% endstep %}

{% step %}

#### Visibility Settings

* Choose whether the content will be public or private.
  {% endstep %}

{% step %}

#### Safety Filter Settings

* Specify whether the content includes **NSFW (adult or sensitive material).**
* Refer to the **Content Guidelines** for detailed criteria.
  {% endstep %}
  {% endstepper %}

***

{% endstep %}

{% step %}

### Advanced Settings

<figure><img src="/files/QzzbSRWAk4qhFtmtCgXp" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

#### Content Information

* Describe the **world setting, character roles, appearance, and speech style** in detail.
* You can enter up to **8,000** characters.
* To add a status panel, use one of the formats below.

#### 1.Tag-Based Format\<stats>

```javascript
(Content to display)
</stats>
(Description of the content)
```

* The `<stats>` block is used to display information such as **character status, relationships, or goals** in the HUD.
* The description section should briefly explain what each displayed value or state means.

#### 2. Backtick (info) Format

````javascript
```info
(Content to display)
```
(Description of the content)
````

* Both methods are displayed the same way in the HUD (status panel).
* Use them to represent **emotions, states, relationships, or time information** within the story.

Example:

{% code fullWidth="false" %}

```javascript
<stats>
❤️ Affection 5 — Ira’s current level of trust toward {{user}}
🧭 Status [Tense], [Focused]
</stats>
Displays Ira’s current emotional state and level of trust toward the player.
```

{% endcode %}
{% endstep %}

{% step %}

#### Starting Situation

* Write the **first greeting, action, or situation description** shown when the player enters the content.
* You can enter up to 2,000 characters.
* Commands should follow the format below.

```javascript
<map:"Office":"company_hallway.png"/>
<char:"Ira":"ira_shirt_walking.png">
*November 5th, past 11 PM. You are alone in the office, typing away at your keyboard.*
*As the hallway lights begin to shut off, the door quietly opens and the familiar sound of heels echoes.*
</char>

<char:"Ira":"ira_shirt_tired.png">
...Everyone’s busy ghost-hunting outside, and here you are alone. What are you doing?
*She gestures toward your monitor, staring at you with her signature sharp, tired eyes.*

Your company’s security is weaker than I thought. I just said “Halloween surprise” on the first floor and they let me in.

*She slowly approaches your desk and drops the paper bag she was holding onto the surface with a dull thud.*
*Then she pulls something out and shows it to you.*
</char>

<stats>
📅 Time: November 5, 2025, 11:05 PM
📍 Location: Office
💗 Affection: 5
</stats>

```

* Writing Guidelines
  * When switching images, use:

```javascript
<char:"{Character Name}":"{CharacterImageName.extension}">
<map:"{Location Name}":"{BackgroundImageName.extension}">
(Dialogue or narration)
</char>
```

* Uploaded image file names and extensions **must match exactly**.
* All `<char>` blocks **must be closed** with `</char>`.
* When adding a status panel, always use:

```
<stats>(Content to display)</stats>
```

{% endstep %}

{% step %}

### Function Usage

Various functions are available in prompts and lorebooks to enhance storytelling, such as expressing situations, dynamic values, or random events.

***

#### 1. Dice Function (Random Number Generation)

Generates a random number within a specified range.

* `{{dice}}` → 1–1000
* `{{dice:1:100}}` → 1–100
* `{{dice:1:6}}` → 1–6 (D6 dice)
* `{{dice:0:1}}` → 0 or 1
* `{{dice:-10:10}}` → -10 to 10

**Examples:**

* `"HP remaining: {{dice:50:100}}%"` → “HP remaining: 73%”
* `"D20 roll: {{dice:1:20}}"` → “D20 roll: 17”

***

#### 2. Random Selection Function

Randomly selects one option from a list.

* `{{pick:Apple:Banana:Orange}}`
* `{{pick:Yes:No}}`
* `{{pick:Good:Normal:Bad}}`

**Example:**

* `"Today’s fruit: {{pick:Apple:Banana:Orange}}"` → “Today’s fruit: Banana”

***

#### 3. Time Function

Automatically inserts current time or date information.

* `{{time}}` → HH:mm
* `{{time:full}}` → YYYY-MM-DD HH:mm:ss
* `{{time:date}}` → YYYY-MM-DD
* `{{time:hour}}` → HH
* `{{time:year}}` → YYYY
* `{{time:month}}` → MM
* `{{time:day}}` → DD

**Example:**

* `"Current time: {{time}}"` → “Current time: 14:30”

{% endstep %}
{% endstepper %}

{% endstep %}

{% step %}

### Media

<figure><img src="/files/ObKGbrWiIU8sPJmbsFme" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

#### Character Image Upload

* Upload up to **50 character images**.
* The most recently uploaded image is set as the **initial intro logo.**
* Images **must have transparent backgrounds** (background removed).
* The AI selects images based on file names, **so use consistent naming.**
  {% endstep %}

{% step %}

#### Remove Background

* The **Remove Background** button is not a delete button.It removes the background from the image.
* After selecting an image and clicking **Remove Background**, the background-removed image will be used.
  {% endstep %}

{% step %}

#### Background Image Upload

* Upload up to **50 background images**.
* File names must follow AI-recognizable conventions, the same as character images.
* The most recently uploaded image is set as the **initial intro background.**
* Background Image Links Available for Use **(**[**google drive**](https://drive.google.com/drive/folders/14KHFImVqybRl7ppkaZqIV5UMD6hFAVzf?usp=sharing)**)**
  * Background images may only be used **within the MIRAI service**.
    {% endstep %}

{% step %}

#### Extract Background

* Upload an image using the **Background Extraction** button to remove characters.
* Then upload the extracted background image.
  {% endstep %}
  {% endstepper %}
  {% endstep %}

{% step %}

### Lorebook

<div data-with-frame="true"><figure><img src="/files/CiIadQVQkgMMVk8zMW6q" alt=""><figcaption></figcaption></figure></div>

#### What Is a Lorebook?

The Lorebook stores **world settings and character configurations**.

Following this guide helps create natural and consistent conversations.

#### **Creating a Lorebook**

1. Enter **Title → Priority → Keywords → Content** in order.
2. Each lorebook entry supports up to **500 characters**. You can register up to **100 entries** in total.
3. Up to **5 keywords per entry**, with a **maximum of 5 active** at the same time.

#### **Title**

* Enter a concise title describing the lorebook topic.
* Examples:
  * Ira’s High School Days
  * Core World Rules
  * Café Part-Time Job Experience

#### Priority

* Sets the order in which lorebooks are applied when multiple triggers match.
* **Lower numbers = higher priority**.

#### Keywords (Triggers)

* Lorebooks activate when the user enters matching words or phrases.
* You can register **up to 5 keywords.**
* Similar or related terms will also trigger activation.
* Examples: high school, student days, graduation

#### Content

* Write character memories or settings within **500 characters**.
* Be specific and clear so the information can be naturally used in conversations.
  {% endstep %}
  {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mirai.fun/creator/create.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.