Blades & Tomes is a turn-based dungeon crawl game made with the libGDX engine where you play as an adventurer, wishing to strike his fortune within the deep depths of dark dungeons. To learn more about the project, please refer to the project description on the wiki here.
This game is made for windows you may try mac, but we do not guarantee that it works. To be able to run the app, please install the following programs:
Please make sure you have a folder dedicated to containing the project as well as a willingness to get "down and dirty" into Gradle and Java, as well as possibly XML and JSON.
IF YOU ARE RUNNING ON LINUX
Please install OpenJDK 8 using the following library path typed for Ubuntu derivatives:
sudo apt install openjdk-8-jdk
If you have another version already installed, after installing OpenJDK 8, type in the following commands:
update-java-alternatives --list
sudo update-java-alternatives --set /path/to/altenative/version
If the above does not work, please copy and paste the following commands into terminal before running:
export JAVA_HOME=/path/to/JDK export PATH=$JAVA_HOME/bin:$PATH
Please refer to this stack overflow page (comment by snesgx) for further information.
To SetUp the local branch, first clone the branch to your workspace directory (let's say "~/my_work_directory"). After this step, then run IntelliJ and select "Open". Move to the "BladeAndTomes" folder and open the "build.gradle" file. After this step, wait for the program to build the project before doing anything else. Once the project has built, make sure to click the build icon in IntelliJ to make sure it is built.
To be able to run the program, please install the latest release of Java, as this utilizes the .jar extension. A link to install Java is provided below:
To install Java, click on the link and follow the instructions provided to get the latest version of Java SE.
For running the program for the first time, click on the "Gradle" side menu, then go to "desktop/other" and click "Run". This will run the game and automatically update it for IntelliJ, so that each successive time you run the game, all that needs to be done is click on the "Run" icon and the project will build and attempt to run.
In order to properly test, please make sure that the correct branch and correct version of the code is available on your computer. Once everything is verified, check RubbleRaiders/BladeAndTomes/tests to make sure it is present as well as to make sure GdxTestRunner.java (Made by Thomas Pronold) (Source: https://github.com/TomGrill/gdx-testing) is within that branch as well as the modules 'examples', 'UnitTests', and 'BehaviorTests'. Once all files are verified, run the command "./gradlew tests:test" in the BladeAndTomes directory in order to run all tests at once through your CLI. The results will be displayed within the console output, and if there are any failures, Gradle will tell you which ones failed if you scroll up. If you wish to test individual methods, IntelliJ provides a simple testing GUI that allows you to do single tests if you open the test file in IntelliJ and left click on the green play button next to the method or class.
./gradlew tests:test
Aidan Emmons - akemmons@email.sc.edu
Brent Able - bpable@email.sc.edu
V.N Anirudh Oruganti - oruganti@email.sc.edu
Alex Facer - afacer@email.sc.edu
Miller Banford - banford@email.sc.edu