技術資料: ダンジョンRPGゲーム設計と実装

2024年11月7日

1. 1. 概要
2. 2. 設計方針
3. 3. クラス構造
4. 4. レビュー
- 4.1. 良い点
- 4.2. 改善提案
5. 5. サンプルコード
6. 6. 実装ガイドライン
7. 7. 今後の課題

1. 概要

この資料では、RPG風のダンジョンゲームのオブジェクト指向設計について説明します。ゲーム内では、プレイヤーがダンジョンを探検し、アイテムを使用して敵と戦います。この設計は、拡張性、保守性、および管理のしやすさを考慮して構築されています。

2. 設計方針

オブジェクト指向設計: クラスとインターフェースを使用して、ゲーム要素を分離し、再利用性と拡張性を確保します。
責任の分離: 各クラスが単一の責任を持つように設計されており、各コンポーネントが明確に分けられています。

3. クラス構造

3.1 インターフェース

I_Element
- ゲーム内要素の基本的な識別子 (id) を提供するインターフェースです。
I_Enemy
- 敵キャラクターの動作 (Move, Attack, Ability) を定義します。
I_Trap
- トラップの能力 (Ability) を定義します。
I_Item
- アイテムの共通プロパティ (id, sellPrice, buyPrice) とメソッド (Ability) を定義します。

3.2 列挙型

FoodType
- アイテムの食べ物の種類 (例: Onigiri, Grass) を定義します。
EquipmentType
- 装備の種類 (例: Sword, Shield, Accessory, Wand, Rock, Bow) を定義します。

3.3 クラス

Gameクラス

概要: ゲーム全体を管理するクラスです。
プロパティ
- ItemList: ゲーム内のアイテムのリスト
- EnemyList: ゲーム内の敵のリスト
役割: ゲームの初期化と要素の管理を行います。

Dungeonクラス

概要: ダンジョンの構造と生成を管理します。
メソッド
- GenerateMap(): マップを生成する
- GenerateTrap(): トラップを生成する
- GenerateEnemy(): 敵を生成する
関連: Floor クラスと 1対1 の関連があります。

Floorクラス

概要: ダンジョンのフロアを表現します。
プロパティ
- Level: フロアのレベル
- Map: マップオブジェクト
役割: フロアの管理を行います。

Mapクラス

概要: フロアのマップを管理します。
プロパティ
- MapX, MapY: マップのサイズ
- MapArray: マップデータの配列
役割: マップの生成と情報の保持を行います。

Playerクラス

概要: プレイヤーの動作とアイテム管理を行います。
プロパティ
- Pouch: プレイヤーが所持するアイテムのリスト
メソッド
- Move(), Attack(), Equip(), Buy(), Sell(), Throw(), Use(): プレイヤーのアクションを表現します。

アイテムの実装

Foodクラス
- 概要: 食べ物アイテムを表現します。
- プロパティ: id, sellPrice, buyPrice, Type
- メソッド: Ability(): 食べ物の特殊効果を実装します。
Equipmentクラス
- 概要: 装備アイテムを表現します。
- プロパティ: id, sellPrice, buyPrice, Type, Endurance, AttackPower, DefensePower
- メソッド: Ability(): 装備の特殊効果を実装します。

4. レビュー

良い点

分離と抽象化
- インターフェースを使用して I_Enemy, I_Item, I_Trap などを定義しているため、将来的な拡張が容易です。
- Game クラスがアイテムと敵をリストとして管理することで、ゲーム内要素の集中管理が可能です。
プレイヤーの行動メソッドの明確化
- Player クラスが複数の行動メソッドを持つことで、プレイヤーの動作ロジックが分かりやすくなっています。
継承と実装の使い分け
- 基本インターフェース I_Element を中心に各要素が継承されているため、ゲーム要素の管理が簡単になっています。

改善提案

Playerクラスの責任分散
- Player クラスに多くのメソッドが集まっているため、アイテム関連の処理 (Buy, Sell, Throw, Use) を別クラスに分離することで、クラスの責任を明確に分散できます。
Dungeonクラスの生成メソッドの分離
- Dungeon クラスに複雑な生成ロジックが集まる場合、別のファクトリークラスに生成ロジックを委譲することを検討してください。
関連の明確化
- 点線の関連が多く、クラス間の依存がわかりにくいため、関連を整理し、管理が複雑化しないよう注意が必要です。
Ability()メソッドの詳細化
- Ability() メソッドが複数のクラスにあるため、具体的な能力の効果をクラスごとに明確化するか、ジェネリックな能力クラスを導入することを検討してください。

