【Java】テキストベースのRPGゲーム開発｜キャラクター作成

/**
 * ANSIカラーコードを定義するクラス
 * このクラスは、コンソール出力時に使用できる ANSI エスケープコードを定数として提供します。
 */
public class ANSIColors {
    public static final String RESET = "\u001B[0m";
    public static final String RED = "\u001B[31m";
    public static final String GREEN = "\u001B[32m";
    public static final String YELLOW = "\u001B[33m";
    public static final String CYAN = "\u001B[36m";
    public static final String BRIGHT_PINK = "\u001B[95m";
}

/**
 * テキストベースRPGゲームのメインクラス
 * このクラスはゲームの開始点となり、ゲームエンジンを初期化して起動します。
 */
public class RPGGame {
    public static void main(String[] args) {
        // ゲーム開始メッセージをシアン色で表示
        System.out.println(ANSIColors.CYAN + "テキストベースRPGを開始します..." + ANSIColors.RESET);      
        // ゲームエンジンのインスタンス作成と起動
        GameEngine gameEngine = new GameEngine();
        gameEngine.start();
    }
}

import java.util.Scanner;

/**
 * ゲームの中核となるエンジンクラス
 * ゲームのメインループ、入力処理、初期化、終了処理を管理します。
 */
public class GameEngine {
    private static final String EXIT_COMMAND = "exit";
    private final Scanner scanner;
    private final CommandProcessor commandProcessor;
    private final Player player;
    private boolean isRunning;

    /**
     * GameEngineのコンストラクタ
     * 必要なオブジェクトの初期化を行います。
     */
    public GameEngine() {
        this.scanner = new Scanner(System.in);
        this.player = new Player("勇者");
        this.commandProcessor = new CommandProcessor(player);
        this.isRunning = true;
    }

    /**
     * ゲームを開始するメソッド
     * 初期化、メインループ、終了処理の順に実行します。
     */
    public void start() {
        init();
        gameLoop();
        cleanup();
    }

    /**
     * ゲームの初期化を行うメソッド
     * ウェルカムメッセージと操作方法を表示します。
     */
    private void init() {
        System.out.println(ANSIColors.GREEN + "テキストベースRPGへようこそ！" + ANSIColors.RESET);
        System.out.println(ANSIColors.YELLOW + "ゲームの操作方法：'help' と入力してください。" + ANSIColors.RESET);
    }

    /**
     * ゲームのメインループ
     * ユーザーからの入力を受け付け、処理を行います。
     */
    private void gameLoop() {
        while (isRunning) {
            System.out.print("> ");
            String input = scanner.nextLine().trim().toLowerCase();
            processInput(input);
        }
    }

    /**
     * ユーザー入力を処理するメソッド
     * 終了コマンドの場合はゲームを終了し、それ以外はCommandProcessorに処理を委譲します。
     *
     * @param input ユーザーからの入力文字列
     */
    private void processInput(String input) {
        if (EXIT_COMMAND.equals(input)) {
            isRunning = false;
            System.out.println(ANSIColors.YELLOW + "ゲームを終了します..." + ANSIColors.RESET);
        } else {
            commandProcessor.processCommand(input);
        }
    }

    /**
     * ゲーム終了時の後処理を行うメソッド
     * リソースの解放とお別れメッセージの表示を行います。
     */
    private void cleanup() {
        scanner.close();
        System.out.println(ANSIColors.GREEN + "プレイしていただきありがとうございました！" + ANSIColors.RESET);
    }
}

/**
 * ユーザーコマンドを処理するクラス
 * 入力されたコマンドに応じて適切な処理を実行します。
 */
public class CommandProcessor {
    private final Player player;

    /**
     * CommandProcessorのコンストラクタ
     * @param player 操作対象のPlayerオブジェクト
     */
    public CommandProcessor(Player player) {
        this.player = player;
    }

    /**
     * 入力されたコマンドを処理するメソッド
     * @param command ユーザーが入力したコマンド文字列
     */
    public void processCommand(String command) {
        switch (command) {
            case "help" -> displayHelp();
            case "status" -> player.displayStatus();
            case "train" -> trainPlayer();
            default -> System.out.println(ANSIColors.RED + "不明なコマンドです。'help' と入力してコマンドのリストを表示してください。" + ANSIColors.RESET);
        }
    }

    /**
     * ヘルプメッセージを表示するメソッド
     * 利用可能なコマンドとその説明を表示します。
     */
    private void displayHelp() {
        System.out.println(ANSIColors.CYAN + "利用可能なコマンド:" + ANSIColors.RESET);
        System.out.println(ANSIColors.YELLOW + "help   - このヘルプメッセージを表示" + ANSIColors.RESET);
        System.out.println(ANSIColors.YELLOW + "status - キャラクターのステータスを表示" + ANSIColors.RESET);
        System.out.println(ANSIColors.YELLOW + "train  - トレーニングを行い経験値を獲得" + ANSIColors.RESET);
        System.out.println(ANSIColors.YELLOW + "exit   - ゲームを終了" + ANSIColors.RESET);
    }

