|string||The full path and filename of the archive to create|
|string||The full path of the destination folder to extract into, excluding final slash|
|string/integer/array/keyword||The name or index of a file to extract, or array of files (or keyword 'all' for all files)|
|string||Optional: Additional files to extract from the archive (arrays and keywords not accepted)|
Extracts one or more files from an archive created with
xzip_create to the destination folder. Also returns
false to indicate if the operation succeeded.
If multiple files are input, even a single error will return
false even though other files succeeded. In this scenario, use
xzip_report to retrieve a list of failed files.
For files stored in the archive, a full path should not be used, just the file name with extension. Use
xzip_list to see what file names are available in the archive. The numerical index from
xzip_list, an array, or the
all keyword can also be used. If a folder is input, all files from the folder will be extracted, preserving the relative path.
Be warned that extraction takes time, and extracting many files at once can cause the game to temporarily appear frozen. It is recommended to extract large archives over a series of Steps and display a loading screen. (See example usage.)
It is recommended to disable the filesystem sandbox for this script. If the sandbox is enabled, archives can only be created and extracted in