# Starter Golf Mini 3D

SMA · Pemula · sesi 49–56

## Memakai starter

Ekstrak seluruh ZIP, Project Manager → Import → project.godot, lalu F5. Panah bergerak pada mode fisika; petunjuk kontrol khusus ada pada HUD. R membuat scene baru. Siapkan folder terpisah sebelum mengubah kode. Godot 4.x; contoh diperiksa dengan 4.4.1 Compatibility.

## Cakupan yang tersedia

Bola fisika, dua penghalang, satu impuls ketika tenang, sensor tujuan dengan batas kecepatan, dan reset. Arah bidik, kekuatan, batas lima pukulan, dan prioritas hasil dikembangkan siswa.

Starter adalah acuan struktur dan mekanik minimum, bukan proyek akhir yang memenuhi semua rubrik. Gunakan lab sesi untuk menguji konsep kecil. Siswa membangun integrasi dan keputusan sendiri sesuai tugas presentasi. Tidak ada build executable yang diklaim telah diuji oleh paket ini.

## Susunan node saat runtime

Node dibuat oleh world.gd dari bentuk dasar. Jalankan F6 lalu lihat Scene → Remote untuk menelusuri pohonnya. Untuk belajar konstruksi editor, buat scene siswa terpisah dan tambahkan node melalui tombol + sesuai fungsi helper di world.gd.

```text
Arena3D
  WorldEnvironment
  DirectionalLight3D
  Camera3D (current)
  StaticBody3D + CollisionShape3D (lantai)
  MeshInstance3D / CharacterBody3D / RigidBody3D (sesuai mode)
  CanvasLayer → Label (HUD)
```

## Cara membangun di editor

1. Buat root Node3D, simpan scene.
2. Tambahkan bentuk visual dan collision secara terpisah. Collider harus anak badan/area, bukan hanya mesh. Pada 3D, tambahkan kamera current dan lampu.
3. Tambahkan script pada node yang tepat. Implementasikan satu mekanik dari tugas sesi, uji, baru lanjut.
4. Hubungkan signal sekali lewat panel Node atau _ready. Label membaca model, bukan menjadi sumber keadaan.
5. Catat input, keadaan awal, harapan, aktual, perbaikan, dan batas pengujian.

## Urutan praktik

- Sesi 49: Lapangan golf dan collision. Susun lantai, dua penghalang StaticBody3D, bola RigidBody3D dan satu Area3D tujuan di permukaan
- Sesi 50: Arah bidik pada X-Z. Ubah sudut bidik terbatas lewat input kiri-kanan dan tampilkan panah; ubah sudut menjadi vektor arah ternormalisasi
- Sesi 51: Kekuatan dan pukulan. Terapkan satu impuls arah kali kekuatan hanya saat bola diam; hitung satu pukulan dan kunci tombol saat bola bergerak
- Sesi 52: Ambang diam yang stabil. Periksa kecepatan kecil selama durasi singkat sebelum membolehkan bidik lagi; tetapkan redaman dan batas waktu yang diuji
- Sesi 53: Tujuan dan kecepatan masuk. Area tujuan memeriksa bola serta batas kecepatannya; bola cepat harus lewat tanpa langsung dinyatakan menang
- Sesi 54: Batas lima pukulan. Periksa tujuan sebelum kalah; tembakan kelima tetap ditunggu sampai bola berhenti atau mencapai tujuan
- Sesi 55: Ulang dan variasi penghalang. Instance ulang lapangan; ubah satu posisi penghalang lalu uji lintasan dapat diselesaikan dengan lima pukulan
- Sesi 56: Presentasi: Golf Mini 3D. Penguji mengubah satu kekuatan atau penghalang; siswa menjelaskan arah, impuls dan status sebelum presentasi

## Kriteria proyek

- Arah bidik dibentuk pada bidang X-Z dan dinormalisasi
- Bola bergerak tidak menerima pukulan kedua
- Tujuan menolak objek lain dan bola yang terlalu cepat
- Pukulan kelima tetap dapat menang; ulang membuat bola serta skor baru

Sumber: https://docs.godotengine.org/en/stable/