Skip to content

TheChainsawBoy/PocketStationSDK

BranchesTags

Repository files navigation

#PocketStation SDK#

A simple Python SDK for creating PocketStation-style games (32x32 pixel display).

##Files

  • engine.py - Core engine with GameObject, Scene, and GameEngine classes.
  • objects.py - Pre-built game objects (Player, Enemy, Wall, Text, Bullet, Sprite).
  • input.py - 5-button input system (WASD + ENTER).
  • collision.py - Advanced collision detection and triggers.
  • sound.py - Play sounds using a frequency similar beeps to PocketStation.
  • camera.py - Allows for creation of scrolling games.
  • characters.py - Library for 8-bit text characters and the functions to draw them.
  • spriteconverter.py - Converts .png images into usable data for the engine.

##Sample Project

#------------------------------------------------------- from engine import GameEngine, Scene, BLACK, WHITE from input import Input from characters import BitString

def create_game(): #Create engine (32x32 monochrome display scaled 12x = 384x384 window) engine = GameEngine("PocketStation Shooter", scale=12)

#Create main game scene
game_scene = Scene("Game")
game_scene.background_color = WHITE

#Add test text
test_txt = BitString("monster", 2, 2)
game_scene.add_object(test_txt)

#Set scene and run
engine.set_scene(game_scene)

#Update input each frame
original_update = game_scene.update
def new_update(dt):
    Input.update()  #Update input system
    original_update(dt)
game_scene.update = new_update

engine.run()

if name == "main": create_game() #-------------------------------------------------------

##Creating Custom Objects

from engine import GameObject, WHITE from input import Input import pygame

class MyObject(GameObject): def init(self, x, y): super().init(x, y, width=5, height=5) self.my_property = 0

def update(self, dt):
    # Game logic here
    if Input.action1_pressed():
        self.x += 1

def draw(self, screen):
    # Only BLACK or WHITE!
    pygame.draw.rect(screen, WHITE, 
                    (int(self.x), int(self.y), 
                     self.width, self.height))

##Creating Custom Sprites

from objects import PixelSprite

sprite_data = [ [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 0, 1, 1, 1, 0, 0, 1, 1, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 0, 0, 1, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 1, 0, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 0, 1, 0, 0, 0, 1, 1, 0, 0, 0, 0, 1, 1, 0, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 0, 0, 0, 1, 0, 1, 1, 0, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 0, 0, 1, 1, 0, 1, 1, 0, 1, 1, 1, 1, 1, 0, 0, 1, 1, 1, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 0, 1, 0, 0, 1, 1, 0, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 1, 1, 1, 1, 1, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1], ]

full_scrn_img = PixelSprite(0, 0, sprite_data) game_scene.add_object(full_scrn_img)

##Using the Input System

from input import Input

#In your update() method: Input.update() # Call once per frame!

#Check buttons: if Input.up_held(): #W key held player.y -= speed if Input.action1_pressed(): #ENTER key just pressed shoot_bullet()

#Or get direction as normalized vector: dx, dy = Input.get_direction() player.x += dx * speed player.y += dy * speed

##Collision Detection

from collision import CollisionHelper, Trigger

#Simple collision check: if player.collides_with(enemy): print("Hit!")

#Push objects apart: CollisionHelper.push_out(player, wall)

#Move with collision: solid_objects = scene.get_objects_by_type(Wall) CollisionHelper.move_and_collide(player, dx, dy, solid_objects)

#Trigger zones: def on_enter_zone(obj): print(f"{obj} entered!")

trigger = Trigger(10, 10, 5, 5, on_trigger=on_enter_zone) scene.add_object(trigger)

##Using the sound system

from sound import SoundManager

#Create sound sm = SoundManager() sm.add_sound("bleep", 523, 0.1) #Play sound sm.play("bleep")

Exporting to EXE

To export your game as an executable:

###Using PyInstaller###

pip install pyinstaller
pyinstaller --onefile --windowed --add-data "icon.ico;." --icon=icon.ico game.py

Your .exe will be in the dist/ folder.

##Controls (Default)

  • W/A/S/D - Directional movement (up/left/down/right)
  • ENTER - Action button 1

About

SDK for Python which makes it easier to make PocketStation style games.

Resources

Readme

License

GPL-3.0 license
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages