# gemini_cli_planet_adventure
**Gemini CLI Planet Adventure** is an adventure game on command-line interface with Google Gemini AI integrated into it.
# Game Features
1. Exploration of AI generated cities
2. AI generated missions
3. Turn-based battles between players
# Source Code
The source code of the game **Gemini CLI Planet Adventure** is available in
[Source Code](https://github.com/GlobalCreativeApkDev/gemini_cli_planet_adventure/blob/master/gemini_cli_planet_adventure/gemini_cli_planet_adventure.py).
# Installation
```
pip install gemini_cli_planet_adventure
```
# How to Play the Game?
Pre-requisites:
1. [Python](https://www.python.org/downloads/) installed in your device.
2. env file in the same directory as <GEMINI_CLI_PLANET_ADVENTURE_DIRECTORY> and has the value of GEMINI_API_KEY.
3. The directory "saved" exists inside the directory <GEMINI_CLI_PLANET_ADVENTURE_DIRECTORY>. Please create the "saved"
directory if it has not existed in <GEMINI_CLI_PLANET_ADVENTURE_DIRECTORY> directory yet.
First, open a Terminal or Command Prompt window and run the following commands.
```
cd <GEMINI_CLI_PLANET_ADVENTURE_DIRECTORY>
python3 gemini_cli_planet_adventure.py
```
**Note:** Replace <GEMINI_CLI_PLANET_ADVENTURE_DIRECTORY> with the path to the directory of the game
**Gemini CLI Planet Adventure**.
Then, the game will start with something looking like in the screenshot below.
You have two choices:
1. Enter "NEW GAME" to create new saved game data.
2. Enter "LOAD GAME" to load existing saved game data.
# New Saved Game Data Creation
The following happens if you choose to create new saved game data.
You will be asked to enter the player name.
You will then be directed to the main menu.
# Loading Existing Saved Game Data
You will only be able to load existing saved game data if at least one or more saved game files are stored inside the "saved" directory.
The following happens when you choose to load existing saved game data.
You will then be asked to enter the name of the player associated with the existing saved game data you want to load.
After that, your saved game data will be loaded and you will be directed to the main menu.
# Main Menu
Once you reach the main menu, you will be asked whether you want to continue playing the game or not.
If you enter 'Y', you will be directed to choose an action. Else, your game data will be saved and you will exit the game.
# Action Choice
Once you entered 'Y' when you were at the main menu, you will be redirected to action choice. At the top of the command-line
window, you will see the map of the city you are in (together with your current location). Below the map, you will see
the available actions you can choose to do. Battles against wild legendary creatures or trainers might occur
if you enter "1" and then select the direction you want to move to.
Then, you will need to follow the instructions on the screen, for whichever action you choose to do.
Raw data
{
"_id": null,
"home_page": "https://github.com/GlobalCreativeApkDev/gemini_cli_planet_adventure",
"name": "gemini-cli-planet-adventure",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "GlobalCreativeApkDev",
"author_email": "globalcreativeapkdev2022@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b1/22/7d8b2693365344c729313e1960b57b895ea35ca90c7ef50ab7a9fb065cad/gemini_cli_planet_adventure-1.1.tar.gz",
"platform": null,
"description": "# gemini_cli_planet_adventure\n\n**Gemini CLI Planet Adventure** is an adventure game on command-line interface with Google Gemini AI integrated into it.\n\n# Game Features\n\n1. Exploration of AI generated cities\n2. AI generated missions\n3. Turn-based battles between players\n\n# Source Code\n\nThe source code of the game **Gemini CLI Planet Adventure** is available in \n[Source Code](https://github.com/GlobalCreativeApkDev/gemini_cli_planet_adventure/blob/master/gemini_cli_planet_adventure/gemini_cli_planet_adventure.py).\n\n# Installation\n\n```\npip install gemini_cli_planet_adventure\n```\n\n# How to Play the Game?\n\nPre-requisites:\n\n1. [Python](https://www.python.org/downloads/) installed in your device.\n2. env file in the same directory as <GEMINI_CLI_PLANET_ADVENTURE_DIRECTORY> and has the value of GEMINI_API_KEY.\n3. The directory \"saved\" exists inside the directory <GEMINI_CLI_PLANET_ADVENTURE_DIRECTORY>. Please create the \"saved\" \ndirectory if it has not existed in <GEMINI_CLI_PLANET_ADVENTURE_DIRECTORY> directory yet.\n\nFirst, open a Terminal or Command Prompt window and run the following commands.\n\n```\ncd <GEMINI_CLI_PLANET_ADVENTURE_DIRECTORY>\npython3 gemini_cli_planet_adventure.py\n```\n\n**Note:** Replace <GEMINI_CLI_PLANET_ADVENTURE_DIRECTORY> with the path to the directory of the game \n**Gemini CLI Planet Adventure**.\n\nThen, the game will start with something looking like in the screenshot below.\n\n\n\nYou have two choices:\n\n1. Enter \"NEW GAME\" to create new saved game data.\n2. Enter \"LOAD GAME\" to load existing saved game data.\n\n# New Saved Game Data Creation\n\nThe following happens if you choose to create new saved game data.\n\n\n\nYou will be asked to enter the player name.\n\nYou will then be directed to the main menu.\n\n# Loading Existing Saved Game Data\n\nYou will only be able to load existing saved game data if at least one or more saved game files are stored inside the \"saved\" directory.\n\nThe following happens when you choose to load existing saved game data.\n\n\n\nYou will then be asked to enter the name of the player associated with the existing saved game data you want to load. \nAfter that, your saved game data will be loaded and you will be directed to the main menu.\n\n# Main Menu\n\nOnce you reach the main menu, you will be asked whether you want to continue playing the game or not. \nIf you enter 'Y', you will be directed to choose an action. Else, your game data will be saved and you will exit the game.\n\n\n\n# Action Choice\n\nOnce you entered 'Y' when you were at the main menu, you will be redirected to action choice. At the top of the command-line \nwindow, you will see the map of the city you are in (together with your current location). Below the map, you will see \nthe available actions you can choose to do. Battles against wild legendary creatures or trainers might occur \nif you enter \"1\" and then select the direction you want to move to.\n\n\n\nThen, you will need to follow the instructions on the screen, for whichever action you choose to do.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "This package contains implementation of an adventure game on command-line interface with Google Gemini AI integrated into it.",
"version": "1.1",
"project_urls": {
"Homepage": "https://github.com/GlobalCreativeApkDev/gemini_cli_planet_adventure"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f389164f8cac36950ce48494a558e74752eda3cc34e97b84f21d7ddf46124e3e",
"md5": "f57e8989388cafc29c5fec5d6aadca74",
"sha256": "6b6ec3898e1c72d3205452c4b0035cbeb649f67d668fe47115a433170c9d89fb"
},
"downloads": -1,
"filename": "gemini_cli_planet_adventure-1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f57e8989388cafc29c5fec5d6aadca74",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 20981,
"upload_time": "2024-07-30T11:07:12",
"upload_time_iso_8601": "2024-07-30T11:07:12.948413Z",
"url": "https://files.pythonhosted.org/packages/f3/89/164f8cac36950ce48494a558e74752eda3cc34e97b84f21d7ddf46124e3e/gemini_cli_planet_adventure-1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b1227d8b2693365344c729313e1960b57b895ea35ca90c7ef50ab7a9fb065cad",
"md5": "99bcf32b5786d03851a30990e33ce105",
"sha256": "fbf89681723aa409c4bfbadb39f530c0a2198e1d69248eadcfe9ed10cd3de785"
},
"downloads": -1,
"filename": "gemini_cli_planet_adventure-1.1.tar.gz",
"has_sig": false,
"md5_digest": "99bcf32b5786d03851a30990e33ce105",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 21403,
"upload_time": "2024-07-30T11:07:14",
"upload_time_iso_8601": "2024-07-30T11:07:14.413332Z",
"url": "https://files.pythonhosted.org/packages/b1/22/7d8b2693365344c729313e1960b57b895ea35ca90c7ef50ab7a9fb065cad/gemini_cli_planet_adventure-1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-30 11:07:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GlobalCreativeApkDev",
"github_project": "gemini_cli_planet_adventure",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "setuptools",
"specs": [
[
"~=",
"69.5.1"
]
]
},
{
"name": "python-dotenv",
"specs": [
[
"~=",
"1.0.1"
]
]
},
{
"name": "mpmath",
"specs": [
[
"~=",
"1.3.0"
]
]
},
{
"name": "tabulate",
"specs": [
[
"~=",
"0.9.0"
]
]
}
],
"lcname": "gemini-cli-planet-adventure"
}
JSON
