mineflayer-python 0.1.0__tar.gz

mineflayer_python-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Drilegems
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

mineflayer_python-0.1.0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: mineflayer-python
+Version: 0.1.0
+Summary: Python wrapper for Mineflayer Minecraft bot library
+Home-page: https://github.com/yourusername/mineflayer-python
+Author: Your Name
+Author-email: your.email@example.com
+Keywords: minecraft,bot,mineflayer,gaming,automation
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: javascript>=0.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: black>=21.0; extra == "dev"
+Requires-Dist: flake8>=3.9; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Mineflayer-Python
+
+Python обертка для [Mineflayer](https://github.com/PrismarineJS/mineflayer) - библиотеки для создания Minecraft ботов.
+
+## Установка
+
+```bash
+# Установите Node.js и npm
+# Затем установите mineflayer
+npm install mineflayer
+
+# Установите Python пакет
+pip install mineflayer-python

mineflayer_python-0.1.0/README.md

@@ -0,0 +1,13 @@
+# Mineflayer-Python
+
+Python обертка для [Mineflayer](https://github.com/PrismarineJS/mineflayer) - библиотеки для создания Minecraft ботов.
+
+## Установка
+
+```bash
+# Установите Node.js и npm
+# Затем установите mineflayer
+npm install mineflayer
+
+# Установите Python пакет
+pip install mineflayer-python

mineflayer_python-0.1.0/mineflayer-python/__init__.py

@@ -0,0 +1,24 @@
+"""
+Mineflayer-Python - Python обертка для Mineflayer
+
+Позволяет легко создавать Minecraft ботов с чистым Python API.
+"""
+
+from .mineflayer import Mineflayer
+from .enums import AuthMode, ViewDistance, Difficulty
+from .enums import OFFLINE, ONLINE, MICROSOFT
+
+__version__ = "0.1.0"
+__author__ = "Your Name"
+__all__ = [
+    'Mineflayer',
+    'AuthMode',
+    'ViewDistance', 
+    'Difficulty',
+    'OFFLINE',
+    'ONLINE',
+    'MICROSOFT',
+]
+
+# Создаем глобальный экземпляр для удобства
+mineflayer = Mineflayer()

mineflayer_python-0.1.0/mineflayer-python/bot.py

@@ -0,0 +1,178 @@
+import asyncio
+from typing import Any, Dict, Optional, Callable
+from dataclasses import dataclass, field
+from .enums import AuthMode
+
+@dataclass
+class BotOptions:
+    """Опции для создания бота"""
+    host: str = "localhost"
+    port: int = 25565
+    username: str = "Bot"
+    auth: AuthMode = AuthMode.OFFLINE
+    version: str = "1.20.1"
+    view_distance: int = 8
+    chat_length_limit: int = 256
+    colors_enabled: bool = True
+    default_chat_patterns: bool = True
+    physics_enabled: bool = True
+    log_errors: bool = True
+    
+    # Дополнительные параметры
+    password: Optional[str] = None
+    profiles_folder: Optional[str] = None
+    client_token: Optional[str] = None
+    access_token: Optional[str] = None
+    session: Optional[Any] = None
+    keep_alive: bool = True
+    
+    def to_dict(self) -> Dict[str, Any]:
+        """Конвертирует опции в словарь для JavaScript"""
+        result = {
+            'host': self.host,
+            'port': self.port,
+            'username': self.username,
+            'auth': str(self.auth),
+            'version': self.version,
+            'viewDistance': self.view_distance,
+            'chatLengthLimit': self.chat_length_limit,
+            'colorsEnabled': self.colors_enabled,
+            'defaultChatPatterns': self.default_chat_patterns,
+            'physicsEnabled': self.physics_enabled,
+            'logErrors': self.log_errors,
+        }
+        
+        # Добавляем опциональные поля
+        if self.password:
+            result['password'] = self.password
+        if self.profiles_folder:
+            result['profilesFolder'] = self.profiles_folder
+        if self.client_token:
+            result['clientToken'] = self.client_token
+        if self.access_token:
+            result['accessToken'] = self.access_token
+        if self.session:
+            result['session'] = self.session
+        result['keepAlive'] = self.keep_alive
+            
+        return result
+
+
+class Bot:
+    """Представляет Minecraft бота"""
+    
+    def __init__(self, js_bot=None):
+        """
+        Инициализирует бота
+        
+        Args:
+            js_bot: JavaScript объект бота (необязательно)
+        """
+        self._js_bot = js_bot
+        self._event_handlers = {}
+        
+    def __getattr__(self, name):
+        """Проксирует вызовы к JavaScript объекту"""
+        if self._js_bot:
+            return getattr(self._js_bot, name)
+        raise AttributeError(f"Bot has no attribute '{name}'")
+    
+    def on(self, event_name: str, callback: Callable):
+        """
+        Регистрирует обработчик события
+        
+        Args:
+            event_name: Название события
+            callback: Функция-обработчик
+        """
+        if event_name not in self._event_handlers:
+            self._event_handlers[event_name] = []
+        self._event_handlers[event_name].append(callback)
+        
+        # Если бот уже создан, регистрируем обработчик в JavaScript
+        if self._js_bot:
+            def js_handler(*args):
+                try:
+                    callback(*args)
+                except Exception as e:
+                    print(f"Error in event handler for {event_name}: {e}")
+            self._js_bot.on(event_name, js_handler)
+    
+    def once(self, event_name: str, callback: Callable):
+        """Регистрирует одноразовый обработчик события"""
+        def wrapper(*args):
+            callback(*args)
+            self.remove_listener(event_name, wrapper)
+        self.on(event_name, wrapper)
+    
+    def remove_listener(self, event_name: str, callback: Callable):
+        """Удаляет обработчик события"""
+        if event_name in self._event_handlers:
+            self._event_handlers[event_name].remove(callback)
+    
+    def emit(self, event_name: str, *args):
+        """Вызывает событие"""
+        if event_name in self._event_handlers:
+            for handler in self._event_handlers[event_name]:
+                try:
+                    handler(*args)
+                except Exception as e:
+                    print(f"Error in event handler for {event_name}: {e}")
+    
+    async def wait_for_event(self, event_name: str, timeout: Optional[float] = None):
+        """
+        Асинхронно ожидает событие
+        
+        Args:
+            event_name: Название события
+            timeout: Таймаут в секундах
+            
+        Returns:
+            Аргументы события
+        """
+        future = asyncio.Future()
+        
+        def handler(*args):
+            if not future.done():
+                future.set_result(args)
+        
+        self.once(event_name, handler)
+        
+        try:
+            return await asyncio.wait_for(future, timeout)
+        except asyncio.TimeoutError:
+            self.remove_listener(event_name, handler)
+            raise
+    
+    # Удобные методы
+    def chat(self, message: str):
+        """Отправляет сообщение в чат"""
+        if self._js_bot:
+            self._js_bot.chat(message)
+    
+    def whisper(self, username: str, message: str):
+        """Шепчет игроку"""
+        self.chat(f"/tell {username} {message}")
+    
+    def say(self, message: str):
+        """Алиас для chat"""
+        self.chat(message)
+    
+    def quit(self, reason: str = "Quit"):
+        """Отключает бота"""
+        if self._js_bot:
+            self._js_bot.quit(reason)
+    
+    @property
+    def username(self) -> Optional[str]:
+        """Возвращает имя бота"""
+        if self._js_bot:
+            return self._js_bot.username
+        return None
+    
+    @property
+    def health(self) -> Optional[float]:
+        """Возвращает здоровье бота"""
+        if self._js_bot and hasattr(self._js_bot, 'health'):
+            return float(self._js_bot.health)
+        return None

mineflayer_python-0.1.0/mineflayer-python/constants.py

@@ -0,0 +1,25 @@
+"""
+Constants for authentication and modes
+"""
+
+# Authentication modes
+OFFLINE = 'offline'
+ONLINE = 'online'
+MICROSOFT = 'microsoft'
+MOJANG = 'mojang'
+
+# Event constants
+EVENT_CHAT = 'chat'
+EVENT_KICKED = 'kicked'
+EVENT_ERROR = 'error'
+EVENT_LOGIN = 'login'
+EVENT_SPAWN = 'spawn'
+EVENT_END = 'end'
+EVENT_DEATH = 'death'
+EVENT_WHISPER = 'whisper'
+EVENT_MESSAGE = 'message'
+
+# Other constants
+DEFAULT_PORT = 25565
+DEFAULT_HOST = 'localhost'
+DEFAULT_USERNAME = 'Bot'

mineflayer_python-0.1.0/mineflayer-python/enums.py

@@ -0,0 +1,30 @@
+from enum import Enum, auto
+
+class AuthMode(Enum):
+    """Режимы аутентификации"""
+    OFFLINE = "offline"
+    ONLINE = "online"
+    MICROSOFT = "microsoft"
+    
+    def __str__(self):
+        return self.value
+
+class ViewDistance(Enum):
+    """Дальность прорисовки"""
+    TINY = 2
+    SHORT = 4
+    NORMAL = 8
+    FAR = 16
+    EXTREME = 32
+
+class Difficulty(Enum):
+    """Сложность мира"""
+    PEACEFUL = 0
+    EASY = 1
+    NORMAL = 2
+    HARD = 3
+
+# Константы для удобства
+OFFLINE = AuthMode.OFFLINE
+ONLINE = AuthMode.ONLINE
+MICROSOFT = AuthMode.MICROSOFT

mineflayer_python-0.1.0/mineflayer-python/mineflayer.py

@@ -0,0 +1,171 @@
+import sys
+from typing import Union, Optional, Dict, Any
+from dataclasses import asdict
+
+# Проверяем наличие javascript модуля
+try:
+    from javascript import require, On, Once, Off, EventEmitter, globalThis
+    JS_AVAILABLE = True
+except ImportError:
+    JS_AVAILABLE = False
+    print("Внимание: модуль 'javascript' не найден. Установите его: pip install javascript")
+    print("Эта библиотека требует Node.js и установленного mineflayer через npm")
+
+from .bot import Bot, BotOptions
+from .enums import AuthMode, OFFLINE, ONLINE, MICROSOFT
+
+
+class Mineflayer:
+    """Основной класс для работы с Mineflayer"""
+    
+    def __init__(self):
+        """
+        Инициализирует Mineflayer
+        
+        Raises:
+            RuntimeError: Если JavaScript модуль недоступен
+        """
+        if not JS_AVAILABLE:
+            raise RuntimeError(
+                "JavaScript модуль недоступен. "
+                "Установите: pip install javascript и убедитесь что Node.js установлен"
+            )
+        
+        try:
+            self._mineflayer_js = require('mineflayer')
+        except Exception as e:
+            raise RuntimeError(f"Не удалось загрузить mineflayer: {e}. "
+                             f"Убедитесь что mineflayer установлен: npm install mineflayer")
+    
+    def createBot(self, *args, **kwargs) -> Bot:
+        """
+        Создает нового бота
+        
+        Args:
+            *args: Позиционные аргументы в порядке: host, username, auth, version
+            **kwargs: Именованные аргументы
+            
+        Returns:
+            Экземпляр Bot
+            
+        Примеры:
+            # Позиционные аргументы
+            bot = mineflayer.createBot("localhost", "Bot", OFFLINE, "1.16.5")
+            
+            # Именованные аргументы
+            bot = mineflayer.createBot(
+                host="localhost", 
+                username="Bot",
+                auth=OFFLINE,
+                version="1.16.5"
+            )
+            
+            # Словарь опций
+            bot = mineflayer.createBot({
+                "host": "localhost",
+                "username": "MyBot"
+            })
+        """
+        # Обработка разных форматов ввода
+        if args and len(args) == 1 and isinstance(args[0], dict):
+            # Если передан словарь
+            options_dict = args[0]
+        elif args:
+            # Если переданы позиционные аргументы
+            options_dict = {}
+            if len(args) >= 1:
+                options_dict['host'] = args[0]
+            if len(args) >= 2:
+                options_dict['username'] = args[1]
+            if len(args) >= 3:
+                options_dict['auth'] = args[2]
+            if len(args) >= 4:
+                options_dict['version'] = args[3]
+        else:
+            # Если переданы только именованные аргументы
+            options_dict = kwargs
+        
+        # Создаем объект опций
+        options = BotOptions(**options_dict)
+        
+        # Создаем JavaScript бота
+        js_bot = self._mineflayer_js.createBot(options.to_dict())
+        
+        # Создаем Python обертку
+        bot = Bot(js_bot)
+        
+        # Регистрируем обработчики событий
+        self._setup_event_proxies(bot, js_bot)
+        
+        return bot
+    
+    def _setup_event_proxies(self, py_bot: Bot, js_bot):
+        """Настраивает проксирование событий из JavaScript в Python"""
+        
+        # Список стандартных событий mineflayer
+        common_events = [
+            'spawn', 'death', 'health', 'chat', 'whisper', 'actionBar',
+            'login', 'kicked', 'end', 'error', 'playerJoined', 
+            'playerLeft', 'entitySpawn', 'entityGone', 'entityMoved',
+            'entityHurt', 'entitySwingArm', 'entityCrouch', 'entityUncrouch',
+            'entityEquip', 'entitySleep', 'entityWake', 'entityEat',
+            'entityAttach', 'entityDetach', 'entityUpdate', 'entityEffect',
+            'entityEffectEnd', 'playerCollect', 'blockUpdate',
+            'chunkColumnLoad', 'chunkColumnUnload', 'soundEffectHeard',
+            'hardcodedSoundEffectHeard', 'noteHeard', 'pistonMove',
+            'rain', 'time', 'scoreboardCreated', 'scoreboardDeleted',
+            'scoreboardTitleChanged', 'scoreUpdated', 'teamCreated',
+            'teamRemoved', 'teamUpdated', 'teamMemberAdded',
+            'teamMemberRemoved', 'resourcePack', 'game'
+        ]
+        
+        # Регистрируем обработчики для стандартных событий
+        for event in common_events:
+            def create_handler(event_name):
+                def handler(*args):
+                    py_bot.emit(event_name, *args)
+                return handler
+            
+            js_bot.on(event, create_handler(event))
+    
+    @staticmethod
+    def supportedVersions() -> list:
+        """Возвращает список поддерживаемых версий"""
+        try:
+            mineflayer_js = require('mineflayer')
+            if hasattr(mineflayer_js, 'supportedVersions'):
+                return list(mineflayer_js.supportedVersions)
+        except:
+            pass
+        return ["1.8", "1.9", "1.10", "1.11", "1.12", "1.13", "1.14", 
+                "1.15", "1.16", "1.17", "1.18", "1.19", "1.20"]
+    
+    def createBotSync(self, *args, **kwargs) -> Bot:
+        """
+        Создает бота синхронно (для скриптов без asyncio)
+        
+        Returns:
+            Экземпляр Bot
+        """
+        import time
+        
+        bot = self.createBot(*args, **kwargs)
+        
+        # Ждем события spawn с таймаутом
+        spawn_event = None
+        timeout = 30  # 30 секунд
+        
+        def on_spawn(*args):
+            nonlocal spawn_event
+            spawn_event = args
+        
+        bot.once('spawn', on_spawn)
+        
+        start_time = time.time()
+        while not spawn_event and (time.time() - start_time) < timeout:
+            time.sleep(0.1)
+        
+        if not spawn_event:
+            raise TimeoutError("Бот не заспавнился в течение 30 секунд")
+        
+        return bot

mineflayer_python-0.1.0/mineflayer_python.egg-info/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: mineflayer-python
+Version: 0.1.0
+Summary: Python wrapper for Mineflayer Minecraft bot library
+Home-page: https://github.com/yourusername/mineflayer-python
+Author: Your Name
+Author-email: your.email@example.com
+Keywords: minecraft,bot,mineflayer,gaming,automation
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: javascript>=0.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: black>=21.0; extra == "dev"
+Requires-Dist: flake8>=3.9; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Mineflayer-Python
+
+Python обертка для [Mineflayer](https://github.com/PrismarineJS/mineflayer) - библиотеки для создания Minecraft ботов.
+
+## Установка
+
+```bash
+# Установите Node.js и npm
+# Затем установите mineflayer
+npm install mineflayer
+
+# Установите Python пакет
+pip install mineflayer-python

mineflayer_python-0.1.0/mineflayer_python.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+setup.py
+mineflayer-python/__init__.py
+mineflayer-python/bot.py
+mineflayer-python/constants.py
+mineflayer-python/enums.py
+mineflayer-python/events.py
+mineflayer-python/mineflayer.py
+mineflayer_python.egg-info/PKG-INFO
+mineflayer_python.egg-info/SOURCES.txt
+mineflayer_python.egg-info/dependency_links.txt
+mineflayer_python.egg-info/requires.txt
+mineflayer_python.egg-info/top_level.txt

mineflayer_python-0.1.0/mineflayer_python.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mineflayer_python-0.1.0/mineflayer_python.egg-info/requires.txt

@@ -0,0 +1,6 @@
+javascript>=0.1.0
+
+[dev]
+pytest>=6.0
+black>=21.0
+flake8>=3.9

mineflayer_python-0.1.0/mineflayer_python.egg-info/top_level.txt

@@ -0,0 +1 @@
+mineflayer-python

mineflayer_python-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mineflayer_python-0.1.0/setup.py

@@ -0,0 +1,39 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="mineflayer-python",
+    version="0.1.0",
+    author="Your Name",
+    author_email="your.email@example.com",
+    description="Python wrapper for Mineflayer Minecraft bot library",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/yourusername/mineflayer-python",
+    packages=find_packages(),
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Topic :: Games/Entertainment",
+        "Topic :: Software Development :: Libraries",
+    ],
+    python_requires=">=3.7",
+    install_requires=[
+        "javascript>=0.1.0",
+    ],
+    extras_require={
+        "dev": [
+            "pytest>=6.0",
+            "black>=21.0",
+            "flake8>=3.9",
+        ],
+    },
+    keywords="minecraft, bot, mineflayer, gaming, automation",
+)