DyNode Documentation

website·Indexed 31 days ago

https://dyn.iorinn.moe

Documentation for DyNode, a lightweight and efficient charting tool for the music game Dynamix. It includes guides on chart editing, timing points, project management, and importing/exporting formats such as .xml, .dyn, .dy, and .osu. The tool features advanced editing capabilities via a built-in console for batch operations and C-style mathematical expressions.

Tokens
30.7K
Snippets
102
Records
256
Agent score
46%

What's inside DyNode

  1. Overview of DyNode Charting Tool

    DyNode is a charting tool for the music game Dynamix. It is designed to enhance, improve, and modernize the visual interface and logic of existing Dynamix charting tools. For the most accurate feature set, users should refer to the latest pre-release versions available on the GitHub Release page, as the documentation may include features not yet present in stable releases.
  2. Introduction to DyNode Chart Editor

    DyNode is a chart editor for the music game Dynamix, designed to modernize the visuals and logic of existing Dynamix chart editors. Users should refer to the latest pre-release versions available on GitHub Releases to ensure access to the features described in the documentation, as some functions may not yet be in the stable release.
  3. Understand DyNode project structure and file handling

    A DyNode project contains all information necessary for chart creation, including difficulty, title, music, background files, timing, and the chart content itself. Project files use a JSON-based format and may be ZSTD compressed.

    Crucially, project files do not store the actual binary content of music or background files; they only store relative paths to these files on the computer. When a project is saved, associated music, background, and video files are copied to the same directory as the project file. If these external files are moved or deleted, the chart content remains intact, but the media will fail to load and must be manually re-linked and saved.

  4. Understand Timing Points in DyNode

    A Timing Point defines the synchronization of a song's segment. It consists of three primary components:

    • Offset: The time (in milliseconds) from the start of the song to the first beat of this Timing Point.
    • BPM (Beats Per Minute): The speed of the music.
    • Meter: The time signature, represented as an integer x which corresponds to x/4 time (e.g., a meter of 4 is 4/4 time, 3 is 3/4 time).

    Timing Points allow the editor to segment songs with tempo or time signature changes and determine the placement of the vertical grid (beat lines).

  5. Understand Timing Points in DyNode

    A Timing Point defines the synchronization between the music and the map grid. It consists of three primary components:

    • Offset: The offset of the first beat in milliseconds (ms). For example, an offset of 100 means the first beat occurs 100ms after the song starts.
    • BPM (Beats Per Minute): Measures the tempo of the music.
    • Meter: The beat pattern. In DyNode, this is represented as an integer x, meaning x/4 beats (e.g., 4 for 4/4 time, 3 for 3/4 time).

    Multiple Timing Points can be used in a single song to handle tempo changes (BPM changes) or meter changes.

  6. DyNode Project Overview

    DyNode is a charting tool for Dynamix, created by NagaseIori and NordLandeW. The software is licensed under the MIT License.
  7. DyNode project file format overview

    DyNode project files use the .dyn extension and follow the dyn file format v1 specification. The format is based on JSON and must use UTF-8 encoding. Files can be stored as plain text or compressed using the ZSTD algorithm (Zstandard Compression Format). To detect ZSTD compression, check for the magic number 0xFD2FB528 (little-endian) at the file header and use the ZSTD_decompress() function from the ZSTD standard library for decompression.
  8. DyNode Project Overview and Licensing

    DyNode is a Dynamix charting tool developed by NagaseIori and NordLandeW. The software is licensed under the MIT License. Most art assets used in the tool are sourced from the game Dynamix, produced by C4Cat Entertainment Limited.
  9. DyNode Project File Format Overview

    DyNode project files use the .dyn extension and follow the dyn file format v1 specification. The format is based on JSON and must use UTF-8 encoding.

    Compression: Files can be stored as plain text or compressed using the ZSTD algorithm (Zstandard Compression Format). To detect a compressed file, check for the magic number 0xFD2FB528 (little-endian) at the file header. Decompression can be performed using the standard ZSTD_decompress() function from the ZSTD library.

    Compatibility: Version 1 is not backward compatible with v0.1 (which used dyn file format v0). Project downgrades are not natively supported; users must export to the Dynamaker-modified format to import into older versions.

  10. Understand Timing Point concepts in DyNode

    A Timing Point defines the rhythmic structure of a specific section of a song. It consists of three primary components:

    • Offset: The offset of the first beat of the Timing Point in milliseconds (ms). For example, an offset of 100 means the first beat occurs 100ms after the song starts.
    • BPM (Beats Per Minute): Measures the tempo/speed of the music.
    • Meter: The beat pattern. In DyNode, this is represented as an integer x, meaning x/4 time (e.g., a meter of 4 is 4/4 time, a meter of 3 is 3/4 time).

    Multiple Timing Points can be used in a single song to handle tempo changes (BPM changes) or time signature changes.

  11. Understand DyNode project structure and file handling

    A DyNode project stores all necessary information to create a chart, including difficulty, title, music, background files, timing, and chart data. Project files use a JSON-based format (potentially compressed with ZSTD).

    Crucially, the project file does not store the actual music or background content, only their relative paths. When a project is saved, associated music, background, and video files are copied to the project file's directory. If these files are moved or deleted, the chart data remains intact, and the files can be reloaded and saved.

  12. Manage Timing Points using Editor Shortcuts

    Use the following keyboard shortcuts to add, modify, or remove Timing Points in the DyNode editor:
    # Add a Timing Point
    # If a single Note is selected, its time is used as the offset
    Y 
    
    # Copy the last Timing Point's time to the selected Note's time
    T
    
    # Import all Timing Points from an .osu file (overwrites existing points)
    F2
    
    # Delete the Timing Point at the current selected Note's time
    Ctrl + Delete
    
    # Undo/Redo timing changes
    Ctrl + Z / Ctrl + Y