TJAPlayer3

TJA Format and on

Main maintainer of this article: @IepIweidieng

This is an unofficial compilation and commentation of the TJA format & its related formats.

This article aims at providing a comprehensive enough overview & possible etymologies and addressing undocumented corner cases.

This article is still in construction and will be updated at times. It’s recommended to check its change history regularly.

Also see TODO for known issues and planned changes of this article.

This article also contains unimplemented proposals, including tentative proposals by the main maintainer of this article and known proposals by simulator developers. These proposals are explicitly expressed to be Proposals and may be subject to changes. See Proposers for the list of proposers for proposals listed in this article.

See Terminologies for the explanation and conventions of some terminologies used in this article.

When there exist multiple equivalent usages accepted by the simulators, the conventional ones are represented in bold.

Formats

Notechart Formats

Known external-use notechart formats used in 太Tai 鼓ko のno 達Tatsu 人jin games and simulators:

The dates listed here are mostly in UTC+9.

Extension Full Name Content Supported by First Release Specification
.bin Binary (譜Fu 面men Notechart File Format) Notechart metadata + definition (binary file) Official games, taiko-web (plugin “Fumen File Format”) 2000 (official local test)
2001-02-21 (AC1)		 Proprietary format, not explained in this article.
.tjf Tatsujin 譜Fu 面men Notechart Data (?) Notechart metadata + definition Taikosan, TaikoJiro 1 2004-05-08 (TJF EDIT)
2006-03-30 (Taikosan nicover)
2007-07-06 (Taikosan’s public release)
2009-01-16 (Taikosan’s public re-release with TJF EDIT’s public release)		 Re-released Taikosan’s Readme.txt
data.txt owatatsujin Notechart Data (?) Notechart set metadata + definition owatatsujin 2007-03-04 (owatatsujin v1.31; first release) See https://web.archive.org/web/20150527222157/http://www.geocities.jp/syun_k765/flash/owatatsu/seqhowto.html
Based on the notechart format of CIRRING-S by D4U: http://noia.g3.xrea.com/parastoic/crs/maker.html
and CarmBeat by D4U http://noia.g3.xrea.com/parastoic/carm/maker.html
Similar to the Simai notation, which is also based on D4U’s format: https://w.atwiki.jp/simai/pages/1003.html
.osu osu! Beatmap Notechart metadata + definition osu!, taiko-web, OutFox (Taiko mode planned) 2007-07-01 (UTC+?)
2008-05 (taiko mode)
Non-after 2008-05-23 (first known mentioning)		 See https://osu.ppy.sh/wiki/en/Client/File_formats.
An .osu file with std or Taiko mode can be played as a Taiko chart.
.sm StepMania Chart (?) Notechart metadata + definition StepMania 3.0, OutFox v0.4.9.9 (taiko mode) (?) 2002-10-23 (StepMania 3.0 release)
2008-07-20 (unofficial taiko mode by toach, author of TaikoJiro)
2021-07-31 (taiko mode) (OutFox v0.4.9.9; first taiko mode release)		 No known official full specification.
No official documentation for Taiko chart. For general chart, see https://outfox.wiki/en/dev/mode-support/sm-support
No known released charts for toach’s unofficial taiko mode, but see https://www.nicovideo.jp/user/460596/mylist/7250555
.tja Tatsujin Notechart Format A(?) (?) Notechart metadata + definition TaikoJiro, Malody, TJAPlayer2 for.PC, taiko-web ver.18.10.11, OutFox v0.4.9.9, TaikoManyGimmicks 2008-12-08 (TaikoJiro v0.80; first release) TaikoJiro’s readme.txt
Also see TaikoJiro 2’s readme.txt
Many extensions exist
.tjc Tatsujin Course (?) Notechart set metadata TaikoJiro v2.34, TaikoJiro 2 v0.98 2009-12-28 (TaikoJiro v2.34) TaikoJiro’s readme.txt
.tps taikopsp Score (?) Notechart definition 太Tai鼓koのno玄Kuro人uto for PSP (taikopsp) 2009-06-12 (taikopsp demo version)
2009-06-18 (taikopsp v0.1.0)
Non-after 2009-08-29 (TPSConverter v0.31 already released)		 taikopsp’s りどみ.html (“Readme.html”)
ot_data.txt OniTaiko DS data Notechart definition 鬼Gwai2太Taai3鼓gu2DS (OniTaiko DS) 2009-07-14 (onitaiko DS v0.8.2 test version)
Non-after 2010-03-05 (known first chart file)		 See the 31-7-2010 entry of:
https://web.archive.org/web/20181012220107/http://www.owataiko.com/~aki/onitaiko_past.html
(zh_HK in UTF-8; need switching page character encoding to read)
.mc Malody Chart (?) Notechart metadata + definition (JSON) Malody Non-before 2014 (Malody)
Non-after 2017-06-24 (mc2tja)		 No known official documentation.
See the non-official parser https://github.com/LuiCat/mc2tja.
An .mc file with Taiko mode can be played as a Taiko chart.
.dtx DTXMania Chart (?) Notechart metadata + definition TJAPlayer2 for.PC (early versions, deprecated (?)) Non-before 2000-01-17 (DTXMania v0.01; first release)
Non-after 2006-06-19 (DTXCreator v0.01; first release)
Non-before 2015-05-15 (taiko mode; 太Tai鼓koさsaんnアAルruファfa (early TJAPlayer2 for.PC) OSDN project registration)		 First used in DTXMania, inherited by TJAPlayer2 for.PC.
No official documentation for Taiko chart. For general chart, see (English translation) https://osdn.net/projects/dtxmania/wiki/DTX%20data%20format,
(Japanese original) https://osdn.net/projects/dtxmania/wiki/DTXデータのフォーマット
songtitles.txt Song Titles Notechart titles taiko-web 2019-04-04 (example)
2019-04-05 (taiko-web commit)		 <blockquote>- A translation text file “songtitle.txt” can be imported
  - Titles and translated titles are each on their own line, if a line begins with a language code, it will translate the song title that is above
  - An example file can be found here: https://gist.github.com/LoveEevee/65fe66f0b54c0536f96fd2f4862984d4</blockquote> Example: https://web.archive.org/web/20200630184942/https://gist.github.com/LoveEevee/65fe66f0b54c0536f96fd2f4862984d4
.tci Open Taiko Chart Information Notechart metadata (JSON) Koioto (plugin “OpenTaikoChart”), TJAPlayer3-f v1.6.0.1 2019-08-17 (format rev.1)
2020-05-07 (plugin “OpenTaikoChart”)		 See https://github.com/AioiLight/Open-Taiko-Chart
.tcc Open Taiko Chart Course Notechart definition (JSON with non-parsed strings) Koioto (plugin “OpenTaikoChart”), TJAPlayer3-f v1.6.0.1 2019-08-17 (format rev.1)
2020-05-07 (plugin “OpenTaikoChart”)		 See https://github.com/AioiLight/Open-Taiko-Chart
.tcm Open Taiko Chart Medley Notechart set metadata (JSON) Koioto (plugin “OpenTaikoChart” v3.0), TJAPlayer3-f v1.6.0.1 2019-11-15 (format rev.2)
2020-05-07 (plugin “OpenTaikoChart”)		 See https://github.com/AioiLight/Open-Taiko-Chart
.ssc StepMania 5 (the spinal shark collective) Chart (?) Notechart metadata + definition sm-ssc (early StepMania 5), OutFox v0.4.9.9 (taiko mode) (?) 2011-02-11 (format introduction)
2011-02-10 (sm-ssc v1.2.1)
2021-07-31 (taiko mode) (OutFox v0.4.9.9; first taiko mode release)		 No known official full specification.
No official documentation for Taiko chart.
For general chart, see https://outfox.wiki/en/dev/mode-support/ssc-support
.tmg TaikoManyGimmicks Notechart metadata + definition TaikoManyGimmicks v0.6.1α 2022 (TaikoManyGimmicks)
2023-04-13 (v0.6.1α, TMG format support)		 TaikoManyGimmicks’ Readme.txt.
The plaintext form is similar to .tja but has some syntax differences (explained right below).

.osu and .mc have corresponding compressed formats, which include multiple notecharts for each difficulty and additional resource files:

The TMG format (.tmg) has plaintext and binary form, where the plaintext form is similar to the TJA format (.tja) and has the following features:

Excluding .bin and the compressed formats, all the formats listed above are text-based and can be edited with any text editor.

Genre Formats

Known external-use genre formats used in 太Tai 鼓ko のno 達Tatsu 人jin games and simulators:

The dates listed here are mostly in UTC+9.

Filename/extension Content Supported by First Release Notes
genre.ini Genre definition for notecharts in the (sub)directory/ies. INI config file. TaikoJiro, taiko-web 2009-06-17 (TaikoJiro v1.90)  
musiclist.txt List of file paths to notecharts TJAPlayer (for PSP) Non-after 2010-02-10 (musiclistGenerator v6)
Non-after 2010-02-24 (TJAPlayer Ver ?×7 already released)		 Similar to the later .t3u8, but in native encoding (assumedly Shift-JIS)
and with the first occurrence of a line being #END (if exist) and all subsequent line ignored.
song.txt Number of notechart directories + List of directory name of notechart directories 鬼Gwai2太Taai3鼓gu2DS (OniTaiko DS) Non-after 2010-06-27 (OniTaiko DS F C v.1.2.1X fat) See https://web.archive.org/web/20100726082352/http://www.owataiko.com/~aki/_onitaikods/readme.txt
box.def Genre definition for notecharts in the (sub)directory/ies. .dtx-syntax headers. TJAPlayer2 for.PC, taiko-web Non-before 2000-01-17 (DTXMania v0.01; first release)
Non-before 2015-05-15 (taiko mode; 太Tai鼓koさsaんnアAルruファfa (early TJAPlayer2 for.PC) OSDN project registration)		 First used in DTXMania, inherited by TJAPlayer2 for.PC
folder.json Genre definition for notecharts in the (sub)directory/ies. (JSON) 2021-02-18 (bundled sample)
2021-03-09 (Koioto Ver.0.39; first release)		 Koioto  
.t3u8 List of file paths to notecharts TJAPlayer3 v4.7.0 2019-07-18 (TJAPlayer3 commit 9261ee0271)
2020-02-03 (TJAPlayer3 v4.7.0)		 See https://github.com/twopointzero/TJAPlayer3/blob/develop/docs/song-list-files.md.
Based on and having identical syntax with .m3u8.
.m3u8 is a UTF-8–encoded variant of .m3u (MP3 URL).

About TJA

The TJA format (.tja, first used in TaikoJiro) was modified and extended from the much simpler TJF format (.tjf, first used in Taikosan), both share similarities with the .bms (Be-Music Script, not BeatMania Score) format and its derivations, especially the .dtx (DTXMania) format.

Naming of TJA

The etymology of both .tjf & .tja were unexplained.

Thus, .tja possibly means (太Tai 鼓ko のno) 達Tatsu 人jin (simulator) 譜fu 面men デーdee タta “(Taiko no) Tatsujin (Simulator) Notechart Format A”.

Standardizations of TJA

The specification and behavior of TJA in TaikoJiro (active in 2008–2013) was often considered the standard for many years.

However, many extensions after are developed and adopted after TaikoJiro, especially since TJAPlayer2 for.PC, and there lacks a cross-simulator standard.

Since around 2022, OpenTaiko (0auBSQ) and Project OutFox have started to collaborate on a new cross-simulator standardization, which is referred to as “OpenTaiko-OutFox standard” in this article.

For OpenTaiko (0auBSQ) and Project OutFox, the per-simulator behaviors are documented, but their behaviors will be unified through their development. Any new-found discrepancies of these simulators from the OpenTaiko-OutFox standard will be soon consolidated and reported to the relevant project.

TJA File Encoding

The mostly used character encoding for legacy TJA files is Shift-JIS.

However, the actual encoding depended on the system setting and can potentially be any non–UTF-8 encoding, including:

UTF-8 (with BOM or not) is often used for modern TJA files.

Compatibility Issues

TJA Lexical Rules

Newlines

Lines are separated (may be unterminated) by either LF (\n) or CR+LF (\r\n) (see Terminologies for further explanation).

Lines containing only whitespaces or nothing at all are ignored.

Comment & Whitespaces

Except when preceded by a text value, // starts a comment which ends at the end of the line and is ignored along with the //.

Except when preceded by a text value, line-final whitespaces (after ignoring comments) are ignored.

Line-initial whitespaces are allowed and ignored only within the notechart definition enclosed between #START & #END (excluding themselves).

Except when within a string value and around a text value, consecutive whitespaces within a line is treated as a single space.

Comma

For multiple values separated by comma (,), except for text-valued fields, optional whitespaces can occur before and/or after the comma.

Value Type

TJA Header

Header Overview

Header Format

TJA header are written in the format of HEADER:values.

Each header MUST be placed on its own line.

The HEADER: part MUST be written in an all-upper-case manner and MUST NOT contain whitespaces in-between. No leading non-newline whitespaces are allowed.

Headers with an unrecognized HEADER: name are ignored.

If the values part is omitted, the default value is used, which can be used for resetting previously used headers from other difficulties or player sides to their default value.

For non-string values, whitespaces can immediately occur after :, e.g., LEVEL: 8.

Post-#START Header Position

Most headers are expected to be placed outside the notechart definition enclosed between #START & #END. However, some commands are allowed to be placed within the notechart definition, or “post-#START position”.

Headers allowed in post-#START position will be explicitly denoted.

Header Scope

For headers not in post-#START position, the effect of each header continues until the next occurrence of the same header or the end of the file.

Headers in post-#START position (e.g., the EXAM headers) are effectively commands.

Header Scope Fineness

See scope fineness.

For headers, the coarsest fineness is per-file. The finest fineness other than sequential is per–player-side.

sequential > per–player-side > per-file

Compatibility Issues

TITLE Headers

OpenTaiko-OutFox standard version: 1.0 (including any <enum-str-lang> forms)
Impact level: metadata ★・・・・
First seen in: TJF format
Supported by: (assumedly universally supported, including TaikoJiro v0.80, Malody, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope fineness: per-file

Specify the title of the song.

SUBTITLE Headers

OpenTaiko-OutFox standard version: 1.0 (including any <enum-str-lang> forms)
Impact level: metadata ★・・・・
First seen in: TaikoJiro v2.64
Supported by: (assumedly universally supported, including TaikoJiro v0.80, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope fineness: per-file

Specify the subtitle (not of the meaning of caption) of the song (could be artist, game series, etc.), or alternatively as the second line (“sub”) of the title.

If the artist of the song should be specified while the subtitle is already used as the second line of the title, the ARTIST: header can be used to specifying the artist of the song.

The display details are unspecified.

ARTIST:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: metadata ★・・・・
First seen in: Malody
Scope fineness: per-file

Specify the artist of the song.

Similar to the -- prefix usage of the SUBTITLE: header, but excluding extra information such as game series, anime series, etc.

The display details are unspecified.

MAKER:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: metadata ★・・・・
First seen in: taiko-web ver.19.11.25
Supported by: OpenTaiko (0auBSQ) v0.6.0
Scope fineness: per-file

Specify the creator (“maker”) of the notechart.

The display details are unspecified.

NOTESDESIGNER Headers

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible) (including both forms of <enum-int-difficulty-course> being 0–4 and being omitted)
Impact level: metadata ★・・・・
First seen in: (Better)TaikoCatsCaffe (?)
Supported by: OpenTaiko (0auBSQ) v0.6.0
Scope fineness: per–player-side (?)

Specify the creator (“designer”) of the notechart (“notes”).

The display details are unspecified.

AUTHOR:

OpenTaiko-OutFox standard version: (non-standard)
Impact level: metadata ★・・・・
First seen in: Malody
Scope fineness: per-file (?)

Specify the creator (“author”) of the notechart.

In Malody, it can be the Malody account name of the creator, but it is not enforced.

The display details are unspecified.

GENRE:

OpenTaiko-OutFox standard version: 1.0 (including any <str-genre> value (?))
Impact level: metadata ★・・・・
First seen in: TJAPlayer2 for.PC
Supported by: taiko-web ver.19.01.06
Scope fineness: per-file

Specify the genre of the song.

The display details are unspecified.

SIDE:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible) (per-file usage);
  1.2 (per–player-side usage for COURSE:Tower)
