Blueprint Koleksi

KURV berjalan di Base Sepolia dan Solana Devnet hari ini. Halaman ini adalah panduan lapangan dari satu build nyata yang selesai (HANI the Dog, 1,000 karya, 20 karya unik), ditulis untuk kreator yang bekerja bersama agen AI lewat konektor KURV di https://mcp.kurv.fun/mcp. Konektor menyajikan panduan yang sama kepada agen sebagai resource kurv://blueprint, dan alat kurv_builder_spec adalah sumber kebenarannya: jika halaman ini dan alat itu berbeda, percayai alatnya.

Hubungkan agen

1. Tambahkan https://mcp.kurv.fun/mcp sebagai server MCP jarak jauh di klien yang mendukung MCP jarak jauh dengan OAuth. Hubungkan agen dengan MCP mendaftar klien dan langkah-langkahnya.
2. Masuk ke KURV di browser dan setujui koneksinya. Kamu memilih apa yang boleh dilakukannya (hanya baca; baca dan draf; atau baca, draf, dan persiapan peluncuran) dan berapa lama berlakunya.
3. Minta agen membaca kurv://blueprint, lalu memanggil kurv_account dan kurv_builder_spec untuk jaringanmu. Konektor juga menawarkan prompt build-kurv-collection, yang menuntun agen menyusuri halaman ini dengan setiap titik henti persetujuan tetap ada.

Siapa mengerjakan apa

Agen merencanakan, memvalidasi, membuat draf, mengunggah karya, melihat pratinjau, dan menyiapkan peluncuran. Kamu menyetujui karya, sampel, dan setiap peringatan, lalu membuka tautan peninjauan dan menandatangani peluncuran dengan dompetmu sendiri. Agen tidak pernah men-deploy, tidak pernah menandatangani, dan tidak pernah meminta kunci privat atau seed phrase. Setelah karya selesai dan disetujui, sisi KURV (validasi, buat, unggah, pratinjau, siapkan) memakan waktu sekitar 20 menit. Membuat karya yang bagus memakan waktu lebih lama, dan memang seharusnya begitu.

Batasnya

Hal	Batas
Ukuran koleksi	1 sampai 1,000 karya, termasuk karya unik: 980 karya acak dan 20 karya unik berarti ukuran 1,000.
Layer	Paling banyak 12.
Gambar trait	Paling banyak 240 total di semua layer, termasuk karya yang hanya dipakai karya unik. Layer kosong tidak memakan jatah.
Karya unik	Paling banyak 32.
Aturan	Paling banyak 48, sama di setiap jaringan.
Ukuran berkas gambar	Paling besar 2 MiB per gambar yang dikirim satu per satu; paling besar 20 MiB untuk satu gambar di dalam zip.
Kanvas	Persegi, paling besar 2,048 kali 2,048 piksel. Setiap berkas tepat seukuran kanvas.
Format	Latar: PNG, JPEG, atau WebP. Setiap layer lain: PNG dengan transparansi sungguhan.
Nama None	Dicadangkan dalam kapitalisasi apa pun. Jangan pernah membuat trait bernama None atau gambar kosong: layer menjadi opsional lewat noneWeight.
Deskripsi	Anggap wajib: 1 sampai 2,000 karakter. Ia masuk ke metadata setiap karya.
Draf	20 aktif per akun. kurv_archive_draft membebaskan satu slot seketika; karya draf yang diarsipkan disimpan 30 hari lalu dihapus.
Pratinjau	Paling banyak 9 sampel acak per panggilan, atau paling banyak 9 nomor karya pilihan, pada 64 sampai 512 piksel.

Agen membaca validCombinations setelah setiap validasi: berapa banyak karya berbeda yang diizinkan layer dan aturan. Jumlahnya dihitung tepat untuk ruang sampai sekitar 50 juta kombinasi dan ditandai sebagai perkiraan di atas itu. Jaga agar tetap jauh di atas ukuran koleksi.

Jalannya, langkah demi langkah

Langkah bertanda Persetujuan berarti: agen berhenti dan menunggu “ya” yang tegas darimu.

