DungeonDocs - C++ Page

Dungeoneer is a game that incorporates many aspects of Dungeons & Dragons, the indomitable role-playing game from the 1980's, so knowing how to play D&D should help you understand Dungeoneer. The official D&D website is dnd.wizards.com, where detailed and authoritative information on the RPG can be found. This version of the documentation is valid for Dungeoneer version Beta 1.1.12.

- If you downloaded a tarball(.tar.gz), please install a C++ compiler("TDM-GCC 32-bit release" is the one I use) and recompile "dungeoneer.cpp" because compression/decompression can corrupt binary files such as executables.

- "dungeoneer_sb.exe" is the SmallBasic version executable. SmallBasic is a stripped-down version of Basic created by Microsoft to teach students about coding and to get them interested in learning Microsoft's Visual Basic.

- "dungeoneer_sb.sb" is the SmallBasic version source code. Feel free to redistribute and modify it; it is for a deprecated and discontinued version of Dungoneer.

- "dungeoneer.cpp" is the C++ version source code. Check "README.txt" for the licensing information on this file.

- "dungeoneer.exe" is the C++ version executable. Check "README.txt" for the licensing information on this file.

- Dungeoneer is covered by a slightly modified version of the MIT License which adds the condition that modified versions of Dungoneer not be shared as unmodified/official versions.

- Dungeoneer source code files are heavily commented to help beginner programmers learn how to code.

- Make more features follow the law of conservation of mass(i.e. you shouldn't be able to still fight after using MIDAS and removing your weapons)

- Make the available weapons and armor class come from the inventory, not the class.

- Make talents complicated, with different levels and maximums based on ability scores and inventory items.

- Make traveling make more sense(i.e. traveling from Hammertown to Trident makes no sense because of the mountain range.)

- Rework the traveling system to account for roads and their specific lengths.(maybe even make some roads inaccessible because of war, natural disaster, etc.)

- Add a loadout editor to manage weapons that are available for use, armor that is being worn, talents that need certain items to be performed, etc.

- Add a chance for the militia/police to show up on a failed attempt to find/buy from/sell to a black market dealer.

Dungeoneer is a text adventure at heart; a game designed from the ground up to be straightforward and, above all, fun! The actions that you as a player can take are determined by your situation: for example, you cannot take a long rest in the middle of combat. Here is a table of the options for the various menus.

Input String	Combat Requirement	Numerical Shortcut
attack	both	1
move	out of combat	2
longrest	out of combat	3
shortrest	out of combat	4
scan	out of combat	6
checkup	out of combat	7
eat	out of combat	8
drink	out of combat	9
buyfood	out of combat	10
buy	out of combat	11
hunt	out of combat	12
sell	out of combat	13
TENDEES!	out of combat	none
midas	out of combat	none
philswift	out of combat	none
flextape	both	none
Combat Menu
attack	both	1
dodge	in combat	2
disengage	in combat	3
flextape	both	none

Dungeoneer has the same four base classes as D&D: fighter, rogue, wizard and cleric. (Selecting your own ability scores & equipment is a planned feature)

Class Name	Strength	Dexterity	Constitution	Intelligence	Wisdom	Charisma	Slot 1	Slot 2	Slot 3
Fighter	15	14	14	11	12	10	Longsword(1d8)	Dagger(1d4)	Light Crossbow(1d8)
Rogue	14	15	13	11	14	8	Shortsword(1d6)	Crossbow(1d10)	Handaxe(1d6)
Wizard	10	12	14	15	13	8	Magic Missile(1d12)	Dagger(1d4)	Fireball(1d6)
Cleric	14	12	12	14	10	14	Silver Shortsword(1d9)	Warhammer(1d8)	Light Crossbow(1d8)

This is what you should see when opening Dungeoneer. (If your initial mission is different, don't sweat: it's randomized) The program will welcome you, tell you an arbitrary motivation for adventuring, and ask you which class you would like to be. Strings are not acceptable here, just the number that appears beside the class name in the prompt. Once you have made your selection, Dungeoneer will spit out a description of who your adventurer is and what they are equipped with, which should look something like this(for a fighter).

After telling you who your adventurer is and what they carry, Dungeoneer will give you a basic notion of your surroundings. After that, it will confront you with the indomitable "What would you like to do?" prompt. All supported inputs are listed in a table above.

Looking at the table above, your only reasonable options are to move or attack. Since there are people in any town who don't exactly love you, you will always be ready to fight. Attacking immediately is the most common course of action.

Here is a screenshot of the combat system. In this case, a cleric just attacked someone with his silvered shortsword. He missed, and his enemy scored a hit on him. However, the enemy dealt no damage because the cleric's armor absorbed the blow. Note that since the cleric has entered combat, his only options are to attack, dodge or disengage.

Also note that disengaging has a chance of failure, as demonstrated in this next screenshot. Note that there is no attack message for the enemy because, apparently, his attack roll failed.

Most D&D players don't realize that they can just "dodge" on their turn, imposing disadvantage on enemy attack rolls. Disadvantage means that a character has to roll two 20-sided dice and use the lesser roll to determine the outcome of the attack. Advantage is similar, but you get to use the greater roll. This is a thing you can do in Dungeoneer, too! Just enter "2" while in combat to dodge!

However, attacking immediately is not the only course of action a player can take, since realistically there is no benefit from murdering a goblin(there is no XP and leveling system yet). So, a more common occupation is hunting. Hunting can kill you, if you manage to find a wild honey badger and are a wizard, but in most cases hunting provides a source of income that doesn't involve boss fights.

The only boss fight in Dungeoneer at the moment is Phil Swift. Phil Swift is the main advertising man for FlexTape and other Flex-branded products. He is also the target of many fresh memes. Given this dank status, Phil Swift was forever memorialized in Dungeoneer. He descends from heaven, pulls out a grinder, and challenges you to a fight. If you somehow manage to kill him, his earthly body will disintegrate into a roll of 100 meters of FlexTape and his soul will ascend back into heaven. The FlexTape Phil Swift grants you is VERY useful, because each meter of it instantly heals you by 10 HP, and is also worth 20 gold pieces. If you don't want to fight Phil Swift, sorry, because there are no other bosses.

There are currently two cheat operations available for use in Dungeoneer. The first one is called TENDEES! and will instantly give you 1000 food. The second one is known as "midas" and will give you the number of gold pieces equal to the sum of all the non-GP items in your inventory. It will also destroy every item in your inventory that is not a gold piece.