Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

a smash-bros like game

branch: master
Octocat-spinner-32 data cut positions of basic version of robot October 29, 2012
Octocat-spinner-32 doc add publish_html rule in doc makefile May 17, 2012
Octocat-spinner-32 tests - moved tests outside of package and into independent directory May 17, 2012
Octocat-spinner-32 usf pylint fixes in entity/game/gui/level/timed_event May 20, 2012
Octocat-spinner-32 utils comment out unused variable "total" January 07, 2012
Octocat-spinner-32 .bzrignore added usf.profile to ignored files in bzr July 19, 2011
Octocat-spinner-32 .gitignore - converted ultimate-smash-friends to a shell script that envokes python May 19, 2012
Octocat-spinner-32 BUILD.txt - updated config module to be python 2.5 compatible November 07, 2011
Octocat-spinner-32 CHANGELOG fix crash at starting level June 05, 2011
Octocat-spinner-32 COPYING.txt Updating Licenses June 17, 2010
Octocat-spinner-32 CREDITS.txt fixed credits path November 25, 2010
Octocat-spinner-32 fix crash at starting level June 05, 2011
Octocat-spinner-32 INSTALL.txt - updated config module to be python 2.5 compatible November 07, 2011
Octocat-spinner-32 Adding main.pyw to manifest June 15, 2010
Octocat-spinner-32 completed keyboard infos in README.txt and April 27, 2011
Octocat-spinner-32 README.txt - updated config module to be python 2.5 compatible November 07, 2011
Octocat-spinner-32 TODO.txt removed old done tasks from TODO.txt June 17, 2011
Octocat-spinner-32 pylint fixes June 22, 2011
Octocat-spinner-32 pylintrc added pylintrc file June 14, 2011
Octocat-spinner-32 setup.cfg - recreated accidentally deleted setup.cfg November 06, 2011
Octocat-spinner-32 setup.iss corrected windows package installer version April 29, 2011
Octocat-spinner-32 - updated November 09, 2011
Octocat-spinner-32 stdeb.cfg updated stdeb.cfg to add .desktop file to usr/share/applications June 08, 2011
Octocat-spinner-32 ultimate-smash-friends - removed dead wood from usf/main May 19, 2012
Octocat-spinner-32 ultimate-smash-friends.desktop fixed icon path and removed unnecessary quotes June 08, 2011
Octocat-spinner-32 viewer.pyw fixed viewer pygame display May 17, 2010
Ultimate Smash Friends

Ultimate Smash Friends is a game which aim at creating quick and fun multiplayer
entertainment. With nice 2d bitmap graphics and arcade gameplay we hope to
deliver hours of fun.

How to install

see INSTALL file if you have not already installed the game.


Global configuration resides in the system.cfg file. If this file does not exist
(because you didn't install Ultimate Smash Friends), you can generate it from the
commmand line as follows:
$ python2 -m usf.config

Local Configuration resides in user.cfg, whose location depends on your platform

Launching the game

In a graphical desktop environment, the game may be launched by double-clicking
on the 'ultimate-smash-friends' script.

Alternatively, the game may be launched from a terminal by typing the following:
python2 -m usf.main

Or, from within the ultimate-smash-friends directory:

You can directly launch a game by passing level and player parameters, separate
players name by a comma, like this:

./ultimate-smash-friends --level rizland --players xeon,blob

(--level can be abreviated as -l and --players as -p)
you can add an artificial intelligence player by adding "AI" before the name of
the character, e.g:

./ultimate-smash-friends --level rizland --players blob,AIxeon

like this the second player will be an AI player.


Keys configuration are stored in the user.cfg file and can be changed from the
options menu of the game

Each player has 4 direction keys and two action keys referred here as A and B
plus a SHIELD key.

Basic actions:

  * The LEFT and RIGHT keys allow to walk
  * The UP key allow to jump
  * The DOWN key allow to pick an item
  * The A key trigger a kick
  * The B key trigger a simple hit
  * The SHIELD key set the shield on until the key is released of the shield is

Combined actions:
  * During a jump, the UP key will trigger a second jump
  * When DOWN has been pushed, a LEFT or RIGHT push will trigger a roll
  * When B is pushed just after a move in any direction, that will trigger a
  smash in that direction
  * When A is pushed after DOWN, a special attack is triggered, if available
  * When DOWN is pushed two times, and then A is pushed, another special attack
  is triggered, if available


The escape key can be used to toggle the menu. Launching a new game will cancel
any current game.


Each character has 7 keys: 4 directional and 2 action keys plus the SHIELD key,
the actions keys are further referenced as A and B. You can use A and B in
combination with directions keys to make more complexe attacks (combos).

the SHIELD key is used to protect the player, but it can't move while protected.

Use the escape key to access the menu in game.

How to win

Rules are simple, when you hit someone, his percents raise, and is projected
every time a little more far, the aim is to beat the enemies out of the map, you
have 3 lives.

Enjoy :)


The addition of characters and levels is designed to be easy, only bitmaps and
an xml file! Characters support vectors in any animations, collision points
in any animations, adding event to game in any animations, the
characters behaviour is very flexible, It's also easy to code a particular
event if you are a developper. We hope this will encourage collaborative
creation of original characters and levels.  Please see the wiki for help on
characters/maps creation.


Please send reports, suggests or patchs to:

last update: Wed, 27 Apr 2011 18:45:51 +0200
Something went wrong with that request. Please try again.