5. サンプルコード

using System;
using System.Collections.Generic;

// インターフェース
interface I_Element
{
    int Id { get; }
}

interface I_Enemy : I_Element
{
    void Move();
    void Attack();
    void Ability();
}

interface I_Trap : I_Element
{
    void Ability();
}

interface I_Item : I_Element
{
    int SellPrice { get; }
    int BuyPrice { get; }
    void Ability();
}

// 列挙型
enum FoodType
{
    Onigiri,
    Grass
}

enum EquipmentType
{
    Sword,
    Shield,
    Accessory,
    Wand,
    Rock,
    Bow
}

// クラス定義
class Game
{
    public List<I_Item> ItemList { get; private set; }
    public List<I_Enemy> EnemyList { get; private set; }

    public Game()
    {
        ItemList = new List<I_Item>();
        EnemyList = new List<I_Enemy>();
    }
}

class Dungeon
{
    public Floor Floor { get; private set; }

    public Dungeon(int level)
    {
        Floor = new Floor(level);
    }

    public void GenerateMap() { /* Map生成ロジック */ }
    public void GenerateTrap() { /* Trap生成ロジック */ }
    public void GenerateEnemy() { /* Enemy生成ロジック */ }
}

class Floor
{
    public int Level { get; private set; }
    public Map Map { get; private set; }

    public Floor(int level)
    {
        Level = level;
        Map = new Map();
    }
}

class Map
{
    public int MapX { get; private set; }
    public int MapY { get; private set; }
    public int[,] MapArray { get; private set; }

    public Map()
    {
        // マップサイズと配列の初期化
        MapX = 10;
        MapY = 10;
        MapArray = new int[MapX, MapY];
    }
}

class Player
{
    public List<I_Item> Pouch { get; private set; }

    public Player()
    {
        Pouch = new List<I_Item>();
    }

    public void Move() { /* 移動ロジック */ }
    public void Attack() { /* 攻撃ロジック */ }
    public void Equip() { /* 装備ロジック */ }
    public

 void Buy(I_Item item) { /* 購入ロジック */ }
    public void Sell(I_Item item) { /* 売却ロジック */ }
    public void Throw(I_Item item) { /* 投げるロジック */ }
    public void Use(I_Item item) { /* 使用ロジック */ }
}

// アイテムクラス
class Food : I_Food
{
    public int Id { get; private set; }
    public int SellPrice { get; private set; }
    public int BuyPrice { get; private set; }
    public FoodType Type { get; private set; }

    public Food(int id, int sellPrice, int buyPrice, FoodType type)
    {
        Id = id;
        SellPrice = sellPrice;
        BuyPrice = buyPrice;
        Type = type;
    }

    public void Ability() { /* 能力のロジック */ }
}

class Equipment : I_Equipment
{
    public int Id { get; private set; }
    public int SellPrice { get; private set; }
    public int BuyPrice { get; private set; }
    public EquipmentType Type { get; private set; }
    public int Endurance { get; private set; }
    public int AttackPower { get; private set; }
    public int DefensePower { get; private set; }

    public Equipment(int id, int sellPrice, int buyPrice, EquipmentType type, int endurance, int attackPower, int defensePower)
    {
        Id = id;
        SellPrice = sellPrice;
        BuyPrice = buyPrice;
        Type = type;
        Endurance = endurance;
        AttackPower = attackPower;
        DefensePower = defensePower;
    }

    public void Ability() { /* 能力のロジック */ }
}

// 使用例
class Program
{
    static void Main()
    {
        Game game = new Game();
        Player player = new Player();
        Dungeon dungeon = new Dungeon(1);

        // アイテムの生成と使用例
        Food onigiri = new Food(1, 10, 5, FoodType.Onigiri);
        player.Pouch.Add(onigiri);

        Console.WriteLine("Player has added an Onigiri to their pouch!");
    }
}