🌌 NebulaMapper — AI Beat Saber Map & Replay Models

Official model repository for NebulaMapper (PhantomVoidTTV/NebulaMapper), an enhanced AI Beat Saber map generator, lighting choreographer, and autonomous VR player bot.

📦 Included Models in PhantomVoidTTV/NebulaMapper

Model Component	Weights / Artifact	Config	Description
Map Model	map.safetensors	map.json	65M+ parameter Encoder-Decoder Transformer with audio overview & musical memory alignment
Rhythm Model	rhythm.safetensors	rhythm.json	47M+ parameter RoPE Transformer predicting exact onset hit ticks per beat
Lighting Model	lights.safetensors	lights.json	7M+ parameter Iterative Masked Diffusion / Transformer for 23 Beat Saber environments
Player Bot Model	player.safetensors	player.json	38M+ parameter Flow-Matching 6-DoF VR headset & dual-saber trajectory generator
Swing Labeler	labeler.safetensors	—	Bidirectional Transformer for forehand/backhand parity & reset detection
Timing BeatNet	timing.safetensors	octave.npz	Audio log-mel beat activation network + octave random forest classifier
Star Estimator	rating.npz	—	Gradient boosted decision forest estimating Star ★, Tech, and Pass ratings
Song Stars	song_stars.npz	—	Audio-to-difficulty star rating and target HPS/Tech/Pass estimator

✨ Custom Build Metadata

• Generation Mode: nebula_evolved
• Custom Mapper Personas: phantomvoid, nebulamapper, nebula_tech, nebula_speed, nebula_acc
• Checkpoint Blend Ratio: 0.08
• Last Updated: 2026-11-04 01:01:32 UTC

🚀 Quick Usage

# Generate a Beat Saber map automatically using PhantomVoidTTV/NebulaMapper
python scripts/generate.py --audio song.mp3 --stars 7.5 10.0 --mapper phantomvoid --replay

# Launch the NebulaMapper Web UI (automatically pulls & pushes models to PhantomVoidTTV/NebulaMapper)
python scripts/webui.py

# Generate / Fine-tune / Evolve models and auto-upload to PhantomVoidTTV/NebulaMapper
python scripts/generate_models.py --mode nebula_evolved --push