Skip to main content

Indie game storeFree gamesFun gamesHorror games
Game developmentAssetsComics
SalesBundles
Jobs
TagsGame Engines

This game is broken on macOS (at least for me)

So I had hoped that downloading the latest update would fix the exception on launch issue on macOS.  Sadly no luck:

I'm sorry, but an uncaught exception occurred.

While parsing /private/var/folders/b3/6wdzzgqj7rb8w1nmsndgyzwr0000gn/T/AppTranslocation/1A2CFC4B-0975-4E5E-9DF6-EEA39AD19035/d/StudioHearts.app/Contents/Resources/autorun/renpy/common/._000atl.rpy.

UnicodeDecodeError: 'utf-8' codec can't decode byte 0xb0 in position 37: invalid start byte

-- Full Traceback ------------------------------------------------------------

Traceback (most recent call last):

  File "renpy/bootstrap.py", line 376, in bootstrap

    renpy.main.main()

    ~~~~~~~~~~~~~~~^^

  File "renpy/main.py", line 435, in main

    renpy.game.script.load_script()  # sets renpy.game.script.

    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^                           

  File "renpy/script.py", line 421, in load_script

    self.load_appropriate_file(".rpyc", ["_ren.py", ".rpy"], dir, fn, initcode)

    ~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

  File "renpy/script.py", line 1011, in load_appropriate_file

    data, stmts = self.load_file(dir, fn + source)

                  ~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^

  File "renpy/script.py", line 800, in load_file

    stmts = renpy.parser.parse(fullfn)

            ~~~~~~~~~~~~~~~~~~^^^^^^^^

  File "renpy/parser.py", line 1675, in parse

    lines = list_logical_lines(fn, filedata, linenumber)

            ~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^

  File "renpy/lexer.py", line 350, in list_logical_lines

    data = data_io.read()

           ~~~~~~~~~~~~^^

  File "<frozen codecs>", line 322, in decode

UnicodeDecodeError: 'utf-8' codec can't decode byte 0xb0 in position 37: invalid start byte

macOS-26.5.1-arm64-arm-64bit arm64

Ren'Py 8.4.1.25072401

Sat Jun 27 16:17:01 2026

I'm not hugely familiar with macOS, but it's possible that app translocation is causing the issue here rather than it being an issue with the game itself. Google tells me that app translocation is a thing macOS does when you try to run a program from the same location to which it was originally downloaded, so you could try moving the game to another folder in Finder. I have no idea if that will fix the issue, but it'd be the first thing to try I guess.

The problem is that dot files (._000atl.rpy) which are metadata files that appear (normally if you access the files from a non mac network share iirc) were in the directory.  To fix this I had to:

dot_clean [App Bundle File]
xattr -cr [App Bundle File]

If you do these steps before you zip the application it should avoid this problem. Simply moving the file (and I know why you suggested it) isn't enough

As far as I know, ._ files are temp files generated by macOS, and aren't actually present in the game files when I build the mac version, nor after it's built, so there isn't much I can do about it unfortunately. Still, I'm glad you were able to find a solution.