GameBox 0.2.0__tar.gz → 0.9.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: GameBox
-Version: 0.2.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.2.0 → gamebox-0.9.0}/pyproject.toml

@@ -3,7 +3,7 @@ requires = ["hatchling >= 1.26"]
 build-backend = "hatchling.build"
 [project]
 name = "GameBox"
-version = "0.2.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.2.0 → gamebox-0.9.0}/src/GameBox/__init__.py

@@ -5,7 +5,7 @@ GameBox makes it easy to build 2D games with graphics, sound, and UI in just a f
 """
 
 
-__version__ = "0.1.3"
+__version__ = "0.3.0"
 __author__ = "Sam Fertig"
 
 #____imports____
@@ -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.2.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.2.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.2.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.2.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):