Skip to content

Partial reloads 19: Add the Jitte family sources and its reload clips - #191

Closed
sunzenshen wants to merge 1 commit into
stack/reload-zr68c/130-srmfrom
stack/reload-zr68c/140-jitte
Closed

sunzenshen wants to merge 1 commit into
stack/reload-zr68c/130-srmfrom
stack/reload-zr68c/140-jitte

Conversation

@sunzenshen

@sunzenshen sunzenshen commented Nov 9, 2026 •

Copy link
Copy Markdown
Contributor

Description

Partial reloads 19: add the Jitte family sources and its reload clips. The Jitte authors the clips; the Jitte-S
(scoped) compiles them. Used by NeotokyoRebuild/neo#2305 (neo layer 19), which gives both Jitte scripts the reload
phases.

It is layer 19 of a stack and builds on #190 (18, SRM family), #189 (17, MPN45 family), #188 (16, PZ252), #187 (15,
SRS), #186 (14, AA13), #185 (13, MilSO), #184 (12, Kyla), #183 (11, Tachi), #182 (10), #181 (09), #180 (08), #178
(07), #179 (06), #177 (05), #196 (04), #195 (03), #194 (02) and #176 (01). Next: #192 (20, M41 family). The neo flag sv_neo_reload_experimental is 1 by
default while the stack is reviewed.


Overview of Changes

  • Jitte sources: scenes jinrai_jitte and jinrai_jittes (one scene per gun, both teams' arms) and the
    projects jinrai_jitte/, nsf_jitte/, jinrai_jittes/, nsf_jittes/, with jitte/viewmodel.qci and
    jittes/viewmodel.qci shared by each gun's team .qc files (the ZR68C layout), preview images jitte/textures/,
    jitte and jittes sections in rom_spec.json.
  • Steps and slots (Jitte scene): reload step markers at 1_unload f40 (the magazine in the hand, off screen),
    2_load f66 (the magazine seat) and 3_cycle f88 (the handle home). Authored slots: drawunloaded (f0-50),
    drawtocycle (f0-41, with its own drawtocycle:3_cycle.sound marker at f41 for the cycle sound on the join),
    skipcycle (f0-19).
  • Glued clips (composites.txt, glued.qci): drawunloaded_reload (joins reload after f40),
    drawtocycle_reload (after f72), reload_skipcycle and drawunloaded_reload_skipcycle (leave reload at f66;
    the Jitte has no magazine tap).
  • Jitte-S, a family variant (the pattern of Partial reloads 09: Add the ZR68-S as a ZR68C family variant #181 and layers 17-18): its team .qc files include
    ../jinrai_jitte/glued.qci; its scene keeps the shipped slots and the reload step markers; the export fills its
    phases file from the Jitte's clips.
  • Variant toggle: the Jitte scene shows the Jitte-S gun on the Jitte rig and action (jitte_gun, jittes_gun).
  • Phases files and sound pieces: weapon_jitte_reload_phases.txt, weapon_jittes_reload_phases.txt; three
    pieces cut from the shipped jitte_reload.wav (jitte_reload_unload, _load, _cycle).
  • Compiled models: v_jinrai_jitte, v_nsf_jitte, v_jinrai_jittes, v_nsf_jittes (the Jitte had no models in
    neoAssets before).
  • README: the Jitte family in the layout, "Gun families" and "Reload resume animations".

How to Review

  • Text: composites.txt, glued.qci, jitte/viewmodel.qci, jittes/viewmodel.qci, the team .qc files and the
    two phases files.
  • viewmodels.blend gains the two Jitte scenes; the other scenes are unchanged. The SMDs are the shipped clips
    (written unchanged by the export) or export output; the checks below cover the binary files.
  • No tool changes.

Checks (measured)

check result
export of all fifteen projects rc 0; ROM CHECK 15 projects, no clamped pose; FAMILY jinrai_jittes compiles the glued clips of jinrai_jitte; no shipped SMD changed; no other gun's SMD or phases file changed; second export: post-export preview unchanged
joins SEAM 0.0000 u, 0.000 deg on all 41 seams
pace PACE jinrai_jitte 3 authored slots, 0 warnings; every other gun unchanged
sounds end before the clip 12 Jitte READY lines (6 per gun)
sources every Jitte source, phases file, wav and model file equals the research branch (#175) byte for byte
compile, 30 projects rc 0, 0 warnings; the other guns' .vvd / .vtx byte-identical to the committed files (the Tachi .vvd excepted, the toolchain difference noted in #176), .mdl differ only in runtime pointer-slot bytes; the Jitte .vvd / .vtx byte-identical to a fresh compile, the .mdl differ only in those pointer-slot bytes
Viewmodel panel (Blender under Xvfb) the Jitte scene: Team toggle Jinrai -> NSF -> Jinrai; Variant jitte -> jittes -> jitte; Export gun rc 0, no file changed
in game with the layer 19 neo PR see the neo PR: both Jittes tactical 30+1, dry 30 then 29+1, resumes after the unload and the load, flag 0 = master, headless TDM PASS

How to Test

  1. Load a build with the layer 19 neo PR (the flag is 1 by default).
  2. Take the Jitte (Recon), fire some rounds and reload: no handle pull, 30+1. Fire it empty and reload: 30, then
    29+1 at the handle.
  3. Reload and switch to the secondary after the old magazine is out (about 1.4-1.6 s in), then back: the draw
    continues the reload, with no pop at the joins.
  4. Repeat with the Jitte-S. In Blender, open the Jitte scene and pick jittes in the Viewmodel panel's Variant
    dropdown.

Related

The Jitte and Jitte-S (scoped) move into the layout as scenes
jinrai_jitte and jinrai_jittes, as on the full-house branch: one scene
per gun with both teams' arms, jitte/viewmodel.qci and
jittes/viewmodel.qci shared by each gun's team .qc files.

The Jitte authors the family's transitions. The reload has three
steps: 1_unload when the magazine is in the hand, off screen (f40),
2_load at the magazine seat (f66) and 3_cycle when the handle is home
(f88). Three authored slots: drawunloaded (f0-50), drawtocycle (f0-41)
and skipcycle (f0-19). They make four glued clips:
drawunloaded_reload (joins reload after f40), drawtocycle_reload
(after f72), reload_skipcycle and drawunloaded_reload_skipcycle (leave
reload at f66; the Jitte has no magazine tap). drawtocycle carries its
own cycle sound marker (f41) for the sound on its join. The steps play
three sound pieces cut from the shipped reload sound.

The Jitte-S is a family variant: its team qcs include
../jinrai_jitte/glued.qci, its scene keeps only the shipped slots, and
the export fills its phases file from the Jitte's clips. The Variant
toggle of the Jitte scene shows the Jitte-S gun.

The four models are compiled from these sources (the Jitte had no
models in neoAssets before).
@sunzenshen
sunzenshen force-pushed the stack/reload-zr68c/130-srm branch from 103e73c to d7b384e Compare November 10, 2026 02:09
@sunzenshen
sunzenshen force-pushed the stack/reload-zr68c/140-jitte branch from c02626d to 7e3c73a Compare November 10, 2026 02:09
@sunzenshen sunzenshen changed the title Partial reloads 16: Add the Jitte family sources and its reload clips Partial reloads 19: Add the Jitte family sources and its reload clips Nov 10, 2026
@sunzenshen

Copy link
Copy Markdown
Contributor Author

Closing to clear the board in favor of the PR stack of sunzenshen#25

@sunzenshen sunzenshen closed this Nov 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant