Garry's Mod

Garry's Mod

BattleBeats | Ambient and Combat music
 此主题已被置顶,因此可能具有重要性
ricky dicky doo dah grimes  [开发者] 5 月 1 日 上午 9:22
HOW TO CREATE PACKS
Creating a music pack for BattleBeats is very easy and requires no coding or special tools. You just need a proper folder structure and your music files. Here’s how to do it:

╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾

You can watch this YouTube tutorial if you’re a visual learner

╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾

1. Create the Folder Structure
First, create an addon folder with a name of your choice
Inside your addon, create the following directory structure:

sound/battlebeats/your_pack_name/
Remember to replace your_pack_name with a 'technical' name for your pack! For example, if you're creating a pack for Final Fantasy XVI, you could name it something like ffxvi

Inside the your_pack_name folder, create two subfolders:
ambient/ combat/
These folders will hold your ambient and combat tracks, respectively
Note: If you want to create an ambient-only or combat-only pack, you can leave the respective folder empty or delete it

Tip: The pack name your_pack_name won't be shown in-game. Only the Workshop title will be displayed (after uploading, of course), unless you're in debug mode

╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾

2. Add Your Music Files
Now place your music tracks into the appropriate folders based on their type
Note: only .mp3 and .ogg files are supported!

IMPORTANT:
  • Use only ASCII characters in your file names (letters A-Z, numbers 0-9, and basic symbols). You CAN use spaces, however avoid special characters, accents, or non-English letters to prevent loading errors

Example names: 60% fantasy - passion.mp3; failume heights (weekday - day).ogg

╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾

3. That's it!
If everything is set up correctly, you can upload your addon to the Workshop
To test your pack before uploading:
  • Place your addon inside addons/ folder inside GMod directory
  • Enable "Debug Mode" option in the BattleBeats settings (Q menu > Utilities > BattleBeats > Advanced)
  • Reload packs using button below debug mode option or restart the map
  • Open BattleBeats pack selector and wait until the pack verification is complete
  • If no errors show up you’re good to go
If you want to use your pack without uploading it to the workshop:
  • Place your addon inside addons/ folder inside GMod directory
  • Enable "Load local packs" options in the BattleBeats settings (Q menu > Utilities > BattleBeats > Advanced)
  • Reload packs using button below debug mode option or restart the map

╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾

You can download a pack template HERE[github.com]

╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾

Tips for Best Results
  • Make sure your tracks aren’t too loud or too quiet - aim for consistent volume
  • Avoid silent gaps at the start or end of tracks - remove any long pauses or empty seconds after the music ends
  • You don’t need to add fade-ins or fade-outs manually - the script handles smooth transitions automatically
  • Use proper song titles or descriptive names for easier management

╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾

Workshop Uploading
This guide is already long enough, so I won’t explain the full process here.
Instead, check out one of these resources:


╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾

Comparison of the Music Pack Creation Process
Aspect
BattleBeats
SBM
Nombat
File Naming
Any names are allowed - script automatically formats them for display
Must end with track length (e.g. `songname_165.ogg`)
Strict naming required: a1.mp3, a2.mp3, c1.mp3, c2.mp3
Track Count
Any number of ambient or combat tracks; each is handled independently. You can create ambient or combat only packs
Requires at least one track for each category
Must have the same number of ambient and combat tracks
Sample Rate
Any - most sample rates should work, no conversion needed
Must be 44100 Hz, 22050 Hz or 11025 Hz or track will fail to play
Must be 44100 Hz, 22050 Hz or 11025 Hz or track will fail to play
Code Editing
None - everything is automatic via file.Find
None - packs are loaded based on filename patterns
Manual Lua editing required: pack name, hook name, sound length, Workshop ID
Ease of Use
As simple as dragging and dropping files - no Lua knowledge needed
Works if you follow the naming pattern
Requires Lua editing skills and precision - easy to break if done incorrectly

╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾╾

Common errors (and fixes)
  • Code: 2 - Error: BASS_ERROR_FILEOPEN → Can’t open the file. Usually caused by strange filenames. Try renaming the file
  • Code: 25 - Error: BASS_ERROR_FREQ → Unsupported sample rate. Happens with uncommon or unusual sample rates
  • Code: 41 - Error: BASS_ERROR_FILEFORM → Unsupported file format. Often caused by corrupted or invalid mp3/ogg files
最后由 ricky dicky doo dah grimes 编辑于; 10 月 20 日 下午 2:25
< >
正在显示第 1 - 10 条,共 10 条留言
pko 5 月 1 日 下午 1:26 
Wow, so simple.
Instructions unclear. What do you mean when you say "create an addon folder inside of your addon"?
ricky dicky doo dah grimes  [开发者] 5 月 30 日 上午 6:50 
引用自 awsomeguyistheman
Instructions unclear. What do you mean when you say "create an addon folder inside of your addon"?
Every addon in GMod starts with a folder named after your addon - like "battlebeats" or anything you want. Inside that folder, you add subfolders based on what your addon needs, like lua, materials, sound, etc.

If you're making a BattleBeats music pack, you only need the sound folder. Inside that, create a battlebeats folder, then inside that, a folder with your pack name (the name doesn't affect how it shows up in the selector). Then create two folders inside your pack: ambient and combat.

Drop your .mp3 files into the appropriate folder and you’re done.

For a more detailed guide on creating GMod addons, check the wiki:
https://wiki.facepunch.com/gmod/Workshop_Addon_Creation
引用自 awsomeguyistheman
Instructions unclear. What do you mean when you say "create an addon folder inside of your addon"?
Every addon in GMod starts with a folder named after your addon - like "battlebeats" or anything you want. Inside that folder, you add subfolders based on what your addon needs, like lua, materials, sound, etc.

If you're making a BattleBeats music pack, you only need the sound folder. Inside that, create a battlebeats folder, then inside that, a folder with your pack name (the name doesn't affect how it shows up in the selector). Then create two folders inside your pack: ambient and combat.

Drop your .mp3 files into the appropriate folder and you’re done.

For a more detailed guide on creating GMod addons, check the wiki:
https://wiki.facepunch.com/gmod/Workshop_Addon_Creation

Thank you.
radiohead 6 月 15 日 上午 6:07 
Thanks
i have an idea for an update. can you please add support for action music packs? (if you can, that is)
Saturn_Wolf 9 月 19 日 上午 6:50 
How would you fix songs overlapping eachother in a local pack?
ricky dicky doo dah grimes  [开发者] 9 月 19 日 上午 7:01 
How would you fix songs overlapping eachother in a local pack?
What do you mean by overlapping
Lil' X-Treme 10 月 14 日 上午 3:23 
How would you fix songs overlapping eachother in a local pack?
What do you mean by overlapping
songs sometimes can overlap,it mainly happens when clicking the Clear the map button thingy too many times.
ricky dicky doo dah grimes  [开发者] 10 月 14 日 上午 5:43 
引用自 Lil' X-Treme
What do you mean by overlapping
songs sometimes can overlap,it mainly happens when clicking the Clear the map button thingy too many times.
Weird i spent like 5 minutes spamming admin cleanup and it didnt happen. This probably has something to do with the x86 (32 bit) version of the game since on x86_64 (64 bit beta branch) im not encountering most of the issues you guys have. I do stress test this mod to prevent issues like that because I know it can be annoying
< >
正在显示第 1 - 10 条,共 10 条留言
每页显示数: 1530 50