Indie game storeFree gamesFun gamesHorror games
Game developmentAssetsComics
SalesBundles
Jobs
Tags

I can't import my rpg maker game on itch.io

A topic by Kiriox created Jun 06, 2022 Views: 578 Replies: 9
Viewing posts 1 to 10

Hello

I would like to import my rpg maker mz game in html on itch.io I put my zip everything goes well but when I go to my game page it gives me this error:

Archive contains filename with non UTF-8 Encoded characters

How can I do ?

I found the error because the files have utf-8 characters but so how can I fix the problem because it will cause dependency problems, right?

I would assume it means your file names have invalid characters in them. That's at least what I can make out from UTF-8 by looking over the topic.

Web-based (HTML) stuff is actually quite picky about how you name your files. You shouldn't use spaces or any special characters, even if your operating system doesn't forbid you using them itself.

If this is indeed the problem, the only thing you can do is go back to your files and change how they are named - which will of course cause problems as you have to re-assign all of these files in every instance within your project again. I think I've read it might be possible to export your event data into text files and change stuff like that in there. But simply importing it back obviously won't work - so there is probably a bit more to that solution.

The only other thing I could come up with is that the archiving itself causes problem. Maybe you have to change that?  I guess it would be best to look up itch.io's help about html games for that: https://itch.io/docs/creators/html5

Sorry for the vague input, but maybe it'll help you out. If someone has more (better) information about that topic, feel free to jump into the conversation.

(1 edit)

I don't think this is a browser problem or game problem, itch.io seems to only support common files. Adding   non UTF-8 Encoded characters like 

ひほわれよう

    or

  നമുക്ക് തകർക്കാം 

 you'll get error.  what you want to do is change anything that is  programming into the game. This means the programming has to be english or close to the english wording, i know i don't like using it too because i don't understand much either but it should fix the problem. Unless it's inside textbox then i have no idea how to fix it.

I am French so some files are named in French, can that be it?

(2 edits) (+1)

Could be possible, yes. French uses various characters that are exclusive to that language (like a lot of countries). It is normally not good to use them in file names, as in the long run you will encounter problems. Even if your game would somehow be working on the website, others may be running into problems with your next project that is to be installed locally, for example.

The best way to avoid this is to use a set way of naming your files and sticking to it. For example Hero01_B . As long as you stick to english alphabet, you shouldn't encounter any problems. You also shouldn't use any special characters like spaces, though. I think brackets are okay, as well as _ . So you still have some room of formatting your files.

Edit: So I've actually checked which special characters are allowed and... this is more complicated than it should be. The general gist for file naming seems to be that you better only use - or _ . Some others may be allowed depending in which scenario they are being used. It is also important to note that you should definitely avoid using special characters at the start or the end. Using a letter of the alphabet first is also recommended. Again, there can be exceptions depending on where it is used. For example RPG Maker specifically uses ! and $ at the beginning of a filename to work with that file in a certain way.

They also don't mention brackets, or rather some state they are not good to be used. Which means I probably have to go back and change my filenames for a third time *sigh*. I actually doubt that every case of special letters will get you in trouble, so maybe some things are a bit overreacting. But the question is how much can you avoid using them to not risk needing to change all names again after you've used them in your project already.

Also, obviously special characters from your native language are still forbidden. Had to learn that the hard way when I was younger, as well.

Hope that helps!

Edit 2: Yes.

I've checked some more and, specifically for html, it seems that some are stating you shouldn't even use _ . Also, you should write in lowercase only.

... I think that covers it. Honestly, I've never seen a more nit-picky naming convention in my life.

Thank you very much I will try to rename the files that I created myself to see

And you know it is possible that in the names of the default files of rpg maker there are its characters?

The default ones should be okay. Most of them only are words and numbers together, some of them use _ . I would assume if the devs of the software have used them, that they shouldn't break anything. In addition, most assets I've come across from different authors also used them in their formatting.

So if you want to play it very save you could decide to not use them, but I would say - and _ should be allowed in between normal letters and numbers in most scenarios.

Also, some default files have ! and $ at the beginning. Although it is normally not allowed to use them, RPG Maker in particular uses them to deal with the files in a specific way in the editor. If the platform you want to upload really cares about that is the other thing, but the software has used these two letters since years.

I also have to admit that even though the rules seem to be so strict, it is actually rare that I've heard of people having big problems with their file naming. So I guess not using native special characters of a language and avoiding really bad special characters should normally be enough.

thank you very much for your answer

I just looked while doing an export of a project just created and it gives me the same error which would mean that rpg maker uses non-compatible default file names which seems strange to me

(1 edit)

How did you name the new project's folder? You have to stick with the same naming convention (no spaces, special characters, etc.) like with your file names.

Other than that, I did another google search and found some results (from itch itself actually) and it's mostly the same answer. Somewhere some folders or files within the project use characters which aren't allowed. If it is a fresh rpg maker project, that would indeed be weird, as from what I know it should all only be localized in english and in a way it shouldn't be incompatible.

The only things I can recommend at this point are to check every single folder and file name from the whole project you are going to archive and upload and check if it follows the naming rules.

Another thing mentioned in one thread was that the program you use to archive a project can be important as well, as it has to do the archiving process in the correct format to support UTF-8 as well. So the solution mentioned there was to switch to another program to archive your project. Either that, or maybe simply changing the settings you are currently archiving your project with.

This topic has been auto-archived and can no longer be posted in because there haven't been any posts in a while.