WEPPY

Panduan Aset & Efek Objek

Alur kerja penyisipan aset, tween, audio, partikel, fisika, dan lingkungan (lighting·terrain).

Bangun dunia game dengan penyisipan aset, animasi tween, audio, efek partikel, grup tabrakan fisika, lighting·terrain·kueri spasial·kamera.

Aset & Efek Objek

Alat yang Disertakan

AlatDeskripsi
manage_assetsCari Creator Store, sisipkan model/paket, info aset
manage_tweenBuat, putar, jeda, batalkan tween
manage_animationMuat, putar, hentikan animasi, kueri track
manage_audioPutar/hentikan/jeda suara, atur audio listener
manage_effectsEmisi partikel, reset, toggle
manage_physicsDaftarkan grup tabrakan, atur kemampuan tabrakan

Alur Kerja Utama

Susun Scene dengan Aset

"Cari model 'pohon' di Creator Store dan tempatkan 3 buah di Workspace"

Tangani pencarian dan penyisipan sekaligus dengan search_insert pada manage_assets.

Efek Interaktif

"Buat tween yang membuka pintu dalam 3 detik saat diklik"

Definisikan tween dengan create pada manage_tween dan putar dengan play. Sekaligus tambahkan efek suara membuka pintu dengan play pada manage_audio.

Kombinasi Partikel + Suara

"Putar partikel ledakan beserta efek suara saat bos muncul"

Emisi partikel dengan emit pada manage_effects dan putar suara secara bersamaan dengan play pada manage_audio.

Referensi Aksi

Manage Assets

AksiDeskripsi
insertSisipkan model dengan ID aset
infoAmbil metadata aset
searchCari Creator Store
search_insertCari dan sisipkan item yang pertama cocok
insert_freeSisipkan model gratis
insert_packageSisipkan paket
exportEkspor seleksi saat ini

Manage Tween

AksiDeskripsi
createBuat tween dengan properti target
playPutar tween yang dibuat
pauseJeda tween yang berjalan
cancelBatalkan tween

Manage Animation

AksiDeskripsi
loadMuat animasi ke Humanoid/AnimationController
playPutar track animasi yang dimuat
stopHentikan animasi yang diputar
get_tracksDaftarkan semua track animasi yang dimuat

Manage Audio

AksiDeskripsi
playPutar suara (buat Sound jika perlu)
stopHentikan suara yang diputar
pauseJeda suara yang diputar
resumeLanjutkan suara yang dijeda
set_listenerAtur tipe/target audio listener

Manage Effects

AksiDeskripsi
emitEmisi partikel dari ParticleEmitter
clearReset semua partikel
toggleAktifkan atau nonaktifkan efek

Manage Physics

AksiDeskripsi
register_groupDaftarkan grup tabrakan
set_collidableAtur apakah dua grup dapat bertabrakan
get_groupsDaftarkan semua grup tabrakan yang terdaftar

Lingkungan Dunia

Alat yang Disertakan

AlatDeskripsi
manage_lightingAtur Lighting, Atmosphere, Sky, zona waktu
manage_terrainBuat/modifikasi terrain, kelola data voxel
spatial_queryRaycast, temukan tanah, validasi penempatan, heightmap
manage_cameraKueri info kamera, pindahkan fokus, tampilan yang disarankan, screenshot viewport mode Edit

Alur Kerja Utama

Atur Suasana Dunia

"Ubah suasana menjadi senja. Langit oranye, tingkatkan kepadatan kabut, atur zona waktu ke jam 18"

Atur zona waktu dengan time pada manage_lighting, sesuaikan kabut dengan atmosphere, dan ubah warna langit dengan sky.

Pembangunan Terrain

"Buat bukit rumput dengan radius 200 di tengah peta dan isi air di sekitarnya"

Buat bukit dengan fill_ball pada manage_terrain dan isi area air di sekitarnya dengan fill_block.

Validasi Penempatan

"Temukan tanah datar untuk meletakkan bangunan ini"

Temukan lokasi yang sesuai dengan find_flat pada spatial_query, verifikasi apakah ada tabrakan dengan check_placement, lalu konfirmasi hasil secara visual dengan focus_position pada manage_camera.

Referensi Aksi

Manage Lighting

AksiDeskripsi
lightingAtur properti layanan Lighting
atmosphereAtur properti Atmosphere
skyAtur properti Sky
terrain_propsAtur properti air/visual Terrain
timeAtur zona waktu

Manage Terrain

AksiDeskripsi
fill_blockIsi terrain berbentuk blok
fill_ballIsi terrain berbentuk bola
fill_cylinderIsi terrain berbentuk silinder
fill_wedgeIsi terrain berbentuk baji
clear_regionReset terrain di area
clear_boundsReset terrain di batas
replace_materialGanti material di area
colors_getAmbil warna material
colors_setAtur warna material
read_voxelBaca data voxel tunggal
read_voxelsBaca data voxel massal
write_voxelsTulis data voxel massal
generateBuat terrain prosedural
smoothHaluskan terrain

Spatial Query

AksiDeskripsi
raycastProyeksikan satu sinar
find_groundTemukan posisi tanah di bawah titik
check_placementVerifikasi apakah penempatan bebas tabrakan
multi_raycastProyeksikan beberapa sinar sekaligus
scan_areaBuat heightmap area
find_flatTemukan area datar untuk pembangunan
find_spawnTemukan posisi spawn yang sesuai
analyze_walkableAnalisis grid area yang dapat dilalui
spatial_mapAmbil posisi semua BasePart
find_spaceTemukan ruang kosong untuk objek
boundsAmbil bounding box instans
snap_gridSnap posisi ke grid
collisionPeriksa tabrakan AABB

Manage Camera (Campuran)

AksiDeskripsi
infoAmbil posisi, rotasi, FOV, ukuran viewport kamera
focus_pathPindahkan fokus kamera ke instans
focus_positionPindahkan fokus kamera ke posisi
suggestAmbil tampilan kamera yang disarankan untuk target
screenshotTangkap viewport mode Edit Studio saat ini sebagai gambar PNG (hanya mode Edit)