mineflex 0.1.0__py3-none-any.whl

mineflex/__init__.py

@@ -0,0 +1,48 @@
+"""
+Mineflex - A native Python Minecraft bot framework.
+
+This package provides a Pythonic API for creating Minecraft bots
+with asyncio support, inspired by Mineflayer.
+"""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+# Public API
+from mineflex.bot import Bot, create_bot
+from mineflex.errors import (
+    MineflexError,
+    ConnectionError,
+    AuthenticationError,
+    ProtocolError,
+    PacketError,
+    UnsupportedVersionError,
+    TimeoutError,
+    InvalidStateError,
+    InteractionError,
+    DiggingError,
+    InventoryError,
+    CraftingError,
+)
+
+__all__ = [
+    # Version
+    "__version__",
+    # Main API
+    "Bot",
+    "create_bot",
+    # Exceptions
+    "MineflexError",
+    "ConnectionError",
+    "AuthenticationError",
+    "ProtocolError",
+    "PacketError",
+    "UnsupportedVersionError",
+    "TimeoutError",
+    "InvalidStateError",
+    "InteractionError",
+    "DiggingError",
+    "InventoryError",
+    "CraftingError",
+]

mineflex/actions/__init__.py

@@ -0,0 +1,10 @@
+"""Actions subsystem - digging, building, combat."""
+
+from __future__ import annotations
+
+from mineflex.actions.action import Action, ActionType
+
+__all__ = [
+    "Action",
+    "ActionType",
+]

mineflex/actions/action.py

@@ -0,0 +1,51 @@
+"""Interaction actions (digging, building, item use)."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import Enum
+from typing import Optional
+
+from mineflex.physics.vec3 import Vec3
+
+
+class ActionType(Enum):
+    """Types of actions."""
+
+    DIG = "dig"
+    BUILD = "build"
+    USE_ITEM = "use_item"
+    ATTACK = "attack"
+    INTERACT = "interact"
+
+
+@dataclass
+class Action:
+    """
+    Represents an action to perform on a block or entity.
+    """
+
+    action_type: ActionType
+    position: Vec3
+    face: Optional[int] = None  # Block face (0-5) for building
+    block_id: Optional[int] = None  # Block ID for building
+
+    @classmethod
+    def dig(cls, position: Vec3) -> "Action":
+        """Create a dig action."""
+        return cls(ActionType.DIG, position)
+
+    @classmethod
+    def build(cls, position: Vec3, block_id: int, face: int) -> "Action":
+        """Create a build action."""
+        return cls(ActionType.BUILD, position, face, block_id)
+
+    @classmethod
+    def use_item(cls, position: Vec3) -> "Action":
+        """Create a use item action."""
+        return cls(ActionType.USE_ITEM, position)
+
+    @classmethod
+    def attack(cls, position: Vec3) -> "Action":
+        """Create an attack action."""
+        return cls(ActionType.ATTACK, position)

mineflex/auth/__init__.py

@@ -0,0 +1,3 @@
+"""Authentication subsystem - offline and Microsoft auth."""
+
+from __future__ import annotations