py2hackCraft2 1.1.43__tar.gz → 1.1.45__tar.gz

{py2hackcraft2-1.1.43 → py2hackcraft2-1.1.45}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py2hackCraft2
-Version: 1.1.43
+Version: 1.1.45
 Summary: Python client library for hackCraft2
 Home-page: https://github.com/0x48lab/hackCraft2-python
 Author: masafumi_t

{py2hackcraft2-1.1.43 → py2hackcraft2-1.1.45}/py2hackCraft/modules.py

@@ -527,7 +527,7 @@ class Inventory:
                 item = inventory.get_item(0)
                 print(f"アイテム: {item.name}, 数量: {item.amount}")
         """
-        self.client.send_call(self.entity_uuid, "getInventoryItem", [self.location.x, self.location.y, self.location.z, slot])
+        self.client.send_call(self.entity_uuid, "getInventoryItem", [self.location.x, self.location.y, self.location.z, slot, self.location.cord])
         item_stack = ItemStack(** json.loads(self.client.result))
         return item_stack
 
@@ -567,7 +567,7 @@ class Inventory:
                 # スロット0と1のアイテムを入れ替え
                 inventory.swap_items(0, 1)
         """
-        self.client.send_call(self.entity_uuid, "swapInventoryItem", [self.location.x, self.location.y, self.location.z, slot1, slot2])
+        self.client.send_call(self.entity_uuid, "swapInventoryItem", [self.location.x, self.location.y, self.location.z, slot1, slot2, self.location.cord])
 
     def move_item(self, from_slot: int, to_slot: int):
         """
@@ -583,7 +583,7 @@ class Inventory:
                 # スロット0のアイテムをスロット5に移動
                 inventory.move_item(0, 5)
         """
-        self.client.send_call(self.entity_uuid, "moveInventoryItem", [self.location.x, self.location.y, self.location.z, from_slot, to_slot])
+        self.client.send_call(self.entity_uuid, "moveInventoryItem", [self.location.x, self.location.y, self.location.z, from_slot, to_slot, self.location.cord])
 
     def retrieve_to_self(self, from_slot: int, to_slot: int):
         """
@@ -599,7 +599,7 @@ class Inventory:
                 # チェストのスロット0のアイテムを自分のスロット5に取り出す
                 inventory.retrieve_from_self(0, 5)
         """
-        self.client.send_call(self.entity_uuid, "retrieveInventoryItem", [self.location.x, self.location.y, self.location.z, to_slot, from_slot])
+        self.client.send_call(self.entity_uuid, "retrieveInventoryItem", [self.location.x, self.location.y, self.location.z, to_slot, from_slot, self.location.cord])
 
     def store_from_self(self, from_slot: int, to_slot: int):
         """
@@ -615,7 +615,7 @@ class Inventory:
                 # 自分のスロット0のアイテムをチェストのスロット5に格納
                 inventory.store_to_self(0, 5)
         """
