How To

Beat Wrangler is a charting tool for the game Beat Banger. It lets you edit existing mods, or make new ones. To get a feel for how a chart's put together, try loading one of the built-in levels. Click Browse or Choose File in the Load form above, navigate to your Beat Banger folder, and select the chart.cfg of one of the levels in the data/ folder. Then, select the Ogg file in the songs/ folder using the other browse button, and click Load. Now, a description of each tab:

Audio

Here, you can fill in some basic details of your chart. You can use the Tap button to determine the tempo of your song, but you can also type it in if you already know it.
The note offset ensures the notes are synchronised to the song's beats. Increase it to make all notes come earlier, decrease it to delay them. Usually, this is set to somewhere around 0.03 seconds.
After filling both in, click Start mapping to create empty notes in the Beats screen. If you want to change the tempo, just go back to this screen and click Change tempo. Don't worry, you won't lose what you've already mapped.

If the music is drowning out the sound effects or vice versa, you can boost or lower their volume using the gain inputs.

Beats

This is where the magic mapping happens. Each box represents half a beat in the song. While the song's playing, the current beat will be bordered in red. Use Z to start half notes, X to start quarter notes, or C to start eighth notes. Notes will repeat until you change note types or end them with V. Half notes go on 𝅗𝅥 , quarter notes go on 𝅗𝅥  and 𝅘𝅥 , and eighth notes can go on every beat. Click the number of a beat to seek to it. Check the Event box to add a beat to the visuals tab.

I recommend resizing your browser window so that eight blocks (four beats) fit on one row. This makes it so that one line represents one measure.

You can use these keyboard shortcuts when mapping:

If the beat can't be placed at the current cursor position, it will use the next possible spot. For example, if you are on beat 4½ and put a half note, it will be placed on beat 6 instead.

To be consistent with how beats are counted in a $\genfrac{}{}{0ex}{}{4}{4}$ time signature, beat counts are halved compared to how they are stored internally. For example, beat 50½ is stored as #101 in the file.

Visuals

You can fill in the file names of the animations and sound effects here. All the animations are 3×2 sprite sheets, except the final animation's Effect, which is 6×4. Make them using the Sprite sheet maker at the top right of the screen.

The backgrounds can be tiled, or exactly sized 600×800.

File Structure

After you're done, your mod's directory should look something like this:

mods/your_mod_name/
├── chart.cfg (Finish, Download)
├── thumb.png
├── meta.cfg
├── anims
│   ├── loopN.png (Visuals, Animation)
│   └── fx
│       ├── rip.png (Visuals, Effect)
│       └── cumfx.png (Visuals, Effect)
├── sfx
│   ├── game_over.ogg (Audio, Game Over Sound)
│   ├── break.ogg (Visuals, Transition Sound)
│   ├── climax.ogg (Visuals, Climax Sound)
│   └── slap.ogg (Visuals, Sound Effect)
├── voice
│   └── bank_name (Visuals, Voice Bank)
│       └── sfx (N).ogg
├── songs
│   └── your_song.ogg (Audio, Song)
└── textures
    └── patternN.png (Visuals, Background)

Questions, Complaints

If you have any questions or are experiencing issues when using the tool, feel free to leave a message in the guestbook.