Skip to content

Latest commit

 

History

History
112 lines (102 loc) · 5.45 KB

README.md

File metadata and controls

112 lines (102 loc) · 5.45 KB
Raw

RAGE Console Resource Converter

Description

  • Tool to convert some resources (like models, textures, etc.) from console games on RAGE engine.

Supported games

Features

  • Convert models (with animations) to OpenIV's openFormats' files which can imported through openFormats I/O
  • Convert textures to DDS format
  • Unpack the resource file to memory segments (for experts)
  • Supported formats are:
    • .xfd/.xwt (v1)
    • .xas (v6)
    • .xtd (v9/v10)
    • .xrsc (v63)
    • .xtp/.xtl (v83)
    • .xdr/.xdd (v102/v109)
    • .xck (v131)
    • .xvd (v133)
    • .xsi (v134)
    • .xft (v138)
    • some others if the resource version and file contents are supported

Download

  • All builds are available in Releases page.

Usage

  • Simple conversion example:
    Converter.CLI.exe -i <input_path>
  • Available options (you can also run Converter.CLI.exe without arguments to see them):
    -l, --basic-log
    Basic logging (verbose) mode. Contains a basic details about opened resource.
    
-e, --extended-log
    Extended logging (very verbose) mode. Contains a basic + exporting details.
    
-n, --nowait
    Disable waiting for user input when all tasks are finished/failed.
    
-i, --input
    Required. The path to folder or file which needs to be converted.
    
-o, --output
    The path to folder(!) where you want to save the result.
        If it's not specified, then output directory will be the same as input.

Limitations

  • Currently supported platform is Xbox 360 only. PlayStation 3 is not fully supported (only unpacking to memory segments).
  • At this moment, conversion results can be exported only to OpenIV's openFormats files. In future versions it may be changed.
  • At this moment, only reading and converting the resources is possible. It means that you can't, for example, make some kind of modifications for that games.
  • Only command-line (CLI) version of the converter is available. Graphical (GUI) version may be added in future versions.
  • This tool can be run only on Windows. Linux/macOS/other OS are not supported officially, but if you can run that tool on it - it's great.

Dependencies

FAQ

  • Q: How can I run your tool? When I double-clicking on EXE, it just displays me a help text.
    A: Right-mouse-click on a empty space of Explorer window with folder where Converter.CLI.exe is located and choose "Open in Terminal", or, if you're on Windows 10, press Shift and then Right-mouse-click and choose "Open command prompt here", or simply click on address bar at the top of the Explorer window and type "cmd", then press Enter.
    Sadly, many people still don't know this.
  •  
  • Q: Can I convert <my-file>?
    A: Read Features section, it has a list of supported formats.
  •  
  • Q: How can I know the resource version of <my-file>?
    A: Some information is explained here. Use it and any hex editor you like to grab the information about resource version you want to know.
  •  
  • Q: Can you add a <feature-name>?
    A: Welcome to Issues page. Just open a new one, and describe what exactly you want.

Thanks

  • oxmaulmike2581 – for his great contribution to the development of this project and assistance.
  • Foxxyyy – for his MagicRDR project
  • XBLToothPik – for his AreDeAre xPlorer 2 project
  • Dageron – for all his work to researching RAGE game engine
  • listener - for all his work researching RAGE game engine

Licensing

  • This project is licensed under MIT License, but some libraries used in this project may have their own licenses.