The audio-format-convert skill converts audio files between WAV, OGG, and MP3 formats using a single command line invocation. It depends on ffmpeg and ships as an executable Node script inside the Funplay Skills toolkit.
What the Skill Is
audio-format-convert is one of several executable skills in the Funplay Skills collection. According to the project's own skill registry, its purpose is straightforward: "Convert between WAV, OGG, MP3." It lists ffmpeg as its only dependency and targets no specific engine — it is marked as engine-agnostic. That means the output works in Unity, Godot, Cocos Creator, or any other runtime without modification.
The skill fits into a larger audio bring-up pipeline defined in the project documentation:
Reference WAV →
audio-format-convert(to OGG/MP3 per platform) →game-audio-polish(loudness, loop, layer review) → engine import.
In practice, you convert your source WAV to the format your target platform prefers, then run the separate game-audio-polish skill to check loudness, loop points, and layering before you hand the files off to your engine.
Why It Matters
Platform requirements differ. Web builds often need OGG or MP3 for browser compatibility. Mobile titles may require MP3 for smaller downloads. Desktop and console targets sometimes demand uncompressed WAV for low-latency sound effects. Managing these conversions by hand is tedious and error-prone, especially across large projects with hundreds of clips.
Funplay Skills ships 12 skills total. Three of them — sprite-sheet, normal-map, and audio-format-convert — include executable Node scripts you can run directly. The remaining nine are conversational review and planning workflows that the agent executes interactively. This split means you get instant, repeatable file conversions for audio alongside guided quality reviews when you need them.
Prerequisites
You need two things installed on your machine:
- Node.js — any recent LTS version.
- ffmpeg — available on your system
PATH.
On macOS, install ffmpeg with Homebrew:
brew install ffmpeg
On Ubuntu or Debian:
sudo apt update && sudo apt install ffmpeg
On Windows, download a prebuilt binary from the ffmpeg website and add it to your PATH.
Verify both tools are available:
node --version
ffmpeg -version
If either command fails, the conversion script will not run.
Basic Conversion
The script lives at skills/audio-format-convert/scripts/convert.mjs. The syntax is:
node skills/audio-format-convert/scripts/convert.mjs <input> <format>
The <input> argument is the path to your source audio file. The <format> argument is the target format: wav, ogg, or mp3.
Convert WAV to OGG
node skills/audio-format-convert/scripts/convert.mjs assets/audio/explosion.wav ogg
This reads explosion.wav and writes explosion.ogg in the same directory.
Convert WAV to MP3
node skills/audio-format-convert/scripts/convert.mjs assets/audio/music_loop.wav mp3
Convert OGG to WAV
node skills/audio-format-convert/scripts/convert.mjs assets/audio/ambient.ogg wav
Convert MP3 to OGG
node skills/audio-format-convert/scripts/convert.mjs assets/audio/voiceover.mp3 ogg
The script handles any pairing of the three formats. Pass the source file and the destination format, and ffmpeg does the encoding.
Batch Processing
For projects with many clips, wrap the script in a shell loop. This example converts every WAV in a directory to OGG:
for file in assets/audio/*.wav; do
node skills/audio-format-convert/scripts/convert.mjs "$file" ogg
done
On Windows PowerShell:
Get-ChildItem -Path assetsudio\*.wav | ForEach-Object {
node skills/audio-format-convert/scripts/convert.mjs $_.FullName ogg
}
Neither loop is fancy. Both are reliable. Run them from your project root so the relative paths resolve correctly.
Using the Full Audio Pipeline
Format conversion is one step. The recommended workflow from the project documentation is:
- Start with a reference WAV. Use your DAW or audio editor to export uncompressed WAV files at your target sample rate.
- Convert to target formats. Use
audio-format-convertto produce OGG or MP3 copies for each platform. - Review with
game-audio-polish. This skill checks loudness normalization, loop points, and layering. It flags issues before you import into your engine. - Import into your engine. Use your engine's MCP server — Unity MCP with 79 tools, Godot MCP with 105 tools, or Cocos MCP with 67 tools — to automate the import and configuration step.
The engine MCP servers communicate over 127.0.0.1 port 8765. Each server requires a specific minimum editor version: Unity 2022.3 or later, Godot 4.2 or later, or Cocos Creator 3.8 or later.
Gotchas and Limitations
ffmpeg is required. The script is a thin wrapper around ffmpeg. If ffmpeg is missing or not on your PATH, the conversion fails silently or throws an unclear error. Always verify your ffmpeg installation before running the skill.
No encoder flags. The script does not expose bitrate, sample rate, or channel layout options. If you need 128 kbps MP3 specifically, or mono output, you must call ffmpeg directly or modify the script. This is a deliberate design choice — the skill targets the common case, not every edge case.
Lossy-to-lossy conversion degrades quality. Converting MP3 to OGG recompresses already compressed audio. Always keep your source WAVs. Convert from WAV to your target format, not from one lossy format to another, unless you have no alternative.
No metadata preservation. The script focuses on the audio stream. Loop points embedded in WAV headers or custom metadata may not survive the conversion. Set loop points inside your engine after import, or use the game-audio-polish skill to verify them.
The skill does not validate loudness. Format conversion and quality review are separate steps by design. Run game-audio-polish after conversion to catch loudness and leveling problems.
When Not to Use This Skill
Skip audio-format-convert if you need fine-grained control over codec parameters, batch normalization, or format detection. Tools like SoX, the full ffmpeg CLI, or DAW batch export give you more control. Use those tools for mastering and final encoding. Use this skill for quick, repeatable format swaps inside a game development pipeline.
Summary
audio-format-convert gives you a single-command path between WAV, OGG, and MP3. It requires only Node.js and ffmpeg, produces engine-agnostic output, and integrates into a larger skill-based pipeline that covers audio polish, texture processing, and engine import.
Run your first conversion today and explore the full Funplay Skills toolkit at the Funplay Skills repository. For more guides on game development workflows, visit the Gamebooom.ai blog.