TSun Bot — API Docs

🚀 Try It

📡 Endpoint

GET /invite

Send guild invites to a target player. Bot accounts from accounts.json connect to game servers, join the target's chat, send a message and invite, then disconnect.

Query Parameters

Name	Type	Description
uidrequired	integer	Target player UID to send invites to
keyoptional	string	API Key stored in your .env file
timeoptional	integer	Duration of spam in seconds (default: `30`)

Example Request

            # Send invite spam for 60 seconds to UID 123456789

            GET http://vbadge.tsunstudio.pw/invite?uid=123456789&time=60&key=MY_SECRET_KEY

Responses

✓ 200 — Success

{
  "status": "success",
  "message": "Started invite spam for 123456789",
  "uid": 123456789,
  "time_seconds": 60,
  "total_accounts": 5
}

✕ 400 — Error

{
"status": "error",
"message": "Missing required parameter: uid"
}

📡 Room Endpoint

GET /room

Send room invite spam to a target player in a specific room. Bot accounts connect to game servers and repeatedly send room join packets.

Query Parameters

Name	Type	Description
uidrequired	integer	Target player UID to send room spam to
roomidrequired	integer	Room ID to spam invites in
keyoptional	string	API Key stored in your .env file
timeoptional	integer	Duration of spam in seconds (default: `30`)

Example Request

            # Send room spam for 60 seconds to UID 123456789 in room 23232323

            GET http://vbadge.tsunstudio.pw/room?uid=123456789&roomid=23232323&time=60&key=MY_SECRET_KEY

Responses

✓ 200 — Success

{
  "status": "success",
  "message": "Started room spam for 123456789 in room 23232323",
  "uid": 123456789,
  "room_id": 23232323,
  "time_seconds": 60,
  "total_accounts": 5
}

✕ 400 — Error

{
"status": "error",
"message": "Missing required parameter: roomid"
}

ℹ️ Project Info

⚙️ How It Works

Bot accounts stored in accounts.json are spawned as background threads. Each bot connects to game servers, joins the target's guild chat, sends a V-Badge invite, and disconnects.

🛡️ Rate Limits & Spam Flow

The script uses all accounts in your config at a rate of 4 concurrent logins every 3 seconds. It automatically repeats looping across all accounts until the requested time (in seconds) expires. It requires key from .env file to be passed.

🖥️ CLI Mode

The original CLI system is preserved. Run python main.py for the interactive terminal interface.

🔑 Bot Accounts

Configure bot credentials in accounts.json as key-value pairs of uid: password.

TSun × Kittens Invite Bot

⚙️ How It Works

🛡️ Rate Limits & Spam Flow

🖥️ CLI Mode

🔑 Bot Accounts