巫师3 WolvenKit mod制作工具

# vgmstream [](https://ci.appveyor.com/project/kode54/vgmstream/branch/master/artifacts) This is vgmstream, a library for playing streamed (pre-recorded) audio from video games. There are multiple end-user bits: - a command line decoder called "test.exe/vgmstream-cli" - a Winamp plugin called "in_vgmstream" - a foobar2000 component called "foo_input_vgmstream" - an XMPlay plugin called "xmp-vgmstream" - an Audacious plugin called "libvgmstream" - a command line player called "vgmstream123" Help and newest builds can be found here: https://www.hcs64.com/ Latest development is usually here: https://github.com/losnoco/vgmstream/ Latest releases are here: https://github.com/losnoco/vgmstream/releases Automated builds with the latest changes: https://ci.appveyor.com/project/kode54/vgmstream/branch/master/artifacts You can find further info about other details in https://github.com/losnoco/vgmstream/tree/master/doc ## Needed extra files (for Windows) Support for some codecs (Ogg Vorbis, MPEG audio, etc) is done with external libraries, so you will need to have certain DLL files. In the case of the foobar2000 component they are all bundled for convenience, or you can get them here: https://github.com/losnoco/vgmstream/tree/master/ext_libs (bundled here: https://f.losno.co/vgmstream-win32-deps.zip, may not be latest). Put the following files somewhere Windows can find them: - `libvorbis.dll` - `libmpg123-0.dll` - `libg719_decode.dll` - `avcodec-vgmstream-58.dll` - `avformat-vgmstream-58.dll` - `avutil-vgmstream-56.dll` - `swresample-vgmstream-3.dll` - `libatrac9.dll` - `libcelt-0061.dll` - `libcelt-0110.dll` For Winamp/XMPlay/command line this means in the directory with the main .exe, or in a system directory, or any other directory in the PATH variable. ## Components ### test.exe/vgmstream-cli *Installation*: unzip the file and follow the above instructions for installing the other files needed. Converts playable files to wav. Typical usage would be: - `test.exe -o happy.wav happy.adx` to decode `happy.adx` to `happy.wav`. If command-line isn't your thing you can also drag and drop files to the executable to decode them as (filename).wav There are multiple options that alter how the file is converted, for example: - `test.exe -m -o file.wav file.adx`: print info but don't decode - `test.exe -i -o file.wav file.hca`: convert without looping - `test.exe -s 2 -F -o file.wav file.fsb`: play 2nd subsong + ending after 2.0 loops - `test.exe -l 3.0 -f 5.0 -d 3.0 -o file.wav file.wem`: 3 loops, 3s delay, 5s fade Available commands are printed when run with no flags. Note that you can also achieve similar results for other plugins using TXTP, described later. ### in_vgmstream *Installation*: drop the ```in_vgmstream.dll``` in your Winamp plugins directory, and follow the above instructions for installing the other files needed. Once installed supported files should be playable. ### xmp-vgmstream *Installation*: drop the ```xmp-vgmstream.dll``` in your XMPlay plugins directory, and follow the above instructions for installing the other files needed. Note that this has less features compared to in_vgmstream and has no configuration. Since XMPlay supports Winamp plugins you may also use ```in_vgmstream.dll``` instead. Because the XMPlay MP3 decoder incorrectly tries to play some vgmstream exts, you need to manually fix it by going to **options > plugins > input > vgmstream** and in the "priority filetypes" put: `ahx,asf,awc,ckd,fsb,genh,msf,p3d,rak,scd,txth,xvag` ### foo_input_vgmstream *Installation*: every file should be installed automatically by the `.fb2k-component` bundle. A known quirk is that when loop options or tags change, playlist won't refresh automatically. You need to manually refresh it by selecting songs and doing **shift + right click > Tagging > Reload info from file(s)**. ### Audacious plugin *Installation*: needs to be manually built. Instructions can be found in the BUILD document in vgmstream's source code. ### vgmstream123 *Installation*: needs to be manually built. Instructions can be found in the BUILD document in vgmstream's source code. Usage: `vgmstream123 [options] INFILE ...` The program is meant to be a simple stand-alone player, supporting playback of vgmstream files through libao. Files compressed with gzip/bzip2/xz also work, as identified by a .gz/.bz2/.xz extension. The file will be decompressed to a temp dir using the respective utility program (which must be installed and accessible) and then loaded. It also supports playlists, and will recognize a special extended-M3U tag specific to vgmstream of the following form: ``` #EXT-X-VGMSTREAM:LOOPCOUNT=2,FADETIME=10.0,FADEDELAY=0.0,STREAMINDEX=0 ``` (Any subset of these four parameters may appear in the line, in any order) When this "magic comment" appears in the playlist before a vgmstream-compatible file, the given parameters will be applied to the playback of said file. This makes it feasible to play vgmstream files directly instead of needing to make "arranged" WAV/MP3 conversions ahead of time. The tag syntax follows the conventions established in Apple's HTTP Live Streaming standard, whose docs discuss extending M3U with arbitrary tags. ## Special cases vgmstream aims to support most audio formats as-is, but some files require extra handling. ### Renamed files A few extensions that vgmstream supports clash with common ones. Since players like foobar or Winamp don't react well to that, they may be renamed to make them playable through vgmstream. - .aac to .laac (tri-Ace games) - .ac3 to .lac3 (standard AC3) - .aif to .laif or .aiffl or .aifcl (standard Mac AIF, Asobo AIF, Ogg) - .aiff/aifc to .aiffl/aifcl (standard Mac AIF) - .asf to .lasf (EA games, Argonaut ASF) - .bin to .lbin (various) - .flac to .lflac (standard FLAC) - .mp2 to .lmp2 (standard MP2) - .mp3 to .lmp3 (standard MP3) - .mp4 to .lmp4 (standard M4A) - .mpc to .lmpc (standard MPC) - .ogg to .logg (standard OGG) - .opus to .lopus (standard OPUS or Switch OPUS) - .stm to .lstm (Rockstar STM) - .wav to .lwav (standard WAV) - .wma to .lwma (standard WMA) - .(any) to .vgmstream (FFmpeg formats or TXTH) Command line tools don't have this restriction and will accept the original filename. The main advantage to rename them is that vgmstream may use the file's internal loop info, or apply subtle fixes, but is also limited in some ways (like standard/player's tagging). .vgmstream is a catch-all extension that may work as a last resort to make a file playable. Some plugins have options that allow any extension (common or unknown) to be played, making renaming is unnecessary (may need to adjust plugin priority in player's options). Also be aware that some plugins can tell the player they handle some extension, then not actually play it. This makes the file unplayable as vgmstream doesn't even get the chance to parse that file, so you may need to disable the offending plugin or rename the file (for example this may happen with .asf and foobar). When extracting from a bigfile, sometimes internal files don't have an actual name+extension. Those should be renamed to its proper/common extension, as the extractor program may guess wrong (like .wav instead of .at3 or .wem). If there is no known extension, usually the header id string may be used instead. Note that vgmstream also accepts certain extension-less files too. ### Demuxed videos vgmstream also supports audio from videos, but usually must be demuxed (extracted without modification) first, since vgmstream doesn't attempt to support them. The easiest way to do this is using VGMToolBox's "Video Demultiplexer" option for com