1. Foto. Kumpulkan 3 sampai 10 foto tajam hewan atau karakter aslinya: wajah, mata, gigi dan mulut, corak, telinga. Pilih satu foto utama dengan wajah dalam sudut tiga perempat.
2. Arah seni. Satu gaya, satu pose (tiga perempat paling cocok), satu kanvas persegi (2,048 kali 2,048 dianjurkan), satu lembar gaya singkat: garis, bayangan, palet, suasana. Persetujuan: karakter induk, sebelum trait apa pun dibuat.
3. Dasar induk. Karakter dalam pose akhirnya di atas latar polos satu warna, di tengah, seukuran penuh kanvas, langsung dikenali sebagai hewan aslinya. Setiap trait adalah suntingan dari induk ini, dengan pose, skala, dan bingkai yang sama.
4. Layer. Layer dilukis dari bawah ke atas: Background, Skin (layer dasar), Collar, Teeth, Eyes, Headwear (opsional). Sekitar enam layer; karakterlah yang membawa koleksi, bukan propertinya. Agen menamai layer dasar di base_layer dan memberi setiap layer kotak jangkar tempat trait-nya harus berada.
5. Trait. Setiap trait adalah suntingan salinan induk, dipotong sehingga hanya piksel trait itu sendiri yang terlihat dan selebihnya transparan. Membuat trait di atas salinan tubuh berwarna polos menjauhkan bulu darinya. Trait yang melenceng posisi atau skalanya ditolak.
6. Karya unik. Tubuh yang berubah seluruhnya (berlian, krom, lava, perunggu), masing-masing dengan latar yang serasi dan tanpa kalung. Karyanya masuk ke layer-nya sebagai trait dengan bobot 0, sehingga tidak pernah muncul di karya acak; ia terhitung dalam 240 gambar.
7. Aturan. Lembar kontak setiap kulit dengan setiap trait kalung, gigi, mata, dan penutup kepala. Setiap pasangan buruk (terpotong, tak terlihat, jelek) menjadi aturan pengecualian berkelompok dengan catatan yang menjelaskan alasannya.
8. Persetujuan: lembar layer, sedikitnya 9 sampel komposit, lembar karya unik, konfigurasi, dan ketentuan penjualan, sebelum draf dibuat.
9. Konfigurasi dan validasi. kurv_builder_spec dengan jaringan, lalu kurv_validate_collection dengan konfigurasi sampai daftar issues-nya tidak lagi memuat kesalahan. Peringatan menyebut apa yang perlu kamu dengar. Jawabannya membawa required_assets, kunci persis yang harus diunggah, dan validCombinations.
10. Draf. kurv_create_collection dengan version: 3, jaringan, konfigurasi, ketentuan penjualan, dan kunci idempotensi, pertama dengan check_only bernilai true, lalu sungguhan. Panggilan yang gagal diulang dengan kunci yang sama. Ketentuan penjualan punya satu bentuk di setiap jaringan: lihat Ketentuan penjualan.
11. Karya. Satu per satu dengan kurv_upload_trait (latar, dasar, dan satu trait per layer dulu, lalu pratinjau, lalu sisanya), atau sekaligus dalam format folder web lewat kurv_upload_collection_zip. Layer kosong adalah noneWeight, bukan PNG transparan.
12. Periksa dan pratinjau. kurv_validate_collection dengan draf menjalankan pemeriksaan karya. kurv_preview_collection dengan 9 sampel setelah unggahan terakhir, plus nomor karya setiap karya unik dan kombinasi paling berisiko. Agen melihat setiap gambar. Pratinjau pertama yang lama menjawab retry_after dan sampel yang tertunda; agen memanggil lagi.
13. Perbaikan tanpa draf baru. kurv_update_collection mengubah aturan, karya unik, bobot, petunjuk, atau deskripsi di tempat; kanvas tidak bisa berubah. kurv_replace_trait_image menukar satu gambar, kurv_rename_trait mengganti nama trait dan memperbarui aturan serta karya uniknya, kurv_delete_trait menghapus trait yang tidak dirujuk apa pun. Lalu pratinjau baru.
14. Persetujuan: sampel akhir dan setiap peringatan, dibacakan kepadamu.
15. Siapkan. kurv_prepare_launch dengan draf. Pada warnings_need_review agen menjelaskan setiap peringatan; hanya setelah kamu menerima, ia memanggil lagi dengan acknowledge_warnings bernilai true. Kamu mendapat tautan browser.
16. Kamu yang menandatangani. Buka satu tautan itu, periksa isinya, pilih Publikasikan dan luncurkan, dan tanda tangani dengan dompetmu sendiri di langkah terakhir. Tiap jawaban hanya satu Kembali. Tidak ada alat yang menandatangani untukmu.

Aturan

Aturan menjaga trait dua layer terpisah atau bersama: {"type", "when", "target", "note"}, dengan type berupa exclude atau require, dan when serta target masing-masing menyebut satu layer dan, opsional, satu trait: satu nama atau daftar nama. Tanpa trait berarti seluruh layer, dan when serta target harus layer yang berbeda. Kuncinya trait: aturan yang ditulis dengan traits ditolak dengan kunci yang benar disebutkan, alih-alih diam-diam berlaku untuk seluruh layer. None hanya bisa mewakili layer kosong jika layer itu memiliki noneWeight di atas 0. Kelompokkan pasangan ke dalam daftar agar tetap di bawah 48: satu aturan per kelompok kulit, mendaftar setiap kalung yang tak boleh mereka pakai.

{"type": "exclude", "note": "Thick fur hides these collars", "when": {"layer": "Skin", "trait": ["Lion Mane", "Fire Fur"]}, "target": {"layer": "Collar", "trait": ["Bow Tie", "Name Tag"]}}

