GameBox 0.3.0__tar.gz → 0.9.0__tar.gz

{gamebox-0.3.0 → gamebox-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: GameBox
-Version: 0.3.0
+Version: 0.9.0
 Summary: GameBox is a beginner-friendly Python package built on top of pygame, designed to make 2D game development faster and easier. It provides ready-to-use modules, utilities, and abstractions that let new developers create polished games without needing advanced coding knowledge—while still offering the flexibility for experienced coders to customize and extend.
 Author-email: Sam Fertig <sfertig007@gmail.com>
 License-Expression: MIT

{gamebox-0.3.0 → gamebox-0.9.0}/pyproject.toml

@@ -3,7 +3,7 @@ requires = ["hatchling >= 1.26"]
 build-backend = "hatchling.build"
 [project]
 name = "GameBox"
-version = "0.3.0"
+version = "0.9.0"
 authors = [
   { name="Sam Fertig", email="sfertig007@gmail.com" },
 ]

gamebox-0.9.0/src/GameBox/GameLevel_ui/_Animations.py

@@ -0,0 +1,39 @@
+import pygame
+import numpy as np
+
+from ..basics._net import Global
+
+class Animation:
+    def __init__(self, image, tileDim, startPos, frames, dur):
+        if type(image) == str:
+            image = pygame.image.load(image)
+
+        #others
+        self.dur = dur
+        self.currentFrame = 0
+        self.currentDur = 0
+
+        #get frames from image
+        self.frames = []
+        x, y = startPos
+        x *= tileDim[0]
+        y *= tileDim[1]
+        for i in range(frames):
+            self.frames.append(image.subsurface(x, y, tileDim[0], tileDim[1]))
+            x += tileDim[0]
+            if x >= image.get_width():
+                x = 0
+                y += tileDim[1]
+
+    def update(self, dt):
+        self.currentDur += dt
+        if self.currentDur >= self.dur:
+            self.currentDur = 0
+            self.currentFrame += 1
+            if self.currentFrame >= len(self.frames):
+                self.currentFrame = 0
+
+    def getFrame(self):
+        return self.frames[self.currentFrame]
+
+

gamebox-0.9.0/src/GameBox/GameLevel_ui/_sprites.py

@@ -0,0 +1,243 @@
+import pygame
+import numpy as np
+
+from ..basics._net import Global
+from ._Animations import Animation
+
+class Sprite_2d:
+    def __init__(self, pos: tuple, image, scale: float = 1.0, collision = True, dirrection: int = 1):
+        """
+        Initialize a 2D sprite.
+        
+        Args:
+            pos: Tuple (x, y) for the sprite position
+            image: Either a file path (str) or pygame.Surface object
+            scale: Scale factor for the sprite (default: 1.0)
+        """
+        #add to game
+        Global.game.objs.append(self)
+        self.collision = collision
+        self.__worldPos__ = True
+        self.dir = dirrection
+
+        self.pos = pos
+        if type(image) == str:
+            self.image = pygame.image.load(image)
+        else:
+            self.image = image
+        
+        #scale image
+        print(self.image)
+        self.image = pygame.transform.scale_by(self.image, scale)
+        #flip image
+        if self.dir == -1:
+            self.image = pygame.transform.flip(self.image, True, False)
+
+    def update(self):
+        #world space
+        x, y = self.pos
+        if self.__worldPos__:
+            x = x - Global.cam.x
+            y = y - Global.cam.y
+        Global.screen.blit(self.image, (x, y))
+        if self.collision:
+            rect = self.image.get_rect()
+            rect.x = x
+            rect.y = y
+            Global.collisions.append(rect)
+
+    def switch_dirrection(self):
+        self.image = pygame.transform.flip(self.image, True, False)
+        
+
+    def move_by(self, x: int, y: int):
+        self.pos = (self.pos[0] + x, self.pos[1] + y)
+
+    def move_to(self, x: int, y: int):
+        self.pos = (x, y)
+
+    def get_pos(self):
+        return self.pos
+
+    def rescale(self, scale: float):
+        self.image = pygame.transform.scale_by(self.image, scale)
+
+    def __remove__(self):
+        Global.game.objs.remove(self)
+
+def split_image(image, tileDim, startPos):
+    if type(image) == str:
+        image = pygame.image.load(image)
+    else:
+        image = image
+
+    #return image split
+    x = startPos[0] * tileDim[0]
+    y = startPos[1] * tileDim[1]
+    return image.subsurface((x, y, tileDim[0], tileDim[1]))
+
+class Animated_Sprite2D:
+    """
+    A class for animated 2D sprites.
+
+    Args:
+        pos (tuple): The position of the sprite in world space.
+        image (str or pygame.Surface): The image of the sprite.
+        imageDim (tuple): The dimensions of the image.
+        tileDim (tuple): The dimensions of the tiles in the image.
+        frames (int): The number of frames in the animation.
+        speed (float): The speed of the animation.
+        scale (float): The scale of the sprite.
+        collision (bool): Whether the sprite has collision.
+        dirrection (int): The direction of the sprite.
+
+    Attributes:
+        animation (Animation): The animation of the sprite.
+        collision (bool): Whether the sprite has collision.
+        dir (int): The direction of the sprite.
+        pos (tuple): The position of the sprite in world space.
+        scale (float): The scale of the sprite.
+        image (pygame.Surface): The current frame of the animation.
+        __worldPos__ (bool): Whether the sprite is in world space.
+
+    Methods:
+        update (None): Updates the sprite.
+        __remove__ (None): Removes the sprite from the game.
+        switch_dirrection (None): Switches the direction of the sprite.
+        move_by (x, y): Moves the sprite by (x, y) in world space.
+        move_to (x, y): Moves the sprite to (x, y) in world space.
+        get_pos (None): Returns the position of the sprite in world space.
+        rescale (scale): Rescales the sprite by the given scale.
+    """
+
+    def __init__(self, pos, image, imageDim, tileDim, frames, speed, scale = 1.0, collision = True, dirrection = 1):
+        """
+        
+        """
+
+        self.animation = Animation(image, tileDim, (0, 0), frames, speed)
+        self.collision = collision
+        self.dir = dirrection
+        self.pos = pos
+
+        self.scale = scale
+        self.image = pygame.transform.scale_by(self.animation.getFrame(), scale)
+        if self.dir == -1:
+            self.image = pygame.transform.flip(self.image, True, False)
+
+        self.__worldPos__ = True
+
+        #add to game
+        Global.game.objs.append(self)
+
+    def update(self):
+        self.animation.update(Global.dt)
+        self.image = pygame.transform.scale_by(self.animation.getFrame(), self.scale)
+        if self.dir == -1:
+            self.image = pygame.transform.flip(self.image, True, False)
+        
+        #world space
+        x, y = self.pos
+        if self.__worldPos__:
+            x = x - Global.cam.x
+            y = y - Global.cam.y
+        Global.screen.blit(self.image, (x, y))
+        if self.collision:
+            rect = self.image.get_rect()
+            rect.x = x
+            rect.y = y
+            Global.collisions.append(rect)
+
+    def __remove__(self):
+        Global.game.objs.remove(self)
+
+    def switch_dirrection(self):
+        self.image = pygame.transform.flip(self.image, True, False)
+
+    def move_by(self, x: int, y: int):
+        self.pos = (self.pos[0] + x, self.pos[1] + y)
+
+    def move_to(self, x: int, y: int):
+        self.pos = (x, y)
+
+    def get_pos(self):
+        return self.pos
+
+    def rescale(self, scale: float):
+        self.image = pygame.transform.scale_by(self.image, scale)
+
+class AnimationPlayer2D:
+    """
+    Class for playing animations in a 2D game.
+
+    Attributes:
+        pos (tuple): Position of the AnimationPlayer2D.
+        scale (float): Scale of the AnimationPlayer2D.
+        anims (dict): Dictionary of animations that can be played, where the key is the name of the animation and the value is an instance of Animated_Sprite2D.
+        currentAnim (str): The name of the currently playing animation.
+
+    Methods:
+        update (None): Updates the currently playing animation.
+        add_animation (name, image, imageDim, tileDim, frames, speed, scale = 1.0, collision = True, dirrection = 1): Adds an animation to the AnimationPlayer2D.
+        remove_animation (name: str): Removes an animation from the AnimationPlayer2D.
+        set_worldPos (worldPos: bool): Sets the world position of all animations in the AnimationPlayer2D.
+        __remove__ (None): Removes the AnimationPlayer2D from the game.
+        set_scale (scale: float): Sets the scale of all animations in the AnimationPlayer2D.
+        set_animation (anim: str): Sets the currently playing animation.
+        move_by (x, y): Moves the AnimationPlayer2D by (x, y) in world space.
+        move_to (x, y): Moves the AnimationPlayer2D to (x, y) in world space.
+        get_pos (None): Returns the position of the AnimationPlayer2D in world space.
+    """
+    def __init__(self, pos, scale):
+        self.pos = pos
+        self.scale = scale
+        self.anims = {}
+        self.currentAnim = None
+
+        self.__worldPos__ = True
+
+        #add to game
+        Global.game.objs.append(self)
+
+    def update(self):
+        if self.currentAnim is not None:
+            self.anims[self.currentAnim].update()
+
+    def add_animation(self, name, image, imageDim, tileDim, frames, speed, scale = 1.0, collision = True, dirrection = 1):
+        self.anims[name] = Animated_Sprite2D(self.pos, image, imageDim, tileDim, frames, speed, scale, collision, dirrection)
+        self.currentAnim = name
+        self.anims[self.currentAnim].__remove__()
+
+    def remove_animation(self, name: str):
+        self.anims[name].__remove__()
+        del self.anims[name]
+
+    def set_worldPos(self, worldPos: bool):
+        for anim in self.anims:
+            self.anims[anim].__worldPos__ = worldPos
+
+    def __remove__(self):
+        if self in Global.game.objs:
+            Global.game.objs.remove(self)
+
+    def set_scale(self, scale: float):
+        for anim in self.anims:
+            self.anims[anim].rescale(scale)
+
+    def set_animation(self, anim: str):
+        self.currentAnim = anim
+
+    def move_by(self, x: int, y: int):
+        self.pos = (self.pos[0] + x, self.pos[1] + y)
+        for anim in self.anims:
+            self.anims[anim].move_by(x, y)
+
+    def move_to(self, x: int, y: int):
+        self.pos = (x, y)
+        for anim in self.anims:
+            self.anims[anim].move_to(x, y)
+
+    def get_pos(self):
+        return self.pos
+
+

{gamebox-0.3.0 → gamebox-0.9.0}/src/GameBox/__init__.py

@@ -16,6 +16,10 @@ from .player._player import Player
 from .basics.utils import clamp, moveTward, zeroOut
 from .tilemap._tilemap import TileMap
 from.helpers._input import Keys
+from .ui._basicUI import Image
+
+from .GameLevel_ui._sprites import Sprite_2d, Animated_Sprite2D, AnimationPlayer2D, split_image
+from.helpers._Conditions import Conditions
 
 
 __all__ = [
@@ -28,5 +32,11 @@ __all__ = [
     "zeroOut",
     "TileMap",
     "Keys",
+    "Image",
+    "Sprite_2d",
+    "Animated_Sprite2D",
+    "AnimationPlayer2D",
+    "split_image",
+    "Conditions",
 ]
 

{gamebox-0.3.0 → gamebox-0.9.0}/src/GameBox/_game.py

@@ -26,6 +26,7 @@ class Game:
         Global.clock = pygame.time.Clock()
         Global.game = self
         self.objs = []
+        self.ui_objs = []
 
 
     def update(self, event: pygame.event,frame_rate=60):
@@ -40,6 +41,11 @@ class Game:
             if type(obj) == Player: player = obj
             else: obj.update()
         if player != None: player.update()
+        
+        #update ui
+        for obj in self.ui_objs:
+            obj.update()
+        
         pygame.display.update()
 
     def get_screen(self):

{gamebox-0.3.0 → gamebox-0.9.0}/src/GameBox/basics/_net.py

@@ -18,6 +18,8 @@ class _global_:
         #-collisions
         self.collisions: list[pygame.Rect] = []
 
+        self.cond: object = None
+
         #objects
         self.player = self._player()
         self.tilemap = []

gamebox-0.9.0/src/GameBox/basics/_shapes.py

@@ -0,0 +1,88 @@
+import pygame
+import numpy as np
+
+from ..basics._net import Global
+
+class Rect:
+    """
+    A rectangle shape used for rendering and collision detection.
+
+    Args:
+        pos (tuple): The position of the rectangle.
+        size (tuple): The size of the rectangle.
+        color (tuple, optional): The color of the rectangle. Defaults to (0,0,0).
+        collision (bool, optional): Whether the rectangle should be used for collision detection. Defaults to True.
+    """
+
+    def __init__(self, pos: tuple, size: tuple, color: tuple = (0, 0, 0), collision: bool = True):
+        """
+        Initialize the rectangle object.
+
+        Args:
+            pos (tuple): The position of the rectangle.
+            size (tuple): The size of the rectangle.
+            color (tuple, optional): The color of the rectangle. Defaults to (0,0,0).
+            collision (bool, optional): Whether the rectangle should be used for collision detection. Defaults to True.
+        """
+        self.x, self.y = pos
+        self.width, self.height = size
+        self.color = color
+        Global.game.objs.append(self)
+        self.collision = collision
+
+    def update(self):
+        """
+        Update the rectangle object.
+
+        This method updates the position and size of the rectangle based on the camera's position and scale.
+        It then renders the rectangle to the screen and adds it to the collision detection list if necessary.
+        """
+        width = self.width * Global.cam.scale
+        height = self.height * Global.cam.scale
+        if (Global.cam.follow) != (self):
+            x = self.x - Global.cam.x
+            y = self.y - Global.cam.y
+        elif (Global.cam.follow) == (self):
+            x = self.x
+            y = self.y
+
+        rect = pygame.Rect(x, y, width, height)
+        if self.collision: Global.collisions.append(rect)
+        pygame.draw.rect(Global.screen, self.color, rect)
+
+    def move(self, x, y):
+        """
+        Move the rectangle object.
+
+        Args:
+            x (int): The x-coordinate to move the rectangle by.
+            y (int): The y-coordinate to move the rectangle by.
+        """
+        if (Global.cam.follow) != (self):
+            self.x += x
+            self.y += y
+        else:
+            Global.cam._move(x, y)
+            
+    def move_to(self, x, y):
+        """
+        Move the rectangle object to a specific position.
+
+        Args:
+            x (int): The x-coordinate to move the rectangle to.
+            y (int): The y-coordinate to move the rectangle to.
+        """
+        if (Global.cam.follow) != (self):
+            self.x = x
+            self.y = y
+        else:
+            Global.cam.x = x
+            Global.cam.y = y
+
+    def __remove__(self):
+        """
+        Remove the rectangle object from the game.
+
+        This method removes the rectangle object from the game's object list.
+        """
+        Global.game.objs.remove(self)

gamebox-0.9.0/src/GameBox/basics/cammera.py

@@ -0,0 +1,75 @@
+import pygame
+import numpy as np
+
+from ._net import Global
+
+from ..basics.utils import moveTward
+
+class Cammera:
+    """
+    A class for the camera object.
+    """
+
+    def __init__(self, scale: float = 1.0):
+        """
+        Initialize the camera object.
+
+        Args:
+            scale (float): The scale of the camera (default: 1.0)
+        """
+        self.x = 0
+        self.y = 0
+        Global.game.objs.append(self)
+        Global.cam = self
+        self.follow = None
+        self.diff = (0, 0)
+        self.scale = scale
+
+    def _move(self, x: int, y: int):
+        """
+        Move the camera by (x, y).
+
+        Args:
+            x (int): The x component of the movement
+            y (int): The y component of the movement
+        """
+        self.x += x
+        self.y += y
+
+    def update(self):
+        """
+        Update the camera position based on the follow target.
+        """
+        return
+        if self.follow is not None:
+            self.x = (self.follow.x - self.diff[0])
+            self.y = (self.follow.y - self.diff[1])
+
+    def set_follow_target(self, target: object):
+        """
+        Set the follow target for the camera.
+
+        Args:
+            target (object): The object to follow
+        """
+        self.follow = target
+        print(target)
+        self.diff = (target.x - self.x, target.y - self.y)
+
+    def set_scale(self, scale: float = 1.0):
+        """
+        Set the scale of the camera.
+
+        Args:
+            scale (float): The scale of the camera (default: 1.0)
+        """
+        self.scale = scale
+
+    def change_scale(self, scale: float = 1.0):
+        """
+        Change the scale of the camera by the given amount.
+
+        Args:
+            scale (float): The amount to change the scale by (default: 1.0)
+        """
+        self.scale += scale

gamebox-0.9.0/src/GameBox/helpers/_Conditions.py

@@ -0,0 +1,65 @@
+import pygame
+import numpy as np
+
+from ..basics.utils import zeroOut
+from ..basics._net import Global
+
+class _Conditions:
+    """
+    Class containing the predefined conditions for the game.
+    Conditions are in the format of 'C' followed by the command ('v' for velocity), and dir (^ up, _ down, < left, > right, # none, ~ any)
+    """
+
+    def __init__(self):
+        """
+        Initialize the conditions.
+        """
+        # conditions start with 'C' and then command ('v' for velocity), and dir (^ up, _ down, < left, > right, # none, ~ any)
+        self.velocity_up = 'CV^'  # velocity up
+        self.velocity_down = 'CV_'  # velocity down
+        self.velocity_left = 'CV<'  # velocity left
+        self.velocity_right = 'CV>'  # velocity right
+        self.velocity_none = 'CV#'  # velocity none
+        self.velocity_any = 'CV~'  # velocity any
+
+Conditions = _Conditions()
+Global.cond = Conditions
+
+class Condition_check:
+    def __init__(self, stateTree: dict[str, dict[_Conditions, str]], currentState: str):
+        self.stateTree = stateTree
+        self.currentState = currentState
+        
+    def check(self, velocity: tuple, pos: tuple):
+        state = self.stateTree[self.currentState]
+        for cond, next in state.items():
+            #velocities
+            if cond[1] == 'V':
+                if self._resolve_velocities(velocity, cond):
+                    self.currentState = next
+                    return next
+        return self.currentState
+                
+
+    def _resolve_velocities(self, velocities, cond):
+        vx, vy = velocities
+        Max = 0.3
+        vx = zeroOut(vx, Max)
+        vy = zeroOut(vy, Max)
+        dir = cond[2]
+        print(vx, vy, dir)
+        #resolve in order up, down, left, right, none, any
+        if dir == "^" and vy < 0: return True
+        if dir == "_" and vy > 0: return True
+        if dir == "<" and vx < 0: return True
+        if dir == ">" and vx > 0: return True
+        if dir == "#" and vx == 0 and vy == 0: return True
+        if dir == "~" and (vx != 0 or vy != 0): return True
+        return False
+
+    def updateState(self, state: str):
+        self.currentState = state
+    def updateStateTree(self, stateTree: dict[str, dict[_Conditions, str]]):
+        self.stateTree = stateTree
+            
+

{gamebox-0.3.0 → gamebox-0.9.0}/src/GameBox/helpers/_collisions.py

@@ -7,7 +7,6 @@ from ..basics._net import Global
 def CheckCollisions(x, y, vx, vy, dim, sample, obj):
         x, y = x + vx, y + vy
 
-
         #basic object collisions
         x, y, vx, vy = _mainCollisionLogic(Global.collisions, x, y, vx, vy, dim)
         x, y, vx, vy = _checkTilemapCollisions(x, y, vx, vy, dim, sample, obj)
@@ -15,20 +14,12 @@ def CheckCollisions(x, y, vx, vy, dim, sample, obj):
         return x, y, vx, vy
     
 def _mainCollisionLogic(collisions, x, y, vx, vy, dim):
-    new_rect = pygame.Rect((x, y), dim)
-    for collision in collisions:
-        #pygame.draw.rect(Global.screen, (255, 0, 0), collision, 1)
-        if collision.colliderect(new_rect):
-            if vx > 0:
-                x = collision.left - dim[0]
-            elif vx < 0:
-                x = collision.right
-            vx = 0
-
     # Y-axis collisions
+    py = y
     new_rect = pygame.Rect((x, y), dim)
+    pygame.draw.rect(Global.screen, "green", new_rect, 5)
     for collision in collisions:
-        #pygame.draw.rect(Global.screen, (255, 0, 0), collision, 1)
+        pygame.draw.rect(Global.screen, "yellow", collision, 5)
         if collision.colliderect(new_rect):
             if vy > 0:  # falling
                 y = collision.top - dim[1]
@@ -36,6 +27,16 @@ def _mainCollisionLogic(collisions, x, y, vx, vy, dim):
             elif vy < 0:  # jumping
                 y = collision.bottom
                 vy = 0
+                
+    new_rect = pygame.Rect((x, py), dim)
+    for collision in collisions:
+        pygame.draw.rect(Global.screen, "yellow", collision, 5)
+        if collision.colliderect(new_rect):
+            if vx > 0:
+                x = collision.left - dim[0]
+            elif vx < 0:
+                x = collision.right
+            vx = 0
 
     return x, y, vx, vy
     

{gamebox-0.3.0 → gamebox-0.9.0}/src/GameBox/helpers/_input.py

@@ -4,6 +4,9 @@ from ..basics._net import Global
 
 
 class _keys:
+    """
+    A class that holds all the key bindings for the game
+    """
     def __init__(self):
 
         #alphabet
@@ -61,6 +64,7 @@ class _keys:
 
         #mouse
         self.mouse_x, self.mouse_y = 0, 0
+
     def init(self): Global.game.objs.append(self)
 
     def is_pressed(self, key): 

{gamebox-0.3.0 → gamebox-0.9.0}/src/GameBox/player/_player.py

@@ -4,37 +4,61 @@ import numpy as np
 from ..basics._net import Global
 
 from ..player._playerPhysics import _playerPhysics
+from ..player._playerSprite import _playerSprite
+
+from ..GameLevel_ui._sprites import Sprite_2d
 
 class Player:
+    """
+    Initialize a Player object.
+
+    Parameters:
+    pos (tuple): The position of the Player in world space.
+    size (tuple): The size of the Player in world space.
+    color (tuple): The color of the Player (default: (0, 0, 0)).
+    gravity (bool): Whether the Player is affected by gravity (default: False).
+
+    Returns:
+    None
+    """
     def __init__(self, pos: tuple, size: tuple, color: tuple = (0, 0, 0), gravity: bool = False):
+        # Set the position and size of the Player
         self.x, self.y = pos
         self.screenPos = pos
         self.dim = size
         self.color = color
+        self.width, self.height = size
 
+        # Set whether the Player is affected by gravity
         self.gravity = gravity
-        
+
+        # State of the Player (e.g. "jumping", "standing", etc.)
+        self.state = ""
+
+        # Add the Player to the game
         Global.game.objs.append(self)
         Global.player.pos = pos
         Global.player.player = self
 
+        # Initialize the sprite for the Player
+        self.sprite = _playerSprite(self)
+
 
     def add_physics(self, speed: float = 1.0, gravity: float = 0.0, jump: float = 10.0, maxV: float = 10.0, airRes: float = 0.2):
         self.physics = _playerPhysics(self, speed, gravity, jump, maxV, airRes)
 
     def update(self):
         self.physics.update()
-        #debug rect
-        width = self.dim[0] * Global.cam.scale
-        height = self.dim[1] * Global.cam.scale
+        #ui
+
         if (Global.cam.follow) != (self):
             x = self.x - Global.cam.x
             y = self.y - Global.cam.y
         elif (Global.cam.follow) == (self):
             x = self.x
             y = self.y
-        rect = pygame.Rect(x, y, width, height)
-        pygame.draw.rect(Global.screen, self.color, rect)
+        velocity = (self.physics.vx, self.physics.vy)
+        self.sprite.update(x, y, velocity)
 
     #movement
     def top_down_movement(self):
@@ -50,3 +74,5 @@ class Player:
         The larger the sample size the longer it may take to calculate collisions per frame.
         """
         self.physics.sample = sample
+
+

{gamebox-0.3.0 → gamebox-0.9.0}/src/GameBox/player/_playerPhysics.py

@@ -19,7 +19,7 @@ class _playerPhysics:
         self.onGround = False
         self.canJump = False
 
-        self.sample = 10
+        self.sample = 25
 
         self.vx, self.vy = 0, 0
 
@@ -34,7 +34,7 @@ class _playerPhysics:
         elif (Global.cam.follow) == (self.player):
             dx = -(self.player.x - x)
             dy = -(self.player.y - y)
-            Global.cam.move(self.vx, self.vy)
+            Global.cam._move(self.vx, self.vy)
 
 
 

gamebox-0.9.0/src/GameBox/player/_playerSprite.py

@@ -0,0 +1,86 @@
+import pygame
+import numpy as np
+
+from ..basics._net import Global
+
+from ..GameLevel_ui._sprites import Sprite_2d, Animated_Sprite2D, AnimationPlayer2D
+from ..helpers._Conditions import Condition_check, _Conditions
+
+class _playerSprite:
+    def __init__(self, player):
+        self.player = player
+
+        self.state = player.state
+        self.statetree = {}
+        self.condition_check = None
+
+        self.sprite = None
+        
+
+    def update(self, x, y, velocity):
+        #state updates
+        if self.condition_check is not None:
+            self.state = self.condition_check.check(velocity, self.player.screenPos)
+            #set animation if possible
+            if type(self.sprite) == AnimationPlayer2D:
+                if self.state in self.sprite.anims:
+                    self.sprite.set_animation(self.state)
+        #any changes to follow target
+        if Global.cam.follow == self.player and self.sprite is not None:
+            self.sprite.__worldPos__ = False
+            self.sprite.move_to(self.player.screenPos[0], self.player.screenPos[1])
+        elif Global.cam.follow != self.player and self.sprite is not None:
+            self.sprite.__worldPos__ = True
+            self.sprite.move_to(self.player.x, self.player.y)
+        
+        if self.sprite is None:
+            #rect (x, y) is top left corner
+            rect = pygame.Rect((x, y), self.player.dim)
+            pygame.draw.rect(Global.screen, self.player.color, rect)
+        if type(self.sprite) == Sprite_2d:
+            self.sprite.update()
+        elif type(self.sprite) == Animated_Sprite2D:
+            self.sprite.update()
+        elif type(self.sprite) == AnimationPlayer2D:
+            self.sprite.update()
+
+    def add_sprite_2d(self, image, scale=1.0, dirrection=1):
+        self.sprite = Sprite_2d((self.player.x, self.player.y), image, scale, False, dirrection)
+        if Global.cam.follow == self.player:
+            self.sprite.__worldPos__ = False
+        self.sprite.__remove__()
+
+    def add_animated_sprite_2d(self, image, imageDim, tileDim, frames, speed, scale = 1.0, collision = False, dirrection = 1):
+        self.sprite = Animated_Sprite2D((self.player.x, self.player.y), image, imageDim, tileDim, frames, speed, scale, collision, dirrection)
+        if Global.cam.follow == self.player:
+            self.sprite.__worldPos__ = False
+        self.sprite.__remove__()
+
+    def remove_sprite(self):
+        if self.sprite is not None:
+            self.sprite = None
+
+    def add_animation_player(self, scale = 1.0):
+        self.sprite = AnimationPlayer2D((self.player.x, self.player.y), scale)
+        if Global.cam.follow == self.player:
+            self.sprite.set_worldPos(False)
+        self.sprite.__remove__()
+
+    def add_animation(self, name, image, imageDim, tileDim, frames, speed, scale = 1.0, collision = True, dirrection = 1):
+        self.sprite.add_animation(name, image, imageDim, tileDim, frames, speed, scale, collision, dirrection)
+        self.sprite.__remove__()
+        self.sprite.set_worldPos(False)
+
+    def remove_animation(self, name: str):
+        self.sprite.remove_animation(name)
+
+    def set_animation(self, anim: str):
+        self.sprite.set_animation(anim)
+
+    def set_states(self, stateTree: dict[str, dict[_Conditions, str]], currentState: str):
+        self.statetree = stateTree
+        self.state = currentState
+        self.condition_check = Condition_check(self.statetree, self.state)
+        
+
+

{gamebox-0.3.0 → gamebox-0.9.0}/src/GameBox/tilemap/_tilemap.py

@@ -9,6 +9,20 @@ from ._Editor import _tilemapEditor
 
 class TileMap:
     def __init__(self, tileSet: str, tileDim: tuple, tileScale: float, mapDim: tuple, mapFill: int, saveFile = None):
+        """
+        Constructor for TileMap object.
+
+        Args:
+            tileSet (str): filepath to tileset image
+            tileDim (tuple): dimensions of a single tile
+            tileScale (float): scale of tiles relative to tileset image
+            mapDim (tuple): dimensions of the map
+            mapFill (int): default tile id to fill map with
+            saveFile (str): filepath to save map to (default is None)
+
+        Returns:
+            None
+        """
         self.tilesetFile = tileSet
         self.mapFile = saveFile
         self.tileDim = (tileDim[0] * tileScale, tileDim[1] * tileScale)

gamebox-0.9.0/src/GameBox/ui/_basicUI.py

@@ -0,0 +1,65 @@
+import pygame
+import numpy as np
+
+from ..basics._net import Global
+
+from ..GameLevel_ui._sprites import Sprite_2d
+
+class Image:
+    def __init__(self, pos: tuple, image, scale: float = 1.0):
+        """
+    Initialize an Image UI element.
+    
+    Args:
+        pos: Tuple (x, y) for the image position
+        image: Either a file path (str) or pygame.Surface object
+        scale: Scale factor for the image (default: 1.0)
+    """
+        #add to game
+        self.image = Sprite_2d(pos, image, scale)
+        self.image.__remove__()
+        Global.game.ui_objs.append(self)
+
+    def move_by(self, x: int, y: int):
+        """
+        Move the image by (x, y) in world space.
+        
+        Args:
+            x: int, the x component of the movement
+            y: int, the y component of the movement
+        """
+        self.image.move_by(x, y)
+
+    def move_to(self, x: int, y: int):
+        """
+        Move the image to (x, y) in world space.
+        
+        Args:
+            x: int, the x component of the position
+            y: int, the y component of the position
+        """
+        self.image.move_to(x, y)
+    
+    def get_pos(self):
+        """
+        Get the position of the image in world space.
+        
+        Returns:
+            tuple: (x, y) the position of the image
+        """
+        return self.image.get_pos()
+
+    def rescale(self, scale: float):
+        """
+        Rescale the image by the given scale.
+        
+        Args:
+            scale: float, the scale factor
+        """
+        self.image.rescale(scale)
+
+    def update(self):
+        """
+        Update the image by drawing it on the screen.
+        """
+        Global.screen.blit(self.image.image, self.image.pos)

gamebox-0.9.0/tests/GettingStarted.py

@@ -0,0 +1,52 @@
+import pygame
+import os
+from src.GameBox import *
+
+width, height = 800, 600
+
+game = Game(width, height, "blue", "First Game!")
+screen = game.get_screen()
+
+cam = Cammera()
+
+Keys.init()
+
+player = Player((width / 2, height / 2), (64, 64), "green", False)
+player.add_physics(1.0, 3.0, 16, 7.0, 0.5)
+
+player.sprite.add_animation_player(2.0)
+player.sprite.add_animation("Walk Left", "tests/Player.png", (5, 1), (32, 32), 5, 0.075, 2.0, True, -1)
+player.sprite.add_animation("Walk Right", "tests/Player.png", (5, 1), (32, 32), 5, 0.075, 2.0, True, 1)
+player.sprite.add_animation("Idle", "tests/Player.png", (5, 1), (32, 32), 1, 0.075, 2.0, True, 1)
+
+player.sprite.set_animation("Idle")
+
+
+stateTree = {
+    "Idle": {Conditions.velocity_left: "Walk Left", Conditions.velocity_right: "Walk Right"},
+    "Walk Left": {Conditions.velocity_none: "Idle", Conditions.velocity_right: "Walk Right"},
+    "Walk Right": {Conditions.velocity_none: "Idle", Conditions.velocity_left: "Walk Left"}
+}
+player.sprite.set_states(stateTree, "Idle")
+
+rect = Rect((width / 2, height / 4), (64, 64), "red", True)
+
+
+cam.set_follow_target(player)
+running = True
+while running:
+    events = pygame.event.get()
+    for event in events:
+        if event.type == pygame.QUIT:
+            running = False
+    
+    player.top_down_movement()
+    game.update(events, 60)
+
+    #print player state
+    os.system("cls")
+    print(player.sprite.state)
+    
+game.quit()
+pygame.quit()
+os.system("cls")

{gamebox-0.3.0 → gamebox-0.9.0}/tests/basicScreen.py

@@ -17,9 +17,9 @@ map = TileMap("tests/levelTiles.png", (16, 16), 5, (25, 25), 0)
 map.load_map_from_json("tests/testMap.json")
 map.activate_editor(Keys.tab)
 
+player.sprite.add_animated_sprite_2d("tests/Player.png", (5, 1), (32, 32), 5, 0.075, 2.0, True, 1)
 
-
-player.set_tilemap_sample(50)
+#player.set_dim_as_sprite()
 
 cam.set_follow_target(player)
 #cam.move(-50, -50)
@@ -33,6 +33,7 @@ while running:
 
     player.top_down_movement()
 
+
     game.update(events, 60)
 
 

gamebox-0.9.0/tests/testMap.json

@@ -0,0 +1 @@
+{"map": [[11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8], [8, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8], [11, 11, 11, 1, 2, 2, 2, 2, 2, 2, 2, 2, 2, 3, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8], [16, 17, 18, 7, 8, 8, 8, 8, 8, 8, 8, 8, 8, 9, 16, 17, 17, 17, 17, 17, 17, 17, 18, 8, 8], [8, 8, 8, 7, 8, 8, 8, 8, 8, 8, 8, 8, 8, 9, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 7, 8, 8, 8, 8, 8, 8, 8, 8, 8, 9, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 7, 8, 8, 8, 8, 8, 8, 8, 8, 8, 9, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 7, 8, 8, 8, 8, 8, 8, 8, 8, 8, 9, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 7, 8, 8, 8, 8, 8, 8, 8, 8, 8, 9, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 13, 14, 14, 14, 14, 14, 14, 14, 14, 14, 15, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8]], "collisions": {"1": "full", "2": "halfTop", "7": "halfLeft", "3": "full", "13": "full", "15": "full", "9": "halfRight", "14": "halfBottom", "8": "none", "6": "bottomLeft", "5": "halfBottom", "4": "bottomRight", "10": "halfRight", "16": "topRight", "12": "halfLeft", "11": "none", "18": "topLeft", "17": "halfTop"}}

gamebox-0.3.0/src/GameBox/basics/_shapes.py

@@ -1,33 +0,0 @@
-import pygame
-import numpy as np
-
-from ..basics._net import Global
-
-class Rect:
-    def __init__(self, pos: tuple, size: tuple, color: tuple = (0, 0, 0), collision: bool = True):
-        self.x, self.y = pos
-        self.width, self.height = size
-        self.color = color
-        Global.game.objs.append(self)
-        self.collision = collision
-
-    def update(self):
-        width = self.width * Global.cam.scale
-        height = self.height * Global.cam.scale
-        if (Global.cam.follow) != (self):
-            x = self.x - Global.cam.x
-            y = self.y - Global.cam.y
-        elif (Global.cam.follow) == (self):
-            x = self.x
-            y = self.y
-
-        rect = pygame.Rect(x, y, width ,height)
-        if self.collision: Global.collisions.append(rect)
-        pygame.draw.rect(Global.screen, self.color, rect)
-
-    def move(self, x, y):
-        if (Global.cam.follow) != (self):
-            self.x += x
-            self.y += y
-        else:
-            Global.cam.move(x, y)

gamebox-0.3.0/src/GameBox/basics/cammera.py

@@ -1,36 +0,0 @@
-import pygame
-import numpy as np
-
-from ._net import Global
-
-from ..basics.utils import moveTward
-
-class Cammera:
-    def __init__(self, scale: float = 1.0):
-        self.x = 0
-        self.y = 0
-        Global.game.objs.append(self)
-        Global.cam = self
-        self.follow = None
-        self.diff = (0, 0)
-        self.scale = scale
-
-    def move(self, x, y):
-        self.x += x
-        self.y += y
-
-    def update(self):
-        return
-        if self.follow is not None:
-            self.x = (self.follow.x - self.diff[0])
-            self.y = (self.follow.y - self.diff[1])
-
-    def set_follow_target(self, target: object):
-        self.follow = target
-        print(target)
-        self.diff = (target.x - self.x, target.y - self.y)
-
-    def set_scale(self, scale: float = 1.0):
-        self.scale = scale
-    def change_scale(self, scale: float = 1.0):
-        self.scale += scale

gamebox-0.3.0/tests/testMap.json

@@ -1 +0,0 @@
-{"map": [[11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 1, 2, 3, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 7, 8, 9, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 13, 14, 15, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 4, 5, 6, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 10, 11, 12, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 16, 17, 18, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8], [8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8]], "collisions": {"1": "full", "2": "halfTop", "7": "halfLeft", "3": "full", "13": "full", "15": "full", "9": "halfRight", "14": "halfBottom", "8": "none", "6": "bottomLeft", "5": "halfBottom", "4": "bottomRight", "10": "halfRight", "16": "topRight", "12": "halfLeft", "11": "none", "18": "topLeft", "17": "halfTop"}}