Impact level: metadata ★・・・・
First seen in: TaikoJiro v2.49
Supported by: OpenTaiko (0auBSQ) v0.6.0
Scope fineness: per-file

Specify whether the corresponding song entry is displayed, regarding the 裏ura 譜fu 面men 状jou 態tai “inner notechart state/mode” (“裏 ura inner or 表 omote outer side”) of the song selection screen.

This allows the chart creators to specify the inner chart of every difficulty together or with different audio as a separate song entry, as in official AC11–AC14.

For specifying the inner chart of solely the Oni difficulty with the same audio as in official AC15 and later official games (except only ハHa レre 晴Ha レre ユYu カka イi inner Hard in AC15), COURSE:Edit is commonly used instead.

別betsu 譜fu 面men “another notechart(s)” was a tentative name used during the development of AC11. The now-official name 裏ura 譜fu 面men “inner notechart” originated from pop’n music 11 (2004), developed by Konami.

Unspecified: Whether and how inner mode is implemented.

Proposal (IID): Make the scope per–player-side.

Compatibility Issues

SIDEREV:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: metadata ★・・・・
First seen in: TaikoJiro 2 v0.70
Scope fineness: per-file

Specify the filename of the 裏ura 譜fu 面men “inner notechart” or 表omote 譜fu 面men “outer notechart” version (“the reverse side”) of this notechart file.

WAVE:

