tvomacka/dungeon

Game logic engine for RPG games

Dungeon

Framework for a 2D adventure/RPG game made using TDD approach. Character/gameplay rules based on GURPS 4e.

Only the parts of the original rules that are actually useful for the game will be implemented!

• Coding Guidelines
• Knowledge Base

Game Initialization and Loading

The instance of the game is a singleton, that can be accessed using the property:

public static Game Instance
{
    get
    {
        instance ??= new Game();
        return instance;
    }
}

This instance can be filled with custom game data using one of the GameLoader*** classes from the Services namespace.

GameLoaderJson.Load(path);

Sample Games

There are some simple game setups stored in the Game Samples Folder that demonstrate some of the basic concepts of the Dungeon Toolkit.

• Dialogue Condition Contains a simple dialog with three possible answers, one of which is disabled because the John Smith character's intelligence is not greater than the requiered value.
• Fetch Quest Is a game instance in which the party has a quest to bring an item to a NPC. After this item is picked up in the inventory, the NPC dialogue will enable an option to give this item to the NPC and therefore complete the quest. After choosing this dialogue option, the quest is completed, the item is removed from character's inventory and experience points are assigned.

Credits and Honorable Mentions

• One of the big reasons to create this project was to learn the test-driven product development as taught by Llewelyn Falco.
• Refactoring the code with ReSharper.

dungeon's Issues

Character Races

Races will be done using Racial Templates with predefined advantages/disadvantages and attribute bonuses.
Needs to be determined if the templates will be loadable from a data file or hard-coded and this work item needs to be implemented accordingly to this decision.

Hexagonal Grid

Convert Item Condition to Inventory Condition

Path Finding in Hex Grid

Needs to be able to find shortest available path from one cell to another, if it exists.

Publish to NuGet should not proceed with failing unit tests

Dialogue Conditions: Full Set of Subjects and Tests

Implement the whole dialogue conditions test matrix.

Special dialogue outcomes

A dialogue must be able to affect the game state by adding quest, providing items, experience etc.

Add Missing Information to the NuGet package

Add readme, license, icon and other possibly missing information to the NuGet package.

https://learn.microsoft.com/en-us/nuget/reference/msbuild-targets#packing-a-license-expression-or-a-license-file

Player Character Secondary Attributes

Secondary Characteristics: HP, Will, Per, FP
Basic Lift (BL), Hit Points (HP), Basic Speed, Basic Move
Build
Size Modifier

Player character attributes - intelligence

Player characters have attributes.
Intelligence affects dialogues, spell casting, etc.

Dialogue Traversal does not Work

The dialogue cannot be traversed - it doesn't keep track of its own state and the state cannot be changed using the dialog options.

Player Character Basic Attributes

Basic Attributes: ST, DX, IQ, HT

Conditional dialogue options

Some of the options in the dialogue will only be accessible when a certain condition is met. Such as having a quest assigned or having a certain score of skill/ability, etc.

Dialogue Conditions: Test Results

• Test results return a set of characters who satisfy the condition.

Dialogue Conditions: Support Abbreviated Subjects

(e.g., INT for Intelligence).

Basic Inventory and Wielding Items

• Item can be placed in an inventory
• A character has a hand slot
• Item can be taken from inventory and placed into character's hand

Character Skills

Fetch Quest

Add a quest which consists of finding a specific item and bringing this item back to an NPC.

Player Secondary Characteristics: Damage Calculation

Get damage value based on strength and damage type (Thrust/Swing).

Dialogue Conditions: Targeted Tests

It should be possible to determine who is being tested. Either the whole party (by default) or a specific character.

Character Classes

Basically the same problem as with Character Races

Compound Conditions

Provide way to compound conditions into expressions using bool algebra operators such as NOT, AND, OR and others if necessary.

XP and Leveling System