First Java project made with Nelson De Oliveira.

This is a meta-game, where the player can either enjoy playing and creating his own worlds.

This is our first project in java for the last year of our bachelor degree. This document resume the subjets and goal, but the original subject can be found here.

For assets, we used images from the Baba Is You game.

Map from demo.map

• The Big Adventure
• Table of Contents
  • How to
    • Donwload
    • Compile
    • Run
  • Creating your world
    • Map format
    • Attributes
  • Playing your world
  • Controls
  • Features

To download the repo, you can either:

• download the .zip archive and unzip-it to create a directory called TheBigAdventure
• Use git command described bellow to automatically create the TheBigAdventure directory

git clone https://github.com/GouruRK/GemCraft

Downloading the repository using git

This project needs Java 21 to be compiled and used.

Except from an IDE which automatically compile and run it, we used Ant, which you can download following the previous link, or by using this commands :

sudo apt-get update
sudo apt-get install ant

With Ant installed and while in the TheBigAdventure directory, use the default ant target to create a jar file called thebigadventure.jar file.

cd TheBigAdventure
ant

Here are some other targets supported by the build.xml file:

• ant clean: removes .classes files
• ant compile: creates .classes files
• ant jar: creates the thebigadventure.jar file
• ant javadoc: creates the docs/api folders with documentation

You can run the program using the following command:

java -jar thebigadventure.jar -- level FILE

Note that some arguments are required while others are mandatory

• -lvl, --level FILE path to the map to play, mandatory
• --validate check if a map syntax is correct without playing it
• --dry-run play with still mobs
• -h, --help print help and exit

A world is contained in a .map file (see demo.map or test.map if you need examples). A map is composed by types of elements :

• the grid one, which specifies generic datas such as dimensions, or tiles, and must have the following structure:

  [grid]
    size: (w x h)
    encodings: ITEM(I) WEAPON(W)
    data: """
    IIIIIII
    I     I
    I     I
    I     I
    IIIIIII
    """
  

• the element ones, which indicates mobs, weapon and many ofther things. Elements must follow the structure :

  [element]
    attribute: value
    attribute: value
  

Here is the list of the possible attributes values

Attributes can only be used one by elements. If you give too much attributes useless for the selected type, they will be ignored (like giving a trade table to a sword)

Note that the syntax is pretty rough, and you can easily creates small mistakes while creating your world. The parser will tell you them all.

When your world is loaded, the camera in centered on your player. The keybinds are the following:

• z/up arrow: move up
• q/left arrow: move left
• s/down arrow: move down
• d/right arrow: move right
• i: toggle your inventory and other interfaces
• a: drop your current held item
• space: use your current held item, talk to friends, replace an item with the selected one

As you may have guess, there is no use for a mouse in this game

• Eat to gain food
• Kill non-friendly mobs
• Pick-up items from the ground
• Trade with friends
• Use differents types of weapons
• Open and close gates with the required items
• Different comportements for mobs
• A sword can shop tree and create a box
• A shovel can plant a seed in a grass block
• A bucket can be filled by water and used to grow a sprout or die a fire
• A bolt has infinite damages, has a three blocks range and set tree to fire
• Fire can spread
• Read a book or paper, change pages

Map from test.map