OpenTaiko-OutFox standard version: 1.0
Impact level: timing ★★★★・
First seen in: TJF format
Supported by: (assumedly universally supported, including TaikoJiro v0.80, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope fineness: per-file

Specify the audio file (“waveform audio file”) of the song.

Unspecified: The exact list of supported file extensions.

Unspecified: Whether the notechart ends at the end of the audio file playback (if the audio file exist).

Compatibility Issues

DEMOSTART:

OpenTaiko-OutFox standard version: 1.0
Impact level: decorative ・・・・・
First seen in: TaikoJiro v2.37
Supported by: (assumedly universally supported, including TaikoJiro v0.80, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope fineness: per-file

Specify the amount of seconds into the song audio for starting playing the preview (“demonstration”) audio in the song selection screen.

OFFSET:

OpenTaiko-OutFox standard version: 1.0
Impact level: timing ★★★★・
First seen in: TaikoJiro
Supported by: (assumedly universally supported, including TaikoJiro v0.80, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope fineness: per–player-side (?)

Specify the amount of seconds past (“offsetted”) from the time position of #START of the notechart which the song audio should start playing from the beginning.

Equation: offset = time-point-of-audio-beginning − time-point-of-chart-start (Unit: Seconds)

Replaced the TJF command #GOMUSIC (starting (“go”) playing the song audio (“music”) from this point).

SONGVOL:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: decorative ・・・・・
First seen in: TaikoJiro v1.66
Supported by: TaikoJiro 2, TJAPlayer3 v1.5.2
Scope fineness: per-file

Specify the relative amplitude percentage (%) of the desired volume gain of the song audio.

Compatibility Issues

SEVOL:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: decorative ・・・・・
First seen in: TaikoJiro v1.66
Supported by: TaikoJiro 2
Scope fineness: per–player-side (?)

Specify the relative amplitude percentage (%) of the desired volume gain of the taiko sound (“sound effect”).

Unspecified: Whether the volume of system voice is affected.

Compatibility Issues

BPM:

OpenTaiko-OutFox standard version: 1.0 (minimum, see each form)
Impact level: timing ★★★★・
First seen in: TJF format
Supported by: (assumedly universally supported, including TaikoJiro v0.80, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope fineness: per–player-side

Specify the initial BPM (beat per minute) of the notechart.

Compatibility Issues

HEADSCROLL:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible) (minimum; unless stated otherwise)
Impact level: gimmicky ★★・・・
First seen in: TJAPlayer2 for.PC
Scope fineness: per–player-side

Specify the initial scrolling velocity (before and non-after the beginning (“head”) of the notechart), relative to the base scrolling velocity.

Can be reset by the #SCROLL command non-before the beginning of the notechart. If every player-side for every difficulty has #SCROLL defined at the beginning of the chart, HEADSCROLL: has no effects.

PREIMAGE:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: decorative ・・・・・
First seen in: OpenTaiko (0auBSQ) v0.5.4
Scope fineness: per–player-side (?)

Specify the jacket (“preview”) image of the song.

COVER:

OpenTaiko-OutFox standard version: (non-standard)
Impact level: decorative ・・・・・
First seen in: Malody
Scope fineness: per-file

Specify the jacket (“cover”) image of the song.

TAIKOWEBSKIN:

OpenTaiko-OutFox standard version: (non-standard)
Impact level: decorative ・・・・・
First seen in: taiko-web ver.19.02.03
Scope fineness: per-file

Specify the skin in the gameplay screen for taiko-web.

Unspecified: The behavior in other simulators.

Each element of <comma-separated-list-string-key-value> can be one of:

SCENEPRESET:

OpenTaiko-OutFox standard version: (non-standard)
Impact level: decorative ・・・・・
First seen in: OpenTaiko (0auBSQ) v0.6.0
Scope fineness: per–player-side (?)

Specify the pre-defined (“preset”) skin (“scene”) in the gameplay screen.

TOWERTYPE:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible) (with <non-negative-int-tower-skin> being 0–9 (?) or omitted, as in the わWa くku わwaくku 冒Bou 険ken ラRa ンn ドdo “Wakuwaku (Exciting) Adventure land” mode from the 7th PS2 console game)
  (non-standard) (otherwise)
Impact level: decorative ・・・・・
First seen in: OpenTaiko (0auBSQ) v0.5.0
Scope fineness: per–player-side (?)

Specify the dedicated tower skin (“type”) to use.

Used in conjunction with COURSE:Tower.

DANTICK:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compat) (with <enum-int-dan-tick-skin> being 0–5 or omitted, as in AC15.8 (レッRedドdoVer. “Red Ver.”) and onward);
  (non-standard) (otherwise)
Impact level: decorative ・・・・・
First seen in: OpenTaiko (0auBSQ) v0.5.1
Scope fineness: per-file

Specify the dedicated 段Dan’ 位i 認nin 定tei モーMoo ドdo “Rank Certification Mode” skin (コko スsu メme チッchik クku “cosmetic” (?)) to use in the certification challenge selection screen.

段Dan’ 位i 認nin 定tei モーMoo ドdo “Rank Certification Mode” resembles 段Dan’ 位i 道Dou 場jou “Rank Dojo”/Dan-i Dojo in the official games.

Used in conjunction with COURSE:Dan.

DANTICKCOLOR:

OpenTaiko-OutFox standard version: (non-standard)
Impact level: decorative ・・・・・
First seen in: OpenTaiko (0auBSQ) v0.5.1
Scope fineness: per-file

Specify the color filter to apply to the 段Dan’ 位i 認nin 定tei モーMoo ドdo “Rank Certification Mode” skin (コko スsu メme チッchik クku “cosmetic” (?)) objects in the certification challenge selection screen.

段Dan’ 位i 認nin 定tei モーMoo ドdo “Rank Certification Mode” resembles 段Dan’ 位i 道Dou 場jou “Rank Dojo”/Dan-i Dojo in the official games.

Used in conjunction with COURSE:Dan.

SELECTBG:

OpenTaiko-OutFox standard version: (non-standard)
Impact level: decorative ・・・・・
First seen in: OpenTaiko (0auBSQ) v0.6.0
Scope fineness: per–player-side (?)

Specify the background image of the song selection screen. Override the skin settings.

BGIMAGE:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: decorative ・・・・・
First seen in: TJAPlayer2 for.PC ver.2016021300
Scope fineness: per–player-side (?)

Specify the background image of the gameplay screen. Override the skin settings.

Unspecified: Whether the image is scaled or stretched to fill the gameplay screen.

BGOFFSET:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: decorative ・・・・・
First seen in: ?
Reference: TJA Format Support (vscode extension)
Scope fineness: per–player-side (?)

Specify the amount of seconds past (“offsetted”) from the time position specified by the OFFSET: header which the background image (“image”) should start displaying.

Equation: bgoffset = time-point-of-image-displaying − time-point-of-audio-beginning (Unit: Seconds)

BGMOVIE:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: decorative ・・・・・
First seen in: TJAPlayer2 for.PC ver.2016021300
Scope fineness: per–player-side (?)

Specify the background video (“movie”) of the gameplay screen. Override the skin settings.

Unspecified: Whether the video is scaled or stretched to fill the gameplay screen.

MOVIEOFFSET:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: decorative ・・・・・
First seen in: TJAPlayer2 for.PC ver.2015081100
Scope fineness: per–player-side (?)

Specify the amount of seconds past (“offsetted”) from the time position specified by the OFFSET: header which the background video (“movie”) should start playing from the beginning.

Equation: movieoffset = time-point-of-video-beginning − time-point-of-audio-beginning (Unit: Seconds)

Compatibility Issues

BGA:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: decorative ・・・・・
First seen in: C-Taiko
Supported by: OpenTaiko (0auBSQ) v0.6.0
Scope fineness: per–player-side (?)

Specify a background video (“animation”) to be used in the gameplay screen by the #BGAON and #BGAOFF commands.

Unspecified: Whether the video is scaled or stretched to fill the gameplay screen.

Not reset by BGA: itself.

Compatibility Issues

LYRICS: / LYRICFILE:

OpenTaiko-OutFox standard version: 1.2
Impact level: decorative ・・・・・
First seen in: taiko-web ver.20.03.31, TJAPlayer3-Develop-ReWrite (parse-only)
Supported by: TJAPlayer3-f v1.6.0.0, OpenTaiko (0auBSQ) v0.6.0
Scope fineness: per-file

Specify the lyric file(s) for the song to display lyrics in the playback screen.

Unspecified: The effective lyric file(s) when both the LYRICS: & LYRICFILE: headers are used.

Unspecified: Whether #LYRIC commands are ignored if the lyric file is used.

Compatibility Issues

EXPLICIT:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: metadata ★・・・・
First seen in: OpenTaiko (0auBSQ) v0.6.0
Scope fineness: per-file

If enabled, specify that the song has explicit (of the meaning of not safe for work (NSFW)) lyrics.

The display details are unspecified.

GAME:

OpenTaiko-OutFox standard version: 1.2 (Taiko and Konga modes)
Impact level: note ★★★★★
First seen in: TaikoJiro v2.13
Supported by: taiko-web (plugin “Donkey Konga Mode”)
Scope fineness: per–player-side (?)

Specify the game mode. The meaning of the symbols used in the notechart definition is changed accordingly; see TJA Notechart Definition.

Unspecified: The implemented game modes other than Taiko mode.

See the #GAMETYPE command for specifying the game mode for specific notechart sections.

Compatibility Issues

COURSE:

OpenTaiko-OutFox standard version: 1.0 (minimum, unless stated otherwise)
Impact level: note ★★★★★
First seen in: TaikoJiro v1.76
Supported by: (assumedly universally supported, including TaikoJiro, Malody, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope fineness: per–player-side

Specify the コーkoo スsu “course”/むmu ずzu かka しshi いi “difficulty”/難nan’ 易i 度do “difficulty (or easiness) level” difficulty/difficulty level (“course”).

Not to be confused with the difficulty star specified by the LEVEL: header.

“Course” in other rhythm games usually refers to playing multiple songs in a row. In early arcade console versions of the official game series, the player could only play a fixed difficulty during the クku レre(ジッjet トto) “credit”/game session. “<difficulty>コーkoo スsu” (“<difficulty> course”) was displayed in those official games.

Depending on the simulator, the COURSE: header may affect the judgment window, default scoring, the default increasing rate of the 魂tamashii ゲーgeeジji spirit gauge/soul gauge, etc.

Compatibility Issues

LEVEL:

OpenTaiko-OutFox standard version: 1.0 (minimum, see each form)
Impact level: scoring ★★★・・
First seen in: TJF format
Supported by: (assumedly universally supported, including TaikoJiro, Malody, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope fineness: per–player-side

Specify the 難nan’ 易i 度do “difficulty (or easiness) level“/difficulty star/? (“level”).

Since the Japanese terminology is easily confused with the fore-mentioned “difficulty” specified by the COURSE: header, the difficulty star is often referred as 星hoshi のno 数kazu/★hoshi のno 数kazu “amount of stars” and is displayed as “★hoshi×n” in the official PC-generation arcade games.

Depending on the simulator and/or user settings, the LEVEL: header may affect the default scoring, the default increasing rate of the 魂tamashii ゲーgeeジji spirit gauge/soul gauge, etc.

Compatibility Issues

STYLE:

OpenTaiko-OutFox standard version: 1.0 (up to 2 player-sides);
  1.2 (up to 5 player-sides) (?)
Impact level: note ★★★★★
First seen in: TaikoJiro v1.99
Supported by: TJAPlayer2 for.PC
Scope fineness: per–player-side

Specify the total amount of player-sides of the notechart(s).

The multiple-player-side notecharts of the difficulty is chosen if enough amount of players have chosen the same difficulty.

In the official games, some difficulties may have only 2-player-side notecharts but are still playable in single player mode, where the notechart for one of the player-side is chosen (always the 1st player-side in PC-generation games).

Unspecified: Whether such notecharts are chosen when some players have chosen different difficulties.

If the specified amount of player-sides is not 1, #START <enum-str-player-side> should be used for specifying the player-side of the notechart.

Reference: ダブルプレイ (“Double Play”; “Two-player Charts”). 太鼓の達人 譜面とか Wiki* (“Taiko no Tatsujin - Wiki* about Notecharts and so on”). https://wikiwiki.jp/taiko-fumen/収録曲/ダブルプレイ

Compatibility Issues

BALLOON Headers

OpenTaiko-OutFox standard version: 1.0 (minimum, see each form)
Impact level: note ★★★★★
First seen in: TaikoJiro
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope fineness: per–player-side

Specify the required amount of hits of 激geki 連ren 打da/ゲge キki 連ren 打da “fierce drumroll” burst note / 風fuu 船sen/ふ fu うu せse んn balloon–type notes (denoted by 7, 9, or D in the notechart definition), in the order of their definition, NOT the hit order during playing.

Each balloon-type note with unassigned hit amount requires an unspecified default amount of hits.

Proposal (IID): The #BALLOON command can be used in the notechart definition for the same purpose instead.

For each element of <comma-separated-list-non-negative-int-amount-of-hits>, if the amount of hits is 0, the per-note behavior is unspecified.

Compatibility Issues

LIFE:

OpenTaiko-OutFox standard version: 1.2 (for COURSE:Tower, except the 0 form)
Impact level: scoring ★★★・・
First seen in: TaikoJiro v2.19
Supported by: OpenTaiko (0auBSQ) v0.4.3
Scope fineness: per–player-side

Specify the initial life count of the life count gauge (if used).

A 不Fu 可ka BAD judgment decreases the life count by 1 (missing). When the life count decreased to 0, the player is immediately judged to be failed and the notechart ends.

Unspecified: Whether there is invincible time after missing and how long is its time duration.

Unspecified: The behavior when a non-zero value is used not in conjunction with COURSE:Tower.

TOTAL:

OpenTaiko-OutFox standard version: 1.0 (despite ignored in TJAPlayer3)
Impact level: scoring ★★★・・
First seen in: TaikoJiro v2.92 & TaikoJiro 2 v0.93
Scope fineness: per–player-side

Specify the total 魂tamashii ゲーgeeジji spirit gauge/soul gauge increment of the notechart when all hit-type notes are hit with 良Ryou GREAT/GOOD judgment, i.e., ドDo ンn ダda フfu ルru コko ンn ボbo Donderful Combo.

GAUGEINCR:

OpenTaiko-OutFox standard version: 1.0
Impact level: scoring ★★★・・
First seen in: TJAPlayer3 v1.5.4
Scope fineness: per–player-side

Specify the rounding mode of the increment of the 魂tamashii ゲーgeeジji spirit gauge/soul gauge.

EXAM Headers

OpenTaiko-OutFox standard version: 1.0 (minimum, unless stated otherwise)
Impact level: scoring ★★★・・
First seen in: TJAPlayer3 v1.5.0
Post-#START position: forbidden;
  allowed (Supported by: TJAPlayer3-Develop-ReWrite)
Scope fineness: per–player-side (?) (or per-song (begins with a #NEXTSONG command and ends with another #NEXTSONG command))

Specify a requirement for passing the notechart in 段Dan’ 位i 認nin 定tei モーMoo ドdo “Rank Certification Mode” (“examination”).

段Dan’ 位i 認nin 定tei モーMoo ドdo “Rank Certification Mode” resembles 段Dan’ 位i 道Dou 場jou “Rank Dojo”/Dan-i Dojo in the official games.

Used in conjunction with COURSE:Dan.

SCOREMODE:

OpenTaiko-OutFox standard version: 1.0
Impact level: scoring ★★★・・
First seen in: TaikoJiro v2.85
Supported by: TaikoJiro 2 v0.72, TJAPlayer2 for.PC
Scope fineness: per–player-side

Specify the scoring mode.

Affects combo bonus, combo milestone bonus, ゴーGoo ゴーGoo タTa イi ムmu Go-Go Time bonus, & big note bonus.

The main scoring formula has two int variables: init & diff.

The “basic score” below refers to the score awarded per 良Ryou GREAT/GOOD judgment on non-big notes outside Go-Go Time sections.

When either the 真Shin’ 打uchi “true percussion (performance)”/”true performance” option is enabled or SCOREMODE:3 is used, the basic score is fixed to init points and the SCOREDIFF: header is ignored.

Unspecified: Scoring details other than the basic score in each mode; usually one of the official games is followed.

Reference: 配点 (“Scoring”). 太鼓の達人 譜面とか Wiki* (“Taiko no Tatsujin - Wiki* about Notecharts and so on”). https://wikiwiki.jp/taiko-fumen/システム/配点

Compatibility Issues

SCOREINIT:

OpenTaiko-OutFox standard version: 1.0
Impact level: scoring ★★★・・
First seen in: TaikoJiro v1.67
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC)
Scope fineness: per–player-side

Specify the 初sho 項kou initial term (refers to an arithmetic progression) (init) used for calculate the basic score. See the explanation for the SCOREMODE: header.

SCOREDIFF:

OpenTaiko-OutFox standard version: 1.0
Impact level: scoring ★★★・・
First seen in: TaikoJiro v1.67
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC)
Scope fineness: per–player-side

Specify the 公kou 差sa common difference (refers to an arithmetic progression) (diff) used for calculate the basic score. See the explanation for the SCOREMODE: header.

HIDDENBRANCH:

OpenTaiko-OutFox standard version: 1.0 (except 0 or omitted forms)
Impact level: metadata ★・・・・
First seen in: TJAPlayer2 for.PC
Scope fineness: per–player-side

If enabled, make the 譜fu 面men 分bun 岐ki “notechart branch“/forked path indicator hidden in the song selection screen; hide the “branch”/path mark on the note field from the beginning of the notechart until time point when the “branch”/path–switching effects should play for the first “branch”/path section in the gameplay screen.

Proposal (IID) TJACOMPAT:

OpenTaiko-OutFox standard version: 1.3
Impact level: note ★★★★★ (maximum, depends on the compatibility flags)
Scope fineness: per–player-side

Specify the intended compatibility mode of the chart.

The supported set of headers & commands and allowed argument forms is not affected. However, the arguments might be interpreted differently dependent on the compatibility mode and flags.

<enum-str-compat-mode> can be one of:

<enum-str-compat-flag> is in the format of <enum-str-compat-item>=<enum-str-compat-option>.

Preset Compatibility Flags

These compatibility flags are in the form of <enum-str-compat-item>=<enum-str-compat-mode>. Charters should only use these flags if necessary.

See Comparison of Compatibility Modes for the value of internal flags for each compatibility mode.

Internal Compatiblity Flags

These compatibility flags are considered for internal uses by the simulator and may be unimplemented. Charters should never specify these flags.

Comparison of Compatibility Modes

Each proposed compatibility-mode behavior is enclosed in parentheses (()) for:

Flag \ Mode (Official game) jiro1 jiro2 tmg tjap3 oos
balloon-popcount N/A common common common n n
(common)
balloonnem-popcount-nonbranch N/A N/A
(1n-or-1nem)		 N/A
(1n-or-1nem)		 N/A
(1n-or-1nem)		 1n-or-3last 1nem
end-at music music music music (?) end end
(music-and-end)
timing-precision ? ms-bpm ms (?) any (?) ms ms
timing-effect-order def time time time (?) flat-time-or-def flat-time-or-def
hbscroll-past N/A nmscroll hbscroll hbscroll hbscroll hbscroll
hbscroll-delay N/A freeze freeze freeze (?) offset offset
roll-pos N/A N/A
(complex)		 complex complex real complex
roll-nodes head tips tips tips head head
scroll-i N/A N/A
(down)		 down down up up
jposscroll-i N/A N/A
(down)		 N/A
(down)		 up up up
jposscroll-interrupt N/A N/A
(trunc)		 N/A
(trunc)		 trunc trunc trunc
sudden-directions N/A N/A
(all)		 N/A
(all)		 all x N/A
(x)
sudden-precision N/A N/A
(ms)		 N/A
(ms)		 any (?) ms ms
stack-order appear-time (PS1/2-gen)
def (PS3/PC-gen)		 def def time (?) time def
angle-barline N/A angle-mirror (?) angle-mirror (?) angle-mirror (?) im none
(angle-mirror)
angle-note N/A angle-mirror angle-mirror angle-mirror none none
(angle-mirror)
angle-roll-bar N/A angle-mirror angle-mirror angle-mirror N/A
(angle-mirror)		 angle
(angle-mirror)

Proposal (Komi) VERSION:

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: note ★★★★★ (restrictive usage) / metadata ★・・・・ (non-mandatory usage)
Scope fineness: per-file

Specification by Komi: https://docs.google.com/document/d/17GKK9U5S_eT97oTwgB6tMMNQsQm2uhp-OIhBMv2Mgso

Specify the version-numbered set of the OpenTaiko-OutFox standard TJA features required by the TJA file.

Simulators may choose to keep the enabled set of TJA features unchanged. If the specified feature set isn’t supported by the simulator, a warning should be emitted, and the simulator may choose the accept or reject such TJA files.

If the TJA file uses any features outside the specified feature set, a warning should be emitted, and the simulator may choose to accept the usage, ignored the usage (treated as a comment for headers and commands, treated as blank 0 for uppercase notechart symbols), or reject such TJA files.

TJC Header

OpenTaiko-OutFox standard version: (non-standard)

TJC Header Overview

The descriptions of Header Overview for TJA mostly applies.

Some TJA headers can be used as TJC headers and have similar or even identical effects. Unspecified: Which TJA headers can be used as TJC header aside from TITLE:, COURSE:, & TOTAL:. Only non-TJA headers are listed in this section.

See the #NEXTSONG command for the TJA command version of TJC headers.

SONG:

OpenTaiko-OutFox standard version: (non-standard)
Impact level: note ★★★★★
First seen in: TaikoJiro v2.34
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope fineness: sequential

Specify a notechart (“song”) of the notechart set.

TJA Command

Command Overview

Command Format

TJA commands are written in the format of #COMMAND values.

Each commands MUST be placed on its own line.

No leading non-newline whitespaces are allowed for the #START and #END commands & other commands placed outside of the notechart definition enclosed between #START & #END.

However, leading non-newline whitespaces are allowed and ignored in the notechart definition enclosed between #START & #END.

The #COMMAND part MUST be written in an all-upper-case manner and MUST NOT contain whitespaces in-between.

Commands with an unrecognized #COMMAND name are ignored.

Unspecified: The behavior when the whitespaces before the values part is omitted for all-letter commands with numeric values (occurs in some legacy charts).

The arguments for commands introduced in TaikoJiro are comma-separated. However, the arguments for commands introduced in TJAPlayer2 for.PC are instead whitespace-separated as in the .bms format (which is modified and extended into the .dtx format for DTXMania).

Unspecified: The behavior when a comma (,) is used as the decimal point (normally a full-stop (.)).

Pre-#START Command Position

Most commands are expected to be placed within the notechart definition enclosed between #START & #END. However, some commands are expected to be placed before the notechart definition, or “pre-#START position”.

Commands allowed in pre-#START position will be explicitly denoted.

Proposal (IID): If a command with command-time effects is placed in the pre-#START position, its command-time effects apply as if these effects were static effects.

Unspecified: The behavior when any commands are placed before any headers outside the notechart definition.

Command Scope

Commands with per–player-side scope are similar to headers but the effects of these commands reset at the end of their scope.

Except for one-shot commands, the effect of each command continues until the next occurrence of any command from the same command group or #END.

Command Scope Fineness

See scope fineness.

For commands, the coarsest fineness is per–player-side. The finest fineness other than sequential is non-before

sequential > non-before > measure & (other) > per–player-side

Some branch-scoped commands have non-before scope fineness, i.e., they can be arranged freely within the same beat position without causing any behavior changes, as long as both their relative order to the sequential commands and the relative order among commands which override each other are not changed.

All commands with other type of scope implicitly have sequential scope fineness.

Command Effect Time

A command may have each part of its effects applied at different time position.

Each part of the effects can be classified into the following effect time types according to the effect-applying time position (listed in the order of descending static-ness):

Effect time Applying time
static Theoretically negative infinity (−∞) measures (presumely −∞ seconds) before the first measure, practically before the notechart is started.
command-time A specific time position relative to the time position of the command.
object-time A specific time position relative to the time position of notechart objects (including notes and bar lines).

If an effect can be interpreted as different effect time types, the effect is classified as the most static-ness type interpreted.

As a special case, for an effect affecting the scrolling path of notechart objects, the effect is classified as object-time only if the path is a direct or indirect function of the time position of notechart objects, otherwise the effect is classified as command-time or static.

Non-static Effect Scope

The non-static effect scope is defined by the targeted game objects which are affected by the non-static effects.

Proposal (IID): Allow the scope of non-static effects to be overridden for branch-scoped commands targeting notes & bar lines, see Proposal (IID): Command Modifier.

Command Effect Target

Commands only affect their targeting game objects. The target of each command can be any (including none) of:

Command Effect Branches

If commands are defined in branched section, some commands affect all branches, while some commands only affects the branch where it is defined.

Due to the incoherent behaviors, many commands introduced in TJAPlayer2 for.PC and descendants have Unspecified effect branches.

#BMSCROLL / #HBSCROLL / #NMSCROLL

OpenTaiko-OutFox standard version: 1.1 (except #NMSCROLL; pre-#START position);
  1.2 (post-#START position)
Impact level: gimmicky ★★・・・
First seen in: TaikoJiro v1.91
Supported by: TaikoJiro 2, TJAPlayer2 for.PC
Pre-#START position: required;
  allowed (Supported by: OpenTaiko (0auBSQ) v0.6.0)
Scope: per–player-side (or branch)
Scope fineness: per–player-side (or non-before)
Effect time: static
Effect target: notes, bar lines
Effect branches: Unspecified

Use a scrolling mode similar to the scrolling method used in either BEMANI-series or the official Taiko (“normal”) game series for the non-before notes and bar lines, unless overridden by user settings.

Scrolling mode comparison: Consider BPM changes occur during notes and bar lines traveling through the whole note field (including the part past the judgment mark).

Scrolling mode Taiko-like BEMANI-like
XMod		 IGS-like
CMod
Command or TaikoJiro setting (Default)
#NMSCROLL		 #BMSCROLL
#HBSCROLL
User option		 User option: REGUL-SPEED
Position Formula px_per_beat × (bpm_at_note ÷ 60 (s/min)) × (second_time_of_note − second_time_played) × scroll × modifier px_per_beat × (visual_beat_of_note − visual_beat_played) × scroll × modifier px_per_beat × (bpm_displayed ÷ 60 (s/min)) × (second_time_of_note − second_time_played) × scroll × modifier
Primary Speed Factor bpm_at_note bpm_visual
(0 during effective positive delays)
(Infinity during visual beat jumps)		 bpm_displayed
Constant Factor on BPM Changes Notes’ and bar lines’ individual drawn velocity Ratios of notes’ and bar lines’ drawn distance to their beat distance Ratios of drawn distances between Notes’ and bar lines’
Default scrolling changes of #BPMCHANGE command Set the per-note or per–bar-line base BPM of non-preceding notes and bar lines Suddenly change the apparent base BPM of all notes & all bar lines (No changes)
Default scrolling changes of #DELAY command (No changes) Pause the scrolling if positive and effective;
(no changes) if negative		 (No changes)
Mode-invariant velocity-changing command #SCROLL <value> #HISPEED(<value>) (TMG format) (Proposal (IID)) #SPEED <value>; *:*; <changing-duration>
Analogous Timing Segment in SSC Format (None) #SCROLLS:; #SPEEDS:;

In OutFox, the Taiko-like scrolling mode can be achieved by using CAMod (AMod/”Average BPM Scroll Mode” with constant per-note or per–bar-line scrolling speed) with the BPM parameter set to 4 × the average BPM of the notechart.

See Sign of Timing Commands for the behavior of timing commands with different sign of values.

Proposal (IID): See Proposal (IID): Command Modifier for the syntax for mode-invariant commands.

Compatibility Issues

#PAPAMAMA

OpenTaiko-OutFox standard version: (non-standard, but seen in official games)
Impact level: note ★★★★★
First seen in: TJAPlayer3-f v1.7.2.0
Pre-#START position: required
Scope: per–player-side
Scope fineness: per–player-side
Effect target: notes
Effect branches: Unspecified

Use the パPa パpa マMa マma サSa ポーpoo トto “Parent Support Mode”/Helping Hand Mode gameplay rules from the official arcade games for certain song in the 簡Kan 単tan/かKa んn たta んn Easy difficulty, where the amount of players is fixed to 1 and the inputs from all players are combined to play the song.

Reference: https://taiko.namco-ch.net/taiko/en/howto/papamama.php#papamama

Unspecified: The behavior when the amount of player-sides specified by the STYLE: header is not 1.

#START / #END

OpenTaiko-OutFox standard version: 1.0 (except proposed forms)
Impact level: note ★★★★★
First seen in: TJF format
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Pre-#START position: forbidden (enclosing the notechart definition)
Scope: per–player-side (or notechart)
Scope fineness: per–player-side (or non-before)
Effect time: static notechart definition + command-time show ending animation (for #END in some simulators)
Non-static effect scope: all
Effect target: notes, bar lines, notefield(s), gameplay screen
Effect branches: all

Respectively start / end the region of notechart definition.

Unspecified: The behavior when any of the followings are violated when defining each difficulty:

Compatibility Issues

#BPMCHANGE

OpenTaiko-OutFox standard version: 1.0 (positive value)
  1.1 (non-zero real value, and resulting time of measure division interval is non-negative or normal Taiko scrolling mode is used)
  2.0 (non-zero real value) (?; to be discussed)
Impact level: timing ★★★★・
First seen in: TJF format
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope: branch
Scope fineness: non-before
Effect time: static objects’ distance + command-time objects’ velocity
Non-static effect scope: all (BMS scrolling modes); (none) (otherwise)
Effect target: notes, bar lines
Effect branches: all

Change the BPM.

Compatibility Issues

#MEASURE

OpenTaiko-OutFox standard version: 1.0 (resulting beats of measure is positive);
  1.1 (resulting beats of measure is any non-zero real value, and resulting time of measure division interval is non-negative or normal Taiko scrolling mode is used);
  2.0 (resulting beats of measure is any real value except division by 0) (?; to be discussed)
Impact level: timing ★★★★・
First seen in: TaikoJiro
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope: branch
Scope fineness: measure
Effect time: static
Effect target: notes, bar lines
Effect branches: Unspecified (with Unspecified behaviors)

Change the time signature / meter signature / measure signature.

Replaced the TJF command #ONESYOSETU (adjust the duration of this one 小shou 節setsu “measure” to fit all note symbols on the following line if placed after the previous measure (if any) and before the first note symbol (if any) of this measure in the notechart definition).

Compatibility Issues

#DELAY

OpenTaiko-OutFox standard version: 1.0
Impact level: timing ★★★★・
First seen in: TaikoJiro v1.60
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC)
Scope: branch
Scope fineness: sequential
Effect time: static objects’ timing + command-time freeze scrolling
Non-static effect scope: all (BMS scrolling modes, positive value); (none) (otherwise)
Effect target: notes, bar lines
Effect branches: Unspecified (with Unspecified behaviors)

Adjust (delay) the time position of all notechart object (including commands) non-preceding the #DELAY command by the specified time duration.

The decorative visual/audio effects are unspecified.

For the timing of notechart object, multiple #DELAY commands placed at the same beat position act as a single #DELAY with the value of the sum of their duration, even when negative delay durations are used.

Unspecified: The visual note positioning behavior in BMS scrolling modes when note objects are placed into the time interval of positive delays.

Compatibility Issues

#GOGOSTART / #GOGOEND

OpenTaiko-OutFox standard version: 1.0
Impact level: scoring ★★★・・
First seen in: TaikoJiro
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope: branch
Scope fineness: sequential
Effect time: static per-note scoring + command-time visual
Non-static effect scope: notes: (none), gameplay screen: all
Effect target: notes, gameplay screen
Effect branches: current

Respectively start / end a ゴーGoo ゴーGoo タTa イi ムmu Go-Go Time section if not already respectively started / ended.

Unspecified: The behavior if #GOGOSTART occurs when a Go-Go Time section has already started.

For playing the Go-Go Time entering effects during an existing Go-Go Time section, a pair of #GOGOEND and #GOGOSTART can be placed together.

#DUMMYSTART / #DUMMYEND

OpenTaiko-OutFox standard version: (non-standard)
Impact level: note ★★★★★
First seen in: TaikoManyGimmicks
Scope: branch
Scope fineness: sequential
Effect time: static
Effect target: notes
Effect branches: current

Respectively start / end a fake/dummy section if not already respectively started / ended.

#SCROLL

OpenTaiko-OutFox standard version: 1.0 (minimum, except TMG forms, see each form)
Impact level: gimmicky ★★・・・
First seen in: TaikoJiro
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC, OutFox v0.4.9.9)
Scope: branch
Scope fineness: non-before
Effect time: static
Effect target: notes, bar lines
Effect branches: current

Change the scrolling speed of notes & bar lines, relative to the normal scrolling velocity and direction.

Unspecified: Whether the notes & the bar lines are rotated around their center accordingly when a complex number value is used.

For specifying the same initial scrolling speed for multiple player-sides or difficulties, the HEADSCROLL: header can be used instead.

Reset by #RESETCOMMAND.

Compatibility Issues

#BARLINESCROLL

OpenTaiko-OutFox standard version: (non-standard)
Impact level: gimmicky ★★・・・
First seen in: taiko-web (plugin “Custom Barlines”)
Scope: branch
Scope fineness: non-before
Effect time: static
Effect target: bar lines
Effect branches: current (?)

Change the scrolling speed of only bar lines, relative to the normal scrolling velocity and direction and prevent this speed from being overridden by further #SCROLL.

#HISPEED

OpenTaiko-OutFox standard version: (non-standard)
Impact level: gimmicky ★★・・・
First seen in: TaikoManyGimmicks v0.6.1α
Scope: branch
Scope fineness: non-before
Effect time: static objects’ distance + command-time objects’ velocity
Non-static effect scope: all (BMS scrolling modes); (none) (otherwise)
Effect target: notes, bar lines
Effect branches: all (?)

Suddenly change the scrolling speed (HiSpeed / high-speed) of notes & bar lines in BMS scrolling modes, as if the BPM were changed accordingly.

Reset by #RESETCOMMAND.

Proposal (IID): #SPEED

OpenTaiko-OutFox standard version: (non-standard)
Impact level: gimmicky ★★・・・
Scope: branch
Scope fineness: non-before
Effect time: command-time
Non-static effect scope: all
Effect target: notes, bar lines
Effect branches: current

Suddenly change the base scrolling speed of notes & bar lines. In other words, suddenly change the normal scrolling velocity and direction.

Targeted notes & bar lines have their distance and/or direction to the visual judgment position scaled and/or rotated. The <approach-specifier> from the proposal (IID) Command Modifier is intended to be used in conjunction.

If the notes & the bar lines are rotated around their center accordingly when a #SCROLL command with complex number value is used, they are also rotated accordingly when a #SPEED command with complex number value is used.

#DIRECTION

OpenTaiko-OutFox standard version: 1.1 (except proposed forms)
Impact level: gimmicky ★★・・・
First seen in: TJAPlayer2 for.PC
Scope: branch
Scope fineness: non-before
Effect time: static
Effect target: notes, bar lines
Effect branches: Unspecified

Change the scrolling direction of notes & bar lines.

Unspecified: Whether the notes & the bar lines are rotated around their center accordingly.

Unspecified: The behavior when a #SCROLL command with complex value is active.

Proposal (IID): The direction is relative to the scrolling direction specified by the #SCROLL command.

Compatibility Issues

#BARLINEOFF / #BARLINEON

OpenTaiko-OutFox standard version: 1.0
Impact level: gimmicky ★★・・・
First seen in: TaikoJiro v2.69
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC)
Scope: branch
Scope fineness: non-before
Effect time: static
Effect target: bar lines
Effect branches: Unspecified (?)

Respectively disable (“turn off”) / enable (“turn on”) the display of all bar lines (including the special bar lines indicating the beginning of a 譜fu 面men 分bun 岐ki “notechart branch“/forked path section) from the definition position and on.

#BARLINE

OpenTaiko-OutFox standard version: 1.2
Impact level: gimmicky ★★・・・
First seen in: taiko-web (plugin “Custom Barlines”)
Supported by: OpenTaiko (0auBSQ) v0.6.0
Scope: branch, instant one-shot
Scope fineness: sequential
Effect time: static
Effect target: bar lines
Effect branches: current

Insert a fake/dummy normal bar line displayed at the head of the current beat position.

#JPOSSCROLL

OpenTaiko-OutFox standard version: 1.1 (except TMG forms)
Impact level: gimmicky ★★・・・
First seen in: TJAPlayer2 for.PC
Supported by: TaikoManyGimmicks v0.6α
Scope: branch
Scope fineness: sequential
Effect time: command-time
Non-static effect scope: all
Effect target: notes, bar lines, judgment mark, note field
Effect branches: Unspecified

Move (“scroll”) the position of the judgment circle from the current position.

Unspecified: The behavior when another #JPOSSCROLL command is placed within the moving duration interval of the current #JPOSSCROLL command.

Reset by #RESETCOMMAND.

The arguments are whitespace-separated.

Compatibility Issues

#JUDGEDELAY

OpenTaiko-OutFox standard version: (non-standard)
Impact level: gimmicky ★★・・・
First seen in: TaikoManyGimmicks
Scope: branch
Scope fineness: non-before
Effect time: static
Effect target: notes, bar lines
Effect branches: Unspecified (?)

Specify the per–note/bar line visual judgment point to be offset (“delay”) from the judgment mark.

Reset by #RESETCOMMAND.

The arguments are whitespace-separated.

SUDDEN / HIDDEN Commands

OpenTaiko-OutFox standard version: 1.1 (except proposed forms)
Impact level: gimmicky ★★・・・
First seen in: TJAPlayer2 for.PC
Supported by: TaikoManyGimmicks v0.6α
Scope: branch
Scope fineness: non-before
Effect time: object-time
Non-static effect scope: non-before
Effect target: notes
Effect branches: Unspecified

Specify non-preceding notes and their 口Kuchi 唱Shou 歌ga “Note phoneticization” to respectively appear and move suddenly / disappear (“hidden”) and stop moving suddenly for once as they move through the notefield.

Reset by #RESETCOMMAND.

Unspecified (?): The behavior when both #NOTESPAWN command(s) and the #SUDDEN and/or (proposal (IID)) #HIDDEN command(s) are in effect.

The arguments are whitespace-separated.

<float-seconds-*-duration> specifies the time durations before the time point of judgment of each note is reached; if its absolute value equals to 0, the time duration is positive infinity (+∞) for the #SUDDEN command and is negative infinity (−∞) for the #HIDDEN command.

Proposal (IID): <enum-str-afftect-type> can be one of:

Compatibility Issues

#NOTESPAWN

OpenTaiko-OutFox standard version: (non-standard)
Impact level: gimmicky ★★・・・
First seen in: TaikoManyGimmicks
Scope: branch
Scope fineness: non-before
Effect time: command-time
Non-static effect scope: non-before
Effect target: notes
Effect branches: current (?)

Specify non-preceding notes and their 口Kuchi 唱Shou 歌ga “Note phoneticization” to respectively appear / disappear (“hidden”) suddenly when the specified time point before the command is reached.

If multiple #NOTESPAWN commands are placed at the same measure position, the first #NOTESPAWN resets the previous #NOTESPAWN effects to the default, and then all the appear and disappear points specified by the #NOTESPAWNs at the same measure position are set simultaneously for non-preceding notes.

Reset by #RESETCOMMAND.

Unspecified (?): The behavior when both #NOTESPAWN command(s) and #SUDDEN and/or (proposal (IID)) #HIDDEN command(s) are in effect.

The arguments are whitespace-separated.

<float-seconds-*-duration> specifies the time durations before the time point of the command is reached.

#ENABLEDORON / #DISABLEDORON

OpenTaiko-OutFox standard version: 2.0
Impact level: gimmicky ★★・・・
First seen in: TJAPlayer3-Extended
Supported by: OpenTaiko (0auBSQ) v0.6.0
Scope: branch
Scope fineness: non-before
Effect time: command-time
Non-static effect scope: all
Effect target: notes
Effect branches: Unspecified

Respectively enable / disable the ドDo ロro ンn “note-wise stealth” game modifier. The 口Kuchi 唱Shou 歌ga “Note phoneticization” is not hidden by this game modifier.

#LYRIC

OpenTaiko-OutFox standard version: 1.0
Impact level: decorative ・・・・・
First seen in: TJAPlayer2 for.PC
Supported by: taiko-web ver.20.03.31, TaikoManyGimmicks v0.6α
Scope: branch
Scope fineness: non-before
Effect time: command-time
Non-static effect scope: all
Effect target: gameplay screen
Effect branches: Unspecified

Display the specified lyric.

Unspecified: Whether #LYRIC commands are ignored if the lyric file specified by the LYRICS: or LYRICFILE: header is used.

Unspecified: The behavior when #LYRIC commands are not consistent among any of the following:

Compatibility Issues

#SENOTECHANGE

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: gimmicky ★★・・・
First seen in: TJAPlayer3 v1.4.0
Scope: branch, note one-shot
Scope fineness: non-before
Effect time: static
Effect target: notes
Effect branches: Unspecified

Override (“change”) the automatically assigned 口Kuchi 唱Shou 歌ga “Note phoneticization” (“sound effect of a note” or “発Hatsu 声sei vocalization of a note” (?)) of the nearest note(s) placed non-before the command.

Similar to the #NOTESCHANGE command, but with a different range of argument.

In the official games, the note phoneticization is assigned per-note and does not follow a definite pattern, especially in earlier games.

The general pattern in recent Taiko games seems to be:

However, in the official Konga games, the general pattern is less consistent and “chain-final” is defined less strictly:

#NOTESCHANGE

OpenTaiko-OutFox standard version: (non-standard)
Impact level: gimmicky ★★・・・
First seen in: C-Taiko
Scope: branch, note one-shot (?)
Scope fineness: non-before
Effect time: static
Effect target: notes
Effect branches: current (?)

Override (“change”) the automatically assigned 口Kuchi 唱Shou 歌ga “Note phoneticization” (“sound effect of a note” or “発Hatsu 声sei vocalization of a note” (?)) of the nearest note(s) (?) placed non-before the command.

Similar to the #SENOTECHANGE command, but with a different range of argument.

Proposal (IID): #BALLOON (Command)

OpenTaiko-OutFox standard version: (non-standard)
Impact level: note ★★★★★
Scope: branch, note one-shot
Scope fineness: non-before
Effect time: static
Effect target: balloon-type notes
Effect branches: current

Basically the same as the BALLOON: header, except that the #BALLOON command only applies to non-preceding notes in the note definition.

Override the assigned hit amount specified by the one of the BALLOON headers if applies to an already assigned balloon-type note.

The semantics are otherwise the same as the BALLOON headers.

#SECTION

OpenTaiko-OutFox standard version: 1.0 (except proposed forms)
Impact level: note ★★★★★
First seen in: TaikoJiro v1.63
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC)
Scope: branch, instant one-shot
Scope fineness: non-before
Effect time: static determine in-section objects + command-time switch sections
Non-static effect scope: last and current section (across branches)
Effect target: (none)
Effect branches: all

Start a 譜fu 面men 分bun 岐ki “notechart branch”/forked path–determining section by resetting the value of the conditions for determining the next not-yet-determined “branch(es)”/path(s) at the beginning of the section. See the explanation for the #BRANCHSTART command.

When the #SECTION command & a “branch”/path–determining point occur at the same beat position, the effect of the #SECTION command should take place after the “notechart branch”/forked path is determined.

The effects of #SECTION applie regardless the current branch and on which branch the command is defined.

An implicit #SECTION is placed at the beginning of every notechart definition.

Unspecified: Whether the value of the condition for determining the “branch”/path by score (#BRANCHSTART s, <number-expert-branch-requirement>, <number-master-branch-requirement>) is reset.

Compatibility Issues

Proposal (IID): #SECTIONRESUME / #SECTIONEND

OpenTaiko-OutFox standard version: (non-standard)
Impact level: note ★★★★★
Scope: branch, instant one-shot
Scope fineness: non-before
Effect time: static determine in-section objects + command-time switch sections
Non-static effect scope: last and current section (across branches)
Effect target: (none)
Effect branches: all

Resume/end a 譜fu 面men 分bun 岐ki “notechart branch”/forked path–determining section by resuming/stopping updating the value of the conditions for determining the next not-yet-determined “branch(es)”/path(s) at the beginning of the section. See the explanation for the #BRANCHSTART command.

This command can apply to only named “branch”/path-determining sections.

#LEVELHOLD

OpenTaiko-OutFox standard version: 1.0
Impact level: note ★★★★★
First seen in: TaikoJiro v1.63
Supported by: TaikoJiro 2, TJAPlayer2 for.PC
Scope: branch
Scope fineness: measure
Effect time: static
Effect target: (none)
Effect branches: current (only the routes reaching the command)

Override the result of all 譜fu 面men 分bun 岐ki “notechart branch“/forked path (“level”) determination from the definition of this measure and on with the current branch/path (“hold”).

Proposal (IID): Its effects end at either the next another #LEVELHOLD or a #LEVELREDIR command.

Compatibility Issues

Proposal (IID): #LEVELREDIR

OpenTaiko-OutFox standard version: (non-standard)
Impact level: note ★★★★★
Scope: branch
Scope fineness: measure
Effect time: static
Effect target: (none)
Effect branches: current (only the routes reaching the command)

Override the result of all 譜fu 面men 分bun 岐ki “notechart branch“/forked path (“level”) determination from the definition of this measure and on with specified branches/paths (redirect).

Its effects end at either the next #LEVELHOLD or another #LEVELREDIR command.

#BRANCHSTART / #BRANCHEND

OpenTaiko-OutFox standard version: 1.0 (except proposed forms; except d condition)
Impact level: note ★★★★★
First seen in: TaikoJiro v1.63
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC)
Scope: notechart
Scope fineness: measure
Effect time: static objects’ measure position + command-time objects’ enabling status & visual
Non-static effect scope: notes, bar lines, & judgment mark(s): non-before, note field(s): non-before the previous measure (#BRANCHSTART) or (none) (#BRANCHEND)
Effect target: notes, bar lines, judgment mark(s), note field(s)
Effect branches: all

Respectively start / end the definition of a 譜fu 面men 分bun 岐ki “notechart branch“/forked path section.

The determining point of this “branch”/path section is defaulted to be placed at the beginning of the previous measure from the #BRANCHSTART command.

At the determining point, the “branch”/path–switching effects are played but the current “branch”/path is not changed until the actual beginning of the “branch”/path section.

Conditions

<enum-str-condition> specifies the condition value for determining the “branch”/path.

Swap note in Taiko mode (G) is not counted as a type of big note for calculating the condition value.

Except for roll count conditions, only notes whose tail (if exists) or critical judgement time is in the taken route are counted.

Unspecified: Whether the condition value is updated based on the duration (if exists) or critical judgement time (hit-type note) of the note, or the actual finish-hit time for the note, if they do not happen in the counted determining section for the same branch determining point.

In addition to expr, <enum-str-condition> can be one of the following:

Precision Conditions

The percentage calculated from notes during the determining section is used.

Judgement Count Conditions

The amount calculated from notes during the determining section is used.

Note Count Conditions

The amount calculated from notes during the determining section is used.

Roll Count Conditions

If a counted drumroll note is defined as beginning non-after but ending after the default beat position of the determining point, the actual determining point is postponed until the earlier of the definition positions of the ending of that note and an unspecified duration before the #BRANCHSTART command.

The accumulated amount calculated from notes during the determining section is used.

State Conditions

For region conditions, the value calculated during the determining section (counted from 0) is used. For other state conditions, the final value at the determining point (may have non-0 initial value) is used.

Condition Judgement

For <number-*-branch-requirement>, the resulting condition value will be compared to the specified requirement value according to <enum-str-range>. For <bool-*-branch-requirement>, the expression will be evaluated.

Usage

They are conventionally used as follow:

#BRANCHSTART r,1,2 // Exemplar branch/path condition similar to the opening section of the "画竜点睛 (Garyoutensei)" series
#N
    // 0 hits: "普通 (Futsuu)" Normal branch/path
    // Normal branch/path section

#E
    // 1 hit: "玄人 (Kurouto)"/Advanced branch/path
    // Advanced branch/path section

#M
    // 2+ hits: "達人 (Tatsujin)"/Master branch/path
    // Master branch/path section

#BRANCHEND // Sometimes optional, see below

// Some commands or notechart section

#BRANCHSTART p,0,101 // Exemplar condition which forces the "玄人 (Kurouto)"/Advanced branch/path to be chosen
// ...

An implicit #BRANCHEND is placed before #BRANCHSTART and #END commands. If no commands & notechart symbols occur after the explicit defined #BRANCHEND and before such commands, the #BRANCHEND can be omitted.

Unspecified: The behavior when any of the followings are violated:

Compatibility Issues

#N / #E / #M

OpenTaiko-OutFox standard version: 1.0
Impact level: note ★★★★★
First seen in: TaikoJiro v1.63
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC)
Scope: notechart
Scope fineness: measure
Effect time: static
Effect target: notes, bar lines, judgment mark(s), note field(s)
Effect branches: all

Start the definition of respectively the 普Fu 通tsuu Normal / 玄Kuro 人uto “Professional”/Advanced (“Expert”) / 達Tatsu 人jin Master 譜fu 面men (分bun 岐ki) “notechart branch”/forked path section.

The definition of unused “branches”/paths due to forced “branch”/path determination can be omitted.

Unspecified: The behavior when any of the followings are violated:

Compatibility Issues

Proposal (barrier): #GROUP

OpenTaiko-OutFox standard version: (non-standard)
Impact level: gimmicky ★★・・・
Scope: branch (?)
Scope fineness: non-before
Effect time: static
Effect target: notes, bar lines, judgment mark(s), note field(s)
Effect branches: current (?)

Start the definition of a timing group. (?)

(TMG syntax, but no known argument)

Proposal (barrier): Conditional SPAWN Commands

OpenTaiko-OutFox standard version: (non-standard)
Impact level: note ★★★★★
Scope: branch (?)
Scope fineness: sequential
Effect time: command-time
Non-static effect scope: non-before
Effect target: notes, bar lines, judgment mark(s), note field(s)
Effect branches: current (?)

Define conditionally enabled notechart sections which appear / disappear with the effects of #NOTESPAWN (“spawn”), when the specified time point before the command is reached.

All <bool-condition> within a conditional spawn definition section are (re-)evaluated at each specified <float-seconds-duration> seconds before the #*SPAWN() command. (?)

Within a conditional spawn definition section, after each (re-)evaluation, the conditional notechart definition section of the first defined #*SPAWN() command with <bool-condition-enable> being true, <bool-condition-disable> being false, or without specifiable <bool-condition-*> is enabled, while all the other sections are disabled.

<enum-str-spawntype> must be one of:

Example usages (adapted from barrier15300):

// Evaluated at 0 seconds before the `#IFSPAWN()`
#IFSPAWN(CD.Good == 100, Spawn, 0)
  // Initially disabled and invisible
  // If enabled, appears 0 seconds before the command
  2010201011102010,
#ELSESPAWN(Vanish, 0)
  // Initially enabled and visible
  // If disabled, disappears 0 seconds before the command
  1011201020101120,
#IFSPAWNEND()

// Evaluated at 0.5, 0, & -1 second before the `#UNLESSSPAWN()`
#UNLESSSPAWN(CD.Good < 100, Spawn, 0)
  // Initially disabled and invisible
  // If enabled, appears 0 seconds before the command
  2222102222102222,
#ELSEIFSPAWN(CD.Bad > 0, Vanish, -1)
  // Initially enabled and visible
  // If disabled, disappears -1 second before (i.e., 1 second after) the command
  1111221110102211,
#ELSESPAWN(Spawn, 0.5)
  // Initially disabled and invisible
  // If enabled, appears 0.5 seconds before the command
  1110111011102220,
#IFSPAWNEND()

#NEXTSONG

OpenTaiko-OutFox standard version: 1.0 (minimum, unless stated otherwise)
Impact level: timing ★★★★・
First seen in: TJAPlayer3 v1.5.0
Scope: notechart
Scope fineness: non-before
Effect time: command-time
Non-static effect scope: all
Effect target: all
Effect branches: all

Switch to the next song in the 段Dan’ 位i 認nin 定tei モーMoo ドdo “Rank Certification Mode”.

段Dan’ 位i 認nin 定tei モーMoo ドdo “Rank Certification Mode” resembles 段Dan’ 位i 道Dou 場jou “Rank Dojo”/Dan-i Dojo in the official games.

Used in conjunction with COURSE:Dan.

See TJC Header for the header version of the #NEXTSONG command.

#GAMETYPE

OpenTaiko-OutFox standard version: 1.2
Impact level: note ★★★★★
First seen in: OpenTaiko (0auBSQ) v0.6.0, OutFox v0.4.18
Scope: branch
Scope fineness: non-before
Effect time: static
Effect target: notes, bar lines
Effect branches: Unspecified

Specify the game mode (“type”) for the notes non-before the current beat position. The meaning of the note symbols non-before the current beat position is changed accordingly; see TJA Notechart Definition.

Unspecified: The implemented game modes other than Taiko mode and Konga mode.

See the GAME: header for specifying the initial game mode for the notechart.

Compatibility Issues

NOTE / BARLINE Commands

OpenTaiko-OutFox standard version: (non-standard)
Impact level: gimmicky ★★・・・
First seen in: TaikoManyGimmicks
Scope: branch
Scope fineness: non-before
Effect time: static
Effect target: notes, bar lines
Effect branches: branch (?)

Manipulate the display properties of notes & bar lines.

The arguments are whitespace-separated.

Resetters:

Setters:

#GRADATION

OpenTaiko-OutFox standard version: (non-standard)
Impact level: gimmicky ★★・・・
First seen in: TaikoManyGimmicks v0.6α
Scope: branch
Scope fineness: gradation group
Effect time: command-time
Non-static effect scope: gradation group
Effect target: notes, bar lines
Effect branches: current (?)

Control the commands apply to the starting/ending of the per–note/bar line approaching phase (“gradation”).

Reset by #RESETCOMMAND.

The arguments are whitespace-separated.

They are conventionally used as follow:

If a static effect of a command is specified to be interpolated, the static effect will be overridden by the command-time version of the same effect with the time position relative to the beginning of the gradation group.

Unspecified: Which commands are supported by the #GRADATION command.

Commands supporting the #GRADATION command in TaikoManyGimmicks:

#INCLUDE

OpenTaiko-OutFox standard version: (non-standard)
Impact level: note ★★★★★ (depending on included notechart definition content)
First seen in: TaikoManyGimmicks v0.6.1α
Scope: (depending on included notechart definition content)
Scope fineness: sequential
Effect time: (depending on included notechart definition content)
Effect target: (depending on included notechart definition content)
Effect branches: (depending on included notechart definition content)

Append (“include”) the notechart definition content defined the included file to the current definition. The included file can include any headers and commands in the TMG format.

#SPLITLANE / #MERGELANE

OpenTaiko-OutFox standard version: (non-standard)
Impact level: gimmicky ★★・・・
First seen in: OpenTaiko (0auBSQ) v0.6.0
Scope: branch
Scope fineness: non-before
Effect time: command-time
Non-static effect scope: all
Effect target: notes, bar lines, judgment mark(s), note field(s)
Effect branches: Unspecified

Split/merge the note field (“lane”) into/from top and bottom note field, with ドDo ンn notes on the top note field, カKa ツtsu notes on the bottom note field, and other notes on the middle of these 2 note fields.

OBJ / CAM Commands

OpenTaiko-OutFox standard version: 2.0
Impact level: gimmicky ★★・・・
First seen in: TJAPlayer3-Extended
Supported by: OpenTaiko (0auBSQ) v0.6.0
Scope: branch
Scope fineness: non-before (some are sequential)
Effect time: command-time
Non-static effect scope: all
Effect target: gameplay screen
Effect branches: Unspecified

Manipulate texture objects & the game screen camara.

Loader & unloader, reset by each other:

Display property setters:

Frame-based animation:

CAM commands:

The #<property>START and #<property>END commands are sequential.

The approach phase of a #<property>START command starts at its definition position and is ended by the nearest non-preceding corresponding #<property>END in notechart definition. Unspecified: The behavior when a #<property>START command either has no such corresponding #<property>END or has such #<property>END with an earlier time position than the #<property>START command itself.

<enum-str-easing-points> can be one of:

<enum-str-easing-function> can be one of:

#BORDERCOLOR

OpenTaiko-OutFox standard version: 2.0
Impact level: decorative ・・・・・
First seen in: TJAPlayer3-Extended
Supported by: OpenTaiko (0auBSQ) v0.6.0
Scope: branch
Scope fineness: non-before
Effect time: command-time
Non-static effect scope: all
Effect target: gameplay screen
Effect branches: Unspecified

Set the color of the displayed region outside the border of the gameplay screen (when the gameplay screen camera is manipulated).

#CHANGETEXTURE / #RESETTEXTURE

OpenTaiko-OutFox standard version: 2.0
Impact level: gimmicky ★★・・・
First seen in: TJAPlayer3-Extended
Supported by: OpenTaiko (0auBSQ) v0.6.0
Scope: branch
Scope fineness: non-before
Effect time: command-time
Non-static effect scope: all
Effect target: gameplay screen
Effect branches: Unspecified

Respectively change / restore (“reset”) the texture used in the current skin.

Reset by each other.

#SETCONFIG

OpenTaiko-OutFox standard version: 2.0
Impact level: gimmicky ★★・・・
First seen in: TJAPlayer3-Extended
Supported by: OpenTaiko (0auBSQ) v0.6.0
Scope: branch
Scope fineness: non-before
Effect time: command-time
Non-static effect scope: all
Effect target: gameplay screen
Effect branches: Unspecified

Override (“set”) the config value read from the SkinConfig.ini of the currently used skin.

Unspecified: The exact list of valid configs, allowed values, and the behaviors.

#BGAON / #BGAOFF

OpenTaiko-OutFox standard version: (non-mandatory; 1.0-compatible)
Impact level: decorative ・・・・・
First seen in: OpenTaiko (0auBSQ) v0.6.0
Scope: branch
Scope fineness: non-before
Effect time: command-time
Non-static effect scope: all
Effect target: gameplay screen
Effect branches: Unspecified

Start (“on”)/stop (“off”) playing the specified background video (“animation”) defined by the BGA: header on the gameplay screen.

The arguments are whitespace-separated.

Compatibility Issues

Proposal (IID): #LUAMOD

OpenTaiko-OutFox standard version: (non-standard)
Impact level: note ★★★★★ (intended; depending on usage)
Scope: branch
Scope fineness: sequential
Effect time: static
Effect target: notes, bar lines (intended; depending on usage)
Effect branches: current

Execute the given Lua code with predefined variables describing the current beat position, the loaded notechart, etc., after the notechart is loaded.

Intended for modifying the content of loaded notechart, including adjusting the notechart timing, calculating relative note distance, etc.

The exact behavior is unspecified.

Inspired by StepMania.

Proposal (IID): #LUAFX

OpenTaiko-OutFox standard version: (non-standard)
Impact level: gimmicky ★★・・・ (intended; depending on usage)
Scope: branch
Scope fineness: sequential
Effect time: command-time + (optional) object-time note-path effects
Non-static effect scope: (Depending on usage)
Effect target: notes, bar lines, judgment mark(s), note field(s) (intended; depending on usage)
Effect branches: current

Execute the given Lua code with predefined variables describing the current beat position, the loaded notechart, etc., when the beginning of the approach phase of the command is reached during gameplay.

Intended for adding decorative visual/audio effects (“FXs”), including changing the moving path of notes, (dis)play extra images and sounds, etc.

Intended to be used in conjunction with Proposed (IID) command modifiers.

The exact behavior is unspecified.

Inspired by StepMania.

Proposal (IID): Command Modifier

OpenTaiko-OutFox standard version: (non-standard)
Impact level: gimmicky ★★・・・
Scope: (Part of a command)
Scope fineness: (Part of a command)
Effect time: command-time + (optional) object-time note-path effects
Non-static effect scope: (As specified)
Effect target: notes, bar lines, note field(s)
Effect branches: (Part of a command)

A command modifier can be specified to certain branch-scoped commands using the following form:

The whitespace rule of the comma (,) also applies to the semicolon (;).

The characters after the first semicolon (;) are ignored in TaikoJiro 1 but cause crashes in TaikoJiro 2 when loaded.

<effect-scope-specifier> specifies the non-static effect scope of the command.

<approach-specifier> specifies the time or beat interval and easing method of the approach phase.

<range-duration-*> specifies the time/beat duration interval of the approach phase and can be one of:

TJA Notechart Definition

The notechart definition is enclosed between #START & #END.

Most headers are not allowed in notechart definition.

Unspecified: The behavior when a header not allowed in notechart definition is placed in a notechart definition.

A notechart definition line can be one of:

Whitespaces in Notechart Definition

In non-command lines, all whitespaces are ignored. (TaikoJiro-only?)

Notechart Symbols

Including the measure delimiter symbol (comma; ,) & note symbols (<enum-str-note>).

A measure consists of at least 1 notechart symbol (except for the last measure of the chart) and any number of commands and headers. The measure delimiter symbol , must be the last element if present.

Unspecified: The behavior if the last measure of the chart is not ended with the measure delimiter symbol ,.

Unspecified: Whether unrecognized note symbols are ignored (removed) or treated as 0 (blank).

The Measure Delimiter Symbol and Timing

The definition of each measure is separated with a comma (,) in a non-command line. Unspecified: The behavior when there are non-whitespaces, non-comment trailing characters after the first comma (,) of a non-command line

Within a measure, there can be any amount of note symbols as long as the unspecified maximum allowed amount is not exceeded.

Each note symbol has the division weight of 1. The measure delimiter symbol , at the end of a measure (if any) has the division weight of 0 if there is at least 1 note symbol in this measure, otherwise this delimiter , has the division weight of 1.

The total beat duration of the measure is divided equally by the total division weight of the notechart symbols of this measure (including the note symbols and the measure delimiter symbol , at the end of this measure (if any)). Each unit of division weight occupies the same amount of beats — a closed-head, open-end interval “measure division interval”.

The beat and time position of the note, note head, or note end for the notechart symbol (if any) is at the beginning of the first division interval for this notechart symbol. The time duration of every division interval can vary and even become negative.

Equation: beat_duration_of_division (scope: a measure)

Equation: time_duration_of_division (unit: seconds)

Compatibility issues:

Commands with non-before scope fineness have their effects fired when all the measure division intervals of the nearest preceding notechart symbol ends. If the measure delimiter symbol , has the division weight of 0, placing such commands before or after this , symbol has the same effects.

Sign of Timing Commands

The time duration of different measure division intervals are possible to overlap by using #BPMCHANGE, #MEASURE, or #DELAY commands with non-positive value.

Unspecified: The input judgment behavior when the time duration intervals of any non-blank note symbols overlap.

Each sign combination of BPM & beat duration is as follow:

Sign of BPM Sign of Beat Duration Notes on Behavior Beat-time Diagram
Positive Positive   b-t diagram for positive BPM & positive beat duration
Positive Negative The time position of notes are unspecified if notes are defined within. b-t diagram for positive BPM & negative beat duration
Zero Any In TaikoJiro 1 and 2, the time duration is 0 instead of infinity. b-t diagram for zero BPM & positive beat duration
b-t diagram for zero BPM & negative beat duration
Negative Positive The time position of notes are unspecified if notes are defined within. b-t diagram for negative BPM & positive beat duration
Negative Negative   b-t diagram for negative BPM & negative beat duration

Their common combinations and usages are as follow:

Usage Examplar Combination Beat-time Diagram
Forward scrolling in BMS scrolling modes. (Assume #SCROLL 1) d: Positive BPM & positive beat duration Beat-time diagram for forward scrolling
Backward scrolling in BMS scrolling modes. (Assume #SCROLL 1) d: Negative BPM & negative beat duration Beat-time diagram for backward scrolling
Forward warp in BMS scrolling modes. (Assume #SCROLL 1) d0: Positive BPM & positive beat duration
+ d1: Negative BPM & positive beat duration
+ (d2): Beat duration ÷ BPM is positive (determines the note spacing)		 Beat-time diagram for a forward warp
Backward warp in BMS scrolling modes. (Assume #SCROLL 1) d0: Negative BPM & negative beat duration
+ d1: Positive BPM & negative beat duration
+ (d2): Beat duration ÷ BPM is positive (determines the note spacing)		 Beat-time diagram for a backward warp
Overlapped notes in forward scrolling sections.
A special case of a warp.
(Can also be done with a negative #DELAY)		 d0: Positive BPM & positive beat duration (with notes)
+ d1: Positive BPM & negative beat duration
+ d2: Positive BPM & positive beat duration (with notes)		 Beat-time diagram for a overlapping forward scrolling section
Overlapped notes in backward scrolling sections.
A special case of a warp.
(Can also be done with a negative #DELAY)		 d0: Negative BPM & negative beat duration (with notes)
+ d1: Negative BPM & positive beat duration
+ d2: Negative BPM & negative beat duration (with notes)		 Beat-time diagram for a overlapping backward scrolling section

Each sign combination of #DELAY duration & BPM is as follow:

Sign of Delay Duration Sign of BPM Musical (“Actual”) Beat-time Diagram Visual Beat-time Diagram
Positive Non-zero Musical beat-time diagram for positive delay duration Visual beat-time diagram for positive delay duration, non-zero BPM
Negative Positive Musical beat-time diagram for negative delay duration Visual beat-time diagram for negative delay duration, positive BPM
Negative Negative Musical beat-time diagram for negative delay duration Visual beat-time diagram for negative delay duration, negative BPM

The visual beat duration behavior between positive and negative delay is not symmetrical, so the visual effects of positive delays and negative delays with total delay duration being zero do not cancel out. The behavior is as follows:

Examplar Combination Musical Beat-time Diagram Visual Beat-time Diagram
d0: Positive delay
+ d1: Negative delay & positive BPM
+ d2: Positive BPM & positive beat duration (with notes)		 Musical beat-time diagram for positive delay and then negative delay Visual beat-time diagram for positive delay and then negative delay, positive BPM

Compatibility Issues

Note Symbols in Taiko Mode

OpenTaiko-OutFox standard version: 1.0 (minimum, unless stated otherwise)
First seen in: TJF format
Supported by: (assumedly universally supported, including TaikoJiro, TJAPlayer2 for.PC, OutFox v0.4.9.9)

Effective when GAME:Taiko or #GAMETYPE Taiko is in effect.

See https://taiko.namco-ch.net/taiko/en/howto/onpu.php for the appearance of notes in the official PC-generation arcade games.

See #SENOTECHANGE for the general patterns of how the alternative forms of 口Kuchi 唱Shou 歌ga
“Note phoneticizations” are used.

  Note Type Note Appearance 口Kuchi 唱Shou 歌ga
“Note phoneticizations” in PC-generation arcade games		 Explanations on Clear Explanations on Fail Notes
0 (blank) (none) (none) Nothing needs to be done. Consume no input. (impossible to fail) First seen in: TJF format
1 Regular ドDo ンn Small orange-ish red circle ドDo Do / コKo / ドDo ンn Don Hit the drum surface within the 可Ka GOOD/OK timing window, consumes a surface input.
Awards 良Ryou GREAT/GOOD or 可Ka GOOD/OK judgment according to the timing and increases combo.
Increases 魂tamashii ゲーgeeジji spirit gauge/soul gauge, & score according to awarded judgment.		 Hit too off but within 不Fu 可ka BAD judgment window (consumes a surface input) or not hit within the 不Fu 可ka BAD judgment window (consumes no inputs).
Gives a 不Fu 可ka BAD judgment & combo break and decreases 魂tamashii ゲーgeeジji spirit gauge/soul gauge.		 First seen in: TJF format
2 Regular カKa ツtsu Small sky-blue circle カKa / カッKa’ Ka Hit the drum rim within the 可Ka GOOD/OK timing window, consumes a rim input.
Awards the same as 1.		 Hit too off but within 不Fu 可ka BAD judgment window (consumes a surface input) or not hit within the 不Fu 可ka BAD judgment window (consumes no inputs).
Gives the same penalty as 1.		 First seen in: TJF format
3 Big ドDo ンn Big orange-ish red circle ドDo ンn（大Ookii） DON Hit the drum surface within the 可Ka GOOD/OK timing window, consumes a surface input.
Awards the same as 1 but extra score bonus† if with certain or greater force (AC)
if the other left or right side is hit within a certain time duration (consumes two surface inputs in total) (CS)		 (same as 1) First seen in: TJF format
4 Big カKa ツtsu Big sky-blue circle カッKa’（大Ookii） KA Hit the drum rim within the 可Ka GOOD/OK timing window, consumes a rim input.
Awards the same as 2 but extra score bonus† if with certain or greater force (AC)
if the other left or right side is hit within a certain time duration (consumes two rim inputs in total) (CS)		 (same as 2) First seen in: TJF format
5 Head of regular (bar) 連Ren 打da drumroll
Examples: 5008, 5558, 5001		 Small yellow circle with bar attached behind
Turns red if hit rapidly while gradually fading out to its original color in AC games		 連Ren 打daー Roll– Roll on the drum surface or rim during its duration, consumes each hit with unlimited speed, reacts to each hit up to 1 hit per 60fps frame (official games).
Increases score per reacted hit.		 (impossible to fail) First seen in: TJF format
I (same as 5) (OpenTaiko (0auBSQ))
Head of regular カKa ツtsu (bar) 連Ren 打da drumroll (OutFox’s OpenTaiko-OutFox standard draft (?))
Examples: I008, III8, I001		 (see 5)
Small sky-blue circle with bar attached behind (OutFox, expected (?))		 (see 5) (same as 5) (OpenTaiko (0auBSQ))
Similar to 5 but only consumes (?) and reacts to rim inputs. (OutFox’s OpenTaiko-OutFox standard draft)
Awards the same as 5.		 (impossible to fail) OpenTaiko-OutFox standard version: 1.2
First seen in: OpenTaiko-OutFox standard 1.2 (first proposed from OutFox), OpenTaiko (0auBSQ) v0.5.4
By analogy with Konga mode
6 Head of big (bar) 連Ren 打da drumroll
Examples: 6008, 6668, 6001		 Big yellow circle with bar attached behind
Turns red if hit rapidly while gradually fading out to its original color in AC games		 連Ren 打da（大Ookii）ー ROLL– Roll on the drum surface or rim during its duration, consumes each hit with unlimited speed, reacts to each hit up to 1 hit per 60fps frame (official games).
Increases score per reacted hit.
Extra score bonus† for each reacted hit if with certain or greater force (?) (earlier AC), and/or with at least 2 hits in a 60fps frame (?) (earlier AC & earlier CS), or always (?) (AC & CS)		 (impossible to fail) First seen in: TJF format
H (same as 6) (OpenTaiko (0auBSQ))
Head of regular ドDo ンn (bar) 連Ren 打da drumroll (OutFox’s OpenTaiko-OutFox standard draft (?))
Examples: H008, HHH8, H001		 (see 6)
Small orange-ish red circle with bar attached behind (OutFox)		 (see 6) (same as 5) (OpenTaiko (0auBSQ))
Similar to 5 but only consumes (?) and reacts to surface inputs. (OutFox’s OpenTaiko-OutFox standard draft)
Awards the same as 5.		 (impossible to fail) OpenTaiko-OutFox standard version: 1.2
First seen in: (first proposed from OutFox), OpenTaiko (0auBSQ) v0.5.4
By analogy with Konga mode
7 Head of regular 激Geki 連ren 打da/ゲGe キki 連ren 打da “fierce drumroll” burst note / 風Fuu 船sen/ふ Fu うu せse んn balloon
Examples: 7008, 7778, 7001		 Small orange circle (slightly brighter than 1) with orange-ish red balloon attached behind ふ Fu うu せse んn Balloon Roll on the drum surface with exactly certain amount of reacted hits during its duration, consumes each surface or rim (?) hit with unlimited speed, reacts to each surface hit up to 1 hit per 60fps frame (official games).
Each reacted hit increases score (except for CS4–5, TDM, & PSP1–2).
Awards extra score bonus† when cleared.		 Fail to input enough amount of reacted hits.
Does not give penalties except that notes (except bombs/mines (?)) placed within the duration of the balloon are impossible to hit while the balloon is not cleared.		 First seen in: TJF format
8 Explicit end of a drumroll-type note (if any), otherwise (blank) (round end of a bar) (end of bar drumrolls)
(none) (otherwise)		 (っ!!) (end of bar drumrolls)
(none) (otherwise)		 Nothing needs to be done. Consumes no input. (impossible to fail) Stopping rolling the drum non-after the point (end of drumrolls)
Introduced to replaced the TJF syntax for specifying drumroll duration (5555 / 7777) (explained below).
9 Head of special burst note/balloon
(Differ from game to game)
Examples: 9008, 9998, 9001		 (Vary)
Big yellow circle with potato attached (PS2-generation)
Big yellow circle in the shape of a confetti ball 🎊 (PS3- and PC-generation)
Has particle decorative visual effects in AC.		 くKu すsu 玉dama Party Popper
(Strictly speaking, 薬Kusu 玉dama/くKu すsu 玉dama “Confetti Ball” 🎊 & party popper 🎉 only resemble each other and are not the same thing)		 (Vary)
In AC, roll on the drum surface with exactly certain amount (summed and shared among players) of reacted hits during its duration, consumes each surface or rim (?) hit with unlimited speed, reacts to each surface hit up to 1 hit per 60fps frame (official games).
Each reacted hit increases score.
Awards vary extra score bonus† when cleared, according to the timing of an additional final hit (consumed) hinted by the player character’s face (AC7) or whether the note is cleared quickly enough (later AC)
(same as 7) First seen in: TaikoJiro v2.75
In the official games, becomes 7 when not all players encounter 9 with the note head, the full bonus time point, & the note end respectively at the same time position for each player.
A Hand-holding big ドDo ンn Big orange-ish red circle with hands holding with other note(s) for other player(s) (none)
ドDo ンn（手Te） “DON (Hand)” (in 4-player mode)		 Similar to 3 but awards extra score bonus† if all players hit within a certain time duration
(same as 3) OpenTaiko-OutFox standard version: 1.0
First seen in: TJAPlayer2 for.PC ver.2018040100
Supported by: OutFox v0.4.9.9
In the official games, becomes 3 when no missable hit-type notes exist at the same time position for any of the player above or below the current player.
B Hand-holding big カKa ツtsu Big sky-blue circle with hands holding with other note(s) for other player(s) (none)
カッKa’（手Te） “KA (Hand)” (in 4-player mode)		 Similar to 4 but awards extra score bonus† if all players hit within a certain time duration. (same as 4) OpenTaiko-OutFox standard version: 1.0
First seen in: TJAPlayer2 for.PC ver.2018040100
Supported by: OutFox v0.4.9.9
In the official games, becomes 4 when no missable hit-type notes exist at the same time position for any of the player above or below the current player.
C Bomb/mine Small dark-blue cherry bomb with ignited fuze 💣 (none) All hits are too off or not hit (both consumes no inputs).
Awards a “bomb/mine-pass” judgment.		 Hit the drum surface or rim within the 可Ka GOOD/OK (?) timing window, consumes an input.
Gives a BOOM (“bomb/mine-miss”) judgment & a combo-break and decreases 魂tamashii ゲーgeeジji spirit gauge/soul gauge.		 OpenTaiko-OutFox standard version: 1.2
First seen in: OpenTaiko-OutFox standard 1.2 (proposed from OutFox)
Supported by: OpenTaiko (0auBSQ) v0.5.4
D Fuze/fuse drumroll
Examples: D008, DDD8, D001		 ?
(Big circular clock with blue-ish purple edge and with bar attached behind in OpenTaiko (0auBSQ))		 (時Ji 爆baku弾dan “Time bomb”/Fuseroll) Similar to 7 but awards a “bomb/mine-pass” judgment. Similar to 7 but gives a BOOM (“bomb/mine-miss”) judgment & a combo-break and decreases 魂tamashii ゲーgeeジji spirit gauge/soul gauge. OpenTaiko-OutFox standard version: 1.2
First seen in: (first proposed from OutFox), OpenTaiko (0auBSQ) v0.6.0
Not in the official games.
F Ad libitum note (AD-LIB) (invisible by default) (none) Hit the drum surface or rim within the 可Ka GOOD/OK timing window, consumes an input.
Awards an AD-LIB judgment but keep combo unchanged.		 Not hit within the 可Ka GOOD/OK timing window (consumes no inputs).
Gives no penalties.		 OpenTaiko-OutFox standard version: 1.1
First seen in: TJAPlayer2 for.PC ver.2016081500
Not in the official games.
Inspired by another rhythm game GROOVE COASTER, developed by TAITO
G Swap note (Vary)
Big green circle in taiko-web (plugin “Green Notes”)
Big purple circle in OpenTaiko (0auBSQ)		 (グGu リーrii ンn Green)
(カKa ドdo ンn KADON)		 Hit the drum surface (or rim) on left or right side within the 可Ka GOOD/OK timing window & the drum rim (or surface) on the other left or right side within a certain time duration (consumes a surface input & a rim input in total)
Awards the same as 1 according to the timing of the first input.		 Hit too off but within 不Fu 可ka BAD judgment window (consumes the first input), or not hit within the 不Fu 可ka BAD judgment window (consumes no inputs), or the second input is not given in a certain time duration after the first input (consumes only the first input).
Gives the same penalty as 1.		 OpenTaiko-OutFox standard version: 1.2
First seen in: taiko-web (plugin “Green Notes”)
Supported by: OpenTaiko (0auBSQ) v0.5.4
Not in the official games.

†: No score bonuses if the PC-generation scoring rule is followed.

Note type category

Duration of drumroll-type notes

The head and end of drumroll-type notes have no timing window. In the official arcade game, drumroll inputs are allowed non-before/non-after the containing frame of the judgment timing of the head/end of the drumroll-type note.

During the defined duration interval within a drumroll-type note, either 0 or the symbol of the note head may appear. E.g.: 5008 / 5558 / 5058 are all equivalent. Unspecified: Whether other drumroll-type notes can be used in place of the repeated symbol of the note head.

Proposal (IID): Each symbol of the note head inside a bar drumroll note denotes a middle point of the bar which can scroll independently to the head, end, and other middle points of the note.

For special balloons (9), the last occurrence of repeated note head symbol (if any) defines the full bonus time point. If the note is cleared, full bonus is awarded only by clearing the note non-after that point and partial bonus is awarded otherwise. The full bonus time point is unspecified when no repeated note head symbols ever occur.

By default, drumroll-type notes are ended non-after one of:

In the official games, drumroll-type notes are usually intentionally made to end earlier than the designed ending beat position by the amount of beats of a 1/48th note.

Unspecified: Whether other drumroll-type note symbols can appear during a drumroll-type note.

Unspecified: The behavior when a drumroll-type note with non-positive time duration is formed, possibly from a drumroll-type note ended by a hit-type note (e.g., 51 / 56 / 65, where the time duration of the drumroll may be shortened as mentioned above) or by using timing settings.

Compatibility Issues

Note Symbols in Jube Mode

OpenTaiko-OutFox standard version: (non-standard)
First seen in: TaikoJiro v2.13

Effective when GAME:Jube is in effect.

Unlike GAME:Taiko, every 4 hexadecimal digits are grouped together to represent a note combination and occupy the same beat duration interval.

In TJA files, within non-command lines, all whitespaces are ignored by TaikoJiro. In this game mode, every 4 digits are conventionally separated with a space for readability.

Example

(This example is adapted from the readme.txt distributed along with TaikoJiro)

Note Layout → 0/1 Notation → Note Symbol (Hexadecimal Digit)
■■□■ → 1101 → D
□■■□ → 0110 → 6
□□□■ → 0001 → 1
□□□□ → 0000 → 0

The above note combination is written D610.

GAME:Jube Example

Note Symbols in Konga Mode

OpenTaiko-OutFox standard version: 1.2 (unless stated otherwise)
First seen in: OpenTaiko (0auBSQ) v0.5.4
Supported by: taiko-web (plugin “Donkey Konga Mode”), OutFox

Effective when GAME:Konga or #GAMETYPE Konga is in effect.

See the exemplar actual gameplays:

See #SENOTECHANGE for the general patterns of how the alternative forms of 口Kuchi 唱Shou 歌ga
“Note phoneticizations” are used.

  Note Type Note Appearance 口Kuchi 唱Shou 歌ga
“Note phoneticizations” in Donkey Konga 3		 Explanations on Clear Explanations on Fail Notes
0 (blank) (none) (none) Nothing needs to be done. Consume no input. (impossible to fail)  
1 Right drum beat Red circle with its right half filled パPa / パッPa’ / パンPan Hit the right bongo drum within the OK timing window, consumes a right input.
Awards GREAT or OK judgment according to the timing and increases combo.
Increases healthy gauge, & score according to awarded judgment.		 Hit too off but within BAD judgment window (consumes a right input) or not hit within the BAD judgment window (consumes no inputs).
Gives a BAD (if hit) or MISS‡ (if not hit) judgment & combo break and decreases healthy gauge.		  
2 Left drum beat Yellow circle with its left half filled ポPo / ポッPo’ / ポンPon Hit the left bongo drum within the OK timing window, consumes a left input.
Awards the same as 1.		 Hit too off but within BAD judgment window (consumes a left input) or not hit within the BAD judgment window (consumes no inputs).
Gives the same penalty as 1.		  
3 Both drum beats Pink circle D Hit the left or right bongo drum within the OK timing window & the other left or right bongo drum within a certain time duration (consumes a left input & a right input in total)
Awards the same as 1 according to the timing of the first input.		 Hit too off but within BAD judgment window (consumes the first input), or not hit within the BAD judgment window (consumes no inputs), or the second input is not given in a certain time duration after the first input (consumes only the first input).
Gives the same penalty as 1.		  
G (same as 3) (see 3) (see 3) (see 3) (see 3) First seen in: OpenTaiko-OutFox standard 1.2, OpenTaiko (0auBSQ) v0.5.4, OutFox v0.4.18
By analogy with Taiko mode.
4 Clap Sky-blue circle with star-ish edge チャCha / チャッCha’ / チャンChan Clap hands above the bongo drums within the OK timing window, consumes a clap input.
Awards the same as 1.		 Hit too off but within BAD judgment window (consumes a clap input) or not hit within the BAD judgment window (consumes no inputs).
Gives the same penalty as 1.		  
J (same as 4) (see 4) (see 4) (see 4) (see 4) OpenTaiko-OutFox standard version: (non-standard)
First seen in: OutFox v0.4.18 (?)
5 Head of right bar drumroll
Examples: 5008, 5558, 5001		 Red circle with its right half filled and with bar attached behind 連Ren 打da～ “Roll~” Similar to 6 but only consumes (?) and reacts to right inputs.
Awards the same as 6.		 (impossible to fail)  
I Head of left bar drumroll
Examples: I008, III8, I001		 Yellow circle with its left half filled and with bar attached behind 連Ren 打da～ “Roll~” Similar to 6 but only consumes (?) and reacts to left inputs.
Awards the same as 6.		 (impossible to fail)  
6 Head of both bar drumroll
Examples: 6008, 6668, 6001		 Pink circle with bar attached behind 連Ren 打da～ “Roll~” Roll on either bongo drum during its duration, consumes each left, right, or clap (?) hit with unlimited speed, reacts to each left or right hit up to 1 hit per 60fps frame (official games).
Increases score per reacted hit.		 (impossible to fail)  
H Head of clap bar applause
Examples: H008, HHH8, H001		 Sky-blue circle with star-ish edge and with bar attached behind 拍Haku 手shu～ “Applaud~” Applaud above the bongo drums during its duration, consumes each left (?), right (?), or clap hit with unlimited speed, reacts to each clap hit up to 1 hit per 60fps frame (official games).
Increases score per reacted hit.		 (impossible to fail)  
7 Head of regular 激Geki 連ren 打da/ゲGe キki 連ren 打da “fierce drumroll” burst note / 風Fuu 船sen/ふ Fu うu せse んn balloon
Examples: 7008, 7778, 7001		 Small orange circle (slightly brighter than 1) with orange-ish red balloon attached behind (ふ Fu うu せse んn Balloon) Roll on either bongo drum with exactly certain amount of reacted hits during its duration, consumes each left, right, and clap (?) hit with unlimited speed, reacts to each left or right hit up to 1 hit per 60fps frame (official games).
Each reacted hit increases score.
Awards extra score bonus† when cleared.		 Fail to input enough amount of reacted hits.
Does not give penalties except that notes (except bombs/mines (?)) placed within the duration of the balloon are impossible to hit while the balloon is not cleared.		 First seen in: OpenTaiko-OutFox standard 1.2
By analogy with Taiko mode.
8 Explicit end of a drumroll-type or applause note (if any), otherwise (blank) (round end of a bar) (end of a bar drumroll or applause)
(none) (otherwise)		 (none) Nothing needs to be done. Consumes no input. (impossible to fail) Stop rolling both the bongo drums or clapping non-after the point (end of drumrolls)
9 Head of special burst note/balloon
Examples: 9008, 9998, 9001		 (Vary) (くKu すsu 玉dama Party Popper) (Vary)
Roll on either bongo drum with exactly certain amount (summed and shared among players) of reacted hits during its duration, consumes each left, right, or clap (?) hit with unlimited speed, reacts to each left or right hit up to 1 hit per 60fps frame (official games).
Each reacted hit increases score.
Awards vary extra score bonus† when cleared, according to whether the note is cleared quickly enough.		 (same as 7) First seen in: OpenTaiko-OutFox standard 1.2
Might become 7 when not all players encounter 9 with the note head, the full bonus time point, & the note end respectively at the same time position for each player.
Not in the official games.
By analogy with Taiko mode.
A Hand-holding both drum beats (Pink circle with hands holding with other note(s) for other player(s)) ? Similar to 3 but awards extra score bonus† if all players hit within a certain time duration
(same as 3) First seen in: OpenTaiko-OutFox standard 1.2, OpenTaiko (0auBSQ), OutFox
Might becomes 3 when no hit-type notes exist at the same time position for any of the player above or below the current player.
Not in the official games.
By analogy with GAME:Taiko.
B Hand-holding clap beat (Sky-blue circle with star-ish edge and with hands holding with other note(s) for other player(s)) ? Similar to 4 but awards extra score bonus† if all players hit within a certain time duration. (same as 4) First seen in: OpenTaiko-OutFox standard 1.2, OpenTaiko (0auBSQ), OutFox
Might becomes 4 when no hit-type notes exist at the same time position for any of the player above or below the current player.
Not in the official games.
By analogy with Taiko mode.
C Bomb/mine (Small dark-blue cherry bomb with ignited fuze 💣) (none) All hits are too off or not hit (both consumes no inputs).
Awards a “bomb/mine-pass” judgment.		 Hit either bongo drum or clap within the OK (?) timing window, consumes an input.
Gives a BOOM (“bomb/mine-miss”) judgment & a combo-break and decreases healty gauge.		 First seen in: OpenTaiko-OutFox standard 1.2, OpenTaiko (0auBSQ)
Not in the official games.
By analogy with Taiko mode.
D Fuze/fuse drumroll
Examples: D008, DDD8, D001		 (Big circular clock with blue-ish purple edge and with bar attached behind in OpenTaiko (0auBSQ)) (時Ji 爆baku弾dan “Time bomb”/Fuseroll) Similar to 7 but awards a “bomb/mine-pass” judgment. Similar to 7 but gives a BOOM (“bomb/mine-miss”) judgment & a combo-break and decreases healthy gauge. First seen in: OpenTaiko-OutFox standard 1.2 (first proposed from OutFox), OpenTaiko (0auBSQ) v0.6.0
Not in the official games.
By analogy with Taiko mode.
F Ad libitum note (AD-LIB) (invisible by default) (none) Hit either bongo drum or clap within the OK timing window, consumes an input.
Awards an AD-LIB judgment but keep combo unchanged.		 Not hit within the OK timing window (consumes no inputs).
Gives no penalties.		 First seen in: OpenTaiko-OutFox standard 1.2, OpenTaiko (0auBSQ)
Not in the official games.
By analogy with Taiko mode.

†: No score bonuses if the PC-generation scoring rule is followed.
‡: A BAD judgment in Konga games corresponds to a hit 不Fu 可ka BAD judgment in Taiko games, while a MISS judgment in Konga games corresponds to a unhit 不Fu 可ka BAD judgment in Taiko games.

Note type category

The note handling details of the Taiko mode apply. See the explanation in Note Symbols in Taiko Mode.

Proposal (Komi): Note Symbols in Beatz Mode

OpenTaiko-OutFox standard version: 2.0

The Beatz mode is based on Squid Beatz 2, a mini game in Splatoon 2, developed by Nintendo.

Squid Beatz 2 is the sequel of Squid Beatz (a mini game in Splatoon, developed by Nintendo). However, Squid Beatz only has 2 note type: left and right notes (similar to Konga mode), while Squid Beatz 2 has more note types but based on instead bottom and top notes (similar to Taiko mode).

Input type Buttons
Top-left Any left shoulder button
Top-right Any right shoulder button
Bottom-left Any D-pad button
Bottom-right Any face (X/Y/B/A) button
  Note Type Note Appearance Explanations on Clear Explanations on Fail Notes
0 (blank) (none) Nothing needs to be done. Consume no input. (impossible to fail)  
1 Bottom single note Red circle on the bottom lane Press a bottom button within the GOOD‡ timing window, consumes a bottom input.
Awards FRESH or GOOD‡ judgment according to the timing.		 Press a top button within the GOOD‡ judgment window (consumes a top input), press too off but within the MISS judgment window (?) (consumes an input), or not press within the MISS judgment window (consumes no inputs).
Gives a MISS judgment & combo break.		  
2 Top single note Green or blue circle on the top lane Press a top button within the GOOD‡ timing window, consumes a top input.
Awards the same as 1.		 Press a bottom button within the GOOD‡ judgment window (consumes a bottom input), press too off but within the MISS judgment window (consumes an input), or not press within the MISS judgment window (consumes no inputs).
Gives the same penalty as 1.		  
3 Bottom double note Red square on the bottom lane Press bottom-left or bottom-right within the GOOD‡ timing window & the other bottom-left or bottom-right within a certain time duration (consumes a bottom-left and a bottom-right input in total)
Awards the same as 1 according to the timing of the first input.		 Press top within the GOOD‡ judgment window (consumes a top input), press too off but within the MISS judgment window (consumes the first input), not press within the MISS judgment window (consumes no inputs), the second input is not given in a certain time duration after the first input (consumes only the first input), or the second input is top or repeated-side bottom (consumes 2 inputs in total).
Gives the same penalty as 1.		  
A (same as 3) (see 3) (see 3) (see 3) By analogy with GAME:Taiko.
4 Top double note Green or blue square on the top lane Press top-left or top-right within the GOOD‡ timing window & the other top-left or top-right within a certain time duration (consumes a top-left and a top-right input in total).
Awards the same as 1 according to the timing of the first input.		 Press bottom within the GOOD‡ judgment window (consumes a botton input), press too off but within MISS judgment window (consumes the first input), not press within the MISS judgment window (consumes no inputs), the second input is not given in a certain time duration after the first input (consumes only the first input), or the second input is bottom or repeated-side top (consumes 2 inputs in total).
Gives the same penalty as 1.		  
B (same as 4) (see 4) (see 4) (see 4) By analogy with GAME:Taiko.
E Top-single bottom-single note Green or blue circle on the top lane and red circle on the bottom lane, joined by grey background Press bottom or top within the GOOD‡ timing window & the other bottom or top within a certain time duration (consumes a bottom and a top input in total).
Awards the same as 1 according to the timing of the first input.		 Press too off but within MISS judgment window (consumes the first input), not press within the MISS judgment window (consumes no inputs), the second input is not given in a certain time duration after the first input (consumes only the first input), or the second input is repeated bottom or top (consumes 2 bottom or 2 top inputs in total).
Gives the same penalty as 1.		  
? Top-single bottom-double note Green or blue circle on the top lane and red square on the bottom lane, joined by grey background Press bottom-left/right or top within the GOOD‡ timing window & all the other bottom-left/right or top, all within a certain time duration (consumes a bottom-left, a bottom-right, and a top input in total).
Awards the same as 1 according to the timing of the first input.		 Press too off but within MISS judgment window (consumes the first input), not press within the MISS judgment window (consumes no inputs), the nth input is not given in a certain time duration after the first input (consumes up to the n−1-st input), or the nth input is repeated-side bottom or repeated top (consumes up to the nth input).
Gives the same penalty as 1.		 No note symbols have been assigned.
? Top-double bottom-single note Green or blue square on the top lane and red circle on the bottom lane, joined by grey background Press bottom or top-left/right within the GOOD‡ timing window & all the other bottom or top-left/right, all within a certain time duration (consumes a bottom, a top-left, and a top-right input in total).
Awards the same as 1 according to the timing of the first input.		 Press too off but within MISS judgment window (consumes the first input), not press within the MISS judgment window (consumes no inputs), the nth input is not given in a certain time duration after the first input (consumes up to the n−1-st input), or the nth input is repeated bottom or repeated-side top (consumes up to the nth input).
Gives the same penalty as 1.		 No note symbols have been assigned.
G Top-double bottom-double note Green or blue square on the top lane and red square on the bottom lane, joined by grey background Press bottom-left/right or top-left/right within the GOOD‡ timing window & all other bottom-left/right or top-left/right, all within a certain time duration (consumes a bottom-left, a bottom-right, a top-left, and a top-right input in total).
Awards the same as 1 according to the timing of the first input.		 Press too off but within MISS judgment window (consumes the first input), not press within the MISS judgment window (consumes no inputs), the nth input is not given in a certain time duration after the first input (consumes up to the n−1-st input), or the nth input is repeated-side buttom or repeated-side top (consumes up to the nth input).
Gives the same penalty as 1.		  
C Bomb/mine (Small dark-blue cherry bomb with ignited fuze 💣) All presses are too off or not press (both consumes no inputs).
Awards a “bomb/mine-pass” judgment.		 Press any button within the GOOD‡ (?) timing window, consumes an input.
Gives a BOOM (“bomb/mine-miss”) judgment & a combo-break and decreases healty gauge.		 Not in the official games.
By analogy with Taiko mode.
F Ad libitum note (AD-LIB) (invisible by default) Press any button within the GOOD‡ timing window, consumes an input.
Awards an AD-LIB judgment.		 Not press within the GOOD‡ timing window (consumes no inputs).
Gives no penalties.		 Not in the official games.
By analogy with Taiko mode.
5 Head of bottom bar drumroll
Examples: 5008, 5558, 5001		 Red circle with bar attached behind on the bottom lane Similar to 6 but only consumes (?) and reacts to bottom inputs.
Awards the same as 6.		 (impossible to fail) By analogy with GAME:Konga.
I Head of top bar drumroll
Examples: I008, III8, I001		 Green or blue circle with bar attached behind on the top lane Similar to 6 but only consumes (?) and reacts to top inputs.
Awards the same as 6.		 (impossible to fail) By analogy with GAME:Konga.
6 Head of both bar drumroll
Examples: 6008, 6668, 6001		 Red circle on the bottom lane and green circle on the top lane, each with bar attached behind on the respective lane, joined by grey background Rapidly press any buttons during its duration, consumes each press with unlimited speed, reacts to each press up to 1 press per 60fps frame. (impossible to fail) By analogy with GAME:Konga.
H (same as 6)
Examples: H008, HHH8, H001		 (see 6) (see 6) (see 6) By analogy with GAME:Konga.
7 Head of regular 激Geki 連ren 打da/ゲGe キki 連ren 打da “fierce drumroll” burst note / 風Fuu 船sen/ふ Fu うu せse んn balloon
Examples: 7008, 7778, 7001		 Small orange circle (slightly brighter than 1) with orange-ish red balloon attached behind Rapidly press bottom buttons with exactly certain amount of reacted presses during its duration, consumes each bottom or top press with unlimited speed, reacts to each bottom press up to 1 press per 60fps frame. Fail to input enough amount of reacted presses.
Does not give penalties except that notes (except bombs/mines (?)) placed within the duration of the balloon are impossible to press while the balloon is not cleared.		 By analogy with Taiko mode.
9 Head of special burst note/balloon
Examples: 9008, 9998, 9001		 (Vary) (Vary)
Rapldly press bottom buttons with exactly certain amount (summed and shared among players) of reacted presses during its duration, consumes each bottom or top press with unlimited speed, reacts to each bottom press up to 1 press per 60fps frame.		 (same as 7) Might become 7 when not all players encounter 9 with the note head, the full bonus time point, & the note end respectively at the same time position for each player.
Not in the official games.
By analogy with Taiko mode.
D Fuze/fuse drumroll
Examples: D008, DDD8, D001		 (Big circular clock with blue-ish purple edge and with bar attached behind in OpenTaiko (0auBSQ)) Similar to 7 but awards a “bomb/mine-pass” judgment. Similar to 7 but gives a BOOM (“bomb/mine-miss”) judgment & a combo-break and decreases healthy gauge. Not in the official games.
By analogy with Taiko mode.
8 Explicit end of a drumroll-type note (if any), otherwise (blank) (round end of a bar) (end of a bar drumroll)
(none) (otherwise)		 Nothing needs to be done. Consumes no input. (impossible to fail) Stop repeately pressing buttons non-after the point (end of drumrolls)

‡: The GOOD judgment in Beatz games corresponds to the 可ka OK judgment in Taiko games.

The note handling details of the Taiko mode apply. See the explanation in Note Symbols in Taiko Mode.

Terminologies

Word Usage of this Article

General Word

& is used only for conjoining independent nouns with similar grammar structure and and is used otherwise.

The ITALIC BOLD ALL-UPPER-CASE keywords MUST, MUST NOT, SHOULD, SHOULD NOT, & MAY are to be interpreted as described in RFC 2119: https://www.rfc-editor.org/rfc/rfc2119

The time relation is denoted as follow:

Word Before Non-after At Non-before After
Time relation < ≤ = ≥ >

The fraction (for beat duration, etc.) is denoted as follow:

Word whole half 1/3rd quarter
1/4th		 1/8th 1/16th …
Fraction 1/1 1/2 1/3 1/4 1/8 1/16 …
Other
spellings		 whole half third quarter
fourth		 eighth sixteenth …

Unspecified

If a usage causes unspecified behavior or the behavior itself is unspecified, the actual or intended behavior may vary from simulator to simulator and/or dependent on user settings. When portability is concerned, such a usage and the behavior SHOULD be avoid and the actual behavior SHOULD NOT be depended upon.

Because this article is still in construction and the TJA format is still evolving, this is possible that some usages or behaviors are stated as unspecified but the actual or intended behaviors are/have become consistent among most simulators.

Scope Fineness

Includes header scope fineness and command scope fineness.

The scope fineness is how often the header or command value changes can be handled by the simulator. The coarsest possible fineness is per–file. The finest possible fineness is sequential.

The scope fineness listed in this article is the coarsest of usually supported fineness.

For simulator developers: A simulator MAY implement a finer scope fineness but SHOULD NOT implement a coarser scope fineness.

For chart creators: If compatibility is concerned, the chart SHOULD NOT relies on a finer scope fineness than the scope fineness listed in this article.

Level of Impact

note ★★★★★
timing ★★★★・
scoring ★★★・・
gimmicky ★★・・・
metadata ★・・・・
decorative ・・・・・

The maximum level of impact of the headers and commands are listed in the description of their scope.

The use of notechart symbols has the impact level of “note”.

Only those whose impact level ≥ note may affect the required types of the gameplay input.

Only those whose impact level ≥ timing may affect the required timing of the gameplay input.

Only those whose impact level ≥ scoring may affect the clear or fail conditions and scoring.

A gimmicky header or command may affect the difficulty for reading the notechart during gameplay, while a metadata or decorative header or command usually does not.

A metadata header or command may affect the sorting order and searching results of songs, while a decorative header or command usually does not.

Whitespace character

Translations

Japanese terminologies of the game: https://wikiwiki.jp/taiko-fumen/用語集

Japanese terminologies are provided with their pronunciation annotated using a 訓Kun 令rei 式Shiki ローRoo マma 字ji-like romanization system. If a Japanese terminology can be written in 漢kan 字ji “Chinese Character” form, both are listed.

Some of the 漢kan 字ji “Chinese Character” form of the Japanese terminologies are literally taken as the Chinese translation.

For some terminologies of the game, there exist multiple English translations. Their are expressed as "LIT"/TDM/TKT/PC (ALTs) when necessary in this article:

Fields with unknown (not existing or simply not investigated by the maintainer of this article) translation are denoted with ?.

Translations which are simply romanization transliterations are omitted.

Some corresponding terminologies from other rhythm games are taken as one of the translations instead: See individual entries of https://github.com/stepmania/stepmania/wiki

Mentioned PC-Compatible Simulators with TJA Format Support

Reference: 太鼓シミュレーター一覧 (“List of Taiko Simulators”). (2022, July 26). 太鼓の達人 Wiki (“Taiko no Tatsujin Wiki”). https://wikiwiki.jp/taiko/太鼓シミュレーター一覧

Unless stated otherwise, a simulator mentioned in this article also refers to its derivations.

The honorific title is omitted.

Proposers

The honorific title is omitted.

Listed in alphabetic dictionary order.

Screen name used for proposal Other screen names Notes
barrier barrier15300 Main maintainer of TaikoManyGimmicks
IID Iweidieng Iep Main maintainer of this article
Komi 0auBSQ, 申mou しshi コko ミmi Main maintainer of OpenTaiko (0auBSQ)

References

TODO

This site is open source. Improve this page.