API Documentation

import requests

BASE = "https://www.mineseedfinder.com"

def scan(seed, x=0, z=0, radius=100, max_=20, types="5"):
    params = {
        "seed": seed,
        "x": x,
        "z": z,
        "radius": radius,
        "max": max_,
        "types": types,  # comma-separated structure IDs, e.g. "5,8,9"
    }
    r = requests.get(f"{BASE}/scan", params=params, timeout=15)
    r.raise_for_status()
    return r.json()

if __name__ == "__main__":
    data = scan(seed=31415, x=0, z=0, radius=100, max_=50, types="5,8,9")
    for s in data.get("results", []):
        print(f"{s['name']:<14} (x={s['x']}, z={s['z']}) dist={s['distance']}")

-- Drop-in for Flarial Client modules. `network` is a Flarial global.
local BASE = "https://www.mineseedfinder.com"

local function scan(seed, x, z, radius, maxResults, types)
    local url = string.format(
        "%s/scan?seed=%d&x=%d&z=%d&radius=%d&max=%d&types=%s",
        BASE, seed, x, z, radius, maxResults, types
    )
    -- seedfinder takes the structure IDs in types, e.g. "5,8,9"
    local resp = network.get(url)
    if not resp or resp.code ~= 200 then
        print("[seedfinder] HTTP error: " .. tostring(resp and resp.code))
        return nil
    end
    return resp.body  -- JSON string; parse it with your JSON lib if needed
end

-- Example: villages, monuments and mansions around spawn on seed 31415
local body = scan(31415, 0, 0, 100, 50, "5,8,9")
print(body or "no response")

// No dependencies - uses the native fetch available in Node 18+.
const BASE = "https://www.mineseedfinder.com";

async function scan(seed, x = 0, z = 0, radius = 100, max = 20, types = "5") {
    const url = new URL("/scan", BASE);
    url.searchParams.set("seed", String(seed));
    url.searchParams.set("x", String(x));
    url.searchParams.set("z", String(z));
    url.searchParams.set("radius", String(radius));
    url.searchParams.set("max", String(max));
    url.searchParams.set("types", types);  // comma-separated IDs, e.g. "5,8,9"

    const res = await fetch(url, { signal: AbortSignal.timeout(15000) });
    if (!res.ok) throw new Error(`HTTP ${res.status} ${res.statusText}`);
    return res.json();
}

(async () => {
    const data = await scan(31415, 0, 0, 100, 50, "5,8,9");
    for (const s of data.results ?? []) {
        console.log(`${s.name.padEnd(14)} (x=${s.x}, z=${s.z}) dist=${s.distance}`);
    }
})().catch((err) => {
    console.error("scan failed:", err);
    process.exit(1);
});