Skip to main content

Kotonebot is game automation library based on computer vision technology, works for Windows and Android.

Project description

kotonebot

[!WARNING] 本项目仍然处于早期开发阶段,可能随时会发生 breaking change。如果要使用,建议 pin 到一个具体的版本。

kotonebot 是一个使用 Python 编写,基于 OpenCV、RapidOCR 等技术,致力于简化 Python 游戏自动化脚本编写流程的框架。

特性

  • 层次化引入
    • 包含 Library、Framework、Application 三个不同层次,分别封装到不同程度,可自由选择
  • 平台无关的输入输出(截图与模拟点击)
  • 基于代码生成的图片资源引用
    • 避免硬编码字符串
  • 图像/OCR 识别结果追踪 & 可视化查看工具
  • 开箱即用的模拟器管理(目前仅支持 MuMu12 与雷电模拟器)

安装

要求:Python >= 3.10

# Windows Host, Windows Client
pip install kotonebot[windows]
# Windows Host, Android Client
pip install kotonebot[android]
# Development dependencies
pip install kotonebot[dev]

快速开始

WIP

协同开发

有时候你可能想以源码方式安装 kotonebot,以便与自己的项目一起调试修改。此时,如果你以 pip install -e /path/to/kotonebot 的方式安装,Pylance 可能无法正常静态分析。 解决方案是在 VSCode 里搜索 python.analysis.extraPaths 并将其设置为你本地 kotonebot 的根目录。

文档

WIP

其他

本项目分离自 KotonesAutoAssistant,因此 c69130 以前的提交均为 KotonesAutoAssistant 的历史提交。

由于使用 filter-repo 移除了大量无用文件,因此历史提交信息和更改的文件可能无法完全对应。

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

kotonebot-0.9.0.tar.gz (1.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kotonebot-0.9.0-py3-none-any.whl (1.6 MB view details)

Uploaded Python 3

File details

Details for the file kotonebot-0.9.0.tar.gz.

File metadata

  • Download URL: kotonebot-0.9.0.tar.gz
  • Upload date:
  • Size: 1.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.3

File hashes

Hashes for kotonebot-0.9.0.tar.gz
Algorithm Hash digest
SHA256 5dcc249d5fc4d576c1dec1c29a12b3f9816d58f3aca1877d2d54f1f1add8096a
MD5 e285e43a8dae752d4036a3c703f73def
BLAKE2b-256 12d79b6b787af4c36114160adbe10587eb14743ceafc750316efe2eddabbaf28

See more details on using hashes here.

File details

Details for the file kotonebot-0.9.0-py3-none-any.whl.

File metadata

  • Download URL: kotonebot-0.9.0-py3-none-any.whl
  • Upload date:
  • Size: 1.6 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.3

File hashes

Hashes for kotonebot-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2043f365b59aa4eb06c67a45a1abc21b10472f8bb7e5db584035bb76b73e588e
MD5 0cbef0c63bc4ff27d1b1c35d90e585f6
BLAKE2b-256 a48289413cbfecc10cb8f5d57a49b0ffdb22fe40b3a82101d3623a1359635a10

See more details on using hashes here.

Supported by

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