Touch & TouchHold
Class: TouchDrop.cs, TouchHoldDrop.cs
Method:
Judge(float currentSec)(TouchDrop inherits from NoteDrop.cs; TouchHoldDrop overrides it)HoldEndJudge(float currentSec)(TouchHoldDrop, inherited from NoteLongDrop.cs)
This page covers both Touch and TouchHold.
INFO
- The judgeable window of both Touch and TouchHold is
[-9f, 18f](JudgableRange = [JudgeTimingWithOffset - 9f, JudgeTimingWithOffset + 18f]) - Both can be judged by buttons: with
ButtonRingForTouchenabled on desktop, clicking the matching button is equivalent to touching - TouchHold's head-judgment window is identical to Touch's; the Fast side only has Perfect
Touch Judgment
TouchDrop overrides Judge with the dedicated TOUCH_JUDGE_* windows (same as the TouchHold head judgment). The Fast side only keeps Perfect (Fast inputs past 9f are ignored outright), and the Late side does not use the 1st variants of Perfect/Great:
| Grade | Fast side | Late side | Width |
|---|---|---|---|
| Perfect | [-9f, 9f] | - | 18f |
| Perfect 2nd | - | (9f, 10.5f] | 1.5f |
| Perfect 3rd | - | (10.5f, 12f] | 1.5f |
| Great | - | (12f, 13f] | 1f |
| Great 2nd | - | (13f, 14f] | 1f |
| Great 3rd | - | (14f, 15f] | 1f |
| Good | - | (15f, 18f] | 3f |
| Miss | - | (18f, inf) | - |
Miss
If still unjudged past 18f (TOUCH_JUDGE_GOOD_AREA_MSEC), TooLateCheck forces a Miss.
TouchHold Judgment
Head Judgment
The TouchHold head judgment is identical to Touch's, using the same TOUCH_JUDGE_* windows; see the Touch Judgment table above.
Press Judgment
Identical to the Hold press judgment (HoldEndJudge), with these differences:
- Press judgment ignores the first
15fand the last12f(TOUCH_HOLD_HEAD_IGNORE_LENGTH_SEC/TOUCH_HOLD_TAIL_IGNORE_LENGTH_SEC) - Releasing has a
2ftolerance - The correction rules for the completion ratio
pare the same as Hold's; see the Hold press-judgment details - TouchHold does not perform the end judgment in Classic mode (
HoldClassicEndJudgedoes not apply)
Touch Groups
Multiple Touch/TouchHold notes on adjacent sensor areas at the same time are grouped together: NoteLoader.cs clusters them by sensor adjacency using the TOUCH_GROUPS table:
- Each group (
TouchGroup) tracks the judged-member ratioPercentand the first non-Miss/TooFast resultJudgeResult - When a member is judged successfully it calls
RegisterResultto register the result with the group - In
TooLateCheck, an unjudged member inherits the group'sJudgeResultandJudgeDiffifPercent > 0.5fand the group already has a result - TouchHold press checks additionally have
TouchHoldGroup: group members share press state, and a member counts as held when more than half of the members are held (Percent > 0.5f)
INFO
A typical scenario for group judgment: two TapTouches in the C area (C1/C2 given together) and multi-point touches across areas — once more than half of the members are judged, the remaining members automatically follow the group result.
Special Behavior
Mine
A Mine does not need to be hit — leaving it alone is the correct action. When a Touch or TouchHold is flagged as Mine:
Touch:
- Safe pass:
MineCheck()auto-judgesPerfectwhenGetTimeSpanToJudgeTiming() > 0(note: the threshold is> 0, not> 3flike Tap/Hold) - Accidental hit:
Check()judges normally then corrects:JudgeResult >= Perfect(Fast side) →TooFast,JudgeResult < Perfect(Late side) →Miss, followed by an immediateEnd() - The judgeable window is not narrowed (same as a normal Touch)
- Autoplay disabled
TouchHold:
- Safe pass:
MineHeadCheck()auto-judgesPerfectwhenGetTimeSpanToJudgeTiming() > 0, plays the hold effect and marks the press state - Accidental hit:
HeadCheck()judges normally then corrects the same way as Touch, followed byisMineForceEnd = trueand an immediateEnd() - Press check: after the safe pass,
MineBodyCheck()checks every frame whether the sensor isOn— if a press is detected, it forcesMissandEnd() BodyCheck()returns immediately whenIsMineis true; normal press judgment is not performedEnd()skipsHoldEndJudgewhenIsMineis true- The judgeable window is not narrowed
- Autoplay not disabled (unlike Tap/Hold/Touch, TouchHold's
Autoplay()does not checkIsMine)
Judge Style Conversion
The final result goes through the same ConvertJudgeGrade conversion as Tap. See the Tap page.