mcapibridge 0.1.1__tar.gz → 0.1.3__tar.gz

{mcapibridge-0.1.1 → mcapibridge-0.1.3}/PKG-INFO

@@ -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.1 → mcapibridge-0.1.3}/README.MD

@@ -1,248 +1,266 @@
-# MCAPIBridge Python Libary
-
-MCAPIBridge is a mod for Minecraft loaded with Fabric.This libary offers some ways to connect Minecraft with this mod in Python.
-
-## QuickStart
-
-### Install
-Ensure your mod loaded.
-
-Use pip to install this.
-```
-pip install mcapibridge
-```
-This is a simple example to connect.
-```
-from mc import Minecraft
-import time
-
-# Default ip is localhost and port is 4711
-# You can use mc = Minecraft(host=YOURIP,port=YOURPORT) to change
-mc = Minecraft()
-
-# Show a message
-mc.postToChat("§aHello, Minecraft! Python is here.")
-```
-
----
-
-## Usage
-
-### Basic
-
-#### `postToChat(msg)`
-Send a message to chat screen.
-*   **msg**: String message.Support `§` .You can check it on Minecraft wiki.
-
-#### `runCommand(cmd)`
-Run commands as Server.
-*   **cmd**: Srting command without '/'
-
-Ex: `mc.runCommand("time set day")`
-
----
-
-### World
-
-#### `setBlock(x, y, z, block_id, dimension=None)`
-Set a block at the point given.
-*   **x, y, z**: Int positions.
-*   **block_id**: String ID.If it is Minecraft vanilla,the ID can be written without `Minecraft:`. Ex:`"stone"`, `"diamond_block"`.Support other namespaces.
-*	**dimension**: Optional String target dimension/player name.
-
-#### `getBlock(x, y, z, dimension=None)`
-Gets the block ID at the specified coordinates.
-*   **x, y, z**: Int positions.
-*   **dimension**: Optional String target dimension/player name.
-*   **return**: String block ID.Ex.`"minecraft:grass_block"`.
-
-#### `spawnEntity(x, y, z, entity_id, yaw=0.0, pitch=0.0, dimension=None)`
-Spawn an entity at the point given.
-*   **entity_id**: String ID.If it is Minecraft vanilla,the ID can be written without `Minecraft:`. Ex:`"zombie"`, `"pig"`, `"lightning_bolt"`.Support other namespaces.
-*   **yaw**: Optional Int degree.Horizontal degree.
-*   **pitch**: Optional Int degree.Vertical degree.
-*   **dimension**: Optional String target dimension/player name.
-
-#### `setEntityVelocity(entity_id, vx, vy, vz)`
-Sets the velocity of an entity.
-*   **entity_id**: Int ID.
-*   **vx, vy, vz**: Double velocity components.
-
-#### `setEntityNoGravity(entity_id, enable=True)`
-Enables or disables gravity for an entity.
-*   **entity_id**: Int ID.
-
-#### `getEntities(x, y, z, radius=10, dimension=None)`
-Gets the block ID at the specified coordinates.
-*   **x, y, z**: Double positions.
-*   **radius**: Double search radius.
-*   **dimension**: Optional String target dimension/player name.
-*   **return**: List of Dicts: [{'id': 123, 'type': 'minecraft:zombie', 'pos': Vec3}, ...]
-
-#### `spawnParticle(x, y, z, particle_id, count=10, dx=0.0, dy=0.0, dz=0.0, speed=0.0, dimension=None)`
-Spawn particle at the point given.
-*   **particle_id**: String ID.If it is Minecraft vanilla,the ID can be written without `Minecraft:`. Ex:`"flame"`, `"heart"`.Support other namespaces.
-*   **count**: Int count.
-*   **dx, dy, dz**: Optional double diffusion ranges.(when count=0, it represents the direction vector)
-*   **speed**: Optional double speed.
-*   **dimension**: Optional String target dimension/player name.
-
-#### `setSign(x, y, z, line1="", line2="", line3="", line4="", dimension=None)`
-Sets the text on a sign block.
-*   **x, y, z**: Int positions.
-*   **line1-4**: String text for each line.
-*   **dimension**: Optional String target dimension/player name.
-
-**The block at the position must already be a sign.**
-
----
-
-### Info
-
-#### `getOnlinePlayers()`
-Get players' name online.
-*   **return**: Dict:  `[{'name': 'Steve', 'id': 123}, ...]`。
-
-#### `getPlayerPos(target="")`
-Get player's position and yaw and pitch.
-*   **target**: String player name.
-*   **return**: Int x,y,z and Double yaw,pitch.
-
-#### `getPlayerEntityId(name)`
-Get player's ID.
-*   **name**: String player name.
-*   **return**: Int ID.
-
-#### `getPlayerName(entity_id)`
-Get player's ID.
-*   **entity_id**: Int ID.
-*   **return**: String player name.
-
-#### `getPlayerDetails(target="")`
-Get player's details.
-*   **target**: String player name.
-*   **return**: Dict including
-    *   `name`: String player name
-    *   `id`: Int ID
-    *   `mode`: String gamemode
-    *   `health`: Double health
-    *   `max_health`: Double max health
-    *   `food`: Int food
-    *   `held_item`: String item held
-    *   `held_count`: Int item held count
-
----
-
-### State
-
-#### `setHealth(target, amount)`
-Set player's health.
-*   **target**: String player name.
-*   **amount**: Double health.
-
-#### `setFood(target, amount)`
-Set player's food.
-*   **target**: String player name.
-*   **amount**: Int food(0-20).
-
-#### `giveEffect(target, effect_name, duration_sec=30, amplifier=1)`
-Effect player.
-*   **effect_name**: String effect ID.Ex:`"speed"`,`"night_vision"`.
-*   **duration_sec**: Int seconds.
-*   **amplifier**: Int amplifier.
-
-#### `setFlying(target, allow_flight=True, is_flying=True)`
-Enable player to fly in survival mode.
-*   **target**: String player name.
-
-#### `setFlySpeed(target, speed=0.05)`
-Set flight speed.
-*   **target**: String player name.
-*   **speed**: Double speed.Default 0.05.
-
-#### `setWalkSpeed(target, speed=0.1)`
-Set walk speed.
-*   **target**: String player name.
-*   **speed**: Double speed.Default 0.1.
-
-#### `setGodMode(target, enable=True)`
-Enable invulnerability.
-*   **target**: String player name.
-
----
-
-### Inventory
-
-#### `getInventory(target="")`
-Get player's inventory.
-*   **return**: List of Dicts.Every dict has `{'slot': block_ID, 'id': item_ID, 'count': item_count}`.
-
-#### `give(target, item_id, count=1)`
-Give player item.
-*   **item_id**: String item ID.
-*   **count**: Int count.
-
-#### `clearInventory(target, item_id="")`
-Clear inventory.
-*   **target**: String player name.
-*   **item_id**: String item ID.
-
----
-
-### TP
-
-#### `teleport(x, y, z, target="")`
-TP player.
-*   **x, y, z**: Int target x,y,z.
-*   **target**: String player ID.
-
-#### `teleportEntity(entity_id, x, y, z)`
-TP entitie.
-*   **entity_id**: Int entity id.
-
----
-
-### Events
-
-#### `pollBlockHits()`
-Get click events.
-*   **return**: List Class `[BlockHit1,BlockHit2,.....]`
-    * **pos**: Class Vec3
-		* Double x
-		* Double y
-		* 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)
-	* **type**: String action:"LEFT_CLICK" or "RIGHT_CLICK"
-
-#### `pollChatPosts()`
-Get player message events.
-*   **return**: List Class `[ChatPost1,ChatPost2,.....]`
-	* **name**: String player name.
-	* **message**: String message.
-
----
-
-### Helper Methods
-
-#### `getDirectionVector(target="")`
-Calculates the direction vector based on a player's rotation. Useful for shooting projectiles.
-*   **target**: String player ID.
-*   **return**: Class `Vec3` normalized direction vector.
-
----
-
-### Helper Classes
-
-#### `Vec3`
-Represents a 3D vector/coordinate.
-*   **properties**: `x`,`y`,`z`.
-*   **Methods**:
-    *   **length()**: Returns vector length.
-
-#### `PlayerPos`
-**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 Python Libary
+
+MCAPIBridge is a mod for Minecraft loaded with Fabric.This libary offers some ways to connect Minecraft with this mod in Python.
+
+## QuickStart
+
+### Install
+Ensure your mod loaded.
+
+Use pip to install this.
+```
+pip install mcapibridge
+```
+This is a simple example to connect.
+```
+from mc import Minecraft
+import time
+
+# Default ip is localhost and port is 4711
+# You can use mc = Minecraft(host=YOURIP,port=YOURPORT) to change
+mc = Minecraft()
+
+# Show a message
+mc.postToChat("§aHello, Minecraft! Python is here.")
+```
+
+---
+
+## Usage
+
+### Basic
+
+#### `postToChat(msg)`
+Send a message to chat screen.
+*   **msg**: String message.Support `§` .You can check it on Minecraft wiki.
+
+#### `runCommand(cmd)`
+Run commands as Server.
+*   **cmd**: Srting command without '/'
+
+Ex: `mc.runCommand("time set day")`
+
+---
+
+### World
+
+#### `setBlock(x, y, z, block_id, dimension=None)`
+Set a block at the point given.
+*   **x, y, z**: Int positions.
+*   **block_id**: String ID.If it is Minecraft vanilla,the ID can be written without `Minecraft:`. Ex:`"stone"`, `"diamond_block"`.Support other namespaces.
+*	**dimension**: Optional String target dimension/player name.
+
+#### `getBlock(x, y, z, dimension=None)`
+Gets the block ID at the specified coordinates.
+*   **x, y, z**: Int positions.
+*   **dimension**: Optional String target dimension/player name.
+*   **return**: String block ID.Ex.`"minecraft:grass_block"`.
+
+#### `spawnEntity(x, y, z, entity_id, yaw=0.0, pitch=0.0, dimension=None)`
+Spawn an entity at the point given.
+*   **entity_id**: String ID.If it is Minecraft vanilla,the ID can be written without `Minecraft:`. Ex:`"zombie"`, `"pig"`, `"lightning_bolt"`.Support other namespaces.
+*   **yaw**: Optional Int degree.Horizontal degree.
+*   **pitch**: Optional Int degree.Vertical degree.
+*   **dimension**: Optional String target dimension/player name.
+
+#### `setEntityVelocity(entity_id, vx, vy, vz)`
+Sets the velocity of an entity.
+*   **entity_id**: Int ID.
+*   **vx, vy, vz**: Double velocity components.
+
+#### `setEntityNoGravity(entity_id, enable=True)`
+Enables or disables gravity for an entity.
+*   **entity_id**: Int ID.
+
+#### `getEntities(x, y, z, radius=10, dimension=None)`
+Gets the block ID at the specified coordinates.
+*   **x, y, z**: Double positions.
+*   **radius**: Double search radius.
+*   **dimension**: Optional String target dimension/player name.
+*   **return**: List of Dicts: [{'id': 123, 'type': 'minecraft:zombie', 'pos': Vec3}, ...]
+
+#### `spawnParticle(x, y, z, particle_id, count=10, dx=0.0, dy=0.0, dz=0.0, speed=0.0, dimension=None)`
+Spawn particle at the point given.
+*   **particle_id**: String ID.If it is Minecraft vanilla,the ID can be written without `Minecraft:`. Ex:`"flame"`, `"heart"`.Support other namespaces.
+*   **count**: Int count.
+*   **dx, dy, dz**: Optional double diffusion ranges.(when count=0, it represents the direction vector)
+*   **speed**: Optional double speed.
+*   **dimension**: Optional String target dimension/player name.
+
+#### `setSign(x, y, z, line1="", line2="", line3="", line4="", dimension=None)`
+Sets the text on a sign block.
+*   **x, y, z**: Int positions.
+*   **line1-4**: String text for each line.
+*   **dimension**: Optional String target dimension/player name.
+
+**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}, ...]`.
+
+#### `getPlayerPos(target="")`
+Get player's position and yaw and pitch.
+*   **target**: String player name.
+*   **return**: Int x,y,z and Double yaw,pitch.
+
+#### `getPlayerEntityId(name)`
+Get player's ID.
+*   **name**: String player name.
+*   **return**: Int ID.
+
+#### `getPlayerName(entity_id)`
+Get player's ID.
+*   **entity_id**: Int ID.
+*   **return**: String player name.
+
+#### `getPlayerDetails(target="")`
+Get player's details.
+*   **target**: String player name.
+*   **return**: Dict including
+    *   `name`: String player name
+    *   `id`: Int ID
+    *   `mode`: String gamemode
+    *   `health`: Double health
+    *   `max_health`: Double max health
+    *   `food`: Int food
+    *   `held_item`: String item held
+    *   `held_count`: Int item held count
+
+---
+
+### State
+
+#### `setHealth(target, amount)`
+Set player's health.
+*   **target**: String player name.
+*   **amount**: Double health.
+
+#### `setFood(target, amount)`
+Set player's food.
+*   **target**: String player name.
+*   **amount**: Int food(0-20).
+
+#### `giveEffect(target, effect_name, duration_sec=30, amplifier=1)`
+Effect player.
+*   **effect_name**: String effect ID.Ex:`"speed"`,`"night_vision"`.
+*   **duration_sec**: Int seconds.
+*   **amplifier**: Int amplifier.
+
+#### `setFlying(target, allow_flight=True, is_flying=True)`
+Enable player to fly in survival mode.
+*   **target**: String player name.
+
+#### `setFlySpeed(target, speed=0.05)`
+Set flight speed.
+*   **target**: String player name.
+*   **speed**: Double speed.Default 0.05.
+
+#### `setWalkSpeed(target, speed=0.1)`
+Set walk speed.
+*   **target**: String player name.
+*   **speed**: Double speed.Default 0.1.
+
+#### `setGodMode(target, enable=True)`
+Enable invulnerability.
+*   **target**: String player name.
+
+---
+
+### Inventory
+
+#### `getInventory(target="")`
+Get player's inventory.
+*   **return**: List of Dicts.Every dict has `{'slot': block_ID, 'id': item_ID, 'count': item_count}`.
+
+#### `give(target, item_id, count=1)`
+Give player item.
+*   **item_id**: String item ID.
+*   **count**: Int count.
+
+#### `clearInventory(target, item_id="")`
+Clear inventory.
+*   **target**: String player name.
+*   **item_id**: String item ID.
+
+---
+
+### TP
+
+#### `teleport(x, y, z, target="")`
+TP player.
+*   **x, y, z**: Int target x,y,z.
+*   **target**: String player ID.
+
+#### `teleportEntity(entity_id, x, y, z)`
+TP entitie.
+*   **entity_id**: Int entity id.
+
+---
+
+### Events
+
+#### `pollBlockHits()`
+Get click events.
+*   **return**: List Class `[BlockHit1,BlockHit2,.....]`
+    * **pos**: Class Vec3
+		* Double x
+		* Double y
+		* Double z
+	* **face**: Int click face.
+	* **entityId**: Int ID of clicking on entity.
+	* **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()`
+Get player message events.
+*   **return**: List Class `[ChatPost1,ChatPost2,.....]`
+	* **name**: String player name.
+	* **message**: String message.
+
+---
+
+### Helper Methods
+
+#### `getDirectionVector(target="")`
+Calculates the direction vector based on a player's rotation. Useful for shooting projectiles.
+*   **target**: String player ID.
+*   **return**: Class `Vec3` normalized direction vector.
+
+---
+
+### Helper Classes
+
+#### `Vec3`
+Represents a 3D vector/coordinate.
+*   **properties**: `x`,`y`,`z`.
+*   **Methods**:
+    *   **length()**: Returns vector length.
+
+#### `PlayerPos`
+**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.1 → mcapibridge-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mcapibridge"
-version = "0.1.1"
+version = "0.1.3"
 description = "Python libary for MCAPIBridge"
 requires-python = ">=3.7"
 license = { file = "LICENSE" }

{mcapibridge-0.1.1 → mcapibridge-0.1.3}/src/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 → mcapibridge-0.1.3}/src/mcapibridge.egg-info/PKG-INFO

@@ -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.