Overview

BigKidsCore is the hub every BigKids.pro plugin connects through. It authenticates your server with one secure token, talks to the BigKids.pro API, writes the chosen map into server.cfg and reports live server status (heartbeat). Install it once — feature plugins won’t run without it.

What this can and cannot do

BigKidsCore is the single place a BigKids.pro plugin talks to the website from. It holds your server token and nothing more, and it never takes orders from the site: your server asks, the site answers.

The token is sent over HTTPS only — over plain http the core refuses to send it at all — and it is never written to any log.
Every command is console-only. There is no in-game permission to grant, so no admin rank can use them.
There is no "run this on my server" endpoint. The website cannot make this plugin do anything.
Revoke or regenerate the server token in your dashboard at any time and the link is dead.

Features

One secure server token for all your servers (stored hashed, shown once) — each machine is still told apart.
Keeps one identity for your server through IP and Steam id changes, so a home connection or a restart never turns it into a second entry with its wipe schedule left behind.
Shared HTTPS API client for all BigKids.pro plugins.
Writes server.levelurl / server.seed into server.cfg (no launcher edits).
Heartbeat: reports version, players and current map to your dashboard.
Reports which map vote your server is actually running, so the site knows a winner has been used and does not run the poll twice.
Reports when your server has really wiped, so the site can tell your community the wipe is done — after it happened, not on a timer.
Sends this world's ore, plants and player-spawn map once per wipe — automatically, with no setting to get wrong.
Reports the map preview, so a world you generated yourself can be shown and voted on.
Console command bigkidscore mapdata — re-reads this world and replaces what the site holds.
Works on Oxide/uMod and Carbon.

Installation

Drop BigKidsCore.cs into oxide/plugins/ (or carbon/plugins/).
In your dashboard → Servers, create the server token and copy it. One token works for all your servers.
Paste the token into oxide/config/BigKidsCore.json → "Server token".
Run oxide.reload BigKidsCore (or c.reload BigKidsCore).

Commands

bigkidscore info	Show core version, API version, connection status and this server's id on bigkids.pro. Server console only.
bigkidscore heartbeat	Report to the site right now. Server console only.
bigkidscore mapdata	Re-read this world's ore, plants and player spawns and replace what the site holds. Server console only.

FAQ

Do I need BigKidsCore for other plugins?

Yes — DiscordMapVote and other BigKids.pro plugins go idle without it.

Is my token safe?

It’s stored only as a hash on our side and sent only over HTTPS. You can regenerate it anytime in the dashboard.

My server's IP keeps changing. Will it show up twice?

No. On first start the core makes up an id for the server and keeps it in <code>oxide/data/BigKids/Instance.json</code> (<code>carbon/data/</code> on Carbon). The site recognises the server by it, so a new IP or a new Steam id after a restart keeps the same entry and the same wipe schedule. Deleting that file makes the site see a new server. <code>bigkidscore info</code> shows the id.