-        self.client.send_call(self.entity_uuid, "storeInventoryItem", [self.location.x, self.location.y, self.location.z, from_slot, to_slot])
+        self.client.send_call(self.entity_uuid, "storeInventoryItem", [self.location.x, self.location.y, self.location.z, from_slot, to_slot, self.location.cord])
 
 class Volume:
     """
@@ -1358,6 +1358,156 @@ class Entity:
         self.client.send_call(self.uuid, "digX", [0, -1, 0])
         return str_to_bool(self.client.result)
 
+    # ===== Sign Operations =====
+
+    def write_sign(self, text) -> bool:
+        """
+        自分の前方の看板にテキストを書き込む
+
+        Args:
+            text: 書き込むテキスト。文字列またはリスト（各要素が各行になる、最大4行）
+
+        Returns:
+            bool: 操作が成功した場合はTrue、失敗した場合はFalse
+
+        Examples:
+            文字列で書き込む::
+
+                entity.write_sign("Hello World")
+
+            複数行を書き込む::
+
+                entity.write_sign(["1行目", "2行目", "3行目", "4行目"])
+        """
+        if isinstance(text, list):
+            text = '\n'.join(str(line) for line in text[:4])
+        self.client.send_call(self.uuid, "setSign", [str(text), "front"])
+        return str_to_bool(self.client.result)
+
+    def write_sign_up(self, text) -> bool:
+        """
+        自分の真上の看板にテキストを書き込む
+
+        Args:
+            text: 書き込むテキスト。文字列またはリスト（各要素が各行になる、最大4行）
+
+        Returns:
+            bool: 操作が成功した場合はTrue、失敗した場合はFalse
+        """
+        if isinstance(text, list):
+            text = '\n'.join(str(line) for line in text[:4])
+        self.client.send_call(self.uuid, "setSign", [str(text), "up"])
+        return str_to_bool(self.client.result)
+
+    def write_sign_down(self, text) -> bool:
+        """
+        自分の真下の看板にテキストを書き込む
+
+        Args:
+            text: 書き込むテキスト。文字列またはリスト（各要素が各行になる、最大4行）
+
+        Returns:
+            bool: 操作が成功した場合はTrue、失敗した場合はFalse
+        """
+        if isinstance(text, list):
+            text = '\n'.join(str(line) for line in text[:4])
+        self.client.send_call(self.uuid, "setSign", [str(text), "down"])
+        return str_to_bool(self.client.result)
+
+    def write_sign_at(self, loc: Location, text) -> bool:
+        """
+        指定した座標の看板にテキストを書き込む
+
+        Args:
+            loc (Location): 座標情報（LocationFactory.absolute/relative/localで生成）
+            text: 書き込むテキスト。文字列またはリスト（各要素が各行になる、最大4行）
+
+        Returns:
+            bool: 操作が成功した場合はTrue、失敗した場合はFalse
+
+        Examples:
+            相対座標で指定::
+
+                loc = LocationFactory.relative(0, 1, 0)  # 1ブロック上
+                entity.write_sign_at(loc, "相対座標のメッセージ")
+
+            ローカル座標で指定::
+
+                loc = LocationFactory.local(0, 0, 1)  # 前方1ブロック
+                entity.write_sign_at(loc, "ローカル座標のメッセージ")
+
+            複数行を書き込む::
+
+                loc = LocationFactory.local(0, 0, 1)
+                entity.write_sign_at(loc, ["1行目", "2行目", "3行目"])
+        """
+        if isinstance(text, list):
+            text = '\n'.join(str(line) for line in text[:4])
+        self.client.send_call(self.uuid, "setSignX", [str(text), loc.x, loc.y, loc.z, loc.cord])
+        return str_to_bool(self.client.result)
+
+    def read_sign(self) -> str:
+        """
+        自分の前方の看板のテキストを読み取る
+
+        Returns:
+            str: 看板のテキスト（複数行の場合は改行で区切られた文字列）、看板がない場合は空文字列
+
+        Examples:
+            テキストを読み取る::
+
+                text = entity.read_sign()
+                print(text)  # "1行目\\n2行目\\n..."
+        """
+        self.client.send_call(self.uuid, "getSign", ["front"])
+        return self.client.result if self.client.result else ""
+
+    def read_sign_up(self) -> str:
+        """
+        自分の真上の看板のテキストを読み取る
+
+        Returns:
+            str: 看板のテキスト（複数行の場合は改行で区切られた文字列）、看板がない場合は空文字列
+        """
+        self.client.send_call(self.uuid, "getSign", ["up"])
+        return self.client.result if self.client.result else ""
+
+    def read_sign_down(self) -> str:
+        """
+        自分の真下の看板のテキストを読み取る
+
+        Returns:
+            str: 看板のテキスト（複数行の場合は改行で区切られた文字列）、看板がない場合は空文字列
+        """
+        self.client.send_call(self.uuid, "getSign", ["down"])
+        return self.client.result if self.client.result else ""
+
+    def read_sign_at(self, loc: Location) -> str:
+        """
+        指定した座標の看板のテキストを読み取る
+
+        Args:
+            loc (Location): 座標情報（LocationFactory.absolute/relative/localで生成）
+
+        Returns:
+            str: 看板のテキスト（複数行の場合は改行で区切られた文字列）、看板がない場合は空文字列
+
+        Examples:
+            相対座標で指定::
+
+                loc = LocationFactory.relative(0, 1, 0)  # 1ブロック上
+                text = entity.read_sign_at(loc)
+
+            ローカル座標で指定::
+
+                loc = LocationFactory.local(0, 0, 1)  # 前方1ブロック
+                text = entity.read_sign_at(loc)
+        """
+        self.client.send_call(self.uuid, "getSignX", [loc.x, loc.y, loc.z, loc.cord])
+        return self.client.result if self.client.result else ""
+
+    # ===== End Sign Operations =====
+
     def attack(self) -> bool:
         """
         自分の前方を攻撃する
