• Use .ogg audio for best compatibility — convert MP3/WAV with Audacity
• Songs with clear percussion (EDM, rock, pop) map better than ambient music
• Try different Style presets — "Tech" for ranked, "Dance" for flow, "Speed" for streams
• Adjust Pattern Complexity slider — higher = more doubles, windows, streams
• Click Re-roll (R key) to get different patterns with the same audio analysis
• Check the Map Warnings panel after generation for potential issues

• BeatForge uses 5 methods: energy autocorrelation, bass autocorrelation, onset histogram, beat-grid tracking, and spectral flux
• [HIGH] confidence means 4+ methods agree — very reliable
• [MED] means 2-3 agree — probably correct but verify in ArcViewer
• [LOW] means methods disagree — manually enter the BPM if you know it
• Variable BPM songs show tempo changes below the BPM display

• Set up your GitHub token in ArcViewer Settings for one-click preview
• Without a token, the zip downloads and you drag it into ArcViewer manually
• Preview files upload to previews/ in your repo — old ones auto-cleanup
• ArcViewer loads via ?url= parameter from your custom domain

BeatForge is an AI-powered Beat Saber auto-mapper built by PhantomVoidTTV. It uses Web Audio API spectral analysis, BSMG mapping theory (parity, swing curvature, emphasis matching, instrument detection), and a multi-method BPM engine to generate playable maps with proper lighting, walls, arcs, chains, and bombs. Maps export as Beat Saber v3.3.0 schema with Info.dat v2.1.0, compatible with Beat Saber 1.40+ and all environments from Default to Coldplay.

v2.2 • 145 functions • 5 BPM methods • 14 presets • 50+ environments • Chroma RGB • GitHub ArcViewer integration • BSMG downmapping