    /**
     * プレイヤーのトレーニングを実行するメソッド
     * ランダムな経験値を獲得し、プレイヤーのステータスを更新・表示します。
     */
    private void trainPlayer() {
        int expGained = (int) (Math.random() * 50) + 10; // 10から59の間でランダムな経験値を生成
        player.gainExp(expGained);
        player.displayStatus();
    }
}

import java.util.EnumMap;
import java.util.Map;

/**
 * プレイヤーキャラクターを表すクラス
 * プレイヤーの属性、レベル、経験値、ステータスを管理します。
 */
public class Player {
    private final String name;
    private int level;
    private int exp;
    private final Map<Stat, Integer> stats;

    /**
     * プレイヤーのステータスを表す列挙型
     */
    public enum Stat {
        HP, MAX_HP, MP, MAX_MP, ATTACK, DEFENSE, SPEED
    }

    /**
     * Playerのコンストラクタ
     * @param name プレイヤーの名前
     */
    public Player(String name) {
        this.name = name;
        this.level = 1;
        this.exp = 0;
        this.stats = new EnumMap<>(Stat.class);
        initializeStats();
    }

    /**
     * 初期ステータスを設定するメソッド
     */
    private void initializeStats() {
        stats.put(Stat.HP, 100);
        stats.put(Stat.MAX_HP, 100);
        stats.put(Stat.MP, 50);
        stats.put(Stat.MAX_MP, 50);
        stats.put(Stat.ATTACK, 10);
        stats.put(Stat.DEFENSE, 5);
        stats.put(Stat.SPEED, 5);
    }

    /**
     * 経験値を獲得するメソッド
     * @param amount 獲得する経験値の量
     */
    public void gainExp(int amount) {
        exp += amount;
        System.out.printf(ANSIColors.GREEN + "%sは%d経験値を獲得しました！%n" + ANSIColors.RESET, name, amount);
        checkLevelUp();
    }

    /**
     * レベルアップの条件を確認し、必要に応じてレベルアップを行うメソッド
     */
    private void checkLevelUp() {
        int expToNextLevel = level * 100;
        while (exp >= expToNextLevel) {
            levelUp();
            expToNextLevel = level * 100;
        }
    }

    /**
     * レベルアップの処理を行うメソッド
     * ステータスの増加と経験値の調整を行います。
     */
    private void levelUp() {
        level++;
        exp -= (level - 1) * 100;
        
        increaseStat(Stat.MAX_HP, 10);
        increaseStat(Stat.MAX_MP, 5);
        increaseStat(Stat.ATTACK, 2);
        increaseStat(Stat.DEFENSE, 2);
        increaseStat(Stat.SPEED, 1);
        
        setStat(Stat.HP, getStat(Stat.MAX_HP));
        setStat(Stat.MP, getStat(Stat.MAX_MP));

        System.out.printf(ANSIColors.BRIGHT_PINK + "%sはレベル%dになりました！%n" + ANSIColors.RESET, name, level);
    }

    /**
     * 指定されたステータスを増加させるメソッド
     * @param stat 増加させるステータス
     * @param amount 増加量
     */
    private void increaseStat(Stat stat, int amount) {
        stats.put(stat, stats.get(stat) + amount);
    }

    /**
     * プレイヤーのステータスを表示するメソッド
     */
    public void displayStatus() {
        System.out.println(ANSIColors.CYAN + name + "のステータス:" + ANSIColors.RESET);
        System.out.println(ANSIColors.CYAN + "レベル: " + ANSIColors.YELLOW + level + ANSIColors.RESET);
        System.out.println(ANSIColors.CYAN + "経験値: " + ANSIColors.YELLOW + exp + "/" + (level * 100) + ANSIColors.RESET);
        for (Stat stat : Stat.values()) {
            System.out.printf(ANSIColors.CYAN + "%s:" + ANSIColors.YELLOW + " %d%n" + ANSIColors.RESET, stat.name(), stats.get(stat));
        }
    }

    /**
     * 指定されたステータスの値を取得するメソッド
     * @param stat 取得するステータス
     * @return ステータスの値
     */
    public int getStat(Stat stat) {
        return stats.getOrDefault(stat, 0);
    }

    /**
     * 指定されたステータスに値を設定するメソッド
     * @param stat 設定するステータス
     * @param value 設定する値
     */
    public void setStat(Stat stat, int value) {
        stats.put(stat, value);
    }

    /**
     * プレイヤーの名前を取得するメソッド
     * @return プレイヤーの名前
     */
    public String getName() {
        return name;
    }

    /**
     * プレイヤーのレベルを取得するメソッド
     * @return プレイヤーのレベル
     */
    public int getLevel() {
        return level;
    }
}