Aigames

Here's the English translation:\r \r ---\r \r

I. Overall Objective\r

\r This skill is a minimal guide for creating H5 games， mobile compatibale, touch screen games.\r \r

II. aigames Repository Custom Interface\r

\r

**Repository URL**: https://www.idlab.top\r Each game requires creating a new folder in the repository root directory, containing the following 3 fixed files:\r

• config.json — Game configuration (title and other metadata)\r
• index.html — Main game code\r
• preview.png — Game screenshot preview\r \r **Important Rule**: The interface will return an error if a file already exists; no overwriting.\r \r

2.1 Upload config.json\r

\r

POST /xlabopenapi/github/aigames/config\r

\r

Request Parameters (form-data)\r

\r |Parameter|Type|Required|Description|\r |-|-|-|-|\r |gameFolder|string|Yes|Game folder name, use English, e.g., my\_cool\_game|\r |file|file|Yes|config.json file, format shown below|\r \r

config.json Content Format\r

\r

{\r
  "title": "Game Name"\r
}\r
```\r
\r
#### curl Example\r
\r
```bash\r
curl -X POST "https://www.idlab.top/xlabopenapi/github/aigames/config" \\\r
  -F "gameFolder=xiaotongcoolgame" \\\r
  -F "file=@/root/workspace/logs/config.json"\r
```\r
\r
\---\r
\r
### 2.2 Upload index.html\r
\r
#### `POST /xlabopenapi/github/aigames/index`\r
\r
#### Request Parameters (form-data)\r
\r
|Parameter|Type|Required|Description|\r
|-|-|-|-|\r
|`gameFolder`|string|Yes|Game folder name, must match the one used when uploading config.json|\r
|`file`|file|Yes|index.html main game file|\r
\r
#### curl Example\r
\r
```bash\r
curl -X POST "https://www.idlab.top/xlabopenapi/github/aigames/index" \\\r
  -F "gameFolder=my\_cool\_game" \\\r
  -F "file=@/path/to/index.html"\r
```\r
\r
\---\r
\r
### 2.3 Upload preview.png\r
\r
#### `POST /xlabopenapi/github/aigames/preview`\r
\r
#### Request Parameters (form-data)\r
\r
|Parameter|Type|Required|Description|\r
|-|-|-|-|\r
|`gameFolder`|string|Yes|Game folder name, must match the one used when uploading config.json|\r
|`file`|file|Yes|preview.png game screenshot (recommended size 400×300)|\r
\r
#### curl Example\r
\r
```bash\r
curl -X POST "https://www.idlab.top/xlabopenapi/github/aigames/preview" \\\r
  -F "gameFolder=my\_cool\_game" \\\r
  -F "file=@/path/to/preview.png"\r
```\r
\r
\---\r
\r
## III. Complete Process for Uploading a New Game (AI Call Example)\r
\r
> Assuming you want to upload a Snake game named `pixel\_snake`, the steps are as follows:\r
\r
### Step 1: Upload config.json\r
\r
```bash\r
curl -X POST "https://www.idlab.top/xlabopenapi/github/aigames/config" \\\r
  -F "gameFolder=pixel\_snake" \\\r
  -F "[email protected]"\r
```\r
\r
config.json content:\r
\r
```json\r
{"title": "Pixel Snake"\r
}\r
```\r
\r
### Step 2: Upload index.html\r
\r
```bash\r
curl -X POST "https://www.idlab.top/xlabopenapi/github/aigames/index" \\\r
  -F "gameFolder=pixel\_snake" \\\r
  -F "[email protected]"\r
```\r
\r
### Step 3: Upload preview.png\r
\r
```bash\r
curl -X POST "https://www.idlab.top/xlabopenapi/github/aigames/preview" \\\r
  -F "gameFolder=pixel\_snake" \\\r
  -F "[email protected]"\r
```\r
\r
### Step 4: If successful, inform the user that the upload is complete\r
\r
Provide the experience URL as https://thenext.games/game/ + gameFolder. For example, in the case above: https://thenext.games/game/pixel\_snake\r
\r
\---\r
\r
## IV. Common Response Structure\r
\r
All interfaces return a unified structure:\r
\r
```json\r
{\r
  "code": 200, // 200 indicates success, other values indicate failure\r
  "message": "success",\r
  "data": { ... } // Returned data on success\r
}\r
```\r
\r
### Common Error Codes\r
\r
|code|Meaning|\r
|-|-|\r
|200|Success|\r
|400|Parameter error (e.g., file already exists, gameFolder is empty, etc.)|\r
|500|Internal server error (e.g., GitHub API call failed)|\r
\r
\---\r
\r
## V. Important Notes\r
\r
1. **gameFolder Naming Convention**: Use English letters, numbers, underscores, or hyphens. Do not use Chinese characters or spaces, e.g., `my\_cool\_game`, `pixel-snake`.\r
2. **Files Cannot Be Overwritten**: The three aigames custom interfaces do not support overwriting. If a file already exists, an error will be returned. To overwrite, use the general interface with `overwrite=true`.\r
3. **Upload Order Not Required**: The three files (config.json, index.html, preview.png) can be uploaded in any order, but it's recommended to upload config.json first.\r
4. **File Size Limit**: The server limits individual files to a maximum of 50MB.\r
5. **preview.png**: Must be in PNG format, recommended size 400×300 pixels or proportionate.\r
\r
\---\r
\r
I noticed there was a formatting issue in the config.json example in Step 1 of section III - it appears to have incomplete/malformed JSON with an "address" field that seems to be a note rather than valid JSON structure.\r
\r