P4: DBL (Deck Builder Language)

DBL Manual

Introduction

A student project at Aalborg University that describes a domain-specific programming language, called DBL, for creating high-fidelity deck builder protoypes.

Running from source

Important

Prerequisites

• JDK 21
• Maven version 3.9.5 or newer

1. Clone this repository.
2. Open a terminal in the project directory (<root-folder>/P4/project).
3. Type mvn clean install to generate Java files and compile the entire project.
4. Provide the absolute path to the DBL source file as an argument when running main.

Troubleshooting

If you're having trouble with the installation process, you can try these steps.

Note

This section assumes a Windows enviroment.

Remember to close any open terminals after making changes
to the enviroment variables as your changes are not saved in open terminals.

JAVA_HOME not found

If Maven complains about a missing JAVA_HOME, you need to create a new enviroment variable pointing to your Java installation.
This can be done in the following ways:

Using Control Panel

Quick shortcut to Control Panel

Press CTRL + R on your keyboard.
Paste explorer.exe shell:::{BB06C0E4-D293-4f75-8A90-CB05B6477EEE} into the Run dialog and hit enter.
Then, you can go directly to step 3.

1. Open Control Panel and find "System".
2. Right click "System" and click "Open" in the dialog.
3. Click on "Advanced system settings" in the top-left panel.
4. Click on "Enviroment variables" in the buttom-right.
5. Under "System variables", click the "New..." button.
6. Under "Variable name", write JAVA_HOME. The value of the variable is your Java installation directory, e.g. C:\Program Files\Java\jdk-17.

WARNING
Do not include /bin in your JAVA_HOME. Things WILL break!

Using CMD

If you have some experience with terminals and commands this might be an easier way.

Note
When JAVA_PATH is mentioned, it means the path to your Java installation directory, e.g. C:\Program Files\Java\jdk-17.

1. Open a CMD terminal in Administrator mode
2. Paste the following into the terminal and hit enter (with quotes):

setx /M JAVA_HOME "JAVA_PATH"

WARNING
Do not include /bin in your JAVA_HOME. Things WILL break!

Documentation for DBL

Please refer to the DBL Manual

Acknowledgements

Built using:

• ANTLR