How does the [overlay] tag work in PSDs for Spine?

Skeir

i've recently been switching to PSD imports for my spine projects (its a life saver). however, i don't understand how the [overlay] tag works. the docs say it works as a clipping mask for all underlying layers, but when i view it in Spine it just removes any layers I put under it.
for example i want to have an eye overlay with pupils under them. i'm not a big fan of clipping attachments for handling these

if it helps, i'm using affinity designer 2. everything else exports properly, and when viewing the exported PSD everything looks normal. it also loads into spine just fine

Spinebot

The [overlay] tag in the PhotoshopToSpine script is used to create a clipping mask for all the layers below it. This means that any layer with the [overlay] tag will affect the appearance of the layers beneath it, but only where there are pixels on those layers. If you are experiencing issues where layers are being removed or not displaying as expected, it might be due to how the layers are structured or tagged in your PSD file. Ensure that the [overlay] tag is correctly applied and that the layers you want to be affected are directly beneath the overlay layer. Additionally, check that the layers are not inadvertently hidden or grouped in a way that affects their visibility in Spine.