@hypersoniclabs/helix-cli 0.1.27-helix3.675 → 0.1.27-helix3.676
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -0
- package/dist/index.js +33 -0
- package/dist/index.js.map +1 -1
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/vehicle/carbonWeave.d.ts +42 -0
- package/dist/vehicle/carbonWeave.js +227 -0
- package/dist/vehicle/carbonWeave.js.map +1 -0
- package/package.json +1 -1
- package/plugins/beamng-vehicle/bin/__pycache__/beamng_abs.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/beamng_audio.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/beamng_engine.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/beamng_expression.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/beamng_jbeam.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/beamng_materials.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/beamng_stock_events.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/fmod_studio.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/fsb5.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/sim_audio.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/sim_audio_ac.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/sim_audio_beamng.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/sim_audio_fixtures.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/test_beamng_engine.cpython-312.pyc +0 -0
- package/plugins/beamng-vehicle/bin/__pycache__/test_sim_audio.cpython-312.pyc +0 -0
package/README.md
CHANGED
|
@@ -65,6 +65,7 @@ The token is stored in `~/.helix/credentials.json` (mode `600`). It's sent as
|
|
|
65
65
|
| `helix continuum make-item --package-id <id> --package-version <v> --manifest-cid <cid> --content-rating <rating> [--offer marketplace\|world --price-lix <n>]` | Project one exact sealed Package Version into an Item, with an optional first offer. |
|
|
66
66
|
| `helix continuum publish-owned-item <item-id> --package-id <id> --package-version <v> --manifest-cid <cid> --content-rating <rating> --accept-rating-attestation` | Publish an existing personal Item from its unchanged public sealed Package pin. Offers are separate. |
|
|
67
67
|
| `helix vehicle audio-import <mod dir\|mod .zip\|AC car dir\|.bank> --out <dir> [--sim beamng\|ac\|auto] [--vehicle <id>] [--config <file.pc>] [--map <slot-map.json>] [--beamng-root <dir>] [--cylinders N] [--base-package <vehicle-package.json>] [--json]` | Takes a car's sounds from the sim mod that carries them, never synthesised: a BeamNG mod's own ladders and every sound its parts name (stock FMOD events resolved in the install's banks with `--beamng-root`, which also supplies what the game itself plays for unnamed slots), or an Assetto Corsa car's FMOD bank. Writes `audio/*.wav` (16-bit PCM, malformed headers repaired) and `audio.json` (the package `audio` block, all 26 live slots (the retired tyre/brake squeal slots are never emitted), `provenance` on every slot, bank sample and blend). `--map` merges slots from several sources. The block always carries the runtime's mix fields (gains, load mix, muffling): from `--base-package` to keep a car's current mix, else the mod's soundConfig, else the engine's defaults. Exit `1` when a slot stays empty. See [docs/vehicle-audio-import.md](docs/vehicle-audio-import.md). |
|
|
68
|
+
| `helix vehicle carbon-weave <in.glb> <out.glb> [--tile-cm <cm>] [--roughness <r>] [--normal-scale <s>] [--carbon-materials <regex>\|none] [--ktx2]` | Give a vehicle GLB's carbon-fibre a tiling 2x2 twill detail normal + roughness map at a real ~1.2 cm tile (UV scale per material from 3D/UV area), clearcoat roughness, non-metal. Tags source names that are exposed carbon first (default `EXT_Carbon*`, `EXT_Plastic_shinny`, `EXT_painted_metal`; an unmapped `EXT_painted_metal` rips as silver sides). Exit `1` when nothing was woven. See [docs/vehicle-carbon-weave.md](docs/vehicle-carbon-weave.md). |
|
|
68
69
|
| `helix vehicle audio-check <dir\|package.json\|audio.json\|item-id> [--reference <clip>]... [--json]` | Proves every sound the runtime will select resolves, is PCM WAV and is audible (pre-publish on local files, or read-back on a published item), and that no two roles share one recording (shift up = shift down, an exhaust rung = an engine rung) and the rev limiter is a short crack the runtime can retrigger. Prints each slot's provenance and FAILS synthesised or generated audio (`AUDIO_SYNTHESISED`), a car without a recorded engine ladder (`AUDIO_ENGINE_UNSOURCED`), a missing or empty slot (`AUDIO_SLOT_UNSOURCED`, except `absent: "not-fitted"` / `"combined-with-engine"`) among the 26 live slots (the retired tyre squeal, scrub, wheelspin, skid and brake squeal slots only warn: `AUDIO_SLOT_RETIRED`), recordings without provenance (`AUDIO_PROVENANCE_MISSING`) and a not-fitted claim the physics contradicts (`AUDIO_SLOT_FITMENT_MISMATCH`) and an audio block without finite mix fields (`AUDIO_MIX_FIELDS_MISSING`: a NaN gain freezes the car in Try Now); `vehicle publish` refuses the same. `--reference <clip>` (repeatable; `slot=clip` for a slot) compares the idle voice's centroid and firing roughness with a real-car recording. |
|
|
69
70
|
| `helix vehicle addon check <dir> [--json]` | Add-on fit gate for local source and host compatibility, including the web customizer's meshless guard (`ADDON_CUSTOMIZER_REFUSES`: a part with no `model.glb` must be a verified tune-only/sound-only definition). |
|
|
70
71
|
| `helix vehicle addon check --item <addOnId>... / --host <vehicleId>... [--json]` | Published mode (public reads, no sign-in): reads each add-on Item's exact Package pin and runs exactly what the web customizer runs; `--host` checks every add-on on the car's rail. Exit `1` = the customizer would refuse a part, with its message. |
|
package/dist/index.js
CHANGED
|
@@ -962,6 +962,39 @@ vehicleCommand
|
|
|
962
962
|
process.exitCode = 2;
|
|
963
963
|
}
|
|
964
964
|
});
|
|
965
|
+
vehicleCommand
|
|
966
|
+
.command('carbon-weave')
|
|
967
|
+
.description('Give a vehicle GLB\'s carbon-fibre a real weave: a tiling 2x2 twill detail normal + roughness map at ~1.2 cm per tile (UV scale from 3D/UV area per material), clearcoat roughness, non-metal. '
|
|
968
|
+
+ 'Applies to materials with semantic family carbon-fiber, and first tags source names that are exposed carbon (default EXT_Carbon*, EXT_Plastic_shinny, EXT_painted_metal; a rip\'s unmapped EXT_painted_metal renders as silver). '
|
|
969
|
+
+ 'Fails if it weaves nothing. See docs/vehicle-carbon-weave.md')
|
|
970
|
+
.argument('<in.glb>', 'the vehicle model')
|
|
971
|
+
.argument('<out.glb>', 'where to write the woven model')
|
|
972
|
+
.option('--tile-cm <cm>', 'real-world size of one weave tile', '1.2')
|
|
973
|
+
.option('--roughness <r>', 'clearcoat roughness factor', '0.17')
|
|
974
|
+
.option('--normal-scale <s>', 'normal map scale', '0.45')
|
|
975
|
+
.option('--carbon-materials <regex>', 'source material names to tag as carbon-fiber; "none" tags nothing')
|
|
976
|
+
.option('--ktx2', 'encode the two weave textures as KTX2 (UASTC) instead of PNG')
|
|
977
|
+
.action(async (inGlb, outGlb, opts) => {
|
|
978
|
+
try {
|
|
979
|
+
const { weaveGlbFile } = await Promise.resolve().then(() => __importStar(require('./vehicle/carbonWeave')));
|
|
980
|
+
const report = await weaveGlbFile((0, node_path_1.resolve)(inGlb), (0, node_path_1.resolve)(outGlb), {
|
|
981
|
+
tileCm: Number(opts.tileCm),
|
|
982
|
+
roughness: Number(opts.roughness),
|
|
983
|
+
normalScale: Number(opts.normalScale),
|
|
984
|
+
carbonMaterials: opts.carbonMaterials === undefined ? undefined : opts.carbonMaterials === 'none' ? null : opts.carbonMaterials,
|
|
985
|
+
ktx2: opts.ktx2,
|
|
986
|
+
});
|
|
987
|
+
for (const w of report.weaved)
|
|
988
|
+
console.log(`${w.material}${w.tagged ? ' (tagged carbon-fiber)' : ''}: ${w.metresPerUv.toFixed(3)} m/uv, ${w.tilesPerUv.toFixed(1)} tiles/uv`);
|
|
989
|
+
for (const s of report.skipped)
|
|
990
|
+
console.log(`skipped ${s}`);
|
|
991
|
+
console.log(`✔ weave on ${report.weaved.length} material(s) -> ${(0, node_path_1.resolve)(outGlb)}`);
|
|
992
|
+
}
|
|
993
|
+
catch (error) {
|
|
994
|
+
process.stderr.write(`✖ ${error instanceof Error ? error.message : String(error)}\n`);
|
|
995
|
+
process.exitCode = 1;
|
|
996
|
+
}
|
|
997
|
+
});
|
|
965
998
|
vehicleCommand
|
|
966
999
|
.command('audio-check')
|
|
967
1000
|
.description('Prove every sound a vehicle declares will actually play: each engine-ladder rung and slot sample the runtime selects must resolve (a local WAV '
|