Live game data,
right inside Arche.

Quick start

Open Arche, switch to the Connect tab, and start a client that pushes JSON to the local socket. Send a profile first so Arche knows which Roblox user each subsequent update belongs to.

Connection

Arche hosts a single WebSocket server bound to loopback on port 8765. Multiple clients can connect at once — each connection is identified by the profile.userId it sends.

ws://127.0.0.1:8765

Lifecycle

Every message is a JSON object. On connect, send a profile message first. Arche keeps a client entry keyed by profile.userId and merges subsequent fields onto it.

If a client disconnects, Arche removes it from the list. Reconnect with the same userId to restore the view.

Message format

A message can include any combination of the fields below. The first message must contain profile.userId.

{
  "profile": {
    "userId": "12345678",
    "username": "Player",
    "displayName": "Player"
  },
  "game": "Blox Fruits",
  "stats": [
    { "label": "Level", "value": "2450" },
    { "label": "Bounty", "value": "30.2M" }
  ],
  "summary": [
    { "label": "Race", "value": "Angel" },
    { "label": "Fruit", "value": "Dough" }
  ],
  "items": [
    { "name": "Dark Blade", "group": "Swords", "detail": "Mastery 600", "count": 1 }
  ],
  "images": [
    "https://example.com/screenshot.png"
  ]
}

Profile

The profile is used as the identity key for a client. Arche looks up profile.userId and groups all future messages under it.

{
  "profile": {
    "userId": "12345678",
    "username": "RobloxPlayer123",
    "displayName": "RobloxPlayer"
  }
}

Avatar

Arche fetches a headshot automatically from Roblox thumbnails using the userId. If the fetch fails, the profile's first letter is shown instead.

Stats & summary

stats renders as a grid of large tiles at the top of the client view. summary renders below it as smaller cards. Both share the same { label, value } shape.

"stats": [
  { "label": "Level", "value": "2450" },
  { "label": "Playtime", "value": "48h 22m" }
],
"summary": [
  { "label": "Race", "value": "Angel" },
  { "label": "Fruit", "value": "Dough" }
]

Items

Items are the richest part of the data model. Each entry renders as a card grouped by the group field.

"items": [
  { "name": "Dark Blade", "group": "Swords", "detail": "Mastery 600" },
  { "name": "Dough", "group": "Fruits", "count": 2 },
  { "name": "God's Chalice", "group": "Materials", "count": 3 }
]

Asset ID formats

The icon field accepts any of the following — Arche extracts the numeric ID before requesting the thumbnail.

Weapon mastery

For weapons, put the mastery in detail (e.g. "Mastery 600"). Arche renders it as a subtitle instead of a count badge.

Images

Arche renders images as clickable cards that open the full image in a new tab. Use direct HTTPS URLs that return an image file. Hosted JPEG/PNG/WebP are supported.

"images": [
  "https://example.com/screenshot.png",
  {
    "url": "https://example.com/item.png",
    "caption": "Rare item"
  }
]

Screenshot · 400×300

Rare item · 400×300

Map view · 400×300

Example scripts

Lua (Roblox Executor)

local WS = WebSocket.connect("ws://127.0.0.1:8765")
local HttpService = game:GetService("HttpService")

local function send(payload)
    WS:Send(HttpService:JSONEncode(payload))
end

local player = game.Players.LocalPlayer

send({
    profile = {
        userId = tostring(player.UserId),
        username = player.Name,
        displayName = player.DisplayName
    },
    game = "Blox Fruits"
})

while task.wait(5) do
    send({
        profile = { userId = tostring(player.UserId) },
        stats = {
            { label = "Level", value = tostring(player.leaderstats.Level.Value) }
        }
    })
end

Lua — extract rbxassetid from tool textures

local function getAssetId(src)
    if type(src) == "number" then return tostring(math.floor(src)) end
    if type(src) ~= "string" then return nil end
    local q = src:match("[&?]id=(%d+)")
    if q then return q end
    return src:match("(%d+)")
end

local items = {}
for _, tool in ipairs(player.Backpack:GetChildren()) do
    if tool:IsA("Tool") then
        table.insert(items, {
            name = tool.Name,
            group = "Inventory",
            icon = getAssetId(tool.TextureId),
            count = 1
        })
    end
end

Node.js

const WebSocket = require("ws");
const ws = new WebSocket("ws://127.0.0.1:8765");

ws.on("open", () => {
    ws.send(JSON.stringify({
        profile: { userId: "12345678", username: "Player", displayName: "Player" },
        game: "Blox Fruits"
    }));
    ws.send(JSON.stringify({
        profile: { userId: "12345678" },
        stats: [{ label: "Level", value: "2450" }],
        items: [{ name: "Dark Blade", group: "Swords", detail: "Mastery 600" }]
    }));
});

Python

import asyncio, json
import websockets

async def main():
    async with websockets.connect("ws://127.0.0.1:8765") as ws:
        await ws.send(json.dumps({
            "profile": {"userId": "12345678", "username": "Player"},
            "game": "Blox Fruits"
        }))
        await ws.send(json.dumps({
            "profile": {"userId": "12345678"},
            "stats": [{"label": "Level", "value": "2450"}]
        }))
        await asyncio.sleep(60)

asyncio.run(main())

Troubleshooting