pyscratch-pysc 1.0.3__tar.gz → 2.0.0__tar.gz

{pyscratch_pysc-1.0.3 → pyscratch_pysc-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyscratch-pysc
-Version: 1.0.3
+Version: 2.0.0
 Summary: A Python game development framework designed to provide an easy transitioning from Scratch to Python
 Author-email: Daniel Ka-Wa Chan <kwdaniel525@protonmail.com>
 License: MIT
@@ -22,10 +22,15 @@ For more information, see: https://kwdchan.github.io/pyscratch/
 
 
 
+## Change History
+### 12 Oct 2025
+**v2.0.0**
+The backdrops are now indexed by keys instead of integers
 
 
-
-## Change History
+### 12 Sep 2025
+**v1.0.4**  
+Fixed the show/hide collision related problem due to the deferral of movement to the frame update.
 
 ### 07 Sep 2025
 **v1.0.3**  

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/1-create-sprites/main.py

@@ -0,0 +1,10 @@
+import pyscratch as pysc
+import player # Very important!
+
+# start the game
+WIN_WIDTH = 500 # change me
+WIN_HEIGHT = 500 # change me
+framerate = 60
+
+pysc.game.update_screen_mode((WIN_WIDTH, WIN_HEIGHT)) 
+pysc.game.start(framerate)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/1-create-sprites/player.py

@@ -0,0 +1,5 @@
+import pyscratch as pysc
+
+# This is the line that create the sprite. Note that you need to match the image file name! 
+player = pysc.create_single_costume_sprite("assets/fish_brown_outline.png")
+player.set_draggable(True) # optional: make the sprite draggable

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/1-create-sprites-task/enemy.py

@@ -0,0 +1,4 @@
+import pyscratch as pysc
+
+enemy = pysc.create_single_costume_sprite("assets/fish_red_outline.png")
+enemy.set_draggable(True) # optional: make the sprite draggable

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/1-create-sprites-task/main.py

@@ -0,0 +1,11 @@
+import pyscratch as pysc
+import player # Very important!
+import enemy # Very important!
+
+# start the game
+WIN_WIDTH = 500 # change me
+WIN_HEIGHT = 500 # change me
+framerate = 60
+
+pysc.game.update_screen_mode((WIN_WIDTH, WIN_HEIGHT)) 
+pysc.game.start(framerate)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/1-create-sprites-task/player.py

@@ -0,0 +1,5 @@
+import pyscratch as pysc
+
+# This is the line that create the sprite. Note that you need to match the image file name! 
+player = pysc.create_single_costume_sprite("assets/fish_brown_outline.png")
+player.set_draggable(True) # optional: make the sprite draggable

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/2-basic-events/enemy.py

@@ -0,0 +1,4 @@
+import pyscratch as pysc
+
+enemy = pysc.create_single_costume_sprite("assets/fish_red_outline.png")
+enemy.set_draggable(True) # optional: make the sprite draggable

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/2-basic-events/main.py

@@ -0,0 +1,11 @@
+import pyscratch as pysc
+import player # Very important!
+import enemy # Very important!
+
+# start the game
+WIN_WIDTH = 500 # change me
+WIN_HEIGHT = 500 # change me
+framerate = 60
+
+pysc.game.update_screen_mode((WIN_WIDTH, WIN_HEIGHT)) 
+pysc.game.start(framerate)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/2-basic-events/player.py

@@ -0,0 +1,31 @@
+import pyscratch as pysc
+
+player = pysc.create_single_costume_sprite("assets/fish_brown_outline.png")
+player.set_draggable(True)
+
+# 1. Create a function that does the thing (any function name is fine)
+def rotate_move(): 
+
+    player.direction += 45
+    player.move_indir(20)
+    yield 0.2 
+
+    player.direction += 45
+    player.move_indir(20)
+    yield 0.2 
+
+    player.direction += 45
+    player.move_indir(20)
+    yield 0.2 
+    
+    player.direction += 45
+    player.move_indir(20)
+
+# 2. Create an event object (any event name is fine)
+click_event = player.when_this_sprite_clicked() 
+
+# 3. Attach the function to the event block
+click_event.add_handler(rotate_move) 
+
+# Or step 2 and 3 together in one line
+#player.when_this_sprite_clicked().add_handler(rotate_move) 

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/2-basic-events-task1/enemy.py

@@ -0,0 +1,4 @@
+import pyscratch as pysc
+
+enemy = pysc.create_single_costume_sprite("assets/fish_red_outline.png")
+enemy.set_draggable(True) # optional: make the sprite draggable

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/2-basic-events-task1/main.py

@@ -0,0 +1,11 @@
+import pyscratch as pysc
+import player # Very important!
+import enemy # Very important!
+
+# start the game
+WIN_WIDTH = 500 # change me
+WIN_HEIGHT = 500 # change me
+framerate = 60
+
+pysc.game.update_screen_mode((WIN_WIDTH, WIN_HEIGHT)) 
+pysc.game.start(framerate)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/2-basic-events-task1/player.py

@@ -0,0 +1,23 @@
+import pyscratch as pysc
+
+player = pysc.create_single_costume_sprite("assets/fish_brown_outline.png")
+player.set_draggable(True)
+
+def scale_move(): 
+
+    player.scale_by(1.05)
+    player.move_indir(20)
+    yield 0.2 
+
+    player.scale_by(1.05)
+    player.move_indir(20)
+    yield 0.2 
+
+    player.scale_by(1.05)
+    player.move_indir(20)
+    yield 0.2 
+    
+    player.scale_by(1.05)
+    player.move_indir(20)
+
+player.when_this_sprite_clicked().add_handler(scale_move) 

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/2-basic-events-task2/enemy.py

@@ -0,0 +1,14 @@
+import pyscratch as pysc
+game = pysc.game
+
+enemy = pysc.create_single_costume_sprite("assets/fish_red_outline.png")
+enemy.set_draggable(True) # optional: make the sprite draggable
+
+def appear():
+    enemy.x = game.screen_width/2
+    enemy.y = game.screen_height/2
+    enemy.hide()
+    yield 3
+    enemy.show()
+
+enemy.when_game_start().add_handler(appear)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/2-basic-events-task2/main.py

@@ -0,0 +1,11 @@
+import pyscratch as pysc
+import player # Very important!
+import enemy # Very important!
+
+# start the game
+WIN_WIDTH = 500 # change me
+WIN_HEIGHT = 500 # change me
+framerate = 60
+
+pysc.game.update_screen_mode((WIN_WIDTH, WIN_HEIGHT)) 
+pysc.game.start(framerate)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/2-basic-events-task2/player.py

@@ -0,0 +1,23 @@
+import pyscratch as pysc
+
+player = pysc.create_single_costume_sprite("assets/fish_brown_outline.png")
+player.set_draggable(True)
+
+def scale_move(): 
+
+    player.scale_by(1.05)
+    player.move_indir(20)
+    yield 0.2 
+
+    player.scale_by(1.05)
+    player.move_indir(20)
+    yield 0.2 
+
+    player.scale_by(1.05)
+    player.move_indir(20)
+    yield 0.2 
+    
+    player.scale_by(1.05)
+    player.move_indir(20)
+
+player.when_this_sprite_clicked().add_handler(scale_move) 

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/3-loops-conditions/enemy.py

@@ -0,0 +1,14 @@
+import pyscratch as pysc
+game = pysc.game
+
+enemy = pysc.create_single_costume_sprite("assets/fish_red_outline.png")
+enemy.set_draggable(True) # optional: make the sprite draggable
+
+def appear():
+    enemy.x = game.screen_width/2
+    enemy.y = game.screen_height/2
+    enemy.hide()
+    yield 3
+    enemy.show()
+
+enemy.when_game_start().add_handler(appear)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/3-loops-conditions/main.py

@@ -0,0 +1,11 @@
+import pyscratch as pysc
+import player # Very important!
+import enemy # Very important!
+
+# start the game
+WIN_WIDTH = 500 # change me
+WIN_HEIGHT = 500 # change me
+framerate = 60
+
+pysc.game.update_screen_mode((WIN_WIDTH, WIN_HEIGHT)) 
+pysc.game.start(framerate)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/3-loops-conditions/player.py

@@ -0,0 +1,23 @@
+import pyscratch as pysc
+
+player = pysc.create_single_costume_sprite("assets/fish_brown_outline.png")
+player.set_draggable(True)
+
+def scale_move(): 
+
+    player.scale_by(1.05)
+    player.move_indir(20)
+    yield 0.2 
+
+    player.scale_by(1.05)
+    player.move_indir(20)
+    yield 0.2 
+
+    player.scale_by(1.05)
+    player.move_indir(20)
+    yield 0.2 
+    
+    player.scale_by(1.05)
+    player.move_indir(20)
+
+player.when_this_sprite_clicked().add_handler(scale_move) 

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/3-loops-conditions-task1/enemy.py

@@ -0,0 +1,14 @@
+import pyscratch as pysc
+game = pysc.game
+
+enemy = pysc.create_single_costume_sprite("assets/fish_red_outline.png")
+enemy.set_draggable(True) # optional: make the sprite draggable
+
+def appear():
+    enemy.x = game.screen_width/2
+    enemy.y = game.screen_height/2
+    enemy.hide()
+    yield 3
+    enemy.show()
+
+enemy.when_game_start().add_handler(appear)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/3-loops-conditions-task1/main.py

@@ -0,0 +1,11 @@
+import pyscratch as pysc
+import player # Very important!
+import enemy # Very important!
+
+# start the game
+WIN_WIDTH = 500 # change me
+WIN_HEIGHT = 500 # change me
+framerate = 60
+
+pysc.game.update_screen_mode((WIN_WIDTH, WIN_HEIGHT)) 
+pysc.game.start(framerate)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/3-loops-conditions-task1/player.py

@@ -0,0 +1,34 @@
+import pyscratch as pysc
+
+player = pysc.create_single_costume_sprite("assets/fish_brown_outline.png")
+player.set_draggable(True)
+
+def scale_move(): 
+
+    for i in range(20):
+        player.scale_by(1.025)
+        yield 0.03 
+
+    for i in range(20):
+        player.scale_by(0.975)
+        yield 0.03 
+
+player.when_this_sprite_clicked().add_handler(scale_move) 
+
+
+# Remember: The function is the stack of scratch blocks without the event block at the top
+def move(): 
+    while True: # the forever loop 
+        if pysc.is_key_pressed("d"):  # the sensing block: 'key [w] pressed'
+            player.x += 4   # the motion block: change y by [-4]
+
+        # the control block: wait [1/60] seconds 
+        # because the frame rate is 60, this is basically to wait for one frame
+        yield 1/60  # must have an yield in a loop! 
+
+# Attach the function to the event
+game_start = player.when_game_start() 
+game_start.add_handler(move) 
+
+# Or just in one line
+#player.when_game_start().add_handler(move) 

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/3-loops-conditions-task2/enemy.py

@@ -0,0 +1,23 @@
+import pyscratch as pysc
+
+spawn_button = pysc.create_single_costume_sprite("assets/button.png")
+
+def spwan_enemy(): 
+    enemy_red = pysc.create_single_costume_sprite("assets/fish_red_outline.png")
+    enemy_blue = pysc.create_single_costume_sprite("assets/fish_blue_outline.png")
+    
+    enemy_red.x = 0
+    enemy_red.y = pysc.game.screen_height/2
+
+
+    enemy_blue.x = pysc.game.screen_width 
+    enemy_blue.y = pysc.game.screen_height/2
+    
+    while True:
+        enemy_red.x += 4
+        enemy_blue.x -= 4
+
+        yield 1/60  # must have an yield in a loop! 
+    
+spawn_button.when_this_sprite_clicked().add_handler(spwan_enemy) 
+

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/3-loops-conditions-task2/main.py

@@ -0,0 +1,11 @@
+import pyscratch as pysc
+import player # Very important!
+import enemy # Very important!
+
+# start the game
+WIN_WIDTH = 500 # change me
+WIN_HEIGHT = 500 # change me
+framerate = 60
+
+pysc.game.update_screen_mode((WIN_WIDTH, WIN_HEIGHT)) 
+pysc.game.start(framerate)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/3-loops-conditions-task2/player.py

@@ -0,0 +1,41 @@
+import pyscratch as pysc
+
+player = pysc.create_single_costume_sprite("assets/fish_brown_outline.png")
+player.set_draggable(True)
+
+def scale(): 
+
+    for i in range(20):
+        player.scale_by(1.025)
+        yield 0.03 
+
+    for i in range(20):
+        player.scale_by(0.975)
+        yield 0.03 
+
+player.when_this_sprite_clicked().add_handler(scale) 
+
+
+# Remember: The function is the stack of scratch blocks without the event block at the top
+def move(): 
+    while True: # the forever loop 
+        if pysc.is_key_pressed("d"): 
+            player.x += 4  
+
+        if pysc.is_key_pressed("a"):  
+            player.x -= 4  
+
+        if pysc.is_key_pressed("w"):  
+            player.y -= 4  
+            
+        if pysc.is_key_pressed("s"):  
+            player.y += 4  
+
+        yield 1/60  # must have an yield in a loop! 
+
+# Attach the function to the event
+game_start = player.when_game_start() 
+game_start.add_handler(move) 
+
+# Or just in one line
+#player.when_game_start().add_handler(move) 

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/4-variables/enemy.py

@@ -0,0 +1,23 @@
+import pyscratch as pysc
+game = pysc.game
+
+enemy = pysc.create_single_costume_sprite("assets/fish_red_outline.png")
+enemy.set_draggable(True) # optional: make the sprite draggable
+
+def appear():
+    enemy.x = game.screen_width/2
+    enemy.y = game.screen_height/2
+    enemy.hide()
+    yield 3
+    enemy.show()
+
+enemy.when_game_start().add_handler(appear)
+
+
+
+def reduce_score():
+    game['Score'] -= 1 
+    
+enemy.when_this_sprite_clicked().add_handler(reduce_score) 
+
+

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/4-variables/main.py

@@ -0,0 +1,11 @@
+import pyscratch as pysc
+import player # Very important!
+import enemy # Very important!
+
+# start the game
+WIN_WIDTH = 500 # change me
+WIN_HEIGHT = 500 # change me
+framerate = 60
+
+pysc.game.update_screen_mode((WIN_WIDTH, WIN_HEIGHT)) 
+pysc.game.start(framerate)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/4-variables/player.py

@@ -0,0 +1,59 @@
+import pyscratch as pysc
+from pyscratch import game
+import pygame
+
+
+# create the variable
+game['Score'] = 0
+
+# for the display of the variable - v1.0.5, default font
+score_display = pysc.create_shared_data_display_sprite("Score")
+score_display.set_draggable(True) # optional
+
+
+# the sprite
+player = pysc.create_single_costume_sprite("assets/fish_brown_outline.png")
+player.set_draggable(True)
+
+
+def add_score():
+    game['Score'] += 1 
+
+player.when_this_sprite_clicked().add_handler(add_score) 
+
+def scale(): 
+
+    for i in range(20):
+        player.scale_by(1.025)
+        yield 0.03 
+
+    for i in range(20):
+        player.scale_by(1/1.025)
+        yield 0.03 
+
+player.when_this_sprite_clicked().add_handler(scale) 
+
+
+# Remember: The function is the stack of scratch blocks without the event block at the top
+def move(): 
+    while True: # the forever loop 
+        if pysc.is_key_pressed("d"): 
+            player.x += 4  
+
+        if pysc.is_key_pressed("a"):  
+            player.x -= 4  
+
+        if pysc.is_key_pressed("w"):  
+            player.y -= 4  
+            
+        if pysc.is_key_pressed("s"):  
+            player.y += 4  
+
+        yield 1/60  # must have an yield in a loop! 
+
+# Attach the function to the event
+game_start = player.when_game_start() 
+game_start.add_handler(move) 
+
+# Or just in one line
+#player.when_game_start().add_handler(move) 

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/5-sprite-object/enemy.py

@@ -0,0 +1,19 @@
+import pyscratch as pysc
+game = pysc.game
+
+spawn_button = pysc.create_single_costume_sprite("assets/fish_red_outline.png")
+spawn_button.y = 250
+
+def spwan_enemy(): 
+    enemy_blue = pysc.create_single_costume_sprite("assets/fish_blue_outline.png")
+
+    enemy_blue.y = pysc.random_number(0, game.screen_height)
+    enemy_blue.x = 0
+    
+    while True:
+        enemy_blue.x += 4
+
+        yield 1/game.framerate  # must have an yield in a loop! 
+    
+spawn_button.when_this_sprite_clicked().add_handler(spwan_enemy) 
+

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/5-sprite-object/main.py

@@ -0,0 +1,11 @@
+import pyscratch as pysc
+import player # Very important!
+import enemy # Very important!
+import pygame
+# start the game
+WIN_WIDTH = 500 # change me
+WIN_HEIGHT = 500 # change me
+framerate = 60
+
+pysc.game.update_screen_mode((WIN_WIDTH, WIN_HEIGHT)) 
+pysc.game.start(framerate, use_frame_time=True)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/5-sprite-object/player.py

@@ -0,0 +1,20 @@
+import pyscratch as pysc
+
+player1 = pysc.create_single_costume_sprite("assets/fish_brown_outline.png")
+player2 = pysc.create_single_costume_sprite("assets/fish_orange_outline.png")
+
+def move(): 
+    while True:
+        if pysc.is_key_pressed("d"):  
+            player1.x += 4   
+
+        if pysc.is_key_pressed("right"):  
+            player2.x += 4   
+
+        yield 1/60  # must have an yield in a loop! 
+
+# for the purpose of this tutorial, 
+# `player1.when_game_start()` and `player2.when_game_start()` are almost the same. 
+game_start = player2.when_game_start()  
+game_start.add_handler(move) 
+

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/5-sprite-object-task1/enemy.py

@@ -0,0 +1,19 @@
+import pyscratch as pysc
+game = pysc.game
+
+spawn_button = pysc.create_single_costume_sprite("assets/fish_red_outline.png")
+spawn_button.y = 250
+
+def spwan_enemy(): 
+    enemy_blue = pysc.create_single_costume_sprite("assets/fish_blue_outline.png")
+
+    enemy_blue.y = pysc.random_number(0, game.screen_height)
+    enemy_blue.x = 0
+    
+    while True:
+        enemy_blue.x += 4
+
+        yield 1/game.framerate  # must have an yield in a loop! 
+    
+spawn_button.when_this_sprite_clicked().add_handler(spwan_enemy) 
+

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/5-sprite-object-task1/main.py

@@ -0,0 +1,11 @@
+import pyscratch as pysc
+import player # Very important!
+import enemy # Very important!
+import pygame
+# start the game
+WIN_WIDTH = 500 # change me
+WIN_HEIGHT = 500 # change me
+framerate = 60
+
+pysc.game.update_screen_mode((WIN_WIDTH, WIN_HEIGHT)) 
+pysc.game.start(framerate, use_frame_time=True)

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/5-sprite-object-task1/player.py

@@ -0,0 +1,38 @@
+import pyscratch as pysc
+
+player1 = pysc.create_single_costume_sprite("assets/fish_brown_outline.png")
+player2 = pysc.create_single_costume_sprite("assets/fish_orange_outline.png")
+
+def move(): 
+    while True:
+        if pysc.is_key_pressed("d"): 
+            player1.x += 4  
+
+        if pysc.is_key_pressed("a"):  
+            player1.x -= 4  
+
+        if pysc.is_key_pressed("w"):  
+            player1.y -= 4  
+            
+        if pysc.is_key_pressed("s"):  
+            player1.y += 4  
+
+        if pysc.is_key_pressed("right"): 
+            player2.x += 4  
+
+        if pysc.is_key_pressed("left"):  
+            player2.x -= 4  
+
+        if pysc.is_key_pressed("up"):  
+            player2.y -= 4  
+            
+        if pysc.is_key_pressed("down"):  
+            player2.y += 4  
+
+        yield 1/60  # must have an yield in a loop! 
+
+# for the purpose of this tutorial, 
+# `player1.when_game_start()` and `player2.when_game_start()` are almost the same. 
+game_start = player2.when_game_start()  
+game_start.add_handler(move) 
+

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/5-sprite-object-task2/enemy.py

@@ -0,0 +1,20 @@
+import pyscratch as pysc
+game = pysc.game
+
+spawn_button = pysc.create_single_costume_sprite("assets/fish_red_outline.png")
+spawn_button.y = 250
+
+def spwan_enemy(): 
+    enemy_blue = pysc.create_single_costume_sprite("assets/fish_blue_outline.png")
+
+    enemy_blue.y = pysc.random_number(0, game.screen_height)
+    enemy_blue.x = 0
+    
+    while True:
+        enemy_blue.x += 4
+
+        yield 1/game.framerate  # must have an yield in a loop! 
+    
+spawn_button.when_this_sprite_clicked().add_handler(spwan_enemy) 
+
+

pyscratch_pysc-2.0.0/assets/startup-assets/tutorial-steps/5-sprite-object-task2/main.py

@@ -0,0 +1,11 @@
+import pyscratch as pysc
+import player # Very important!
+import enemy # Very important!
+import pygame
+# start the game
+WIN_WIDTH = 500 # change me
+WIN_HEIGHT = 500 # change me
+framerate = 60
+
+pysc.game.update_screen_mode((WIN_WIDTH, WIN_HEIGHT)) 
+pysc.game.start(framerate, use_frame_time=True)