Featured image of post 第9回-完成!ローグライク通知システム - Perlでローグライク通知システムを作ろう

第9回-完成!ローグライク通知システム - Perlでローグライク通知システムを作ろう

全機能を統合してローグライク通知システムを完成!対話的なCLIでダンジョン探索を体験。実績、サウンド、統計が連動する様子を確認。

@nqounetです。

「Perlでローグライク通知システムを作ろう」シリーズの第9回です。前回は、開放閉鎖原則(OCP)を実践して統計システムを追加しました。今回は、すべての機能を統合してローグライク通知システムを完成させます。

前回の振り返り

前回は、既存コードを変更せずにStatisticsObserverを追加することで、開放閉鎖原則を体感しました。

これまでに作った機能

シリーズを通して、以下の機能を作成してきました。

機能役割
第1回GameEventイベントを表現
第3回LogObserverログ出力
第3回AchievementObserver実績管理
第4回GameEventObserverObserver共通インターフェース
第4回SoundObserverサウンドエフェクト
第5回GameEventEmitterイベント発生元
第8回StatisticsObserver統計記録

対話的なCLIを作成する

これらを統合して、対話的なCLIでダンジョン探索ができるシステムを作りましょう。

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
#!/usr/bin/env perl
# 言語: perl
# バージョン: 5.36以上
# 依存: Moo(cpanmでインストール)

use v5.36;

# ===================================
# イベントクラス
# ===================================
package GameEvent {
    use Moo;
    use v5.36;

    has 'type' => (
        is       => 'ro',
        required => 1,
    );

    has 'message' => (
        is       => 'ro',
        required => 1,
    );

    has 'data' => (
        is      => 'ro',
        default => sub { {} },
    );
}

# ===================================
# Observerインターフェース
# ===================================
package GameEventObserver {
    use Moo::Role;
    use v5.36;

    requires 'update';
}

# ===================================
# 各Observer実装
# ===================================
package LogObserver {
    use Moo;
    use v5.36;

    with 'GameEventObserver';

    sub update ($self, $event) {
        say "[LOG] " . $event->message;
    }
}

package AchievementObserver {
    use Moo;
    use v5.36;

    with 'GameEventObserver';

    has 'unlocked' => (
        is      => 'ro',
        default => sub { [] },
    );

    has 'defeated_count' => (
        is      => 'rw',
        default => 0,
    );

    has 'item_count' => (
        is      => 'rw',
        default => 0,
    );

    sub update ($self, $event) {
        my $type = $event->type;

        if ($type eq 'enemy_defeated') {
            my $count = $self->defeated_count + 1;
            $self->defeated_count($count);

            $self->_check_achievement($count, 1, 'はじめての勝利');
            $self->_check_achievement($count, 5, 'ハンター見習い');
            $self->_check_achievement($count, 10, 'ハンター');
        }
        elsif ($type eq 'item_acquired') {
            my $count = $self->item_count + 1;
            $self->item_count($count);

            $self->_check_achievement($count, 1, 'コレクター見習い');
            $self->_check_achievement($count, 5, 'コレクター');
        }
        elsif ($type eq 'level_up') {
            my $level = $event->data->{level} // 0;
            $self->_check_achievement($level, 3, '成長中');
            $self->_check_achievement($level, 5, '一人前');
        }
    }

    sub _check_achievement ($self, $current, $target, $name) {
        if ($current == $target) {
            push @{$self->unlocked}, $name;
            say "[ACHIEVEMENT] ★ 実績解除: $name ★";
        }
    }

    sub show_achievements ($self) {
        if (@{$self->unlocked}) {
            say "";
            say "☆ 解除した実績 ☆";
            say "  - $_" for @{$self->unlocked};
        } else {
            say "";
            say "まだ実績を解除していません";
        }
    }
}

