gradle_rpg

Name

RPG game characters and items.

Description

This project is a small RPG game with no graphics.
It is able to create some items(weapons and armor) and some heroes (Mage, Ranger, Warrior, Rogue).
The heroes can equip armor or weapon and can damage an opponent. Unfortunately, there is no HP attribute yet.
The heroes have three attributes(strength, dexterity and intelligence).
The weapon types are Staff,Wand,Dagger,Sword
The armor's materials are Leather,Plate,Mail,Cloth.
All heroes can equip only one weapon(Slot weapon) and three armor pieces.
The available armor slots are Head,Body and Legs, one armor piece per slot.
The weapon types of Staff and Wand are available to Mages.
These Heroes can only be outfitted with Cloth armor.
The Bow weapon types are available for Rangers to use.
These Heroes can only wear armor made of Leather and Mail.
The Dagger and Sword weapon types are available to Rogues.
These Heroes can only wear armor made of Leather or Mail.
The Axe,Hammer,Sword weapon types are available to Warriors.
Only Mail and Plate armor type can be equipped to these Heroes.
Mage's stats at level 1(str:1,dex:1,intel:8). Mage at level 2(str:2,dex:2,intel:13). The strong attribute of Mage is intelligence.
Ranger's stats at level 1(str:1,dex:7,intel:1). Ranger at level 2(str:2,dex:12,intel:2). The strong attribute of Ranger is dexterity.
Rogue's stats at level 1(str:2,dex:6,intel:1). Rogue at level 2(str:3,dex:10,intel:2). The strong attribute of Rogue is dexterity.
Warrior's stats at level 1(str:5,dex:2,intel:1). Warrior at level 2(str:8,dex:4,intel:2). The strong attribute of Warrior is strength.
Calculate damage at hero's lvl 1:

The dmg of warrior's at level 1 with no equipment must be 1*(1+(5/100)).(5 is the strong attribute of hero's, in this case it is strength). - The dmg of warrior's at level 1 with weapon equipped must be 2*(1+(5/100)).(2 is the weapon's damage). - The dmg of warrior's at level 1 with one armor piece equipped(e.g. plate body with strength 2)
must be 1*(1+(5+2)/100).
"5+2" is hero's strong attribute plus the armor's attribute which must be the same type of hero's strong attribute - The dmg of warrior's at level 1 with one armor piece equipped and weapon equipped
(example d and c together) must be 2*(1+(5+2)/100) 17. As it is obvious from above, the hero's three attributes and damage changes depending on the equipped items and hero's levels.

Furthermore, the app can display the character status or item status.Also, it displays the equipment items which are equipped by the hero.

Visuals

Installation

This app was created and tested in intellij using the gradle tool.

Usage

There is a menu to choose a hero class

Please choose a Hero:  
Please select from 1 to 5:  
1. Mage  
2. Ranger  
3. Rogue  
4. Warrior  
5. Exit

Type a number from 1 to 5 and press Enter

If you chose a hero, then this option will appear:

Please select a name for your hero

Type whatever name you want and press Enter

Then, you will have to choose a Hero's action:

Please select from 1 to 5:  
1. Level up  
2. Equip weapon  
3. Equip armor  
4. Display status  
5. Exit

Type the number and press Enter

If you equip the weapon:
- It will appear on the screen to type the weapon's name. Type it and press Enter.
- Then type the required Hero's level to equip this weapon(greater than 0). Type it and press Enter.
- Type the weapon's dmg (greater than 0) and press Enter..
- Choose the type of weapon(1 to 7). Type the number and press Enter.
- If it is the valid type for the hero's class it will appear on the screen(Equipped:Weapon's name).
If you equip armor:
- It will appear on the screen to type the armor item's name. Type it and press Enter.
- Then type the required Hero's level to equip this armor item(greater than 0). Type it and press Enter.
- Write in a line the values of three attributes(strength, dexterity, intelligence) like this: 2,5,2 Press Enter
- Choose the type of armor(1 to 4). Type the number and press Enter.
- Choose the slot you want to equip the armor(1 to 3). Type it and press Enter.

Devs

In main method which is in the main class:

A hero(e.g. Ranger) is created like this example below:

Hero heroName = new Ranger("myName");

You can display the status with this line:

heroName.display();

An armor item can be created like this:

Item leatherBody = new Armor("Common leather Body", 5, Armor.ArmorType.Leather, 1, 2, 4, Item.Slot.Body);

There are 7 arguments: (itemName, requiredLevel,armorType,strength,dexterity,intelligence,slot);
The requiredLevel is the lowest level at which the Hero can use this specific item. (e.g. the item has requierdLevel=11, the hero must be at least of level 11 to be able to equip it).

A weapon can be created like this:

Item commonBow = new Weapon("Common Bow", 1,2, Weapon.WeaponType.Bow);

The arguments are 4: (itemName, requiredLevel, weaponDamage, weaponType)
The requiredLevel is described previously(check part 3 of this section).

Display Hero's stats:

heroName.display();

Increase hero's level:

heroName.levelUp();

Equip an armor piece:

heroName.equipArmor(leatherBody);

Equip a weapon:

heroName.equipWeapon(commonBow);

Drop a weapon:

heroName.dropWeapon();

Drop an item:

heroName.dropArmor(leatherBody);

Display an item:

commonBow.displayStats();
leatherBody.displayStats();

There are comments in code. The comments for all hero's subclasses are in Mage subclass.
Some parts of code satisfy the Liscov Substitution Principle.
Documentation generated in (https://github.com/tassosant/RPG_game/tree/main/gradle_rpg_doc)

Roadmap

Autogenerate items in a chest class
Console game user interface(terminal ui)
Heroes can fight
Heroes can move

Project status

This project is only for educational purposes

tassosant/RPG_game