beckhoff-xts-viewer-3d-assets
v0.3.1
Published
GLB asset bundle for beckhoff-xts-viewer-3d — Beckhoff XTS modules, movers, and tool carriers as runtime-ready GLBs.
Maintainers
Readme
beckhoff-xts-viewer-3d-assets
GLB asset bundle for beckhoff-xts-viewer-3d.
This package only contains binary GLB files for every supported Beckhoff XTS module, mover, and tool carrier. Calibration metadata (origin-correction, path lengths, AABBs) is compiled into the viewer JS bundle — sidecar JSON files are intentionally not shipped here.
Why a separate package
The viewer logic is small (~100 kB compressed). The CAD-derived GLBs total ~27 MB. Splitting them lets:
npm install beckhoff-xts-viewer-3dstay tiny.- Consumers who self-host can install just the assets and serve them from their own static folder / CDN.
- The viewer's default
assetsBaseUrlpoints at the matching version on jsDelivr — zero configuration for typical apps.
Versioning
Versions are kept in lock-step with the viewer package by the release
pipeline. Use assets@<version> matching your viewer version (or @latest
if you don't care).
Usage
Default (recommended) — jsDelivr CDN
If you import beckhoff-xts-viewer-3d and don't pass
assetsBaseUrl, the viewer defaults to:
https://cdn.jsdelivr.net/npm/beckhoff-xts-viewer-3d-assets@<viewer-version>/modelsNothing to install. jsDelivr caches the GLBs at the edge.
Self-hosted
npm install beckhoff-xts-viewer-3d-assetsCopy the models/ directory into your app's static folder and pass it as
assetsBaseUrl:
<XtsViewer3D config={cfg} assetsBaseUrl="/models" />For Vite / Next.js / Remix, this typically means a small build-time copy
step (copyfiles, cp -r, or framework-native asset handling) from
node_modules/beckhoff-xts-viewer-3d-assets/models to
public/models.
Contents
GLBs for:
- Standard AT — AT2000 / AT2001 / AT2002 / AT2020 / AT2021 / AT2025 / AT2026 / AT2040 / AT2041 / AT2050 / AT2100 / AT2102 / AT2002 + ZX2002
- Eco AT — AT2200 / AT2202
- Hygienic ATH — ATH2000 / ATH2001 / ATH2002 / ATH2020 / ATH2040 / ATH2041 / ATH2042 / ATH2050 (plus -0002 alt-rail variants)
- Movers — AT9011 / AT9012 / AT9014 / ATH9011 / Hepco GFX
- Tool carriers — AT8200-1000-0100 / AT8200-2000-0100
- Hepco rails — Hepco-GFX2-1TC-S25
License
MIT for the wrapper. The underlying CAD geometry is derived from publicly distributed Beckhoff / Hepco product files and remains subject to their respective licensing terms.
