Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
e328d4a
Add ZR68S viewmodels with a partial reload (research)
sunzenshen Oct 16, 2026
3b56371
ZR68S: segmented reload sequences (research)
sunzenshen Oct 16, 2026
d866497
ZR68: per-phase reload sound pieces (research)
sunzenshen Oct 16, 2026
2433878
ZR68S: size the resume reaches by their path (research)
sunzenshen Oct 16, 2026
40c5842
ZR68S: draw-resume sequences after the drop (research)
sunzenshen Oct 16, 2026
18444e3
ZR68: start the drop sound piece at the first hand sound (research)
sunzenshen Oct 16, 2026
1ef27f1
ZR68C: segmented reload sequences (research)
sunzenshen Oct 16, 2026
9e2a6b1
ZR68L: segmented reload sequences and sound pieces (research)
sunzenshen Oct 16, 2026
b6b9cb3
MX, MX-S: segmented reload sequences and sound pieces (research)
sunzenshen Oct 16, 2026
f7d3f3b
M41, M41S, M41L: segmented reload sequences and sound pieces (research)
sunzenshen Oct 16, 2026
794a2c2
Jitte, Jitte scoped: segmented reload sequences and sound pieces (res…
sunzenshen Oct 16, 2026
8d0eda6
SRM, MPN: segmented reload sequences and sound pieces (research)
sunzenshen Oct 16, 2026
ccbe908
AA13, PZ: segmented reload sequences and sound pieces (research)
sunzenshen Oct 16, 2026
8a10b89
SRS: segmented reload sequences and sound pieces (research)
sunzenshen Oct 16, 2026
4dda8b8
Jitte, AA13, SRS: draw-resume with the arm parked out of view (research)
sunzenshen Oct 16, 2026
8f7daa8
Milso, Tachi: pistol reloads with the slide release (research)
sunzenshen Oct 16, 2026
542c4bb
Kyla: resume sequences and sound pieces (research)
sunzenshen Oct 16, 2026
720e674
Milso, Tachi: placeholder slide-release sound (research)
sunzenshen Oct 16, 2026
ff0c2fc
Supa7: standalone rack sequence (research)
sunzenshen Oct 16, 2026
9e3653e
MX, MX-S: reach the charging handle at its hold (research)
sunzenshen Oct 16, 2026
e799355
MX, MX-S: compiled models with the f62 bolt resume (research)
sunzenshen Oct 16, 2026
ffdd6f3
Tachi: reload from empty with the slide held back
sunzenshen Oct 16, 2026
f4d180d
Merge vm-empty-slide-assets into research-reload-phases
sunzenshen Oct 16, 2026
ae84ea2
ZR68C, Tachi: one-handed chamber shot and fire_blend (research)
sunzenshen Oct 17, 2026
031d430
Other guns: one-handed chamber shot and fire_blend (research)
sunzenshen Oct 17, 2026
3764476
Add Blender sources for reload phases
sunzenshen Oct 30, 2026
c9ad1e8
Update reload-phase animation sources
sunzenshen Oct 31, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
Binary file added neo/models/weapons/v_jinrai_aa13.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_aa13.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_aa13.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_aa13.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_aa13.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_jitte.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_jitte.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_jitte.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_jitte.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_jitte.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_jittes.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_jittes.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_jittes.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_jittes.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_jittes.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_klya9.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_klya9.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_klya9.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_klya9.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_klya9.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_milso.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_milso.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_milso.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_milso.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_milso.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mosok41.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mosok41.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mosok41.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mosok41.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mosok41.vvd
Binary file not shown.
Binary file modified neo/models/weapons/v_jinrai_mosok41l.dx80.vtx
Binary file not shown.
Binary file modified neo/models/weapons/v_jinrai_mosok41l.dx90.vtx
Binary file not shown.
Binary file modified neo/models/weapons/v_jinrai_mosok41l.mdl
Binary file not shown.
Binary file modified neo/models/weapons/v_jinrai_mosok41l.sw.vtx
Binary file not shown.
Binary file modified neo/models/weapons/v_jinrai_mosok41l.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mosok41s.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mosok41s.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mosok41s.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mosok41s.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mosok41s.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mpn.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mpn.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mpn.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mpn.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mpn.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mpn_s.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mpn_s.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mpn_s.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mpn_s.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mpn_s.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mx.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mx.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mx.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mx.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mx.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mxs.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mxs.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mxs.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mxs.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_mxs.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_pz.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_pz.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_pz.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_pz.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_pz.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_shotgun.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_shotgun.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_shotgun.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_shotgun.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_shotgun.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srm.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srm.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srm.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srm.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srm.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srm_s.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srm_s.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srm_s.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srm_s.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srm_s.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srs.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srs.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srs.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srs.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_srs.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_tachi.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_tachi.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_tachi.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_tachi.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_tachi.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68c.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68c.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68c.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68c.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68c.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68l.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68l.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68l.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68l.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68l.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68s.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68s.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68s.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68s.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_jinrai_zr68s.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_aa13.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_aa13.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_aa13.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_aa13.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_aa13.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_jitte.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_jitte.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_jitte.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_jitte.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_jitte.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_jittes.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_jittes.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_jittes.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_jittes.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_jittes.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_klya9.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_klya9.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_klya9.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_klya9.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_klya9.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_milso.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_milso.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_milso.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_milso.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_milso.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mosok41.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mosok41.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mosok41.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mosok41.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mosok41.vvd
Binary file not shown.
Binary file modified neo/models/weapons/v_nsf_mosok41l.dx80.vtx
Binary file not shown.
Binary file modified neo/models/weapons/v_nsf_mosok41l.dx90.vtx
Binary file not shown.
Binary file modified neo/models/weapons/v_nsf_mosok41l.mdl
Binary file not shown.
Binary file modified neo/models/weapons/v_nsf_mosok41l.sw.vtx
Binary file not shown.
Binary file modified neo/models/weapons/v_nsf_mosok41l.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mosok41s.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mosok41s.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mosok41s.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mosok41s.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mosok41s.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mpn.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mpn.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mpn.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mpn.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mpn.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mpn_s.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mpn_s.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mpn_s.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mpn_s.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mpn_s.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mx.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mx.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mx.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mx.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mx.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mxs.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mxs.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mxs.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mxs.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_mxs.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_pz.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_pz.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_pz.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_pz.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_pz.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_shotgun.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_shotgun.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_shotgun.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_shotgun.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_shotgun.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srm.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srm.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srm.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srm.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srm.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srm_s.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srm_s.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srm_s.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srm_s.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srm_s.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srs.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srs.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srs.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srs.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_srs.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_tachi.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_tachi.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_tachi.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_tachi.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_tachi.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68c.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68c.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68c.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68c.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68c.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68l.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68l.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68l.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68l.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68l.vvd
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68s.dx80.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68s.dx90.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68s.mdl
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68s.sw.vtx
Binary file not shown.
Binary file added neo/models/weapons/v_nsf_zr68s.vvd
Binary file not shown.
71 changes: 71 additions & 0 deletions neo/modelsrc/weapons/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
# Research reload-phase animation projects

The folders in this directory contain editable Blender projects for the reload
phase work on `research-reload-phases`. Each project is the source for its
folder's `anims/*.smd` exports. Keep the `.blend`, its reference SMD, the QC,
and the animation exports together.

There are 37 animation projects and 42 QCs. Most folders contain one model and
one project named after its QC. The MX, MX-S, and ZR68 folders share an
animation set across their team QCs, so each has one project named
`<folder>_reload_phases.blend`. Its reference mesh is for preview; the team
references have matching bone hierarchies. Those shared projects preview the
first QC's Jinrai reference; each QC still compiles its own team-specific
reference mesh, sequence metadata, activities, and events.

## Requirements and editing

- Blender 5.2 or newer; the projects were created with Blender 5.2.3.
- Blender Source Tools 3.4.3, enabled in Blender preferences.
- Source SDK Base 2013 Multiplayer's `bin/studiomdl.exe` for compilation.
- Python 3 for the compile helper; no extra packages are required.

Open the `.blend` in the relevant model folder and edit its animation slots.
The `anims/*.smd` files are generated exports, not the editing source.
`segments.csv` and each folder's README retain research timing and provenance;
they are not used to export or compile the saved Blender projects.

The preview mesh and camera are for animation inspection. Blender Source Tools
does not export the mesh in these projects: keep the existing reference SMD
unchanged. The preview uses imported material names without decoded texture
images.

## Export animations

From this directory, export every saved project with:

```sh
blender --background --python-exit-code 1 --python export_reload_phases.py
```

The helper exports every animation slot to its folder's `anims/` directory,
checks that all expected files were freshly written, and verifies that the
reference SMD was not changed. To export selected folder names only, append
them after `--`, for example `-- jinrai_tachi mx`.

The project exporter leaves QC files unchanged. Edit the matching QC as well
if a sequence's name, activity, playback rate, transition, or event changes.

## Compile models

Compile all 42 QCs into a separate directory:

```sh
python compile_reload_phases.py --compiler "C:/path/to/studiomdl.exe" --output "C:/path/to/output/models/weapons"
```

The helper compiles in a temporary game configuration and copies only the
resulting model files to `--output`; it does not edit a game's `gameinfo.txt`.
To update the compiled assets in neoAssets, use
`--output "../../models/weapons"` from this directory, then review the
binary diff before including it.

The local SDK rebuild was not byte-identical to the committed models.
Semantic checks found the same bones, sequences, frame counts, FPS, and vertex
positions across all 42 models; the largest decoded bone rotation difference
was 0.09 degrees. Keep the existing compiled assets unless a rebuild is
deliberate.

The compiled model folder is `neo/models/weapons/`. A game install is not
required to export or compile. Any animation or QC change still needs an
in-game check before it is treated as behavior-preserving.
76 changes: 76 additions & 0 deletions neo/modelsrc/weapons/compile_reload_phases.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
"""Compile all reload-phase QCs to a chosen output directory.

Run: python compile_reload_phases.py --compiler PATH --output PATH
Runtime depends on the number of QCs and Source SDK Base 2013 MP version.
"""
import argparse
from pathlib import Path, PurePosixPath
import re
import shutil
import subprocess
import tempfile


def model_output(qc, staging):
text = qc.read_text(encoding="utf-8")
match = re.search(r'^\$modelname\s+"([^"]+)"', text, re.MULTILINE)
if not match:
raise RuntimeError(f"No $modelname in {qc}")
model = staging / "models" / Path(*PurePosixPath(match.group(1)).parts)
return model.with_suffix("") if model.suffix.lower() == ".mdl" else model


def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument(
"--compiler", type=Path, required=True,
help="Source SDK Base 2013 Multiplayer/bin/studiomdl.exe",
)
parser.add_argument(
"--output", type=Path, required=True,
help="Directory to receive compiled model files",
)
args = parser.parse_args()
compiler = args.compiler.resolve()
output = args.output.resolve()
if not compiler.is_file():
parser.error("Compiler does not exist: " + str(compiler))
root = Path(__file__).resolve().parent
qcs = sorted(root.glob("*/*.qc"))
if not qcs:
raise RuntimeError(f"No QC files found under {root}")

with tempfile.TemporaryDirectory(prefix="neo-reload-phases-") as temporary:
staging = Path(temporary)
(staging / "gameinfo.txt").write_text(
'"GameInfo" { "game" "Reload phase compile" "FileSystem" { '
'"SteamAppId" "243750" "SearchPaths" { '
'"Game" "|gameinfo_path|." } } }\n',
encoding="ascii",
)
for qc in qcs:
subprocess.run(
[str(compiler), "-nop4", "-game", str(staging), str(qc)],
cwd=qc.parent,
check=True,
)
model = model_output(qc, staging)
for extension in (".mdl", ".vvd", ".dx90.vtx"):
if not Path(str(model) + extension).is_file():
raise RuntimeError(
f"Compiler did not create {model}{extension} for {qc}"
)

model_dir = staging / "models" / "weapons"
outputs = sorted(model_dir.glob("*"))
if not outputs:
raise RuntimeError("Compiler produced no models")
output.mkdir(parents=True, exist_ok=True)
for path in outputs:
shutil.copy2(path, output / path.name)
print("COMPILED", path.name, "->", output / path.name)
print(f"COMPILE_PASS {len(qcs)} QCs, {len(outputs)} output files")


if __name__ == "__main__":
main()
78 changes: 78 additions & 0 deletions neo/modelsrc/weapons/export_reload_phases.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
"""Export saved Blender reload-phase projects with Blender Source Tools.

Run: blender --background --python-exit-code 1 --python export_reload_phases.py
Requires Blender 5.2 or newer and Blender Source Tools 3.4.3.
"""
from pathlib import Path
import sys

import bpy


def export_project(project):
bpy.ops.wm.open_mainfile(filepath=str(project))
bpy.ops.preferences.addon_enable(module="io_scene_valvesource")
scene = bpy.context.scene
folder = project.parent
reference = folder / scene.get("reference_smd", "")
if not reference.is_file():
raise RuntimeError(f"Missing reference SMD for {project}: {reference}")
reference_bytes = reference.read_bytes()
armatures = [obj for obj in scene.objects if obj.type == "ARMATURE"]
if len(armatures) != 1:
raise RuntimeError(f"Expected one armature in {project}; found {len(armatures)}")
armature = armatures[0]
if armature.animation_data is None or armature.animation_data.action is None:
raise RuntimeError(f"No animation action in {project}")
expected = [
folder / "anims" / (slot.name_display + ".smd")
for slot in armature.animation_data.action.slots
]
previous = {
path: path.stat().st_mtime_ns if path.exists() else None
for path in expected
}

scene.vs.export_path = "//"
scene.vs.export_format = "SMD"
armature.data.vs.action_selection = "FILTERED"
armature.vs.action_filter = "*"
armature.vs.subdir = "anims"
armature.vs.export = True
for obj in scene.objects:
if obj.type == "MESH":
obj.vs.export = False
for collection in bpy.data.collections:
collection.vs.export = False

result = bpy.ops.export_scene.smd(export_scene=True)
if result != {"FINISHED"}:
raise RuntimeError(f"Source Tools export failed for {project}: {result}")
missing = [path for path in expected if not path.is_file()]
stale = [
path for path in expected
if path.is_file() and path.stat().st_mtime_ns == previous[path]
]
if missing or stale:
raise RuntimeError(
f"Incomplete export for {project}; missing={missing}, unchanged={stale}"
)
if reference.read_bytes() != reference_bytes:
raise RuntimeError(f"Reference mesh changed during export: {reference}")
print(f"EXPORTED {project.name}: {len(expected)} animations; reference retained", flush=True)


def main():
root = Path(__file__).resolve().parent
filters = set(sys.argv[sys.argv.index("--") + 1:]) if "--" in sys.argv else set()
projects = sorted(root.glob("*/*.blend"))
if filters:
projects = [path for path in projects if path.parent.name in filters]
if not projects:
raise RuntimeError("No matching Blender projects found")
for project in projects:
export_project(project)


if __name__ == "__main__":
main()
6 changes: 6 additions & 0 deletions neo/modelsrc/weapons/jinrai_aa13/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# v_jinrai_aa13 with segmented reloads - research branch

Decompiled from the shipped viewmodel and recompiled with the AA13 plan's partial, resume and
draw-resume reload sequences (`segments.csv`, rows `aa13.*`). Built with ntre's
`proposals/0057-reload-cue-timing/tools/` and studiomdl (MDL v48; animations over 120 frames are stored in
30-frame sections, as studiomdl does by default).
Loading