Z-Index

Z-Indexはスプライトが画面に描画される「重なり順」を制御する非常に重要な要素です。
Playdateは1-bit ディスプレイを採用しているため、重なり順を適切に管理しないと、キャラクターが背景に隠れてしまったり、UIが見えなくなったりします。

Playdateのスプライトシステム（playdate.graphics.sprite）では、以下のルールで描画順が決まります。

Playdate の内部（C API）では、Z-Index は int16_t（16ビット符号付き整数）として定義されています。
そのため、取りうる値の範囲は -32,768 ～ 32,767 となります。

スプライトに対して以下のメソッドを使用して設定・取得を行います。

メソッド	説明
sprite:setZIndex(z)	スプライトのZ-Indexを指定した整数 z に設定します。
sprite:getZIndex()	スプライトの現在のZ-Indexを返します。

local mySprite = gfx.sprite.new(image)
mySprite:setZIndex(100) -- UIなど手前に出したいもの
mySprite:add()

開発をスムーズにするために、あらかじめ用途ごとにZ-Indexの範囲を決めておくのが一般的です。

『ゼルダの伝説』のような見下ろし視点（トップダウン）のゲームでは、「キャラの足元（Y座標）が下にあるほど手前に表示する」という処理が必要です。これを「Yソート」と呼びます。
Playdateでは、毎フレーム update 内でY座標をZ-Indexに反映させることで簡単に実現できます。

function mySprite:update()
    -- Y座標をそのままZ-Indexに設定することで、
    -- 画面の下にいるキャラが自動的に手前にくる
    self:setZIndex(self.y)
end

sprite.update() の呼び出し: Z-Indexを変更した後、実際に画面に反映されるのは playdate.graphics.sprite.update() が実行されたタイミングです。; この関数が内部でZ-Indexに基づいた並び替え（ソート）を自動で行います。
描画パフォーマンス: スプライトの数があまりに多く、かつ毎フレーム全員のZ-Indexを書き換えると負荷がかかる場合があります。; 動きがない背景などは固定の値を使い、必要なものだけ動的に変更しましょう。
不透明度（パターン）との関係: 1ビット画面なので「半透明」はありませんが、ディザリング（網点）を使ったスプライトを重ねる際、Z-Indexが正しくないと意図した見た目になりません。; 重なり順は常に意識しておく必要があります。

Playdate 非公式開発まとめ wiki