> For the complete documentation index, see [llms.txt](https://fortunemeta.gitbook.io/fortune-metaverse-engine/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fortunemeta.gitbook.io/fortune-metaverse-engine/guides/creating-your-first-fortune-world.md).

# Creating your first Fortune world

Creating a basic Fortune world with no custom scripting elements or logic is a very straightforward process. See our online web creator here for an editor and preview renderer: <https://fortune.day/create>.

Two rooms can be linked together via a single prompt in a JSON file. This example also shows how an item can be given when a prompt is successfully entered, and how a room or prompt can require that item in order for entry to be given.

This animated GIF is the results of the JSON game data below.

<figure><img src="https://raw.githubusercontent.com/jddunn/text-rpg-engine/master/screenshots/text-rpg-demo-full.gif" alt=""><figcaption></figcaption></figure>

```json
"game": {
    "start": "Beginning",
    "end": "Second",
    "rooms": 
        [
            {
                "name": "Beginning",
                "contents": "This is the beginning room",
                "prompts": [
                    {
                        "name": "go right",
                        "keywords": ["go right", "move right", "open right", "enter right", "door right", "right door"],
                        "results":  {
                            "successText": "You enter in the access code '14052' and successfully open the door.",
                            "failText": "The door is locked with an access code!",
                            "roomToEnter": "Second",
                            "itemsGiven": "trophy"
                        },
                        "requirements": ["accessKey"]
                    },
                    {
                        "name": "look room",
                        "keywords": ["look room", "look at room", "search room", "examine room", "look in"],
                        "results":  {
                            "successText": "You see a room with a door to the right and a statue in the middle."
                        }
                    },
                    {
                        "name": "get statue",
                        "keywords": ["look room", "look at room", "search room", "examine room", "look in"],
                        "results":  {
                            "successText": "You see a room with a door to the right and a statue in the middle."
                        }
                    },
                    {
                        "name": "get statue",
                        "keywords": ["get statue", "pick up statue", "take statue", "pick statue"],
                        "results":   {
                            "successText": "You pick up the statue. It feels heavy in your hands, and there's something hanging off the bottom.",
                            "itemsGiven": ["statue"]
                          }
                    },
                    {
                        "name": "rotate statue",
                        "keywords": ["rotate statue", "rotate the statue"],
                        "results": {
                            "successText": "You take the note from the bottom of the statue.",
                            "failText": "You have no statue to look at!",
                            "itemsGiven": ["note"]
                        },
                        "requirements": ["statue"]
                    },
                    {
                        "name": "look note",
                        "keywords": ["look at note", "examine note", "take note", "get note", "check note", "read note", "look note"],
                        "results": {
                            "successText": "You look at the note and find an access code: '14052'.",
                            "failText": "You have no note to look at!",
                            "itemsGiven": ["accessKey"]
                          },
                        "requirements": ["statue", "note"]
                    }
                ]
            },
            {
                "name": "SecondRoom",
                "contents": "You did it! You won!"
            }
        ]
}
```

{% hint style="info" %}
You can use Fortune's world creator / renderer online here: <https://fortune.day/create>.
{% endhint %}


---

# 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, and the optional `goal` query parameter:

```
GET https://fortunemeta.gitbook.io/fortune-metaverse-engine/guides/creating-your-first-fortune-world.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.