# Understand the data schema

> You can interact with the API through HTTP requests from any language, For ease of use and comprehension, here are some key concepts and data flows within RPGGO. Understanding these will help you rapidly build your own AI-native app.

## RPGGO is a role-play game framework built around AI. 

To integrate concepts from both gaming and storytelling, we've designed four fundamental elements: ***games***, ***scenes***, ***goals***, and ***NPCs*** to assist you in crafting your open-world experience.

<figure><img src="/files/Aq6wra95F24SyAawIwLs" alt=""><figcaption><p>Key Concepts</p></figcaption></figure>

* <mark style="background-color:blue;">**Game**</mark>: A complete gaming experience, which can encompass multiple scenes, using various scenes to enrich perspectives and clues, facilitating a progressive storytelling approach.
* <mark style="background-color:blue;">**Scene**</mark> <mark style="color:blue;">**(Chapter in V2)**</mark><mark style="color:blue;">:</mark> A specific location or scenario within the game. Each scene contains one or more goals. When all goals are achieved, the game transitions to the next scene for further exploration.
* <mark style="background-color:blue;">**Goal**</mark>: Specific goals within a scene that players must accomplish. These goals often require dialogue with NPCs to obtain clues necessary for completion. Typically, multiple goals will progressively uncover deeper clues to aid players.
* <mark style="background-color:blue;">**NPC**</mark>**&#x20;**<mark style="color:blue;">**(Character in V2)**</mark>: Individuals or observers present in a scene. Additionally, each scene requires a DM to assist in advancing the game or handling unexpected situations. Players can freely interact with NPCs to gather clues or just for fun.

## In summary, users can engage in conversations with NPCs to acquire information while the "DM" will oversee the game

* Users can submit answers and reasoning to the DM to achieve next goal set within a scene.&#x20;
* Once all goals in a scene are completed, the game progresses to the next scene, at which point goals and NPCs may have undergone new changes.&#x20;
* Victory in the game is achieved when all scene goals are met.
* *Bad endings are under designed, which is based on value checks, and this will be released soon, more detailed controls and multi storylines can be made from the creator side easily.*

For schema details , go to next chapter.

{% content-ref url="/pages/d9ZYL7sCXdRZKCJe5O4Q" %}
[🪿LLM-based Game Open Schema (L-GOS)](/dev-docs/data-schema/llm-based-game-open-schema-l-gos.md)
{% endcontent-ref %}

<br>


---

# Agent Instructions: 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://developer.rpggo.ai/dev-docs/data-schema/understand-the-data-schema.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.