bromagosa / ludus

Ludus is a game framework on top of Amber. The name stands for game or leisure in Latin.

Ludus for Amber

Ludus is an HTML5 canvas game framework for Amber Smalltalk.

You can find documentation for all methods and a couple of example games at the project page.

This repository is a move to Amber Smalltalk version 0.12.4 from the original Ludus as an Amber branch (version 0.9.1). The name stands for game or leisure in Latin.

Ludus has been ported from Amber 0.9.1 to Amber 0.12.4 by Philippe Back and Hannes Hirzel.

Prerequisites

1. A web browser with reasonably good support for HTML5 canvas.
2. nodejs. This will give you the node package manager npm as well.
3. A global install of the amber npm package
4. A global install of the bower client side package manager in order to install the dependencies

The amber and bower packages can be installed with the following command (In some cases you have to call npm with sudo npm):

npm install --global amber-cli bower

or the same thing, but less typing:

npm i -g amber-cli bower

Getting Started

Clone the repo, and start the amber server:

git clone https://github.com/bromagosa/Ludus.git
cd Ludus
amber serve

Point your browser to:

http://localhost:4000/dev.html

Enjoy!

The default port is 4000. Use --port to specify a custom port:

amber serve --port 9000

See also

Another Amber Smalltalk game framework by Masashi Umezawa https://github.com/mumez/enchant-from-amber . It wraps the enchantjs library with Amber Smalltalk code.

Submarine game in Amber https://github.com/johnnyt/subwars

ludus's Issues

Rename games.html to index.html

Remove index.html and
rename games.html to index.html in preparation for publication on gh-pages.

Implement swipes for mobile devices

Fix the SmallCave welcome screen in some browsers

In some browsers I've noticed the welcome screen is not shown. However, when you click on the canvas, the game starts normally.

Left player keys in the pong example are reversed

Q moves the paddle down, A moves it up. Should be the other way around.

Sprite animations broken in Sokoban

Happened on merging with latest changes derived from the Ovni game...

Add a new step-by-step example

Such as the one in the screencast I recorded for the Mozilla Festival 2011:

http://vimeo.com/31597779

Create methods to detect mouse events on Sprites

Sprite >> onMouseClickDo: aBlock

Then it should be called from Game >> step. For instance:

cow onMouseOverDo: [ (self soundNamed: 'moo') play ].
draggableBox whileMouseDownDo: [ draggableBox center: self mousePosition ].
quitIcon onMouseClickDo: [ self end ]

We need to consider conflicts between Game mouse events and Sprite mouse events. What to do if both elements have mouse events defined?

Keyboard scrolling should be disabled while a game is on

Coordinates in some mouse events are wrong

Try to embed a memory game in a page, not at the corner, and see.

Scale and Rotation for Sprites

Imported from https://github.com/bromagosa/amber/issues/4

Documentation from 0.9.1

Check if all of the documentation of https://github.com/bromagosa/amber/tree/ludus has been lifted to the new repo.

MemoryGame -- showing second tile

When the user clicks on a second tile which does not match the first one the two tiles are hidden too quickly. Add a delay before hiding the two tiles.

handleCardClick

    | clickedCard |

    clickedCard := cards detect: [ :which | which touchingMousePointer: self mousePosition ] ifNone: [ nil ].

    clickedCard ifNotNil: [
        (self soundNamed: clickedCard animalName) play.
        clickedCard showAnimal.
        lastSelectedCard 
            ifNil: [ lastSelectedCard := clickedCard ]
            ifNotNil: [
                lastSelectedCard = clickedCard 
                    ifTrue: [ clickedCard hideAnimal ]
                    ifFalse: [
                        lastSelectedCard animalName = clickedCard animalName 
                            ifTrue: [ Transcript show: 'yay :)'; cr ]
                            ifFalse: [ 
                                lastSelectedCard hideAnimal.
                                clickedCard hideAnimal ]].
                lastSelectedCard := nil.
            ]
    ]

SmallCave start

 SmallCave start

in a workspace gives an error message.