Bot AI

Coordinate server-side bot AIs to fill seats and manage lifecycles.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/kerem-ersoz/gonul --skill bot-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Bot AI
Source: https://github.com/kerem-ersoz/gonul/tree/main/.github/skills/bot-ai
Command: npx skills add https://github.com/kerem-ersoz/gonul --skill bot-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bots are server-side AI players that fill empty seats. This Skill coordinates BotManager lifecycle, bot naming/identification, and game-specific decision logic to provide reliable, testable bot behavior.

Core Features & Use Cases

  • Bot lifecycle management: add, remove, and regenerate bot IDs to maintain table balance.
  • Game-specific decision dispatch: routes to Hearts, King, Spades, and Okey101 decision functions with a consistent 1000ms delay.
  • Naming and identification: Turkish name pool with fallback to Bot-{random} and ID patterns for bot detection.
  • Timing and safety: uses the same socket handlers as humans to ensure parity.

Quick Start

Initialize the Bot AI system and spawn 1–3 Turkish-named bots to fill vacant seats on a new table.

Frequently Asked Questions about Bot AI

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add server-side bots to fill empty seats in a multiplayer game?

To add server-side bots to fill empty seats, you initialize a BotManager module to handle the bot lifecycle, spawn bots with generated IDs, and dispatch their decisions through the same socket event flow as human players. This ensures table balance and deterministic behavior.

How do multiplayer bots make game-specific decisions for card games like Hearts or Spades?

Multiplayer bots make game-specific decisions by routing logic to defined decision functions for games like Hearts, King, Spades, and Okey101. The system applies a consistent 1000ms action delay before executing the chosen move to simulate human timing and ensure safe interactions.

Can I use server-side game bots with my existing socket event handlers?

Yes, you can use server-side game bots with existing socket event handlers. The bot system uses the exact same socket event flow as human players, ensuring parity and safe interactions without requiring separate networking logic or specialized bot protocols.

How does the bot naming and identification system work for multiplayer game servers?

The bot naming system uses a Turkish name pool to assign identities to bots, falling back to a Bot-{random} pattern if names are exhausted. It also generates specific ID patterns, allowing the game server to easily detect and manage bot players separately from human users.

What is the best way to manage the lifecycle of AI bots on a game server?

The best way to manage AI bot lifecycles is using a dedicated BotManager module to add, remove, and regenerate bot IDs as needed. This approach maintains table balance and ensures deterministic behavior throughout the duration of the game play.

Do I need to define custom decision functions for each card game I want bots to play?

Yes, you need to define custom decision functions for each card game. The Bot AI system dispatches actions to specific decision logic for Hearts, King, Spades, and Okey101, requiring these functions to be defined to ensure proper and deterministic bot behavior.