Skip to main content

A performant library designed for creating and managing bots in a Tetris-like game environment. This library offers various tools and features to build, test, and deploy bots efficiently to Botris.

Project description

botris-interface

GitHub license GitHub issues GitHub stars GitHub forks

botris-interface is a performant library designed for creating and managing bots in a Tetris-like game environment. This library offers various tools and features to build, test, and deploy bots efficiently to Botris.

Installation

To install the library, use the following command:

pip install botris-interface

Usage

Creating a Bot

To create a bot, you need to implement the Bot interface provided by the library. Here is an example:

from botris_interface import Bot

class CoolBot(Bot):
    async def analyze(
        self, game_state: GameState, players: List[PlayerData]
    ) -> Awaitable[List[Command]]:
        # Implement your bot logic here
        pass

Running the TetrisGame

You can run the TetrisGame using the following code:

from botris import TetrisGame
from botris.engine import Move

gs = TetrisGame()
gs.execute_move(Move.move_left)

Connecting a Bot to the Server

To connect your bot to the server, use the following code:

import asyncio
from botris import Interface

async def main():
    bot = MyBot()
    itf = Interface.create(TOKEN, ROOM_KEY, bot)
    await client.connect()

asyncio.run(main())

License

This project is licensed under the MIT License - see the LICENSE file for details.

GitHub Repository

For more information, visit our GitHub repository.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

botris_interface-0.1.3.tar.gz (842.9 kB view details)

Uploaded Source

Built Distribution

botris_interface-0.1.3-py3-none-any.whl (852.0 kB view details)

Uploaded Python 3

File details

Details for the file botris_interface-0.1.3.tar.gz.

File metadata

  • Download URL: botris_interface-0.1.3.tar.gz
  • Upload date:
  • Size: 842.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.12.1 Windows/11

File hashes

Hashes for botris_interface-0.1.3.tar.gz
Algorithm Hash digest
SHA256 e964c77f4a63debb643f58be0a5df68f7bbdc5c8752ce0397b4a526f77b057fb
MD5 58264b7651baf60750e0f5c06255d122
BLAKE2b-256 3e71534bed77fe179f01846983abe81fea973611ed3fa8f95fad13615642bfd7

See more details on using hashes here.

File details

Details for the file botris_interface-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for botris_interface-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 18742545908b1b2a827c4ccbff21ff7c77fbf9da132ab039e31f11d753ba627c
MD5 e9d4600ab46b46fead21bbaf266a0c85
BLAKE2b-256 af391cd91bb1692a186aca02bcee9886c170edef75b3ce1282278bccdd704f29

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page