Skip to content

Latest commit

 

History

History
87 lines (64 loc) · 6.06 KB

README.md

File metadata and controls

87 lines (64 loc) · 6.06 KB
Raw

TECHMANIA

An open source rhythm game, written in Unity, playable with or without a touchscreen.

Download for Windows

Download for iOS/iPadOS

Trailer

Discord

Official website

Licensing

All code and assets are released under the MIT License, with the following exceptions:

Roadmap and progress

Refer to the Kanban.

Manual and documentation

Refer to the documentation website.

Platform

The game is designed for Windows PCs, with the Touch control scheme requiring a touchscreen monitor. Patterns using other control schemes are playable with a mouse and keyboard.

We also provide technical support for iOS/iPadOS, in that we are able to respond to bug reports and some feature requests. However please be aware of the following:

  • The game's UI is designed for PC and may be difficult to navigate on a phone;
  • The game's difficulty is tuned for PC and may prove too difficult for mobile players;
  • Some features in the included editor require mouse and keyboard, and therefore are unavailble to mobile users.

Builds for other platforms also exist, but are not officially supported at the moment.

Content policy

Per the MIT license, you are free to produce any Content with TECHMANIA, including but not limited to screenshots, videos and livestreams. Attributions are appreciated, but not required. However, please keep the following in mind:

  • If your Content features 3rd party music, it may be subject to copyright claims and/or takedowns. You may not hold TECHMANIA responsible for the resulting losses.
  • If your Content is publicly available and features any unofficial skin, you must clearly state so in the description of your Content, to avoid potential confusion.
  • If your Content is commercial, additional limitations apply:
    • Your Content cannot feature the official tracks f for fun, Yin-Yang Specialist (MUG ver) and v (Game Mix).
    • Your Content cannot feature the Fever sound effect. You can swap the sound with one that allows commercial use, make a custom build, and produce Content from that build.

Feedback

For technical issues, read the contribution guidelines, then submit them to Issues.

For general discussions, head to Discord.

Making your own builds

Follow the standard building process:

  • Install Unity, making sure your Unity version matches this project's. Check the project's Unity version at ProjectVersion.txt.
  • Clone this repo, then open it from Unity.
  • File - Build Settings
  • Choose your target platform, then build.

Please note that the default skins are not part of the project, so you'll need to copy the Skins folder from an official release into your build folder, in order for your build to be playable. Alternatively, set up streaming assets in your local clone.

If the build fails or produces a platform-specific bug, you can submit an issue, but we do not guarantee support.

On streaming assets

In PC builds we release the base game and resources (official tracks and skins) separately so PC players don't need to redownload resources when updating. On mobile builds, however, it's more beneficial to include the resources in the release so the installation process is easier. To achieve this, we take advantage of streaming assets.

In order to keep this repo focused, the streaming assets folder (TECHMANIA/Assets/StreamingAssets) is ignored in .gitignore. To set up streaming assets in your local clone:

  • Create the following folders:
    • TECHMANIA/Assets/StreamingAssets
    • TECHMANIA/Assets/StreamingAssets/Tracks
    • TECHMANIA/Assets/StreamingAssets/Tracks/Official Tracks
    • TECHMANIA/Assets/StreamingAssets/Skins
  • Download Skins_and_Tracks.zip from an official release.
  • Copy everything:
    • from Skins_and_Tracks.zip/Tracks to TECHMANIA/Assets/StreamingAssets/Tracks/Official Tracks
    • from Skins_and_Tracks.zip/Skins to TECHMANIA/Assets/StreamingAssets/Skins

If done correctly, you should see official tracks and skins in the game even when they are not in the build folder.

Additionally, we perform the following optimizations / decorations for the mobile releases:

  • In tracks, convert .wav to .ogg, and .wmv to .mp4, in order to decrease file size and increase compatibility. When doing so, make sure to also update filenames in track.tech.
  • Copy TECHMANIA/Assets/Sprites/Logo.png to TECHMANIA/Assets/StreamingAssets/Tracks/Official Tracks so it shows up as eyecatch.

Platform-specific forks