What is this repository?

This is a fork of DTXManiaNX, with a main focus on improving QOL, as well as cleaning up and improving the codebase. This fork was initially started from frustration with the lack of QOL features or decent UX in essentially all DTXMania forks, and intends to create a gameplay and menu navigation system more in line with the arcade.

Installation / Downloads

Visit releases for automated builds. Stable builds are not provided at this point.

Some of the changes made from upstream DTXManiaNX:

• Newly written renderer

  • Uses an abstracted architecture allowing arbitrary graphics backends
    • Currently uses OpenGL (instead of DirectX9)
  • Supports translating, rotating, and scaling elements according to a hierarchy
  • Fully serializable and skinnable
  • Resolution independent
  • Font rendering currently handled by Skia

• New theming engine

  • Written on top of new renderer
  • Doesn't affect old UI elements (for now)
  • Any game element can be skinned or transformed

• Support for arbitrary resolutions such as 1080p or 2160p (4K)

  • Currently restricted to 16:9
  • UI scales gracefully, independent of resolution

• Rewritten song database

  • ~4-8x performance speedup
  • Safer handling of files
  • No more reliance on legacy (unsafe) BinaryFormatter
  • Song name transliteration (romanization)

• Greatly improved sorting functionality

  • Sorting functionality similar to GITADORA, with songs grouped in various categories
  • Group by BOX, Difficulty, Level, Title, Artist, etc

• Song selection UI recreated from scratch

  • Customizable options for various display parts
  • Grealy improved smoothness and UX

• Improved Guitar navigation

  • P + strum to confirm
  • Y + strum to go back

• Improved settings menu

  • Most menu options are now sorted into categories (for example, Audio, Video, Gameplay, etc)
  • Added options for drum velocity
  • Removed options that don't affect the current game
  • Improved naming and description for various elements

• Extensive Dear ImGui-based tooling

  • Inspector and hierarchy views for new UI framework, performance analysis, song database tests, etc
  • Toggle using ctrl + i
  • In game log viewer (ctrl + l)

Current roadmap (in no particular order)

• Rework guitar gameplay stage
• Feature parity on song select screen with upstream DTXManiaNX
• Lane swapping (similar to DTXMania AL)
• Song database serialization
• Song favourite filters
• (fuzzy) song search
  • Most of the work for this was already done, romanization for japanese is there
• Play results screen rework
• Create separate video rendering behaviour option for 4:3 videos to stretch
• Load random videos from a folder for charts with missing videos
• P4IO input support (arcade Gitadora hardware)
• Configurable slow/fast
• Configurable positions for judgement
• Separate kick pedal offset (?)

Building

The current .NET SDK target is 8.0 (In the future this will be lowered to 6.0, mainly so we can still support Windows 7, which is used by real hardware GITADORA machines) https://dotnet.microsoft.com/en-us/download/dotnet/8.0

Install the required SDK (Currently .NET 8.0)

winget install Microsoft.DotNet.SDK.8

Clone the repository

git clone https://github.com/BocuD/DTXmaniaNX.git
cd DTXManiaNX/DTXMania

Build a release

dotnet build -p:Configuration=Release

Run the game

cd ../Runtime
./DTXManiaNX.exe

In the root of the repository, a build_and_run.bat script is included to automate these steps.

What is DTXManiaNX?

DTXManiaNX is a program that replicates gameplay from Konami's music video game, Gitadora - Drummania/GuitarFreaks. It processes DTX files (including older formats such as BMS/BME or GDA/G2D) and allows playing of custom created charts with a use of a game, keyboard or MIDI controller.

For more information regarding creation of DTX files and its data formats, do visit the original DTXMania Wiki. Various video tutorials are available from APPROVED DTX Gaming's YouTube page or Furukon Rhythm Gaming's YouTube page.

Original and Ongoing Forks

• DTXMania4 (ＦＲＯＭ)

https://dtxmania.net/

• DTXManiaNX (limyz / fisyher)

https://github.com/limyz/DTXmaniaNX

• DTXMania (yyagi)

https://osdn.net/projects/dtxmania

• DTXMania AL (Sena)

http://senamih.com/dtxal

• DTXManiaXG verK (kairera0467)

https://osdn.net/projects/dtxmaniaxg-verk

Installation

1. Download the latest release of DTXMania and extract it to a location of your choice

2. Download and install the .NET 8.0 Runtime (if prompted)

3. Download and install the DirectX End-User Runtime (DirectX v9.0c)

4. Run DTXManiaNX.exe

Community Support

For additional help or support, ask away in DTXMania on Discord! https://discord.gg/ST5MWHe