ActorXImporter: What is the Role of the .props.txt File?

wumoxh

Newbie

Posts: 17

ActorXImporter: What is the Role of the .props.txt File?

« on: October 25, 2025, 17:27 »

Hello, I'm currently trying to learn scripting and using ActorXImporter as a learning sample.
I’ve encountered some confusion and would appreciate your guidance when you have time.

When extracting the psa, there’s also a .config and a .props.txt file.
The .config file is only a few KB in size, while the .props.txt is very large.
However, it seems that when ActorXImporter reads the psa, it only reads the .config file. Is that correct?
If so, does that mean the .props.txt file has no effect?

When converting animations, I noticed that if I delete both the .config and .props.txt files, issues occur with the animations.
But I haven’t yet looked into what happens if only one of them is missing.

If it’s convenient for you, I’d greatly appreciate some guidance.
Thank you very much!


	Logged

spiritovod

Global Moderator
Hero Member

Posts: 2806

Re: ActorXImporter: What is the Role of the .props.txt File?

« Reply #1 on: October 25, 2025, 23:53 »

Config contains retargeting options, which are parsed from skeleton and then can be used via respective settings in ActorX importer. You can see approximate difference between those settings in the umodel itself by switching retargeting mode with Ctrl+R after applying animations - "disabled" is what you get in other tools by default. It's less useful for UE5 games though, as in most cases animation retargeting sources are not parsed for them in umodel, and it requires some manual adjustments.

Props is supplementary file, which is optional, and it contains some properties parsed by umodel, but not used by it or by the importer. They can be used outside of umodel for some manual processing, especially for materials or cases like this one.


	Logged

wumoxh

Newbie

Posts: 17

Re: ActorXImporter: What is the Role of the .props.txt File?

« Reply #2 on: October 26, 2025, 07:45 »

Thank you very much for your reply.

I saw you mentioned:

"previously it was supported only in ActorX importer."

But then I also saw you stated above:

"but not used by it or by the importer."

So I'm a bit confused. Can the Max script be manually corrected, similar to how it's done in Blender?

Because I'm not a Blender user.

I'm using Umodel to export PSA/PSK files.


	Logged

spiritovod

Global Moderator
Hero Member

Posts: 2806

Re: ActorXImporter: What is the Role of the .props.txt File?

« Reply #3 on: October 26, 2025, 18:09 »

It seems you misunderstood things. ActorX importer is already able to apply retargeting via config files (where possible), it's "translation mode" option in the importer. In the mentioned topic it's explained how to perform similar thing in blender with dumped from umodel or taken from respective props files values.

Also I'm not fluent in max scripting and can't help much with implementing new features to the importer.


	Logged

wumoxh

Newbie

Posts: 17

Re: ActorXImporter: What is the Role of the .props.txt File?

« Reply #4 on: October 26, 2025, 18:58 »

Thank you very much for your answer.

I had misunderstood your point because I noticed that if the .config and .props.txt files are missing, the animations become abnormal. While studying the script, I observed that it seems to only read the .config file, but the .props.txt file is much larger. This confused me, especially after seeing how in Blender, data from .props.txt is used for fixes.

Now my understanding is:
By keeping the Translation mode set to the default "Use from AnimSet", the importer can correctly read and utilize the data from both files, without the need for manual correction. Is that right?


	Logged

spiritovod

Global Moderator
Hero Member

Posts: 2806

Re: ActorXImporter: What is the Role of the .props.txt File?

« Reply #5 on: October 26, 2025, 21:17 »

Like it was already said, ActorX importer doesn't use props files for anything, only config ones. Also results in 3ds max can be incorrect in some cases anyway. It depends on the game, which may use more complex approach not handled by umodel and the importer, or custom properties, or things like that.


	Logged

Pages: [1]

Gildor's Forums

Gildor's Forums