Tutorial DIY Bikin Peliharaan Desktop Codex Sendiri

Diperbarui 2026-07-16 · versi terverifikasi dengan cara resmi

Pet desktop Codex App tak terbatas pada beberapa ekor bawaannya. Pintu kustomisasi dibuka lengkap secara resmi: asal kamu menyiapkan satu spritesheet sesuai spesifikasi dan satu pet.json, lalu menaruhnya di folder di komputermu, karakter apa pun yang kamu gambar bisa tinggal di desktop. Yang lebih ringkas lagi, ada skill resmi bernama hatch-pet: lempar beberapa gambar referensi ke sana, dan seluruh set animasinya ia gambarkan untukmu. Tulisan ini menjelaskan kedua jalur itu sampai tuntas, lalu ditutup dengan satu contoh nyata: dua meme kapibara, bagaimana menjadi pet yang benar-benar bisa berjalan.

Apakah ini cara resmi

Ya. hatch-pet tercatat di direktori curated (pilihan) pada repositori skill resmi OpenAI, openai/skills; spesifikasi kanvas pet, 9 baris status animasi, jumlah frame per baris, dan durasinya semua dipatok oleh berkas kontrak resmi. Satu hal yang perlu diperhatikan: repositori ini kini sudah ditandai bermigrasi, dan ekosistem skill yang baru ada di openai/plugins — tapi hatch-pet sendiri masih bisa dipasang dan dipakai di tempat lamanya.

Wujud seekor pet jauh lebih sederhana daripada dugaan kebanyakan orang — cuma dua berkas:

~/.codex/pets/id-pet-kamu/
├── pet.json          # metadata berisi 4 field
└── spritesheet.webp  # spritesheet 1536×1872 (PNG juga boleh)

Detail spesifikasinya (berapa frame per baris animasi, kotak mana yang wajib dikosongkan transparan) sudah kami rangkum jadi tabel rujukan cepat, lihat rincian spesifikasi spritesheet.

Jalur satu: hatch-pet, biar AI yang menggambar

Cocok buat yang menginginkan kesan gambar tangan yang halus dan sudah memakai Codex App. Syaratnya, di Codex sudah terpasang skill pembangkit gambar resmi ($imagegen, versi baru umumnya sudah bawaan).

1. Pasang: ketik $skill-installer hatch-pet di percakapan Codex, lalu mulai ulang Codex setelah selesai;
2. Sampaikan permintaan: cukup bilang "tolong tetaskan seekor pet ___ untukku". Boleh cuma deskripsi teks, boleh juga dilampiri gambar referensi — maskot perusahaanmu, sketsa tangan, bahkan foto hewan peliharaan. Gayanya bisa dipilih: pixel (piksel), plush (boneka bulu), clay (tanah liat), sticker (stiker), 3d-toy (mainan 3D), dan lain-lain; kalau tak ditentukan, ia menyimpulkannya sendiri;
3. Biarkan ia bekerja: hatch-pet membuat satu sosok acuan lebih dulu untuk kamu setujui, lalu menggambar 9 status animasi baris demi baris (diam, lari kiri-kanan, melambai, melompat, gagal, menunggu, bekerja, meninjau), menyusunnya otomatis jadi gambar besar 1536×1872, membuang latarnya jadi transparan, dan menjalankan skrip validasi;
4. Aktifkan: hasilnya langsung mendarat di ~/.codex/pets/ — tinggal pilih di pengaturan pet.

Pengalaman praktis soal gambar referensi: berikan 1-3 gambar sekaligus, dengan karakter tampak seluruh badan dan latar yang bersih — hasilnya paling bagus. Mintalah ia mempertahankan "wajah yang sama, palet warna yang sama" di semua baris gerakan — ini butir dengan bobot tertinggi dalam standar QA resmi.

Jalur dua: gambar frame demi frame lewat kode

Untuk kamu yang tak mau bertaruh pada gacha dan ingin kendali 100%. Seluruh 91 pet di situs ini dibuat secara prosedural dengan Python + Pillow: tubuhnya dirakit dari blok warna di kisi kecil, tiap frame diberi parameter sesuai statusnya, lalu semuanya disusun jadi gambar besar sesuai spesifikasi. Begitu satu mesin penggambar selesai ditulis, menambah pet baru cukup sepuluh baris konfigurasi. Alur lengkap dan rancangan jumlah frame-nya ada di bab bikin sendiri pada panduan.

Praktik: dua meme, satu pet desktop

Ada pembaca yang mengirim dua meme kapibara dan bertanya "yang begini bisa juga?". Bisa, dan justru inilah alur baku kustomisasi dari gambar. Cara kami tiga langkah:

1. Ambil cirinya, bukan jiplak gambarnya: yang diambil dari gambar referensi adalah daftar ciri — badan bulat warna teh susu, oval moncong gelap yang memakan separuh wajah, telinga bulat kecil, semburat pipi, postur rebahan yang malas secara menyeluruh, dan garis tepi cokelat hangat;
2. Gambar ulang berdasarkan ciri itu: pakai daftar tadi untuk menggambar kapibara orisinal di kisi piksel, lengkap 9 baris animasi (lompatannya pun ia lakukan dengan sungguh-sungguh, walau alirannya rebahan);
3. Lolos validasi resmi: jalankan validate_atlas.py dari repositori resmi untuk memeriksa ukuran, jumlah frame, dan transparansi — hijau semua baru dirilis.

Karya jadinya bernama Paka si Kapibara Rebahan; di halamannya kamu bisa langsung melihat 9 statusnya dan mengunduhnya gratis.

Lima titik yang paling sering bikin gagal

• Jumlah frame tiap baris berbeda: diam 6 frame, melambai 4 frame, melompat 5 frame, lari dan gagal 8 frame, sisanya 6 frame — kotak yang tergambar lebih harus transparan sepenuhnya, kalau tidak validasinya gagal;
• Lompatan jangan sampai keluar kotak: seluruh pet (termasuk telinga dan topi) harus utuh di dalam 192×208 pada setiap frame;
• Transparansi harus bersih: tak boleh menyisakan bayangan semi-transparan, bayangan tanah, atau garis kecepatan; piksel transparan juga tak boleh menyimpan sisa nilai RGB;
• Susunan folder: pet.json harus langsung berada di dalam pets/id-pet/ — satu lapis folder tambahan saat mengekstrak adalah penyebab paling umum dari "pet-nya tidak muncul";
• Baris working bukan berlari: secara resmi baris ini menggambarkan "fokus bekerja"; menggambarnya sebagai lari melangkah akan dinilai tidak lolos.

Tabel spesifikasi yang lebih lengkap (termasuk durasi putar resmi tiap baris) ada di sini.

Malas repot?

Situs ini sudah menyiapkan 91 ekor: katalog orisinal 50 ekor + seri inspirasi 41 ekor, semuanya lolos skrip validasi resmi, gratis diunduh, bebas dimodifikasi. Tiap halaman detail dilengkapi perintah pemasangan PowerShell satu baris — dalam 30 detik kapibara atau kucing siber sudah bisa tinggal di desktopmu.