CLI has no access to project information like custom types. #3797

This is a known issue. When you use the CLI, there's no project loaded, so it can't know what properties go with your classes. The solution to this would be to provide something like a --project parameter so you can specify the project file to use.

A workaround for now is to use a custom export format that makes a copy of the map, resolves the values (e.g. by parsing the project file, or having the values hard-coded), and then writes out the file in the actually desired format (you can access an existing format you want via tiled.mapFormat(shortname), and you can write the map using the MapFormat's write(map, fileName) method).

Thanks. That explanation makes perfect sense. I should have thought of that.

Thanks for the workaround. I'll have a look at the existing exporter and command line interface and see if I can figure something out. Hopefully someone will be able to share a fix before I get started!

Regarding the workaround, I fear I didn't make it very clear: this would have to be a custom format script, using the scripting API. This is not something you can do via the CLI parameters, and the existing TMX code will probably not have anything you need because it's doing different work, and is a different language (C++, whereas scripting is JavaScript).

This script for copying/pasting layers may be of use in writing code to clone the map (necessary because the TileMap passed into write() is read-only), but I am not aware of any public script for resolving the class properties, though I know people have tackled that issue via scripting.

Hm. Thanks. I'm really a C++ programmer and I don't want to get too distracted if this turns out to be a big task. I'll have a look though.

The simplest workaround is to manually export all the maps from the GUI. Not ideal, but I might be able to live with it. Is it possible to write simple script to control the GUI? Perhaps I could add a command that Exports on Save, or a script to export all tmx files in the project (or from a list in a file). Is this possible?

Yes, that's doable via scripting, but there's also a built-in "Repeat last export on save" option in the Preferences that may do what you need.

Haha. Perfect! I'll just use that preference for now.

It sounds like the lack off access to the project on the command line is the issue that really needs fixing; is there a pre-existing issue I can follow, or is this it?

I think this issue might be it. It's been discussed multiples times elsewhere, but I don't think anyone's opened an actual issue before. At least, I couldn't find one.

For clarity, it might be good to edit the title and first post of this one to reflect the specific problem, i.e. that CLI has no access to project information like custom types.

Done. Thank you very much for your support.

I've added the --project command-line parameter in #3802. Any help with testing it would be appreciated. I verified on Linux that it allowed me to use file formats defined in the project-specific extensions folder as well as basic handling of custom classes and enums.

Given that I planned for the next release to be a 1.10.2 patch release, I'll wait with merging this until after the release, to be included in Tiled 1.11.

Hi Thorbjørn. Many thanks for this. I'll test on Windows as soon as I can.

I've added the --project command-line parameter in #3802. Any help with testing it would be appreciated.

Is the Tiled installer (Windows (64-bit, Qt 6) I guess) from this build available, or will I need to build locally?

Is the Tiled installer (Windows (64-bit, Qt 6) I guess) from this build available, or will I need to build locally?

You can download the auto-builds here: https://github.com/mapeditor/tiled/actions/runs/5753294396?pr=3802 (scroll down)

@bjorn I've tested this on Windows and it seems to be working just fine thanks. I don't have any custom file formats, but it seems to be working fine for the custom enums and classes I use.

For my set of levels, the output from the CLI is now identical to that from the GUI (except for tiledversion obviously).

Please let me know if I need to do anything on this issue or the pull request.

@howprice Thanks for testing! I've finally merged it for the next release now. :-)

Thanks for implementing this. I'll keep an eye out for the next release. What is the best way to receive notifications or new releases?

@howprice Tiled itself would notify you about a new release in its taskbar, unless disabled. To get a notification in your email, you can subscribe to the "Releases" on GitHub here:

At least, if you have GitHub configured to send you emails on notifications.

If you log in to itch.io, you can also follow me there to get notified about releases: https://thorbjorn.itch.io/tiled (top right corner).