NOTE: This project is dead and has been archived. Thanks to those who have helped made it what it is for the last 12 years.
Further ideas and contributions should be made toward the following projects instead:
OpenITG
An open-source rhythm dancing game which is a fork of StepMania 3.95
with the goal of adding arcade-like ITG-style behavior and serving as a drop-in
replacement for the ITG binary on arcade cabinents.
TODOs
Short-term
- Getting Started Guide - build and development
- self-contained cache-rebuilding solution
- OpenGL Driver uses fix function pipeline rather than shader
Long-term
- StepMania 4.0 LUA Bindings
- StepMania 4.0 Theme metrics
How to check-out the source
git clone https://github.com/openitg/openitg.git
How to contribute
- Create an account at github.com
- Goto https://github.com/openitg/openitg
- Click "fork"
git clone https://github.com/<username>/openitg.git
- Edit files...
git add <filename>
for every file you add or edit
git commit
# now your change is committed locally
git push
# now your change is pushed to your github
- From https://github.com//openitg, click "pull request". Base branch is the
branch you want to put your changes on, and head branch is the branch you made
your changes to already.
- Write a short description of your change. Be sure to include the goal, any
bugs fixed, features added, etc, and any credit you wish to have. Click "send
pull request".
How to build for arcade
- Choose a location for your chroot: MY_CHROOT=/home/cmyers/chroot
- Install debootstrap and chroot (on debian/ubuntu, apt-get install chroot debootstrap)
- Set up chroot, from root dir of source, as the root user, run:
./chroot-arcade.sh `pwd` $MY_CHROOT
cd /root/openitg-dev/ && ./build-arcade.sh
NOTE: the chroot will be created in the location you choose for MY_CHROOT. This
will build an entire Debian Sarge Linux system (the same OS used by arcade
machines). This will take approximately 350MB. A full clone of the repo is
about 300MB after you build all artifacts, so expect to have at least 650MB of
free space to work with.
How to build for home on 32-bit linux:
TODO: No chroot necessary, need script to install dependencies on various
distributions...
How to build for home on 64-bit Ubuntu:
# Install required dependencies
sudo apt install git build-essential autoconf automake \
libgl1-mesa-dev libglu1-mesa-dev libpng12-dev \
libjpeg62-dev liblua5.1-0-dev libvorbis-dev libmad0-dev \
libusb-dev libxrandr-dev libavcodec-dev libswscale-dev \
libavformat-dev libasound2-dev libavutil-dev
# Clone the software
git clone https://github.com/openitg/openitg.git
# Change to the OpenITG directory
cd openitg
# Build OpenITG
./build-home.sh
How to build for home on windows:
- Open visual studio (2010, 2013, and 2015 have been tested)
- Select "File -> Open Project" and pick src\Stepmania-net2010.sln
- 5 Projects will load in the solution explorer. Right click each and select properties.
- For each of the project properties, under the configurations drop-down, select "All Configurations" and under Configuration "Options->General" select the appropriate platform toolset for your VS Version.
- If you use Visual Studio 2013, depending on your edition of it, there is a bug, you will need to add the /FS flag to Additional Options under "C/C++ -> Command Line", or you can simply build twice the first time you build.
- To compile the release, select the appropriate profile (usually the SSE2 build), then select "Build -> Rebuild Solution".