. rage-lint - Validate RAGE metafiles

GoatGeek · 2021-06-16T09:44:30.659Z

rage-lint (Lint RAGE `.meta` and `.xml` files)

Tired of invalid `.meta` files? Fear not, `rage-lint` will help you find the problem!

What it does:

This is a tool for developers to validate RAGE (GTA5’s game engine) .meta files against the game code. It is capable of:

Validating metafile structure
Identifying missing or invalid fields
Validating numeric and hex values for correctness
Automatic validation updates

What it supports:

Vehicle metafiles
Weapon metafiles
Literally everything else… to some degree

► GitHub Repo

► GitHub Action

► Downloads / Releases

Latest Version - 0.0.4

Added a version checker, so you will be notified if a new version is available

Simplified the results output

Full Changelog

0.0.3

Support for ambiguous types in <Item type="CChildElement"> elements, you should see better validation results now

More formatting improvements

Added a -u / --update argument to force re-downloading the schema

0.0.2

Fixed a fatal error when running rage-lint.exe across different Windows drives

0.0.1

Initial release!

Usage

Run with GitHub Actions

If you have a public (or private) GitHub repository, you can easily run rage-lint to check your files on every commit, for free!

► rage-lint-action · GitHub Marketplace

Running locally (easy way)

A prebuilt .exe is made available here:

► rage-lint · GitHub Releases

Running locally (hard way)

To run the script directly, you will need Python 3.x installed on your local computer – then you can also clone the repository and follow the instructions in the README to install the Python dependencies.

Running rage-lint

rage-lint accepts a list of globs to process. So if you wanted to lint ALL .meta files, you would run it like so:

rage-lint.exe **/*.meta

To run both .meta and .xml files:

rage-lint.exe **/*.meta **/*.xml

This is experimental!

This is powered by GTA5.xsd, which is a really big generated XML schema so we can check metafiles against the game logic!

There may be issues with validation, please report any issues here so the validation can be fixed! If you have questions about the errors reported, feel free to also leave a comment here so it can be explained for others.

SaltySea · 2021-06-16T09:45:14.528Z

amazing work!

carlos55ml · 2021-06-16T09:48:35.153Z

Very useful! I love it!

MasiBall · 2021-06-16T09:52:01.103Z

This will make my work easier. Nice release!

ArtikX · 2021-06-16T10:20:47.982Z

You should verify your exe against the antivirus. VirusTotal

GoatGeek · 2021-06-16T10:22:21.639Z

It’s a Python script made into an .exe, of course it will be flagged. If you don’t want to run it then don’t. You can always do it the hard way too, and run the script yourself.

Shane_Martin · 2021-06-16T10:29:16.841Z

With the exe is it just the case of putting it into the GTA5 game folder and running, or can you have it run in any folder?

Do we need to install anything else to get it working as it just closes down when trying to run for me.

Apologies for being a noob.

ArtikX · 2021-06-16T10:30:03.091Z

Lucky for me. I have already python installed

SkellyKat_Gaming · 2021-06-16T10:32:20.391Z

hi i got an issue where it says this
Traceback (most recent call last):
File “rage-lint.py”, line 33, in
File “ntpath.py”, line 703, in relpath
ValueError: path is on mount ‘C:’, start on mount ‘D:’
[27888] Failed to execute script rage-lint
do you know what the issue is and yes i have python installed.

GoatGeek · 2021-06-16T10:35:12.384Z

You can place it anywhere, but it is a terminal application, so you will have to run it from the console (like cmd.exe or Powershell). If you want it to be available, you will have to place it in a directory that is in your Windows %PATH%.

For example, if you want to lint your resources:

cd to your resources/ directory
Run it like so:

C:\Path\To\rage-lint.exe **/*.meta

GoatGeek · 2021-06-16T10:36:05.281Z

SkellyKat_Gaming:

ValueError: path is on mount ‘C:’, start on mount ‘D:’

This is a bug that will be fixed in the next update, all you should need to do is move the .exe to the same drive that your resources are on.

SkellyKat_Gaming · 2021-06-16T10:43:01.434Z

i have it still doesn’t work.

GoatGeek · 2021-06-16T10:55:33.776Z

Go ahead and try v0.0.2 which I just built, this should fix the issue.

SynTer · 2021-06-16T11:00:18.525Z

Good work, Goat! Thanks for this, gonna use it a lot!!!

SkellyKat_Gaming · 2021-06-16T11:25:23.461Z

Works now looks like i got some stuff to fix.

SirBombay · 2021-06-16T18:28:43.599Z

Aw yes, goat. Here. have a heart

ultrahacx · 2021-06-16T18:55:03.324Z

Finally I don’t have to smash my head anymore Thanks for such a great tool

Parchoquer · 2021-06-17T11:03:02.463Z

Wow thank you!
smart and very useful

AGW_Ismael · 2021-06-18T04:15:50.573Z

Excellent work, a very useful tool that will help greatly to fix countless hidden errors in meta files.

Edit : Not sure what’s on your plate in the future or if it even interests you, but do you believe some sort of tool that scrapes vehicle modkit IDs and lists duplicates is feasible ? Would be a godsend for people who made the big mistake of merging their meta files using broken tools (like myself hahah).

GoatGeek · 2021-06-18T14:04:51.973Z

AGW_Ismael:

Not sure what’s on your plate in the future or if it even interests you, but do you believe some sort of tool that scrapes vehicle modkit IDs and lists duplicates is feasible

Stop reading my mind.

I had plans for implementing this, but it would likely come after RDR2 support and some other fixes I need to do.