Text-Based-RPG

A short text-based RPG. Explore a mysterious house room by room, collect items, interact with your environment, and navigate through a branching world—all through your command line.

Author: Timothy Johnson
Date: January 2021 to February 2021

Overview

    This is a text-based role-playing game (RPG) built in Java that allows players to explore a series of interconnected rooms in a house. Each room contains items that can be picked up or dropped, and rooms may have unique mechanics (such as healing). Players can navigate using typed commands and manage an inventory system.

🧩 Features

🧍 Player creation and inventory system

🧭 Room navigation with cardinal directions (north, south, east, west)

🪑 Dynamic room objects and interactions

🛏️ Special rooms (e.g., Sleep Room that heals the player)

🛠️ Command-based interaction system (like look, inventory, pick up)

📦 Utility class for modular string-based item management

🎮 Gameplay

You begin by entering a room and are prompted with command options. Each action affects the game's state.

Available Commands:

Command	Description
look	List all visible items in the room
inventory	Check what items you're currently carrying
go <dir>	Move to a new room (where <dir> is n/e/s/w)
pick up	Pick up an item from the room
drop	Drop an item from your inventory into the room
exits	Show all available exits from the current room
help	Show help menu with commands
quit	Exit the game

📁 Code Structure

.
├── CustomPlayer.java    ---    Defines the custom player, inventory, and interactions
├── GameDemoSimple.java    ---    Demo entry point of the game and room setup
├── GameVersion2.java    ---    Second entry point of the game and room setup
├── GameVersion3.java    ---    Third entry point of the game and room setup
├── GameVersion4.java    ---    Fourth entry point of the game and room setup
├── MonsterRoom.java    ---    Monster Room logic
├── Player.java    ---    Defines the player, inventory, and interactions
├── README.md
├── Room.java    ---    Generic room logic, including navigation and item handling
├── SleepRoom.java    ---    Sleep room logic to allow player to heal
├── SubClass.java
├── SuperClass.java
├── Trying.java
├── Utilities.java    ---    Helper methods for string manipulation and command reference

⚙️ How It Works
Player Initialization: The game creates a player with a name, starting room, and an empty or pre-defined inventory.

Room Interaction: Each room contains:

A unique name

Items to interact with

List of directional exits

🖼️ Screenshots / Visuals

🧰 Technologies Used

Java 17 (or specify version)

Command Line Interface (CLI)

OOP Principles (Encapsulation, Inheritance via CustomPlayer, etc.)

Tokenizer and StringBuilder for parsing and managing state

🚀 Getting Started

To run this project on your local machine:

1. Clone this repository

    git clone https://github.com/MrTimmyJ/text-based-rpg-java.git
    cd text-based-rpg-java

2. Compile all Java files

   javac *.java

3. Run the game

   java GameDemoSimple

📝 Note: The Main.java file should be created to initialize your rooms and player, then loop through rooms until continuePlay is false. Different versions of "Main" include: GameDemoSimple.java, GameVersion2.java, GameVersion3.java, and GameVersion4.java.

🌱 Planned Features

🧠 Custom player class with health, stamina, or traits

🎲 Random events or item spawns

🗺️ Map system to visualize progress

💾 Save/Load system using file I/O

🧙 NPC interactions with dialogue options

📜 Quest system with objectives

🪪 License

This open-source project is available under the MIT License.