package SoundObserver {
    use Moo;
    use v5.36;

    with 'GameEventObserver';

    has 'enabled' => (
        is      => 'rw',
        default => 1,
    );

    has 'sound_map' => (
        is      => 'ro',
        default => sub {{
            enemy_defeated => '♪ ジャン!',
            item_acquired  => '♪ キラリン!',
            level_up       => '♪ ファンファーレ!',
        }},
    );

    sub update ($self, $event) {
        return unless $self->enabled;

        my $type = $event->type;
        my $sound = $self->sound_map->{$type};

        if ($sound) {
            say "[SOUND] $sound";
        }
    }
}

package StatisticsObserver {
    use Moo;
    use v5.36;

    with 'GameEventObserver';

    has 'stats' => (
        is      => 'ro',
        default => sub {{
            enemy_defeated => 0,
            item_acquired  => 0,
            level_up       => 0,
        }},
    );

    sub update ($self, $event) {
        my $type = $event->type;

        if (exists $self->stats->{$type}) {
            $self->stats->{$type}++;
        }
    }

    sub show_stats ($self) {
        say "";
        say "┌─────────────────────┐";
        say "│    探索統計         │";
        say "├─────────────────────┤";
        say "│ 敵撃破数:     " . sprintf("%5d", $self->stats->{enemy_defeated}) . " │";
        say "│ アイテム取得: " . sprintf("%5d", $self->stats->{item_acquired}) . " │";
        say "│ レベルアップ: " . sprintf("%5d", $self->stats->{level_up}) . " │";
        say "└─────────────────────┘";
    }
}

# ===================================
# イベントエミッター
# ===================================
package GameEventEmitter {
    use Moo;
    use v5.36;

    has 'observers' => (
        is      => 'ro',
        default => sub { [] },
    );

    sub attach ($self, $observer) {
        unless ($observer->does('GameEventObserver')) {
            die "Error: ObserverはGameEventObserverを実装している必要があります";
        }
        push @{$self->observers}, $observer;
    }

    sub detach ($self, $observer) {
        @{$self->observers} = grep { $_ != $observer } @{$self->observers};
    }

    sub notify ($self, $event) {
        for my $observer (@{$self->observers}) {
            $observer->update($event);
        }
    }
}

# ===================================
# ゲームメインクラス
# ===================================
package DungeonGame {
    use Moo;
    use v5.36;

    has 'emitter' => (
        is      => 'ro',
        default => sub { GameEventEmitter->new() },
    );

    has 'log_observer' => (
        is      => 'ro',
        default => sub { LogObserver->new() },
    );

    has 'achievement_observer' => (
        is      => 'ro',
        default => sub { AchievementObserver->new() },
    );

    has 'sound_observer' => (
        is      => 'ro',
        default => sub { SoundObserver->new() },
    );

    has 'statistics_observer' => (
        is      => 'ro',
        default => sub { StatisticsObserver->new() },
    );

    has 'player_level' => (
        is      => 'rw',
        default => 1,
    );

    has 'enemies' => (
        is      => 'ro',
        default => sub { ['スライム', 'ゴブリン', 'オーク', 'トロル', 'ドラゴン'] },
    );

    has 'items' => (
        is      => 'ro',
        default => sub { ['薬草', 'ポーション', '宝箱', '魔法の剣', '古代の鍵'] },
    );

    sub BUILD ($self, $args) {
        $self->emitter->attach($self->log_observer);
        $self->emitter->attach($self->achievement_observer);
        $self->emitter->attach($self->sound_observer);
        $self->emitter->attach($self->statistics_observer);
    }

    sub defeat_random_enemy ($self) {
        my @enemies = @{$self->enemies};
        my $enemy = $enemies[rand @enemies];

        my $event = GameEvent->new(
            type    => 'enemy_defeated',
            message => "${enemy}を倒した!",
        );
        $self->emitter->notify($event);

        # たまにレベルアップ
        if (rand() < 0.3) {
            $self->level_up();
        }
    }

    sub find_random_item ($self) {
        my @items = @{$self->items};
        my $item = $items[rand @items];

        my $event = GameEvent->new(
            type    => 'item_acquired',
            message => "${item}を手に入れた!",
        );
        $self->emitter->notify($event);
    }

    sub level_up ($self) {
        my $new_level = $self->player_level + 1;
        $self->player_level($new_level);

        my $event = GameEvent->new(
            type    => 'level_up',
            message => "レベルが${new_level}になった!",
            data    => { level => $new_level },
        );
        $self->emitter->notify($event);
    }

    sub toggle_sound ($self) {
        my $current = $self->sound_observer->enabled;
        $self->sound_observer->enabled(!$current);
        say $current ? "[SETTINGS] サウンドをOFFにしました" : "[SETTINGS] サウンドをONにしました";
    }

    sub show_results ($self) {
        $self->statistics_observer->show_stats();
        $self->achievement_observer->show_achievements();
    }
}

