Antarctic Adventures is a text-based adventure exploration game featuring the player as a penguin in Antarctica. The game was created using Python and Grammatical Framework. By typing commands into the chat system, the games uses utilizing natural language processing (NLP) to parse and carry out different command sentences, such as picking up and eating fish and other items and exploring around in the game map.
Table of contents
Note: These commands only run on Linux. If your operating system is Windows, you can install and use Windows Subsystem for Linux.
- Clone the repository in the target file location.
- Run updates on the Linux machine with
sudo apt update && upgrade. - Install Python with
sudo apt install python3 python3-pip ipython3. - Install PGF for Python with
pip install pgf. - Run the program with
python3 main.py.
| File | Contents |
|---|---|
| Adventure.gf | abstract grammar |
| AdventureEng.gf | concrete grammar |
| constant.py | constants |
| event.py | functions for different user-specified commands |
| helper.py | functions helping to carry out miscellaneous tasks |
| main.py | main function |
| output.py | functions for outputting text to the user and logging |
| process.py | fuctions for parsing and processing inputted expressions |
You start at location (0,0), and can command to move in the cardinal directions North, East, West, or South to explore different areas. When moving locations, the program generates a new environment with different items in it. Use this feature to catch fish to eat.
Certain items generate in each environment.
| Environment | Possible items |
|---|---|
| Ocean | Fish |
| Snow field | Ice, Rock, Snow |
You start with MAX_HUNGER and MAX_HP. Each turn, hunger decreases by NORMAL_HUNGER_LOSS_RATE until reaching 0. Eating food will increase the hunger by FOOD_HUNGER_GAIN_RATE. If hunger reaches 0, the HP will decrease each turn by STARVING_HP_LOSS_RATE. If HP reaches 0, the game ends.
| Stat | Amount | Ways to decrease | Ways to increase |
|---|---|---|---|
| Hunger | 0 - MAX_HUNGER | Decreases by NORMAL_HUNGER_LOSS_RATE each turn | Increases by FOOD_HUNGER_GAIN_RATE when eating food |
| HP | 0 - MAX_HP | Decreases by STARVING_HP_LOSS_RATE each turn when Hunger is at 0 | Increases by FOOD_HP_GAIN_RATE when eating food |
* You can modify these constant values in constant.py.
| Food | Environment |
|---|---|
| Fish | Ocean |
- Program states player location, generated environment, and inventory contents
- With commands, player can:
- Pick up items to add to inventory
- Drop items, removing them from inventory and placing them back in environment
- Eat fish, removing them from inventory and increasing hunger
- Move to a different location
- Player dies if HP becomes 0 from hunger loss
- Program generates environments ever time the player moves--does not have a 'map' of the environment to remember where places and things are
- Game crashes when trying to pick up more object than there are on the ground--tell player also how many of an object they see on the ground.
- Add statements for hunger and health instead of numbers, show every few turns, not every turn.
- Show inventory only when player asks
- No statement for when trying to catch fish outside of ocean area/in a place where there is no fish