@@ -2126,7 +2276,7 @@ class Entity:
     def livestock_herd(self, animal_uuid: str, x: float, y: float, z: float, cord: str = "^", speed: float = 1.0) -> None:
         """
         動物を指定座標に誘導
-        
+
         Args:
             animal_uuid (str): 動物のUUID
             x (float): 目標X座標
@@ -2134,11 +2284,11 @@ class Entity:
             z (float): 目標Z座標
             cord (str): 座標系（"": 絶対座標, "~": 相対座標, "^": ローカル座標、デフォルト: "^"）
             speed (float): 移動速度（0.5-2.0、デフォルト1.0）
-            
+
         Example:
             >>> entity.livestock_herd(cow_uuid, 100, 64, 200, "^", 1.0)
         """
-        self.client.send_call(animal_uuid, "livestockHerd", [x, y, z, cord, speed])
+        self.client.send_call(self.uuid, "livestockHerd", [animal_uuid, x, y, z, cord, speed])
         result = json.loads(self.client.result)
         if not result.get('success', False):
             raise Exception(f"Herd operation failed: {result.get('message', 'Unknown error')}")
@@ -2198,7 +2348,7 @@ class Entity:
             >>> except Exception as e:
             >>>     print(f"Cannot shear: {e}")
         """
-        self.client.send_call(sheep_uuid, "livestockShear", [])
+        self.client.send_call(self.uuid, "livestockShear", [sheep_uuid])
         result = json.loads(self.client.result)
         if not result.get('success', False):
             raise Exception(f"Shear operation failed: {result.get('message', 'Unknown error')}")
@@ -2224,7 +2374,7 @@ class Entity:
             >>> except Exception as e:
             >>>     print(f"Cannot milk: {e}")
         """
-        self.client.send_call(cow_uuid, "livestockMilk", [])
+        self.client.send_call(self.uuid, "livestockMilk", [cow_uuid])
         result = json.loads(self.client.result)
         if not result.get('success', False):
             raise Exception(f"Milk operation failed: {result.get('message', 'Unknown error')}")
@@ -2241,7 +2391,7 @@ class Entity:
         Example:
             >>> entity.livestock_feed(cow_uuid, "wheat")
         """
-        self.client.send_call(animal_uuid, "livestockFeed", [food_type])
+        self.client.send_call(self.uuid, "livestockFeed", [animal_uuid, food_type])
         result = json.loads(self.client.result)
         if not result.get('success', False):
             raise Exception(f"Feed operation failed: {result.get('message', 'Unknown error')}")
@@ -2261,7 +2411,7 @@ class Entity:
             >>> print(f"Health: {info['health']}/{info['maxHealth']}")
             >>> print(f"Can breed: {info['canBreed']}")
         """
-        self.client.send_call(animal_uuid, "livestockInfo", [])
+        self.client.send_call(self.uuid, "livestockInfo", [animal_uuid])
         result = json.loads(self.client.result)
         if not result.get('success', False):
             raise Exception(f"Get info operation failed: {result.get('message', 'Unknown error')}")

{py2hackcraft2-1.1.43 → py2hackcraft2-1.1.45}/py2hackCraft2.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py2hackCraft2
-Version: 1.1.43
+Version: 1.1.45
 Summary: Python client library for hackCraft2
 Home-page: https://github.com/0x48lab/hackCraft2-python
 Author: masafumi_t

{py2hackcraft2-1.1.43 → py2hackcraft2-1.1.45}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="py2hackCraft2",
-    version="1.1.43",
+    version="v1.1.45",
     packages=find_packages(),
     install_requires=[
         "websocket-client>=1.6.0",