My third major foray into C++ Coding, courtesy of the Codecademy Build a Text Adventure Project.
The premise of the project was to create a program that will use conditionals to provide multiple linear outcomes in an adventure game. I got a bit carried away, and decided to exercise my new found, nascent knowledge of classes to make the game modular and expandable.
To that end, the Player and game Locations are derived from a class, with built-in methods used to manipulate factors such as the inventory and whether the area is free of monsters. I’ve used while/for loops, if/else and switch statements, random number generation and tried to make the program as resilient to incorrect user input as possible.
As always, my code comes with the caveat that I am self-taught, so have little doubt that things can be done more efficiently. I welcome encouragement and friendly tips on how to improve.
Here’s some actual gameplay footage!
Starting with int main():
//2020 MrN00b0t solution to Codecademy Build a Text Adventure Project
#include <iostream>
#include <string>
#include <vector>
#include "adventure.hpp"
int main (){
bool game_status = true;
while (game_status) {
play_game();
game_status = play_again();
}
}
My header file, containing function declarations:
//2020 MrN00b0t solution to Codecademy Build a Text Adventure Project
#include <iostream>
#include <string>
#include <vector>
class Player {
private:
std::vector<std::string> inventory;
std::vector<std::string> inv();
std::string name;
int gold;
public:
Player(std::string new_name = "Bronan", std::vector<std::string> new_inventory = { "Backpack" }, int new_gold = 5);
int gp();
//displays inventory and gold
void show_inv();
//used for purchases
void buy_item(std::string item, int cost);
//checks inventory for a specific item
bool check_inv(std::string item);
//add item to inventory
void add_item(std::string item);
//reset inventory and gold
void reset();
};
class Location {
private:
std::string name;
std::string description;
std::vector<std::string> options;
bool cleared = false;
public:
Location(std::string new_name, std::vector<std::string> new_options, std::string new_description);
void locate();
void describe();
void show_options();
std::vector<std::string> get_options();
std::string get_name();
bool is_clear();
void clear();
void reset();
};
bool greeting();
void play_game();
bool choice();
std::string get_rumour();
bool play_again();
void reset_locs();
And finally my core code:
//2020 MrN00b0t solution to Codecademy Build a Text Adventure Project
#include <iostream>
#include <string>
#include <vector>
#include <cstdlib>
#include <time.h>
#include "adventure.hpp"
//establish global objects and variables
//Making Players and Locations objects allows for ease of expansion
//For example, adding new player stats to allow random combats
//Ideally in future version also make items into objects to allow more functionality
Player player;
Location merchant("Cloaks and Daggers", { "1) Buy Thieves Tools (1gp)", "2) Buy Sword (4gp)", "3) Visit the Tavern", "4) Go on adventure!\n" }, "The merchant here sells simple weapons and tools.\nNothing too fancy but the quality is good.\n");
Location tavern("The Thirsty Ferret", { "1) Drink ale!", "2) Ask around for rumours", "3) Visit the Merchant", "4) Go on adventure!\n" }, "A very basic hostelry with straw on the floors.\nSeveral of the patrons are either highly inebriated, unconcious or fighting.\nThe ale seems reasonable and fairly priced.....\n");
Location crossroads("Crossroads", { "1) Visit the Undercrypt", "2) Enter the Maw of the Beast", "3) Investigate the Needletoe Caverns", "4) Return to safety\n" }, "Leaving town by the footpath, the well worn trail splits into three lesser travelled paths.\n");
Location undercrypt("Undercrypt", { "1) Fight the banshee", "2) Run away\n" }, "As you descend into the darkness of the crypt, you see a ghastly spectral visage floating towards you. As it nears, it emits a terrifying wail.\n");
Location needletoe_caverns("Needletoe Caverns", { "1) Fight the goblins", "2) Run away\n" }, "Picking your way through the tumbledown rockfalls of the cavern, you are set upon by a pack of snarling goblins, with vicious, long razor sharp finger and toe nails.\n");
Location maw_unknown("Maw", { "1) Step through the left portal", "2) Step through the right portal", "3) Search the area", "4) Return to safety\n" }, "You step through a cavern of tooth like stalactites into a short tunnel, at the end of which are two shimmering portals.\n");
Location maw_trapped("Maw Tunnel", { "1) Ignore the device and step through the left portal", "2) Ignore the device and step through the right portal", "3) Attempt to deactivate the device", "4) Return to safety\n"}, "You notice a small device embedded in the cavern wall, projecting a magical field across the tunnel between you and the two portals. There are piles of ash on the floor.\n");
Location maw_clear("Maw Tunnel - Disintegration device deactivated!", { "1) Step through the left portal", "2) Step through the right portal", "3) Return to safety\n" }, "The device has been deactivated. Two shimmering portals stand before you.\n");
Location dragon_lair("Dragons' Lair", { "1) Fight the dragon", "2) Flee in terror\n" }, "A huge winged beast sits atop a pile of treasure. As you step through the portal, it opens its fanged mouth. Molten lava drips from its' jaw.\nIt booms, 'You dare interrupt my slumber?'\n\n");
//set starting location
Location current_loc = tavern;
//define constructor and methods for Location
Location::Location(std::string new_name, std::vector<std::string> new_options, std::string new_description)
: name(new_name), options(new_options), description(new_description){
}
void Location::locate(){
std::cout << "You are currently at:\n" + name +"\n\n";
}
void Location::describe() {
std::cout << description + "\n";
}
void Location::show_options() {
std::cout << "Will you:\n\n";
for (std::string option : options) {
std::cout << option + "\n";
}
}
std::vector<std::string> Location::get_options() {
return options;
}
std::string Location::get_name() {
return name;
}
bool Location::is_clear() {
return cleared;
}
void Location::clear() {
cleared = true;
}
void Location::reset() {
cleared = false;
}
//define constructor and methods for Player
Player::Player(std::string new_name, std::vector<std::string> new_inventory, int new_gold)
: name(new_name), inventory(new_inventory), gold(new_gold) {
}
std::vector<std::string> Player::inv() {
return inventory;
}
int Player::gp() {
return gold;
}
void Player::show_inv() {
std::cout << "\nYou have the following items in your inventory:\n";
for (std::string item : inventory) {
std::cout << item + "; ";
}
std::cout << "\n\nYou have " << gold << " gold.\n\n";
}
void Player::buy_item(std::string item, int cost) {
if (cost > player.gp()) {
std::cout << "\nYou do not have enough gold for that.\n\n";
return;
}
else {
std::cout << "\nYou buy the " << item << " for " << cost << " gold.";
player.gold -= cost;
player.inventory.push_back(item);
player.show_inv();
return;
}
}
bool Player::check_inv(std::string item) {
for (std::string thing : player.inventory) {
if (thing == item) {
return true;
}
}
return false;
}
void Player::add_item(std::string item) {
player.inventory.push_back(item);
}
void Player::reset() {
player.gold = 5;
player.inventory = { "Backpack" };
}
//define game functions
bool greeting(){
std::string ready;
std::cout << "\n******** Welcome to the Thirsty Ferret ********\n";
std::cout << "**** Where adventure is just a pint away!! ****\n";
std::cout << "\n";
std::cout << "Drawn by tales of riches awaiting the bold, you have travelled to the village of Donbury.\n";
std::cout << "Tired from your journey, you make your way to the village hub: The Thirsty Ferret Inn.\n\n";
std::cout << "From any location, several choices will be available to you.\n";
std::cout << "You need simply select your choice with the corresponding number.\n";
std::cout << "You may also view your inventory at any time by typing INV.\n\n";
std::cout << "Quit the game at any time by typing QUIT.\n\n";
std::cout << "Good luck adventurer!\n\n";
std::cout << "Enter Y when you are ready to begin your journey....\n";
std::cout << "Any other key to exit\n";
std::cin >> ready;
if (ready == "y" || ready == "Y") {
return true;
}
return false;
}
//random rumour generator that gives players hints about what they might face
std::string get_rumour() {
srand(time(NULL));
int rumour = std::rand() % 4;
switch (rumour) {
case 1:
return "\nThe bartender says, 'They say The Undercrypt is inhabited by spirits who cannot be harmed with weapons!'\n\n";
case 2:
return "\nA shady character nods at you conspiratorially, 'The path through the Maw is beset with traps, ware you.'\n\n";
case 3:
return "\nA stout dwarf brags of his deeds, 'The goblins of Needletoe have wicked long claws. Best kept at arms length!'\n\n";
case 4:
return "\nA travelling scholar opines, 'It's said a fierce dragon lies beyond the Maw, its' scales impervious to simple weapons.\n\n";
default:
return "\nYou learn nothing of value.\n\n";
}
}
//location reset function for game restart. Attempted to write with a list of locations and a for loop to reset each. Didn't work. One to figure out.
void reset_locs() {
merchant.reset();
tavern.reset();
crossroads.reset();
undercrypt.reset();
needletoe_caverns.reset();
maw_unknown.reset();
maw_clear.reset();
maw_trapped.reset();
dragon_lair.reset();
}
void play_game() {
//sets out the initial instructions
bool game_status = greeting();
player.show_inv();
//loops through the game choices until victory (or death!) condition denoted by game_status==false
while (game_status) {
if (current_loc.is_clear()) {
std::cout << "\nThis area is quiet and empty.\n\n";
std::cout << "\nWith nothing left to do here, you return to The Crossroads.\n\n";
current_loc = crossroads;
}
current_loc.locate();
current_loc.describe();
current_loc.show_options();
game_status = choice();
}
}
bool play_again() {
std::string play_again;
//determines if player wishes to play again
std::cout << "\nWould you like to play again? Type Y for YES, any other key for NO\n\n";
std::cin >> play_again;
if (play_again == "y" || play_again == "Y") {
current_loc = tavern;
player.reset();
reset_locs();
return true;
}
else {
return false;
}
}
//core game data is contained in a series of switches, defined by the value of current_loc
bool choice() {
std::string choose;
std::cin >> choose;
//Any text commands should be added before the try statement, which filters out any unknown strings.
if (choose == "INV") {
player.show_inv();
return true;
}
else if (choose == "QUIT") {
return false;
}
else {
try {
int val_test = std::stoi(choose);
}
catch (std::invalid_argument){
std::cout << "\nInvalid choice. Try again.\n\n";
return true;
}
catch (std::out_of_range) {
std::cout << "\nInvalid choice. Try again.\n\n";
return true;
}
}
if (current_loc.get_name() == "The Thirsty Ferret") {
switch (std::stoi(choose)) {
case 1:
std::cout << "\nYou tarry awhile and get blind drunk on the local grog.\n\n";
return true;
case 2:
std::cout << get_rumour();
return true;
case 3:
std::cout << "\nYou decide to visit the merchant.\n\n";
current_loc = merchant;
return true;
case 4:
std::cout << "\nYou set out into the wilds.\n\n";
current_loc = crossroads;
return true;
default:
std::cout << "\nInvalid choice. Try again.\n\n";
return true;
}
}
if (current_loc.get_name() == "Cloaks and Daggers") {
switch (std::stoi(choose)) {
case 1:
player.buy_item("Thieves Tools", 1);
return true;
case 2:
player.buy_item("Sword", 4);
return true;
case 3:
std::cout << "\nYou visit the tavern.\n\n";
current_loc = tavern;
return true;
case 4:
std::cout << "\nYou set out into the wilds.\n\n";
current_loc = crossroads;
return true;
default:
std::cout << "\nInvalid choice. Try again.\n\n";
return true;
}
}
if (current_loc.get_name() == "Crossroads") {
switch (std::stoi(choose)) {
case 1:
std::cout << "\nYou follow the overgrown path to the Undercrypt. A dark stoned tomb entrance looms before you.\n\n";
current_loc = undercrypt;
return true;
case 2:
std::cout << "\nYou take the steep, narrow mountainous trail to The Maw. A menacing cave entrance pierces the mists ahead.\n\n";
if (maw_trapped.is_clear()) {
current_loc = maw_clear;
}
else {
current_loc = maw_unknown;
}
return true;
case 3:
std::cout << "\nA short distance from the crossroads, you encounter an abandoned mine entrance. Skeletons impaled with spears adorn either side.\n\n";
current_loc = needletoe_caverns;
return true;
case 4:
std::cout << "\nYou make your way back to the comfort of the Thirsty Ferret.\n\n";
current_loc = tavern;
return true;
default:
std::cout << "\nInvalid choice. Try again.\n\n";
return true;
}
}
if (current_loc.get_name() == "Needletoe Caverns") {
switch (std::stoi(choose)) {
case 1:
if (!player.check_inv("Sword")){
std::cout << "\nWith no suitable weapon to fight off the goblins, you are quickly overwhelmed as they slash you to ribbons with their terrible claws.\n\n";
std::cout << "\nDarkness takes you. Perhaps you were not the Chosen One after all. Your quest is over.\n\n";
return false;
}
else {
std::cout << "\nYou cut through the goblins with your sword, keeping at arms length from their terrible talons.\n\n";
std::cout << "As the dust of battle settles, you find a holy symbol attached to one of the goblins.\n";
std::cout << "You put the Holy Symbol in your backpack and return to The Crossroads.\n\n";
needletoe_caverns.clear();
current_loc = crossroads;
player.add_item("Holy Symbol");
return true;
}
case 2:
std::cout << "\nYou run away, back to the crossroads.\n\n";
current_loc = crossroads;
return true;
default:
std::cout << "\nInvalid choice. Try again.\n\n";
return true;
}
}
if (current_loc.get_name() == "Undercrypt") {
switch (std::stoi(choose)) {
case 1:
if (player.check_inv("Sword") && !player.check_inv("Holy Symbol")) {
std::cout << "\nYou swing at the spirit with your sword, but the blade passes through! The banshee grips you in a permanent, icy embrace.\n\n";
std::cout << "\nDarkness takes you. Perhaps you were not the Chosen One after all. Your quest is over.\n\n";
return false;
}
else if (!player.check_inv("Holy Symbol")) {
std::cout << "\nWith no suitable weapon to fight the spirit, you flail wildly at it. The banshee envelops you in an icy embrace.\n\n";
std::cout << "\nDarkness takes you. Perhaps you were not the Chosen One after all. Your quest is over.\n\n";
return false;
}
else {
std::cout << "\nYou draw your Holy Symbol from your backpack. The spirit shrieks in terror, then vanishes.\n\n";
std::cout << "You discover an old lance amongst the debris of the crypt. It feels like an item of power.\n";
std::cout << "You put the Dragon Lance in your backpack and return to The Crossroads.\n\n";
undercrypt.clear();
current_loc = crossroads;
player.add_item("Dragon Lance");
return true;
}
case 2:
std::cout << "\nYou run away, back to the crossroads.\n\n";
current_loc = crossroads;
return true;
default:
std::cout << "\nInvalid choice. Try again.\n\n";
return true;
}
}
if (current_loc.get_name() == "Maw") {
switch (std::stoi(choose)) {
case 1:
std::cout << "\nYou carelessly step toward the portal, oblivious to the disentegration field across your path, which reduces you to ash in an instant.\n\n";
std::cout << "\nDarkness takes you. Perhaps you were not the Chosen One after all. Your quest is over.\n\n";
return false;
case 2:
std::cout << "\nYou carelessly step toward the portal, oblivious to the disentegration field across your path, which reduces you to ash in an instant.\n\n";
std::cout << "\nDarkness takes you. Perhaps you were not the Chosen One after all. Your quest is over.\n\n";
return false;
case 3:
std::cout << "\nYour search identifies a device, which appears to generate a magical field across your path.\n\n";
current_loc = maw_trapped;
return true;
case 4:
std::cout << "\nYou run away, back to the crossroads.\n\n";
current_loc = crossroads;
return true;
default:
std::cout << "\nInvalid choice. Try again.\n\n";
return true;
}
}
if (current_loc.get_name() == "Maw Tunnel") {
switch (std::stoi(choose)) {
case 1:
std::cout << "\nYou heedlessly step toward the portal, ignoring the disentegration field across your path, which reduces you to ash in an instant.\n\n";
std::cout << "\nDarkness takes you. Perhaps you were not the Chosen One after all. Your quest is over.\n\n";
return false;
case 2:
std::cout << "\nYou heedlessly step toward the portal, ignoring the disentegration field across your path, which reduces you to ash in an instant.\n\n";
std::cout << "\nDarkness takes you. Perhaps you were not the Chosen One after all. Your quest is over.\n\n";
return false;
case 3:
if (player.check_inv("Thieves Tools")) {
std::cout << "\nBeads of sweat form on your brow as you carefully deactivate the device with your Thieves Tools.\n\n";
std::cout << "\nThe magical field dissipates before you. Perhaps those piles of ash weren't as careful as you.\n\n";
maw_trapped.clear();
current_loc = maw_clear;
return true;
}
else {
std::cout << "\nYour clumsy efforts to deactivate the device without the proper tools fail catastrophically.\n";
std::cout << "\nYou accidentally break the field with your hand, resulting in your disintegration.\n\n";
std::cout << "\nDarkness takes you. Perhaps you were not the Chosen One after all. Your quest is over.\n\n";
return false;
}
case 4:
std::cout << "\nYou run away, back to the crossroads.\n\n";
current_loc = crossroads;
return true;
default:
std::cout << "\nInvalid choice. Try again.\n\n";
return true;
}
}
if (current_loc.get_name() == "Maw Tunnel - Disintegration device deactivated!") {
switch (std::stoi(choose)) {
case 1:
std::cout << "\nWith the trap disarmed, you step safely into the mystical portal.\n\n";
current_loc = dragon_lair;
return true;
case 2:
std::cout << "\nWith the trap disarmed, you step safely into the mystical portal.\n\n";
current_loc = dragon_lair;
return true;
case 3:
std::cout << "\nYou run away, back to the crossroads.\n\n";
current_loc = crossroads;
return true;
default:
std::cout << "\nInvalid choice. Try again.\n\n";
return true;
}
}
if (current_loc.get_name() == "Dragons' Lair") {
switch (std::stoi(choose)) {
case 1:
if (player.check_inv("Sword") && !player.check_inv("Dragon Lance")) {
std::cout << "\nYou valiantly charge towards the beast with your sword drawn, but you are unable to pierce the scaled hide with your blade.\n";
std::cout << "\nThe wyrm covers you in a breath of molten flame, and you scream as your flesh melts and strips from your bones.\n\n";
std::cout << "\nDarkness takes you. Perhaps you were not the Chosen One after all. Your quest is over.\n\n";
return false;
}
else if (!player.check_inv("Dragon Lance")) {
std::cout << "\nWith no suitable weapon to fight the dragon, your efforts can only be described as suicidal.\n\n";
std::cout << "\nThe wyrm covers you in a breath of molten flame, and you scream as your flesh melts and strips from your bones.\n\n";
std::cout << "\nDarkness takes you. Perhaps you were not the Chosen One after all. Your quest is over.\n\n";
return false;
}
else {
std::cout << "\nYou draw your Dragon Lance and charge at the wyrm. The tip of the weapon catches the beast in the throat just as it prepares to engulf you in fiery doom.\n\n";
std::cout << "The dragon chokes on its' own molten breath and collapses heavily to the floor\n";
std::cout << "The riches of the dragons' hoard are yours to claim, adventurer! Congratulations, you have survived this adventure!\n\n";
dragon_lair.clear();
return false;
}
case 2:
std::cout << "\nYou run away, back to the crossroads.\n\n";
current_loc = crossroads;
return true;
default:
std::cout << "\nInvalid choice. Try again.\n\n";
return true;
}
}
}
mrn00b0t 