Skip to content

Partial reloads 08: Add the ZR68C reload that keeps a chambered round - #180

Closed
sunzenshen wants to merge 1 commit into
stack/reload-zr68c/40-attachfrom
stack/reload-zr68c/50-cycle
Closed

sunzenshen wants to merge 1 commit into
stack/reload-zr68c/40-attachfrom
stack/reload-zr68c/50-cycle

Conversation

@sunzenshen

@sunzenshen sunzenshen commented Nov 9, 2026 •

Copy link
Copy Markdown
Contributor

Description

Adds the animations needed to preserve the chambered round when the reload was with a partial magazine.

Demos:

Reloading with a round still chambered:

sc-1-tactical.mp4

Interrupting a reload after the magazine detach:

sc-4-tac-unload.mp4

(There is no additional animation for resuming after mag attachment, because that is just the weapon draw animation.)


Partial reloads 08. This PR adds the ZR68C reload that keeps a chambered round, used by NeotokyoRebuild/neo#2294: a
reload with a round in the chamber leaves reload after the magazine tap and returns to idle, with no bolt pull.

It is layer 08 of a stack and builds on #178 (07: the resume after the load), #179 (06), #177 (05), #196 (04), #195 (03), #194 (02) and #176 (01).
Next: 09 (the ZR68-S, #181). The neo flag sv_neo_reload_experimental is 1 by default while the stack is reviewed.


Overview of Changes

  • New slot: skipcycle in the jinrai_zr68c scene, 10 frames (f0-9): from the reload pose at f56 (after the
    tap) back to idle01 f0, magazine seated, handle home. The one scene serves both teams.

  • Markers in the jinrai_zr68c scene: reload:2_load.exit f56, where a reload with a round chambered leaves reload;
    reload:1_unload.sound f1, the first hit of the new unload sound piece.

  • Sequences (new lines of jinrai_zr68c/composites.txt and glued.qci):

    sequence plays when parts length
    reload_skipcycle a reload with a round chambered reload f0-56, then skipcycle 66 frames, 2.167 s
    drawunloaded_reload_skipcycle drawn after 1_unload of reload_skipcycle drawunloaded, reload f31-56, skipcycle 68 frames, 2.233 s
  • Phases file: rows for both sequences. reload_skipcycle plays sound pieces, as a glued clip does: unload
    0.033 s, load 1.300 s, tap 1.733 s; its 1_unload row names the resume drawunloaded_reload_skipcycle (load
    1.367 s, tap 1.800 s, ammo 1.400 s). No other row changes.

  • Sound: zr68_reload_unload.wav, cut from the original reload sound (neo#2294 adds its weapon_zr68.reload_unload
    entry).

  • Compiled models: v_jinrai_zr68c, v_nsf_zr68c with the two new sequences.

  • README and README_ANIMATOR: the slot, the two markers, the two clips, a range that ends at a marker.

How to Review

  • The text carries the change: composites.txt and glued.qci (two lines each), the phases file, the README.
  • viewmodels.blend changes only in the skipcycle slot and the two markers; the other files are generated or
    binary and the checks below cover them.

Checks (measured)

check result
export jinrai_tachi jinrai_zr68c rc 0; no shipped SMD changed; 0 clamps; the post-export blend is unchanged on a second export
joins SEAM 0.0000 u, 0.000 deg on all five seams of the four glued clips
pace PACE jinrai_zr68c 3 authored slots, 0 warnings
sounds end before the clip 9 READY lines, e.g. reload_skipcycle 2.167 s >= weapon_zr68.reload_load_part2 end 1.800 s; the 03 and 04 lines unchanged
compile rc 0; no SMD, phases, wav or model differs from the layer before the merge
compiled ZR68C vs the original NEOTOKYO models 52 / 52 bones; 15 shipped sequences keep frames and fps; Jinrai 0.0185 u / 0.048 deg, NSF 0.0216 u / 0.047 deg (as in #177)
compiled ZR68C vs layer 07 every shared sequence 0.0000 u; only the two new sequences differ
in game, layer 08 assets in the neo build tactical reload: 20 to 1 (+0.705 s) to 31 (+1.335 s), idle at +2.175 s, unload, load and part2 pieces, no cycle; dry reload: 0 to 30 (+1.335 s, chamberempty 1), chambered at +2.28 s (29+1), idle at +2.715 s; flag 0: reload 20 to 30 at +2.22 s (master); HUD ends 30 lit with the glyph (tactical) and 29 lit + 1 dim (dry), 2 magazines
in game with the layer 08 neo PR tactical reload: reload_skipcycle, no bolt pull, 30+1, unload/load/tap sounds once; tactical after the unload: drawunloaded_reload_skipcycle, 30+1; the 03 and 04 resumes unchanged; headless TDM 12 bots PASS, 0 asserts

How to Test

  1. Load a build with the layer 08 neo PR (the flag is 1 by default).
  2. Take a ZR68C, fire a few rounds and reload: no bolt pull, the HUD ends at 30+1.
  3. Reload again with a round chambered and switch to the secondary after the old magazine is out (about 0.7-1.3 s
    in), then back: the draw loads the magazine, taps it, and returns to idle without a pop at the joins.
  4. Optional: viewmodels_post_export.blend, scene jinrai_zr68c, slots reload_skipcycle and
    drawunloaded_reload_skipcycle.

Related

A reload with a round chambered plays reload_skipcycle: reload up to
2_load.exit (f56, after the tap), then the new skipcycle slot back to
idle, with no bolt pull. drawunloaded_reload_skipcycle resumes it
after 1_unload. Both teams compile the Jinrai clips.

The phases file gains the rows of both clips. reload_skipcycle plays
sound pieces, as a glued clip does, so the unload step gets its own
piece, zr68_reload_unload.wav.
@sunzenshen
sunzenshen force-pushed the stack/reload-zr68c/40-attach branch from f013d1f to cf34668 Compare November 10, 2026 02:07
@sunzenshen
sunzenshen force-pushed the stack/reload-zr68c/50-cycle branch from 53981be to 43a4a8d Compare November 10, 2026 02:07
@sunzenshen sunzenshen changed the title Partial reloads 05: Add the ZR68C reload that keeps a chambered round Partial reloads 08: Add the ZR68C reload that keeps a chambered round Nov 10, 2026
@sunzenshen
sunzenshen marked this pull request as ready for review November 10, 2026 04:45
@sunzenshen
sunzenshen marked this pull request as draft November 13, 2026 03:50
@sunzenshen

Copy link
Copy Markdown
Contributor Author

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

@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