{"id":25715149,"url":"https://github.com/mscrnt/textadventure","last_synced_at":"2026-05-06T14:40:35.163Z","repository":{"id":208878253,"uuid":"722698664","full_name":"mscrnt/TextAdventure","owner":"mscrnt","description":"A texted based gaming using PySide and OpenAI","archived":false,"fork":false,"pushed_at":"2023-12-10T19:44:00.000Z","size":14714,"stargazers_count":2,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-25T13:50:45.576Z","etag":null,"topics":["gamedev","json","openai","pyside6","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mscrnt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-23T18:19:24.000Z","updated_at":"2024-04-07T15:11:28.000Z","dependencies_parsed_at":"2023-11-23T19:59:44.600Z","dependency_job_id":"9bd7e73e-5925-4980-b516-039e4758d312","html_url":"https://github.com/mscrnt/TextAdventure","commit_stats":null,"previous_names":["mscrnt/textadventure"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mscrnt/TextAdventure","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mscrnt%2FTextAdventure","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mscrnt%2FTextAdventure/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mscrnt%2FTextAdventure/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mscrnt%2FTextAdventure/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mscrnt","download_url":"https://codeload.github.com/mscrnt/TextAdventure/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mscrnt%2FTextAdventure/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32699097,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T08:33:17.875Z","status":"ssl_error","status_checked_at":"2026-05-06T08:33:17.221Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gamedev","json","openai","pyside6","python3"],"created_at":"2025-02-25T13:43:18.907Z","updated_at":"2026-05-06T14:40:35.146Z","avatar_url":"https://github.com/mscrnt.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\n\n# Text Adventure Game - Project README\n\n## Introduction\n\n### Warning!!!\n\nThis project is in early alpha. Quests have not been implemented. Player can move around and interact with environment in limited ways.\n\nWelcome to my Text-Based Adventure Game, an engaging and interactive experience where your choices shape the narrative. Enhanced with AI, this game offers a unique journey through a world of mystery and challenges, featuring exploration, interaction with objects and NPCs, and solving puzzles or completing quests.\n\n## Features\n- **AI-Enhanced Gameplay:** Dynamic storylines and reactive game environments powered by OpenAI's GPT model, allowing for natural language understanding and creative storytelling.\n- **Customizable Worlds:** Explore a variety of worlds, each with its unique set of challenges and story elements.\n- **Dynamic Characters:** Interact with a cast of evolving characters and engage with NPCs within the game world.\n\n## Technologies Used\n- **Programming Language:** Python\n- **User Interface:** PySide\n- **Data Handling:** JSON for efficient game data management\n- **AI Integration:** Advanced AI algorithms for an adaptive game experience\n\n## Installation\n1. Clone the repository and ensure Python 3.7+ is installed.\n2. Create a virtual environment using `python -m venv venv`.\n3. Install PySide and other dependencies using `pip install -r requirements.txt`.\n4. Run the game using `python main.py`.\n5. To use the AI assistant, you will need to create an OpenAI account and set the `OPENAI_API_KEY` environment variable to your API key.\n    - You can use the flag --use-ai to enable the AI assistant.\n\n## How to Play\nBegin by creating your character, select a world to start in, and navigate the game using intuitive text commands. Engage with the game using text commands, with the AI assistant interpreting your inputs for immersive interactions.\n\n## Game Components\n\n## data/docs/\n- Contains documentation for the game's data files, including JSON references and AI Assist class reference.\n\n### main.py\n- Entry point of the application, initializing the game and managing the main loop.\n\n### game_ui.py\n- Manages the game's user interface, handling game output, user inputs, and UI updates.\n\n### main_window.py\n- Creates the main application window, integrating UI components and managing events.\n\n### game_manager.py\n- Core game logic controller, managing game states, player interactions, and progression.\n\n### player_sheet.py\n- Manages player data, tracking inventory, stats, and characteristics.\n\n### quest_tracker.py\n- Quest management system for monitoring progress, triggers, and completions.\n\n### world_builder.py\n- Constructs and manages the game world, generating locations, NPCs, events, and handling interactions.\n\n### ai_assist.py\n- Integrates AI for enhanced interaction, processing player commands and providing dynamic responses.\n\n### utilities.py\n- Provides utility functions, including JSON file handling for loading and saving game data.\n\n## Game Mechanics\n- **Exploration:** Travel through various locations within the game world.\n- **Inventory Management:** Collect, use, and manage items.\n- **Quests:** Complete quests for rewards and story progression.\n- **Interactions:** Engage with NPCs and objects within the game world.\n\n## Data Structure\n- The game's world and player data are stored in JSON format, facilitating easy modification and expansion.\n\n## Contribution\n- **Adding Content:** Modify JSON files to add new items, locations, or quests.\n- **Customization:** Adjust game mechanics or AI responses in the Python files as needed.\n\n## Support\nFor any issues or suggestions, please open an issue on the project's GitHub page.\n\n## Acknowledgements\n\n---\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmscrnt%2Ftextadventure","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmscrnt%2Ftextadventure","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmscrnt%2Ftextadventure/lists"}