# ===================================
# メイン処理
# ===================================
package main {
    use v5.36;

    say "╔═══════════════════════════════════════════╗";
    say "║   ローグライク・ダンジョン探索ゲーム      ║";
    say "║   〜通知システムデモ〜                    ║";
    say "╚═══════════════════════════════════════════╝";
    say "";
    say "コマンド:";
    say "  1: 敵を倒す";
    say "  2: アイテムを探す";
    say "  3: サウンドON/OFF";
    say "  4: 結果を表示";
    say "  q: 終了";
    say "";

    my $game = DungeonGame->new();

    while (1) {
        print "> ";
        my $input = <STDIN>;
        chomp $input;

        if ($input eq '1') {
            $game->defeat_random_enemy();
        }
        elsif ($input eq '2') {
            $game->find_random_item();
        }
        elsif ($input eq '3') {
            $game->toggle_sound();
        }
        elsif ($input eq '4') {
            $game->show_results();
        }
        elsif ($input eq 'q') {
            say "";
            say "=== ゲーム終了 ===";
            $game->show_results();
            last;
        }
        else {
            say "不明なコマンド: $input";
        }

        say "";
    }
}

実行例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
╔═══════════════════════════════════════════╗
║   ローグライク・ダンジョン探索ゲーム      ║
║   〜通知システムデモ〜                    ║
╚═══════════════════════════════════════════╝

コマンド:
  1: 敵を倒す
  2: アイテムを探す
  3: サウンドON/OFF
  4: 結果を表示
  q: 終了

> 1
[LOG] スライムを倒した!
[ACHIEVEMENT] ★ 実績解除: はじめての勝利 ★
[SOUND] ♪ ジャン!

> 2
[LOG] 薬草を手に入れた!
[ACHIEVEMENT] ★ 実績解除: コレクター見習い ★
[SOUND] ♪ キラリン!

> 3
[SETTINGS] サウンドをOFFにしました

> 1
[LOG] ゴブリンを倒した!

> q

=== ゲーム終了 ===

┌─────────────────────┐
│    探索統計         │
├─────────────────────┤
│ 敵撃破数:         2 │
│ アイテム取得:     1 │
│ レベルアップ:     0 │
└─────────────────────┘

☆ 解除した実績 ☆
  - はじめての勝利
  - コレクター見習い

完成したシステムの構造

	graph TB
    subgraph "イベント発生"
        G[DungeonGame] --> E[GameEvent]
    end

    subgraph "通知システム"
        E --> EM[GameEventEmitter]
        EM --> L[LogObserver]
        EM --> A[AchievementObserver]
        EM --> S[SoundObserver]
        EM --> ST[StatisticsObserver]
    end

    subgraph "出力"
        L --> CL[コンソールログ]
        A --> AC[実績解除通知]
        S --> SE[サウンドエフェクト]
        ST --> SS[統計データ]
    end

今回のまとめ

今回は、これまでに作成した全機能を統合してローグライク通知システムを完成させました。

  • 対話的なCLIで操作可能
  • 敵討伐、アイテム取得、レベルアップイベント
  • ログ、実績、サウンド、統計が連動

次回予告

次回は最終回「これがObserverパターンだ!」です。作ってきたシステムの正体を明かし、デザインパターンの世界へ誘います。

comments powered by Disqus
Hugo で構築されています。
テーマ StackJimmy によって設計されています。