pumpkin-api-py 0.1.0.dev2__py3-none-any.whl → 0.1.0.dev3__py3-none-any.whl

pumpkin_api/wit/common.wit

@@ -67,6 +67,20 @@ interface common {
         count: u8,
     }
 
+    /// Represents the type of click interaction in a GUI.
+    enum click-type {
+        left,
+        right,
+        shift-left,
+        shift-right,
+        middle,
+        drop,
+        control-drop,
+        double-click,
+        number-key,
+        unknown,
+    }
+
     /// Represents the various poses an entity can be in.
     enum entity-pose {
         standing,

pumpkin_api/wit/event.wit

@@ -1,5 +1,5 @@
 interface event {
-    use common.{block-position, game-mode, hand, item-stack, position};
+    use common.{block-position, game-mode, hand, item-stack, position, click-type};
     use player.{player};
     use text.{text-component};
     use %world.{%world};
@@ -179,6 +179,23 @@ interface event {
         cancelled: bool
     }
 
+    record inventory-click-event-data {
+        player: player,
+        window-type: option<string>,
+        click-type: click-type,
+        slot: s16,
+        raw-slot: s16,
+        clicked-item: option<item-stack>,
+        cursor: option<item-stack>,
+        hotbar-button: s32,
+        cancelled: bool
+    }
+
+    record inventory-close-event-data {
+        player: player,
+        window-type: option<string>
+    }
+
     record block-redstone-event-data {
         target-world: %world,
         state-id: u16,
@@ -272,6 +289,8 @@ interface event {
         player-toggle-sneak-event,
         player-toggle-flight-event,
         player-toggle-sprint-event,
+        inventory-click-event,
+        inventory-close-event,
         block-redstone-event,
         block-break-event,
         block-burn-event,
@@ -305,6 +324,8 @@ interface event {
         player-toggle-sneak-event(player-toggle-sneak-event-data),
         player-toggle-flight-event(player-toggle-flight-event-data),
         player-toggle-sprint-event(player-toggle-sprint-event-data),
+        inventory-click-event(inventory-click-event-data),
+        inventory-close-event(inventory-close-event-data),
         block-redstone-event(block-redstone-event-data),
         block-break-event(block-break-event-data),
         block-burn-event(block-burn-event-data),

pumpkin_api/wit/gui.wit

@@ -1,6 +1,6 @@
 interface gui {
     use text.{text-component};
-    use common.{item-stack};
+    use common.{item-stack, click-type};
 
     enum gui-type {
         generic-9x1,
@@ -46,5 +46,17 @@ interface gui {
         
         /// Clears all items from the GUI.
         clear-items: func();
+
+        /// Sets whether players can grab items out of the inventory.
+        set-allow-grab-items: func(allow: bool);
+
+        /// Returns whether players can grab items out of the inventory.
+        get-allow-grab-items: func() -> bool;
+
+        /// Sets whether players can put items into the inventory from their own.
+        set-allow-put-items: func(allow: bool);
+
+        /// Returns whether players can put items into the inventory from their own.
+        get-allow-put-items: func() -> bool;
     }
 }

pumpkin_api/wit/player.wit

@@ -25,6 +25,25 @@ interface player {
         walk-speed:         f32,
     }
 
+    /// Represents a player's skin textures and metadata.
+    record player-skin {
+        /// The base64-encoded texture data (usually JSON containing skin/cape URLs).
+        value: string,
+        /// The optional signature for the texture data.
+        signature: option<string>,
+    }
+
+    /// Flags representing visible skin parts.
+    flags skin-parts {
+        cape,
+        jacket,
+        left-sleeve,
+        right-sleeve,
+        left-pants-leg,
+        right-pants-leg,
+        hat,
+    }
+
     /// A handle to a player on the server.
     resource player {
         /// Returns the player as an entity.
@@ -59,6 +78,12 @@ interface player {
         get-permission-level: func () -> permission-level;
         /// Sets the player's permission level.
         set-permission-level: func (level: permission-level);
+        /// Grants or denies a specific permission node for the player.
+	    set-permission: func(node: string, value: bool);
+	    /// Removes an explicitly set permission node from the player.
+	    unset-permission: func(node: string);
+        /// Returns `Some(true)` if granted, `Some(false)` if denied, or `None` if not set.
+        has-permission-set: func (node: string) -> option<bool>;
         /// Checks if the player has a specific permission node.
         has-permission: func (node: string) -> bool;
         /// Returns the player's display name, which may include formatting.
@@ -162,16 +187,6 @@ interface player {
         /// Adds experience points to the player.
         add-experience-points:   func(points: s32);
 
-        /// Returns whether the player is currently sneaking.
-        is-sneaking:  func() -> bool;
-        /// Sets whether the player is currently sneaking.
-        set-sneaking: func(sneaking: bool);
-        /// Returns whether the player is currently sprinting.
-        is-sprinting: func() -> bool;
-        /// Sets whether the player is currently sprinting.
-        set-sprinting: func(sprinting: bool);
-        /// Returns whether the player is currently on the ground.
-        is-on-ground: func() -> bool;
         /// Returns whether the player is currently flying.
         is-flying:    func() -> bool;
         /// Sets whether the player should be flying.
@@ -184,5 +199,13 @@ interface player {
 
         /// Returns the player's IP address.
         get-ip: func() -> string;
+
+        /// Returns the player's current skin textures.
+        get-skin: func() -> option<player-skin>;
+
+        /// Returns the currently visible skin parts.
+        get-skin-parts: func() -> skin-parts;
+        /// Sets which skin parts are visible.
+        set-skin-parts: func(parts: skin-parts);
     }
 }

pumpkin_api/wit/server.wit

@@ -16,6 +16,18 @@ interface server {
         hard,
     }
 
+    /// Represents the three main Minecraft dimensions.
+    enum dimension {
+        overworld,
+        nether,
+        end,
+    }
+
+    variant command-sender {
+        console,
+        player(player),
+    }
+
     /// Represents the global server instance.
     resource server {
         /// Returns the current difficulty level of the server.
@@ -47,6 +59,12 @@ interface server {
         /// Gets a world by its dimension name (e.g., "minecraft:overworld").
         get-world-by-name: func(name: string) -> option<%world>;
 
+        execute-command: func(command: string, sender: command-sender);
+
+        /// Creates or loads a world by its name and dimension.
+        /// If a world with the given name already exists, it will be returned.
+        create-world: func(name: string, dimension: dimension) -> %world;
+
         /// Broadcasts a system chat message to all players.
         broadcast: func(message: string);
 

pumpkin_api/wit/world.wit

@@ -114,10 +114,27 @@ interface %world {
         get-head-yaw: func() -> f32;
 
         is-on-ground: func() -> bool;
+        
         is-sneaking: func() -> bool;
+        set-sneaking: func(sneaking: bool);
+        
         is-sprinting: func() -> bool;
+        set-sprinting: func(sprinting: bool);
+        
+        is-swimming: func() -> bool;
+        set-swimming: func(swimming: bool);
+        
         is-invisible: func() -> bool;
+        set-invisible: func(invisible: bool);
+        
         is-glowing: func() -> bool;
+        set-glowing: func(glowing: bool);
+        
+        is-fall-flying: func() -> bool;
+        set-fall-flying: func(fall-flying: bool);
+        
+        is-on-fire: func() -> bool;
+        set-on-fire: func(on-fire: bool);
 
         teleport: func(pos: position, world-ref: %world);
         set-velocity: func(velocity: position);
@@ -137,6 +154,27 @@ interface %world {
         set-fire-ticks: func(ticks: s32);
 
         remove: func();
+
+        /// Performs a raycast from the entity's eye position in its looking direction.
+        raycast: func(max-distance: f64, fluid-handling: bool) -> option<raycast-result>;
+    }
+
+    /// Result of a raycast operation.
+    record raycast-result {
+        /// The block position that was hit.
+        pos: block-pos,
+        /// The face of the block that was hit.
+        face: block-direction,
+    }
+
+    /// Represents a cardinal direction or block face.
+    enum block-direction {
+        down,
+        up,
+        north,
+        south,
+        west,
+        east,
     }
 
     /// Represents a Minecraft world (dimension).

{pumpkin_api_py-0.1.0.dev2.dist-info → pumpkin_api_py-0.1.0.dev3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pumpkin-api-py
-Version: 0.1.0.dev2
+Version: 0.1.0.dev3
 Summary: Pumpkin plugin API for Python
 Author: alex
 License-Expression: GPL-3.0-only

{pumpkin_api_py-0.1.0.dev2.dist-info → pumpkin_api_py-0.1.0.dev3.dist-info}/RECORD

@@ -4,22 +4,22 @@ pumpkin_api/impl.py,sha256=aSNUbwT85Pj3kQ_VkC0z9g4UjU-NVlJvZKHe0l3ms8I,7235
 pumpkin_api/wit/block-entity.wit,sha256=UtPgcxtaOL50-mV3rskGYlSVoy0Q9SvqO02lGHXzF0U,1349
 pumpkin_api/wit/boss-bar.wit,sha256=Th8NF4JrCQJxe57D9eBGm-aTxd05kBquAYc_VueXmmo,2625
 pumpkin_api/wit/command.wit,sha256=KmWN6VSxNUz21CAruQfUtpc0HHOIe6ESvDdR5p_mTBs,4659
-pumpkin_api/wit/common.wit,sha256=HB1OSpeThyQuMbewJRXR14axUt09Vi1-CdN0O2Kry7Y,4007
+pumpkin_api/wit/common.wit,sha256=ZhwWoQQqhf_Is99uLA2dgHye4qitq6G3xVr0vGV86m0,4276
 pumpkin_api/wit/context.wit,sha256=-cFh8YUsXzfSDq26nIesYm4mjzPbtSh5jrpn_djScv8,1388
 pumpkin_api/wit/entity.wit,sha256=OwmIfY-_6VkwD5beRAo_OMa7ig_XbS0a72qpblC91P4,46
-pumpkin_api/wit/event.wit,sha256=vwTl7LKwVU1JQyoZxC3N118_Mo_T0KzF3I9AN-voCTg,8397
-pumpkin_api/wit/gui.wit,sha256=hfWrQ2HouHeqwANqWOXdbos4GJOwKeU321IfDk7WpSY,1153
+pumpkin_api/wit/event.wit,sha256=gHE_pB7v6Wy5ZPCAo9gntqhn00flQEavyPtm_W2njhI,9008
+pumpkin_api/wit/gui.wit,sha256=u1J3JizHnHggLapRfylzX_VIobZto7aW8NKslU4E9gQ,1667
 pumpkin_api/wit/i18n.wit,sha256=eAeFkI2N-5MG4cc_-g0-mpOsX1BzF6clAZ603PvWweg,758
 pumpkin_api/wit/log.wit,sha256=h7j6AO9uUKcWVC70j6GLC3vQXuy-CcICRqfIDmtXg0o,309
 pumpkin_api/wit/metadata.wit,sha256=nezu18ck20EnJ-m199-9u7Xh5ohleU_q6WD0J6M4Go8,487
 pumpkin_api/wit/permission.wit,sha256=3LLdPwL0TcKvfp28ZFthdFOtXWKJgf0d1aEO95UM0b4,1653
-pumpkin_api/wit/player.wit,sha256=ElORRwz9w6y7Q-mXuVC6xD4-daTc03_LpaCC7WmS2mU,8174
+pumpkin_api/wit/player.wit,sha256=4BKr67GRApPo41429OcRJJNW4q0NXQ39DCu31hbY-Vw,8859
 pumpkin_api/wit/plugin.wit,sha256=LrpupaW7OJoAvkRI7rhCjgqU3x063MpXRFn5Wi3C18Q,2457
 pumpkin_api/wit/scheduler.wit,sha256=lBpuJQwnreK1JcfXtuD6WZzYJ62M1fpa0M4UZ7KFkPo,1176
 pumpkin_api/wit/scoreboard.wit,sha256=pR7tcQeL3i9aWB7vFKYkHM4uQIyqIIGsRkGA22oJF-M,2009
-pumpkin_api/wit/server.wit,sha256=IHszNRXPVEpctJlXQt-2qTe0kLEj9sl3ammGLsQontg,3041
+pumpkin_api/wit/server.wit,sha256=HSUtLtYsAAGL6vN_n7Sj3ufT52l7x9bOaoeVhfoxAoo,3542
 pumpkin_api/wit/text.wit,sha256=IjdNsXxTzxTEOsSuDMmfF0hFsA4kuKkANW7HvMypUU8,1375
-pumpkin_api/wit/world.wit,sha256=3lmQ9PL4tAQMweCRan-cRLtWKBTZX51F_mGKqDz-GSo,7031
+pumpkin_api/wit/world.wit,sha256=-I3KPjFpoos4ZlbdVVBi3fmfpsjKhmomqopJt--vaXQ,8095
 ./componentize_py_runtime.pyi,sha256=3suTYQdRo3dzsP7919mJBuxuwNbUbjnQPiMcaXZs3ic,1109
 ./componentize_py_types.py,sha256=SWM0sddLchor0Un7py0s4j-2kZQylrdpWzxmLPDHBJQ,327
 ./poll_loop.py,sha256=KUBgZTycS3Ek-a-GPQebovucd2BumNe0c2XFwupKGHI,12181
@@ -33,21 +33,21 @@ pumpkin_api/wit/world.wit,sha256=3lmQ9PL4tAQMweCRan-cRLtWKBTZX51F_mGKqDz-GSo,703
 ./wit_world/imports/block_entity.py,sha256=GwmYkITX3BDfHef9Xj6TBmuyG7AuWlVrauucSUjvPdI,2692
 ./wit_world/imports/boss_bar.py,sha256=CdbDxyG-CfpDhV66dnJcdISqozlBPwq9JXIh65IMN7w,3906
 ./wit_world/imports/command.py,sha256=AMIIx2iGkKSfcfX-SpNrSJEnl4CUjBJRJ_5zn82iDQE,10512
-./wit_world/imports/common.py,sha256=S19orYR0yE8MGLxHYHXHPSqqsn1yHxuvL7JWSGwgLPI,3922
+./wit_world/imports/common.py,sha256=saUG1PGdqX1THonOL5T0iaUrWkqByhGGMuwdoUohCAU,4188
 ./wit_world/imports/context.py,sha256=zxp4bKS8bFI0wFrJgBn8DFO8CoIGG0L4b7JcHYdZJSM,2452
-./wit_world/imports/event.py,sha256=gAqDJM-O-HaSnHogho6YpTzEVHzg2CywVgfmcXxkXv8,9717
-./wit_world/imports/gui.py,sha256=dqXQwb3nrA9tyMb-d0YEdDFwte8TdNEEsu8PpCufYKs,2175
+./wit_world/imports/event.py,sha256=mp-KFuPUwkWjqFreH26CH9NdEXspFWLd5Do9S-S-CJ0,10387
+./wit_world/imports/gui.py,sha256=pHoFVb9n-VjyfztkApmBH8pnkjtECwKOiuZnKD6p1rA,2901
 ./wit_world/imports/i18n.py,sha256=gBG038CJr91bGuc7BSqR8xDmS15YT2sh6B3fWOnCIZk,1179
 ./wit_world/imports/logging.py,sha256=vVWjK9fDjj7tGKHwfsSWDTtyDFmyr4mSw5VhLSLwLS8,762
 ./wit_world/imports/permission.py,sha256=gijthLLFfZs0GVBVCsZwhnX3tMAQa8dozE934sqQ8xY,1770
-./wit_world/imports/player.py,sha256=mK2yu-rmmvLvuV9BDXl6t685uXBi9c-NS0qyQGxCVqs,12242
+./wit_world/imports/player.py,sha256=nLbPrTkHbQn5ln9iwo90OdoPkfjBh-WctRbDaUduXUs,12877
 ./wit_world/imports/scheduler.py,sha256=sI7Axa6jSCvPg9DbeKjbRPSRQPMMUUXMN636gVjwACY,1625
 ./wit_world/imports/scoreboard.py,sha256=zixPPHtgRjJHUWtEBBncvVJnrg4DwlmdJnHZSwNSO1U,3030
-./wit_world/imports/server.py,sha256=K1mF4EyMF9JY4uZOe3BvKKkMVwnrTJ-oZ60roIGJS0g,4705
+./wit_world/imports/server.py,sha256=_1CrNxXHMMvOxrdP37VkhPsjTCcX7Z1Swuj_Euf6f54,5409
 ./wit_world/imports/text.py,sha256=QJej3ya2GDsQF2_5xbCcKe6sKsxSGC2TNzEAAjPFVA0,3031
-./wit_world/imports/world.py,sha256=m9KR7SwY9EOCnULJk4qYAgSvYLzg3LxyU35FN-aXXCE,8878
-pumpkin_api_py-0.1.0.dev2.dist-info/METADATA,sha256=BaH97p0Iu8jCDSuH7om5_hjqVS3S3EsY9PZEzXP0Yx0,1212
-pumpkin_api_py-0.1.0.dev2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-pumpkin_api_py-0.1.0.dev2.dist-info/entry_points.txt,sha256=iPEUhVo3qB9KUZDtQWPnRbfg8ReUEouzRHDLOWaNNW0,64
-pumpkin_api_py-0.1.0.dev2.dist-info/licenses/LICENSE,sha256=1Oq26e5aRaugKmSso0nYTJB_TsOoAWtYhTgje1HgFqw,35122
-pumpkin_api_py-0.1.0.dev2.dist-info/RECORD,,
+./wit_world/imports/world.py,sha256=G2JAIcGEgTdy4y2utSbC3iCod0xZXA3ynv_VbmY4l-0,10231
+pumpkin_api_py-0.1.0.dev3.dist-info/METADATA,sha256=SwV4CWwVAhV-7892Xa7zS9rZ4rtdgGkemPo6083nvtk,1212
+pumpkin_api_py-0.1.0.dev3.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+pumpkin_api_py-0.1.0.dev3.dist-info/entry_points.txt,sha256=iPEUhVo3qB9KUZDtQWPnRbfg8ReUEouzRHDLOWaNNW0,64
+pumpkin_api_py-0.1.0.dev3.dist-info/licenses/LICENSE,sha256=1Oq26e5aRaugKmSso0nYTJB_TsOoAWtYhTgje1HgFqw,35122
+pumpkin_api_py-0.1.0.dev3.dist-info/RECORD,,

wit_world/imports/common.py

@@ -77,6 +77,21 @@ class ItemStack:
     registry_key: str
     count: int
 
+class ClickType(Enum):
+    """
+    Represents the type of click interaction in a GUI.
+    """
+    LEFT = 0
+    RIGHT = 1
+    SHIFT_LEFT = 2
+    SHIFT_RIGHT = 3
+    MIDDLE = 4
+    DROP = 5
+    CONTROL_DROP = 6
+    DOUBLE_CLICK = 7
+    NUMBER_KEY = 8
+    UNKNOWN = 9
+
 class EntityPose(Enum):
     """
     Represents the various poses an entity can be in.

wit_world/imports/event.py

@@ -184,6 +184,23 @@ class PlayerInteractUnknownEntityEventData:
     action: EntityInteractionAction
     cancelled: bool
 
+@dataclass
+class InventoryClickEventData:
+    player: player.Player
+    window_type: Optional[str]
+    click_type: common.ClickType
+    slot: int
+    raw_slot: int
+    clicked_item: Optional[common.ItemStack]
+    cursor: Optional[common.ItemStack]
+    hotbar_button: int
+    cancelled: bool
+
+@dataclass
+class InventoryCloseEventData:
+    player: player.Player
+    window_type: Optional[str]
+
 @dataclass
 class BlockRedstoneEventData:
     target_world: world.World
@@ -278,15 +295,17 @@ class EventType(Enum):
     PLAYER_TOGGLE_SNEAK_EVENT = 18
     PLAYER_TOGGLE_FLIGHT_EVENT = 19
     PLAYER_TOGGLE_SPRINT_EVENT = 20
-    BLOCK_REDSTONE_EVENT = 21
-    BLOCK_BREAK_EVENT = 22
-    BLOCK_BURN_EVENT = 23
-    BLOCK_CAN_BUILD_EVENT = 24
-    BLOCK_GROW_EVENT = 25
-    BLOCK_PLACE_EVENT = 26
-    SERVER_COMMAND_EVENT = 27
-    SPAWN_CHANGE_EVENT = 28
-    SERVER_BROADCAST_EVENT = 29
+    INVENTORY_CLICK_EVENT = 21
+    INVENTORY_CLOSE_EVENT = 22
+    BLOCK_REDSTONE_EVENT = 23
+    BLOCK_BREAK_EVENT = 24
+    BLOCK_BURN_EVENT = 25
+    BLOCK_CAN_BUILD_EVENT = 26
+    BLOCK_GROW_EVENT = 27
+    BLOCK_PLACE_EVENT = 28
+    SERVER_COMMAND_EVENT = 29
+    SPAWN_CHANGE_EVENT = 30
+    SERVER_BROADCAST_EVENT = 31
 
 
 @dataclass
@@ -394,6 +413,16 @@ class Event_PlayerToggleSprintEvent:
     value: PlayerToggleSprintEventData
 
 
+@dataclass
+class Event_InventoryClickEvent:
+    value: InventoryClickEventData
+
+
+@dataclass
+class Event_InventoryCloseEvent:
+    value: InventoryCloseEventData
+
+
 @dataclass
 class Event_BlockRedstoneEvent:
     value: BlockRedstoneEventData
@@ -439,7 +468,7 @@ class Event_ServerBroadcastEvent:
     value: ServerBroadcastEventData
 
 
-Event = Union[Event_PlayerJoinEvent, Event_PlayerLeaveEvent, Event_PlayerLoginEvent, Event_PlayerChatEvent, Event_PlayerCommandSendEvent, Event_PlayerPermissionCheckEvent, Event_PlayerMoveEvent, Event_PlayerTeleportEvent, Event_PlayerChangeWorldEvent, Event_PlayerExpChangeEvent, Event_PlayerItemHeldEvent, Event_PlayerChangedMainHandEvent, Event_PlayerGamemodeChangeEvent, Event_PlayerCustomPayloadEvent, Event_PlayerFishEvent, Event_PlayerEggThrowEvent, Event_PlayerInteractUnknownEntityEvent, Event_PlayerInteractEvent, Event_PlayerToggleSneakEvent, Event_PlayerToggleFlightEvent, Event_PlayerToggleSprintEvent, Event_BlockRedstoneEvent, Event_BlockBreakEvent, Event_BlockBurnEvent, Event_BlockCanBuildEvent, Event_BlockGrowEvent, Event_BlockPlaceEvent, Event_ServerCommandEvent, Event_SpawnChangeEvent, Event_ServerBroadcastEvent]
+Event = Union[Event_PlayerJoinEvent, Event_PlayerLeaveEvent, Event_PlayerLoginEvent, Event_PlayerChatEvent, Event_PlayerCommandSendEvent, Event_PlayerPermissionCheckEvent, Event_PlayerMoveEvent, Event_PlayerTeleportEvent, Event_PlayerChangeWorldEvent, Event_PlayerExpChangeEvent, Event_PlayerItemHeldEvent, Event_PlayerChangedMainHandEvent, Event_PlayerGamemodeChangeEvent, Event_PlayerCustomPayloadEvent, Event_PlayerFishEvent, Event_PlayerEggThrowEvent, Event_PlayerInteractUnknownEntityEvent, Event_PlayerInteractEvent, Event_PlayerToggleSneakEvent, Event_PlayerToggleFlightEvent, Event_PlayerToggleSprintEvent, Event_InventoryClickEvent, Event_InventoryCloseEvent, Event_BlockRedstoneEvent, Event_BlockBreakEvent, Event_BlockBurnEvent, Event_BlockCanBuildEvent, Event_BlockGrowEvent, Event_BlockPlaceEvent, Event_ServerCommandEvent, Event_SpawnChangeEvent, Event_ServerBroadcastEvent]
 
 
 

wit_world/imports/gui.py

@@ -67,6 +67,26 @@ class Gui:
         Clears all items from the GUI.
         """
         raise NotImplementedError
+    def set_allow_grab_items(self, allow: bool) -> None:
+        """
+        Sets whether players can grab items out of the inventory.
+        """
+        raise NotImplementedError
+    def get_allow_grab_items(self) -> bool:
+        """
+        Returns whether players can grab items out of the inventory.
+        """
+        raise NotImplementedError
+    def set_allow_put_items(self, allow: bool) -> None:
+        """
+        Sets whether players can put items into the inventory from their own.
+        """
+        raise NotImplementedError
+    def get_allow_put_items(self) -> bool:
+        """
+        Returns whether players can put items into the inventory from their own.
+        """
+        raise NotImplementedError
     def __enter__(self) -> Self:
         """Returns self"""
         return self

wit_world/imports/player.py

@@ -30,6 +30,26 @@ class PlayerAbilities:
     fly_speed: float
     walk_speed: float
 
+@dataclass
+class PlayerSkin:
+    """
+    Represents a player's skin textures and metadata.
+    """
+    value: str
+    signature: Optional[str]
+
+class SkinParts(Flag):
+    """
+    Flags representing visible skin parts.
+    """
+    CAPE = auto()
+    JACKET = auto()
+    LEFT_SLEEVE = auto()
+    RIGHT_SLEEVE = auto()
+    LEFT_PANTS_LEG = auto()
+    RIGHT_PANTS_LEG = auto()
+    HAT = auto()
+
 class Player:
     """
     A handle to a player on the server.
@@ -102,6 +122,21 @@ class Player:
         Sets the player's permission level.
         """
         raise NotImplementedError
+    def set_permission(self, node: str, value: bool) -> None:
+        """
+        Grants or denies a specific permission node for the player.
+        """
+        raise NotImplementedError
+    def unset_permission(self, node: str) -> None:
+        """
+        Removes an explicitly set permission node from the player.
+        """
+        raise NotImplementedError
+    def has_permission_set(self, node: str) -> Optional[bool]:
+        """
+        Returns `Some(true)` if granted, `Some(false)` if denied, or `None` if not set.
+        """
+        raise NotImplementedError
     def has_permission(self, node: str) -> bool:
         """
         Checks if the player has a specific permission node.
@@ -316,31 +351,6 @@ class Player:
         Adds experience points to the player.
         """
         raise NotImplementedError
-    def is_sneaking(self) -> bool:
-        """
-        Returns whether the player is currently sneaking.
-        """
-        raise NotImplementedError
-    def set_sneaking(self, sneaking: bool) -> None:
-        """
-        Sets whether the player is currently sneaking.
-        """
-        raise NotImplementedError
-    def is_sprinting(self) -> bool:
-        """
-        Returns whether the player is currently sprinting.
-        """
-        raise NotImplementedError
-    def set_sprinting(self, sprinting: bool) -> None:
-        """
-        Sets whether the player is currently sprinting.
-        """
-        raise NotImplementedError
-    def is_on_ground(self) -> bool:
-        """
-        Returns whether the player is currently on the ground.
-        """
-        raise NotImplementedError
     def is_flying(self) -> bool:
         """
         Returns whether the player is currently flying.
@@ -366,6 +376,21 @@ class Player:
         Returns the player's IP address.
         """
         raise NotImplementedError
+    def get_skin(self) -> Optional[PlayerSkin]:
+        """
+        Returns the player's current skin textures.
+        """
+        raise NotImplementedError
+    def get_skin_parts(self) -> SkinParts:
+        """
+        Returns the currently visible skin parts.
+        """
+        raise NotImplementedError
+    def set_skin_parts(self, parts: SkinParts) -> None:
+        """
+        Sets which skin parts are visible.
+        """
+        raise NotImplementedError
     def __enter__(self) -> Self:
         """Returns self"""
         return self

wit_world/imports/server.py

@@ -22,6 +22,28 @@ class Difficulty(Enum):
     NORMAL = 2
     HARD = 3
 
+class Dimension(Enum):
+    """
+    Represents the three main Minecraft dimensions.
+    """
+    OVERWORLD = 0
+    NETHER = 1
+    END = 2
+
+
+@dataclass
+class CommandSender_Console:
+    pass
+
+
+@dataclass
+class CommandSender_Player:
+    value: player.Player
+
+
+CommandSender = Union[CommandSender_Console, CommandSender_Player]
+
+
 class Server:
     """
     Represents the global server instance.
@@ -74,6 +96,14 @@ class Server:
         Gets a world by its dimension name (e.g., "minecraft:overworld").
         """
         raise NotImplementedError
+    def execute_command(self, command: str, sender: CommandSender) -> None:
+        raise NotImplementedError
+    def create_world(self, name: str, dimension: Dimension) -> world.World:
+        """
+        Creates or loads a world by its name and dimension.
+        If a world with the given name already exists, it will be returned.
+        """
+        raise NotImplementedError
     def broadcast(self, message: str) -> None:
         """
         Broadcasts a system chat message to all players.

wit_world/imports/world.py

@@ -218,6 +218,25 @@ class World:
         raise NotImplementedError
 
 
+class BlockDirection(Enum):
+    """
+    Represents a cardinal direction or block face.
+    """
+    DOWN = 0
+    UP = 1
+    NORTH = 2
+    SOUTH = 3
+    WEST = 4
+    EAST = 5
+
+@dataclass
+class RaycastResult:
+    """
+    Result of a raycast operation.
+    """
+    pos: BlockPos
+    face: BlockDirection
+
 class Entity:
     
     def get_id(self) -> int:
@@ -240,12 +259,32 @@ class Entity:
         raise NotImplementedError
     def is_sneaking(self) -> bool:
         raise NotImplementedError
+    def set_sneaking(self, sneaking: bool) -> None:
+        raise NotImplementedError
     def is_sprinting(self) -> bool:
         raise NotImplementedError
+    def set_sprinting(self, sprinting: bool) -> None:
+        raise NotImplementedError
+    def is_swimming(self) -> bool:
+        raise NotImplementedError
+    def set_swimming(self, swimming: bool) -> None:
+        raise NotImplementedError
     def is_invisible(self) -> bool:
         raise NotImplementedError
+    def set_invisible(self, invisible: bool) -> None:
+        raise NotImplementedError
     def is_glowing(self) -> bool:
         raise NotImplementedError
+    def set_glowing(self, glowing: bool) -> None:
+        raise NotImplementedError
+    def is_fall_flying(self) -> bool:
+        raise NotImplementedError
+    def set_fall_flying(self, fall_flying: bool) -> None:
+        raise NotImplementedError
+    def is_on_fire(self) -> bool:
+        raise NotImplementedError
+    def set_on_fire(self, on_fire: bool) -> None:
+        raise NotImplementedError
     def teleport(self, pos: Tuple[float, float, float], world_ref: World) -> None:
         raise NotImplementedError
     def set_velocity(self, velocity: Tuple[float, float, float]) -> None:
@@ -274,6 +313,11 @@ class Entity:
         raise NotImplementedError
     def remove(self) -> None:
         raise NotImplementedError
+    def raycast(self, max_distance: float, fluid_handling: bool) -> Optional[RaycastResult]:
+        """
+        Performs a raycast from the entity's eye position in its looking direction.
+        """
+        raise NotImplementedError
     def __enter__(self) -> Self:
         """Returns self"""
         return self