1.6 Noslēguma projekts: Pong

Pong ir klasiska 1972. gada arkādes spēle. Divi spēlētāji vada vertikālas paddles un atsit bumbu pretiniekam. Pirmais ar 5 punktiem uzvar.

Šis projekts ir labs 1. tēmas noslēgumam, jo tajā ir maz objektu, bet tie pārbauda gandrīz visu pamatu: Scene Tree, atkārtoti lietojamas scēnas, Input Map, C++ klases, sadursmes, UI atjaunināšanu un spēles stāvokli. Pong nav izvēlēts tāpēc, ka tas ir vizuāli sarežģīts; tas ir izvēlēts tāpēc, ka kļūdas tajā ir viegli pamanāmas.

Spēles loģika tiek rakstīta C++. Godot editorā drīkst salikt scēnas un iestatīt resursus, bet paddle kustība, bumbas atlēkšana, punktu pieskaitīšana un uzvaras pārbaude jārealizē GDExtension klasēs.

C++ klases:

• Paddle - spēlētāja vadītā raķete ar ievades darbībām input_up un input_down.
• Ball - bumba ar ātrumu, sadursmju apstrādi un reset mehāniku.
• Game - punktu uzskaite, UI atjaunināšana, uzvaras noteikšana un raunda restartēšana.

class Game : public Node {
    GDCLASS(Game, Node)
private:
    int score_left = 0;
    int score_right = 0;
    Ball *ball = nullptr;
public:
    void _ready() override;
    void on_score(bool left_player);
    void reset_ball();
    void update_score_labels();
};

1. uzdevums - Iesildies ar gatavu piemēru

Šis ir īss iesildīšanās uzdevums. Nokopē sagatavi, ielīmē to pareizajā koda vietā un palaid. Šeit pietiek droši izmēģināt tēmu 1.6 Noslēguma projekts: Pong; detalizētu izpratni veidosi nākamajos uzdevumos.

Kopējamais piemērs vai sagatave: izmanto šo bloku kā starta punktu, nevis kā gala risinājumu.

class Game : public Node {
    GDCLASS(Game, Node)
private:
    int score_left = 0;
    int score_right = 0;
    Ball *ball = nullptr;
public:
    void _ready() override;
    void on_score(bool left_player);
    void reset_ball();
    void update_score_labels();
};

1. Atver darba failu vai rīku. C++ fragmentu ievieto atbilstošajā .cpp vai .hpp failā pie šīs stundas klases.
2. Nokopē visu piemēra bloku no šī uzdevuma un ielīmē to norādītajā vietā.
3. Palaid kodu tieši tādu, kāds tas ir, un pārliecinies, ka parādās rezultāts, izvade vai vismaz nav kļūdas paziņojuma.
4. Atrodi vienu drošu vietu, ko drīkst mainīt: tekstu, skaitli, krāsu, mainīgā vērtību vai testa ierakstu.
5. Maini tikai šo vienu vērtību un palaid kodu vēlreiz.
6. Salīdzini rezultātu pirms un pēc izmaiņas. Ja parādās kļūda, atcel pēdējo izmaiņu un palaid vēlreiz.
7. Turpini pie 2. uzdevuma tikai tad, kad šis mazais piemērs darbojas.

2. uzdevums - Ievieto algoritmu spēles projektā

Pievieno šīs stundas paņēmienu kā nelielu, strādājošu spēles mehānikas daļu.

1. Izvēlies vienu projekta vietu: spēlētāju, pretinieku, kameru, UI, datu glabāšanu, sadursmi vai līmeņa ģenerēšanu.
2. Nosauc klases, metodes un mainīgos pēc to lomas, piemēram, PlayerState, velocity, score vai update_ui().
3. Uzraksti metodi, kas nolasa stāvokli, veic vienu skaidru darbību un atgriež vai parāda rezultātu.
4. Izsauc šo metodi no piemērotas vietas: _ready(), _process(), _physics_process(), signāla apstrādātāja vai projekta palīgklases.
5. Pievieno vienu īsu komentāru pie sarežģītākās loģikas vietas.
6. Pārkompilē projektu un pārbaudi, ka editorā nav kļūdu.
7. Salabo pirmo atrasto kļūdu pirms pievieno nākamo mehānikas daļu.
8. Veic Git commit ar īsu tehnisku ziņu par pievienoto C++ funkcionalitāti.

3. uzdevums - Testē mehāniku un izdari secinājumu

Pārbaudi, vai C++ algoritms darbojas paredzami spēles vidē.

1. Izveido trīs testa scenārijus: parastu darbību, robežgadījumu un kļūdainu vai neērtu spēlētāja darbību.
2. Palaid parasto scenāriju un pārbaudi rezultātu spēles logā vai Godot konsolē.
3. Palaid robežgadījumu ar mazāko, lielāko, tukšo vai nulles vērtību, ko mehānika pieļauj.
4. Palaid kļūdaino scenāriju un pārbaudi, vai projekts neavarē.
5. Izlabo vienu konkrētu problēmu C++ kodā, node sasaistē vai datu inicializācijā.
6. Pārkompilē un pārbaudi labojumu vēlreiz ar visiem trim scenārijiem.
7. Beigās pieraksti vienu secinājumu: kura metode, klase vai algoritma solis vislabāk palīdzēja saprast tēmu 1.6 Noslēguma projekts: Pong.

Papildu uzdevums - Pievieno mazu mehāniku

Ja pamatdarbs ir pabeigts, paplašini spēli ar vienu nelielu C++ uzlabojumu.

1. Izvēlies vienu mazu papildinājumu, kas izmanto to pašu šīs stundas paņēmienu.
2. Pievieno vienu jaunu atribūtu, metodi, signāla apstrādi, datu elementu vai UI atjauninājumu.
3. Savieno papildinājumu ar esošo scēnu vai klasi, nevis atstāj to atsevišķā demonstrācijā.
4. Pārkompilē un pārliecinies, ka pamatmehānika joprojām darbojas.
5. Saglabā izmaiņas ar Git commit tikai pēc veiksmīgas pārbaudes.

• Izveido AIPaddle : public Paddle, kas seko bumbai tikai tad, kad bumba kustas tā virzienā.
• Pievieno skaņas efektu paddle sadursmei un punktam, bet skaņas palaišanu izsauc no C++.
• Pievieno pauzes režīmu ar bool paused, kas aptur bumbas un paddle kustību.

• Bumba iziet cauri paddle: Speed pārāk augsts; lieto move_and_collide nevis set_position.
• Punkti netiek atjaunināti: Pārliecinies par get_node<Label>("ScoreLeft") references.
• Build neizmainās: Izdzēs .sconsign.dblite un kompilē no jauna.