miniworlds#
miniworlds is a game engine written in Python and Pygame, designed for students to create 2D mini-worlds and games.
Creating your first games with minigames is simple and fun.
miniworlds and miniworldss
miniworlds is the successor project to miniworldss. Many things are similar, but some names and functions differ from miniworldss. (e.g., Tokens became Actors, Boards became Worlds)
Examples#
Two actors controlled by keyboard#
Two actors that are controlled using the keyboard.
from miniworlds import World, Actor
world = World()
world.add_background("images/grass.jpg")
player = Actor((90,90))
player.add_costume("images/player.png")
player.costume.orientation = -90
@player.register
def on_key_down_w(self):
player.y = player.y - 1
player2 = Actor((180,180))
player2.add_costume("images/player.png")
player2.costume.orientation = -90
@player2.register
def on_key_pressed_s(self):
player2.y = player2.y - 1
world.run()
Example: Two actors#
Skeetshooting#
A randomly placed target can be “shot” with the mouse.
from miniworlds import World, Actor, Number
import random
world = World(400, 400)
world.add_background("images/skeetshooting.png")
target = Actor((100, 100))
target.add_costume("images/target-red.png")
target.orientation = -90
target.size = (80,80)
cooldown = 5
hits = Number((20,20), 0)
@target.register
def act(self):
global cooldown
if self.world.frame % 50 == 0:
target.position = (random.randint(0, 400), random.randint(0, 400))
cooldown -= 1
@target.register
def on_clicked_left(self, position):
global cooldown, hits
if cooldown < 0:
hits += 1
cooldown = 10
world.run()
Example: Skeetshooting#
Aircrafts#
Classic game where you control an aircraft, avoid and shoot enemies.
from miniworlds import World, Actor, Circle, Text
import random
world = World(300, 600)
world.add_background("images/clouds.png")
world.background.is_scaled = False
aircraft = Actor((150, 500))
aircraft.add_costume("images/ship.png")
@aircraft.register
def on_setup(self):
"""The downtime specifies the number of frames until the next shot can be fired.
If downtime > 100 a shot can be fired (@see on_key down of aircraft)
"""
self.downtime = 0
@aircraft.register
def act(self):
"""Increment the downtime every frame per 1"""
self.downtime += 1
@aircraft.register
def on_key_pressed(self, keys):
"""Move aircraft left/right with a, d keys.
"""
if "a" in keys:
aircraft.x -= 1
elif "d" in keys:
aircraft.x += 1
@aircraft.register
def on_key_down(self, keys):
"""Shoot, if downtime > 100
"""
if " " in keys and self.downtime > 100:
position = aircraft.center
position = (aircraft.center[0], aircraft.center[1] - 20)
bullet = Circle(position)
self.downtime = 0
@bullet.register
def act(self):
self.y = self.y - 1
@bullet.register
def on_detecting_actor(self, other):
if other in self.world.enemies:
other.remove()
self.remove()
@world.register
def on_setup(self):
self.enemies = []
@world.register
def act(self):
if self.frame % 120 == 0:
enemy = Actor((random.randint(30, 270), 50))
enemy.add_costume("images/enemy.png")
enemy.orientation = 180
self.enemies.append(enemy)
@enemy.register
def act(self):
self.y = self.y + 1
@enemy.register
def on_detecting_actor(self, other):
""" If enemy detects the aircraft, the game ends.
"""
if other == aircraft:
self.world.stop()
aircraft.remove()
t = Text((150, 300), "GAME OVER")
t.color = (0, 0, 0)
for enemy in self.world.enemies:
enemy.remove()
self.remove()
world.run()
Example: Skeetshooting#
RPG Template with console and sidebar#
from miniworlds import TiledWorld, Toolbar, Console, Actor, Button, Label, PagerHorizontal
world = TiledWorld()
world.columns = 8
world.rows = 8
world.tile_size = 24
world.camera.world_size_x = 16
world.camera.world_size_y = 16
world.add_background((255, 255, 255, 255))
toolbar = Toolbar()
@toolbar.register
def on_setup(self):
self.add_background("images/bg")
self.background.set_mode(mode="textured", texture_size=(200, 200))
world.toolbar = world.layout.add_right(toolbar, size=180)
console = Console()
world.console = world.add_bottom(console, size=100)
world.console.newline("You enter a new world")
pager = PagerHorizontal(console)
world.add_bottom(pager, size=60)
def create_grass(pos):
g = Actor(pos)
g.add_costume("images/grass2.png")
g.static = True
g.layer = 0
def create_wall(pos, walls):
w = Actor(pos)
w.add_costume("images/wall.png")
w.static = True
w.is_blocking = True
walls.append(w)
@world.register
def on_setup(self):
for i in range(world.rows):
for j in range(world.columns):
create_grass((j, i))
self.walls = []
create_wall((0, 4), self.walls)
create_wall((1, 4), self.walls)
create_wall((2, 4), self.walls)
create_wall((3, 4), self.walls)
create_wall((4, 4), self.walls)
create_wall((5, 4), self.walls)
create_wall((6, 4), self.walls)
create_wall((6, 0), self.walls)
create_wall((6, 1), self.walls)
create_wall((6, 3), self.walls)
torch = Actor((10, 4))
@torch.register
def on_setup(self):
torch.layer = 2
torch.add_costume("images/torch.png")
fireplace = Actor((10, 12))
fireplace.layer = 2
@fireplace.register
def on_setup(self):
self.costume_not_burned = fireplace.add_costume("images/fireplace_0.png")
self.burning = False
self.costume_burned = fireplace.add_costume(
["images/fireplace_1.png", "images/fireplace_2.png"]
)
fireplace.switch_costume(self.costume_not_burned)
door = Actor((6, 2))
@door.register
def on_setup(self):
self.add_costume("images/door_closed.png")
self.closed = True
self.door_open_costume = door.add_costume("images/door_open.png")
self.switch_costume(0)
door.layer = 2
player = Actor((8, 2))
@player.register
def on_setup(self):
self.add_costume("images/knight")
self.costume.is_rotatable = False
self.layer = 3
self.is_blockable = True
@player.register
def act(self):
self.world.camera.from_actor(self)
@player.register_message("burn")
def burn_torch(self, sender):
print("BURN?")
if not fireplace.burning:
fireplace.world.play_sound("sounds/fireplace.wav")
fireplace.switch_costume(fireplace.costume_burned)
fireplace.costume.is_animated = True
@player.register_message("open_door")
def open(self, sender):
if door.closed:
door.switch_costume(door.door_open_costume)
door.world.play_sound("sounds/olddoor.wav")
door.closed = False
inventory = []
@player.register
def on_key_down_w(self):
player.move_up()
@player.register
def on_key_down_s(self):
player.move_down()
@player.register
def on_key_down_a(self):
player.move_left()
@player.register
def on_key_down_d(self):
player.move_right()
@player.register_message("Torch")
def light_fireplace(self, data):
print("light")
found_actors = player.detect_all()
if fireplace in found_actors:
self.world.console.newline("You light the fireplace.")
self.send_message("burn")
self.world.toolbar.remove("Torch")
else:
self.world.console.newline("...nothing happens")
@player.register_sensor(door)
def ask_open_door(self, door):
if door.closed:
self.undo_move()
message = "The door is closed - Do you want to open it?"
reply = self.ask.choices(message, ["Yes", "No"])
if reply == "Yes":
self.send_message("open_door")
@player.register_sensor(torch)
def pick_up_torch(self, torch):
reply = self.ask.choices(
"You find a torch - Do you want to pick it up?", ["Yes", "No"]
)
if reply == "Yes":
inventory.append("Torch")
torch.remove()
l = Label("You pick up the torch")
line = world.console.add(l)
b = Button("Torch", "images/torch.png")
world.toolbar.add(b)
world.run()
Example: RPG#
Credits#
Greenfoot <https://www.greenfoot.org/>_ Miniworlds is strongly inspired by Greenfoot.Kenney Assets <https://www.kenney.nl/assets>_ Most images in the examples are based on Kenney Assets