# ctrlCaptcha

Автоматически обрабатывает и сохраняет карты капчи в Minecraft через mineflayer бота. Обрабатывает карты капчи, преобразует их в изображения и сохраняет для дальнейшего использования.

## Notice

Некоторые цвета для версий до 1.16.5 могут быть слегка неправильными из-за изменений в палитре цветов Minecraft.

## Поддерживаемые версии Minecraft

- 1.16.5
- 1.19.2
- 1.20
- 1.20.4
- 1.21.1
- 1.21.3

Для версий выше 1.21.3 используется обработчик версии 1.21.3.

## Установка

1. Установите плагин с npm:

```bash
npm i mineflayer-install-captcha
```

2. Загрузите плагин в ваш mineflayer бот:

```javascript
const mineflayer = require('mineflayer')

const bot = mineflayer.createBot({
    host: 'server ip',
    port: 25565,
    username: 'BOT',
    version: '1.19.2',
    savePath: './maps'
})

bot.loadPlugin(require('mineflayer-install-captcha').inject)
```

## Особенности серверов

### Funtime

Применяется специальная фильтрация карт по позиции относительно направления взгляда бота:
- Определяет позицию центральной карты по yaw бота
- Фильтрует карты в радиусе 5 блоков от центральной
- Использует специальные координаты для разных направлений (yaw: 0, 90, -90, 180)

### Holyworld

Определяется автоматически по IP адресу сервера. Для этих серверов используется стандартная обработка карт.

## Формат выходных файлов

Изображения сохраняются в формате PNG с именем файла в формате `{host}-{timestamp}.png`, где:
- `host` - IP адрес или домен сервера
- `timestamp` - временная метка в миллисекундах

Если капча состоит из нескольких карт, они объединяются в сетку с автоматическим определением количества строк и столбцов на основе позиций карт.


## Зависимости

- `mineflayer` ^4.33.0 - библиотека для создания Minecraft ботов
- `jimp` 0.22.12 - библиотека для работы с изображениями

## Лицензия

MIT