Aturan sampai ke karya: mesin yang sama menghasilkan pratinjau dan berkas yang diterbitkan, dan minting membagikan berkas itu. Karya unik bisa melewati aturan dengan ignoreRules bernilai true; keunikan tetap berlaku.

Karya unik

Karya unik adalah specials: sebuah nama, setiap layer dengan trait-nya atau None, nomor karya terpasang yang opsional, dan deskripsi opsional. Karya unik yang melewatkan satu layer mendapat layer itu secara acak, dan validasi memperingatkan layer mana saja. null ditolak, begitu pula nama trait yang tidak ada.

{"name": "Diamond Grail", "tokenId": 1, "traits": {"Background": "Diamond Vault", "Skin": "Pave Diamond", "Collar": "None", "Teeth": "Diamond Grill", "Eyes": "None"}}

Karya yang diinginkan orang

• Karya yang digarap serius dan dipoles. Tanpa tampilan datar, keruh, atau jelas buatan mesin.
• Latar yang kuat: warna berani atau adegan kaya. Hindari tema tempat (kota, pantai) kecuali memang disengaja.
• Pose tiga perempat dan kemiripan yang bisa dikenali dari hewan aslinya: corak, warna mata, bentuk telinga.
• Trait berani yang pas di tubuh karakter, digambar di atas bentuk induknya. Gigi pas persis dengan mulut.
• Tidak ada penutup kepala yang melayang. Topi duduk di kepala dengan bayangan sentuh; telinga besar keluar di atas pinggirannya.
• Pakaian biasanya tidak pas di hewan. Pilih kalung, rantai, dan hiasan leher, dan coba di setiap kulit.
• Karya unik premium berubah seluruhnya, dengan latar serasi dan tanpa kalung.

Konektor memeriksa karya saat tiba. Kesalahan menolak unggahan: ukuran kanvas yang berbeda, layer di atas latar yang bukan PNG dengan transparansi, gambar tanpa piksel yang terlihat. Peringatan kembali untuk kamu tinjau: trait di luar jangkarnya, trait dengan skala berbeda dari layer-nya, trait yang keluar dari kisi piksel dasar, trait yang masih membawa gambar dasar seluruhnya atau sebagian, trait yang menutupi seluruh kanvas. Satu peringatan bisa keliru: mata alami di layer yang sama dengan kacamata hitam memang sengaja berbeda ukuran. Agen memasang mixedScales pada layer itu, atau acknowledge pada trait-nya setelah kamu setuju, dan karya tetap seperti seharusnya.

Apa yang dibaca balik oleh agen

Setiap alat yang memvalidasi menjawab semua masalah sekaligus dalam satu daftar issues, masing-masing dengan jalur, kode, tingkat keparahan, pesan, dan perbaikan. Kunci yang tak dikenal ditolak dengan nama berikut kunci sah terdekat. Jaringan disebut dengan nama (base-sepolia, solana-devnet, solana-localnet), dan draf tanpa jaringan memakai Base Sepolia dan mengatakannya. Metode penjualan memakai nama di situs web (fixed, mystery, rising, falling, auction): lewat konektor Base menawarkan fixed, mystery, dan rising, Solana menawarkan fixed dan rising, sedangkan penjualan falling dan auction diatur di situs web. Kolom penjualan yang tidak dimiliki jaringan, seperti simbol di Solana, ditolak dengan namanya. Metadata dibuktikan lewat pengujian: setiap karya mematuhi aturan, karya unik mendarat pada karya tempat ia dipasang, dan layer kosong ditulis sebagai {"trait_type": "<layer>", "value": "None"}.

Karya jadi

Karya yang sudah ada sebagai gambar jadi melewati layer: kurv_finished_art_limits, lalu kurv_upload_finished_file_part untuk setiap gambar dan metadata.json, lalu kurv_import_finished_collection. Byte disimpan apa adanya, termasuk animasi, dan batas berlapis tidak berlaku; batas penerbitan situs web saat ini yang berlaku. Karya jadi menjelaskan berkasnya.

Batas yang diketahui dari build ini

• Nilai penjualan Solana versi 2 diperiksa oleh parser aplikasi sendiri setelah kuncinya, satu per satu; penjualan versi 3 menjawab semua masalah sekaligus.
• Draf karya jadi tidak bisa disunting di tempat; perbaikan berarti unggahan baru dan kunci baru.
• Draf yang diarsipkan tidak bisa dipulihkan lewat konektor; karyanya disimpan 30 hari.
• Robinhood Chain tidak tersedia lewat konektor: tidak ada konfigurasi jaringan dan tidak ada skema penjualan. Ia datang setelah peluncuran Base dan Solana.

Angka koleksi adalah potret sesaat dan peluncuran memindahkan nilai sungguhan di jaringannya; baca Risiko dan penafian sebelum menasihati siapa pun soal uang.