Skip to content

Card draw / randomizer for use in music game tournaments including DDR, SMX, ITG, and PIU

License

Notifications You must be signed in to change notification settings

noahm/DDRCardDraw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

c8c6150 · Apr 13, 2024
Mar 29, 2024
Oct 3, 2023
Mar 7, 2024
Mar 9, 2024
Nov 25, 2023
Apr 12, 2024
Apr 12, 2024
Dec 6, 2021
Jul 31, 2023
Jul 2, 2023
Jan 3, 2024
Jan 22, 2024
Dec 12, 2023
Feb 20, 2024
Sep 12, 2021
Dec 12, 2023
Apr 13, 2024
Nov 25, 2023
Mar 10, 2024
Oct 13, 2023
Feb 26, 2024
Apr 11, 2024

Repository files navigation

DDR Tools

Discord GitHub contributors GitHub branch checks state GitHub last commit

The official build is available at https://ddr.tools/

Read all about what the app can do in the user manual

Customizing / Contributing

This app can be easily customized for novel formats a tournament might use. If you have feature requests or ideas, you're welcome reach out on our Discord server, Facebook messenger, or on the fediverse.

If you want to take a stab at developing on the app yourself, you will need have node.js >= 18.0.0 installed along with yarn. Some familarity with React will also help.

Clone this repo to your computer. Then the following commands will be useful:

# Before running anything else, do this!
# It's a one-time local install of dependencies needed to build the app.
yarn install

# local development will start, with app running at http://localhost:8080/
# edits to the files in ./src/ will automatically reload the browser
yarn start

# if you make changes to any game/song data in ./src/songs/ this will give
# a basic sanity check on the format and contents of it
yarn validate:json

# build a zipped, standalone copy of the app that runs entirely offline,
# jacket images and all! simply unzip somewhere and open index.html
yarn build:zip

Data imports

There are some other useful scripts in scripts/ that help in maintaining data integrity and pulling in new song data. Several have top-level aliases so you can conveniently update song data: (must have node and yarn installed, and run yarn install once, as above)

# download latest StepManiaX song data and jackets
yarn import:smx

# download latest DDR A3 song data and jackets (blends data from ZIv, RemyWiki, skillattack)
yarn import:ddr

# import an ITG/StepMania song pack into card draw
yarn import:itg path/to/pack/folder some-stub-name

# import the latest Pump it Up data using a data dump found here:
# https://github.com/AnyhowStep/pump-out-sqlite3-dump/
yarn import:pump path/to/pumpout/db

About

Card draw / randomizer for use in music game tournaments including DDR, SMX, ITG, and PIU

Resources

License

Stars

Watchers

Forks