mcapibridge 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

mc/minecraft.py

@@ -41,8 +41,10 @@ class BlockHit:
         self.pos = Vec3(x, y, z)
         self.face = face
         self.entityId = entityId
-        self.action = action # 1=Left,2=Right
-        self.type = "RIGHT_CLICK" if action == 2 else "LEFT_CLICK"
+        self.action = action # 1=Left,2=Right,101-105:Keyboard Action
+        if action == 1: self.type = "LEFT_CLICK"
+        elif action == 2: self.type = "RIGHT_CLICK"
+        elif action > 100: self.type = f"KEY_MACRO_{action - 100}"
 
 class Minecraft:
     def __init__(self, host="localhost", port=4711):
@@ -340,3 +342,14 @@ class Minecraft:
         cmd = f"world.setSign({int(x)},{int(y)},{int(z)},{l1},{l2},{l3},{l4})"
         if dimension: cmd += f",{dimension}"
         self._send(cmd)
+
+    def lookAt(self, target, x, y, z):
+        self._send(f"player.lookAt({target},{x},{y},{z})")
+        
+    def setEntityNbt(self, entity_id, nbt_string):
+        self._send(f"entity.setNbt({entity_id},{nbt_string})")
+
+    def setBlockNbt(self, x, y, z, nbt_string, dimension=None):
+        cmd = f"block.setNbt({int(x)},{int(y)},{int(z)},{nbt_string})"
+        if dimension: cmd += f",{dimension}"
+        self._send(cmd)

{mcapibridge-0.1.1.dist-info → mcapibridge-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcapibridge
-Version: 0.1.1
+Version: 0.1.3
 Summary: Python libary for MCAPIBridge
 Author: TaotianZhufang
 License: MIT License
@@ -127,13 +127,31 @@ Sets the text on a sign block.
 
 **The block at the position must already be a sign.**
 
+#### `lookAt(target, x, y, z)`
+Forces a player or entity to look at a specific coordinate.
+*   **target**: String player name or Entity ID.
+*   **x, y, z**: The coordinate to look at.
+*   *Example*: `mc.lookAt("Steve", 0, 100, 0)` forces Steve to look up.
+
+#### `setEntityNbt(entity_id, nbt_string)`
+Modifies the NBT data of an entity directly using JSON format.
+*   **entity_id**: Integer Entity ID.
+*   **nbt_string**: Valid SNBT string (e.g., `"{NoAI:1b, Glowing:1b}"`).
+*   *Note*: Useful for setting attributes like Scale in 1.20.6 (`{Attributes:[{Name:"generic.scale",Base:2.0d}]}`).
+
+#### `setBlockNbt(x, y, z, nbt_string, dimension=None)`
+Modifies the NBT data of a block entity (Tile Entity).
+*   **x, y, z**: Integer coordinates.
+*   **nbt_string**: Valid SNBT string.
+
+
 ---
 
 ### Info
 
 #### `getOnlinePlayers()`
 Get players' name online.
-*   **return**: Dict:  `[{'name': 'Steve', 'id': 123}, ...]`。
+*   **return**: Dict:  `[{'name': 'Steve', 'id': 123}, ...]`.
 
 #### `getPlayerPos(target="")`
 Get player's position and yaw and pitch.
@@ -245,7 +263,7 @@ Get click events.
 		* Double z
 	* **face**: Int click face.
 	* **entityId**: Int ID of clicking on entity.
-	* **action**: Int action type:1--left click,2--right click.(Left click event is only affected by player clicking where which can reach)
+	* **action**: Int action type:1--left click,2--right click,101-105--Keyboard pressed.(Bind keys at Minecraft settings)
 	* **type**: String action:"LEFT_CLICK" or "RIGHT_CLICK"
 
 #### `pollChatPosts()`
@@ -274,7 +292,7 @@ Represents a 3D vector/coordinate.
     *   **length()**: Returns vector length.
 
 #### `PlayerPos`
-**Inherits Vec3.**Represents player position with rotation.
+**Inherits Vec3** Represents player position with rotation.
 *   **properties**: `x`,`y`,`z`,`yaw`,`pitch`.
 *   **Methods**:
     *   **forward(distance=1.0)**: Returns a new `Vec3` position at `distance` blocks ahead of the player's view.

mcapibridge-0.1.3.dist-info/RECORD

@@ -0,0 +1,7 @@
+mc/__init__.py,sha256=6TuAOkHXMgtW0yNeyMAcVxiqRR8BTMekzrkDnNqQ93k,172
+mc/minecraft.py,sha256=YVGKatw6nfTYfK9anqPj385XjIVE9M1I1hvwThVZK3E,12573
+mcapibridge-0.1.3.dist-info/licenses/LICENSE,sha256=tg_NYNbCG6JoE2a-Y6UDqKyr7eRAVOwSsSY8IzO9Cqw,1092
+mcapibridge-0.1.3.dist-info/METADATA,sha256=3TWaffHF1zSTrup1cIMAazUyN4mhHIGQeNYkyhOQWow,9686
+mcapibridge-0.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+mcapibridge-0.1.3.dist-info/top_level.txt,sha256=mNvdbMTKH8yVJh_OZ544RPTdOb3iE8wpsosgMq2V_cM,3
+mcapibridge-0.1.3.dist-info/RECORD,,

mcapibridge-0.1.1.dist-info/RECORD

@@ -1,7 +0,0 @@
-mc/__init__.py,sha256=6TuAOkHXMgtW0yNeyMAcVxiqRR8BTMekzrkDnNqQ93k,172
-mc/minecraft.py,sha256=04hoiMjnYTjRCr9511fjiV4RoX0nuTHV05Gh3-OzlXE,12008
-mcapibridge-0.1.1.dist-info/licenses/LICENSE,sha256=tg_NYNbCG6JoE2a-Y6UDqKyr7eRAVOwSsSY8IzO9Cqw,1092
-mcapibridge-0.1.1.dist-info/METADATA,sha256=m4uSCW0K8gZRAhavBYNSUcABMawAzCaNNk8zZEkuWfc,8906
-mcapibridge-0.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-mcapibridge-0.1.1.dist-info/top_level.txt,sha256=mNvdbMTKH8yVJh_OZ544RPTdOb3iE8wpsosgMq2V_cM,3
-mcapibridge-0.1.1.dist-info/RECORD,,