{"id":20631935,"url":"https://github.com/mariarodr1136/verticalvictory","last_synced_at":"2025-03-08T22:37:09.175Z","repository":{"id":262157496,"uuid":"886384515","full_name":"mariarodr1136/VerticalVictory","owner":"mariarodr1136","description":"VerticalVictory is an interactive Connect 4 game where players take turns dropping discs into a grid to connect four in a row—horizontally, vertically, or diagonally. The game ends when a player wins or the grid fills without a winner (a draw) 🎱","archived":false,"fork":false,"pushed_at":"2024-11-10T21:29:00.000Z","size":516,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-17T07:21:32.749Z","etag":null,"topics":["2d-game","connect-4","cpp","cpp-game","game-development","game-logic","interactive","multiplayer","multiplayer-game","sfml"],"latest_commit_sha":null,"homepage":"","language":"C++","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/mariarodr1136.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":"2024-11-10T21:16:42.000Z","updated_at":"2024-11-10T21:34:03.000Z","dependencies_parsed_at":"2024-11-10T22:29:01.417Z","dependency_job_id":"969c3ba4-c15e-4ba9-b04f-3e196fd0fe62","html_url":"https://github.com/mariarodr1136/VerticalVictory","commit_stats":null,"previous_names":["mariarodr1136/verticalvictory"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariarodr1136%2FVerticalVictory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariarodr1136%2FVerticalVictory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariarodr1136%2FVerticalVictory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariarodr1136%2FVerticalVictory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mariarodr1136","download_url":"https://codeload.github.com/mariarodr1136/VerticalVictory/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242619105,"owners_count":20159001,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["2d-game","connect-4","cpp","cpp-game","game-development","game-logic","interactive","multiplayer","multiplayer-game","sfml"],"created_at":"2024-11-16T14:14:11.990Z","updated_at":"2025-03-08T22:37:09.156Z","avatar_url":"https://github.com/mariarodr1136.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VerticalVictory - A Connect 4 Game 🧩\n\n![C++](https://img.shields.io/badge/Languages%20\u0026%20Frameworks-C%2B%2B-blue) ![SFML](https://img.shields.io/badge/Languages%20\u0026%20Frameworks-SFML-lightblue)\n\n## Overview\nVerticalVictory is a fun and interactive implementation of the classic **Connect 4** game. Players take turns dropping their discs into a grid with the objective of connecting four of their discs in a row—horizontally, vertically, or diagonally. The game is won when a player achieves this connection, or when the grid is full without a winner (a draw).\n\nThis project was built using **C++** and **SFML** for graphical user interface (GUI) rendering. The game provides a visually appealing experience with real-time interaction.\n\n\u003cimg width=\"696\" alt=\"Screenshot 2024-11-10 at 4 14 54 PM\" src=\"https://github.com/user-attachments/assets/ba20164f-b3bb-4889-8e68-4027c83500d1\"\u003e\n\n\n## Table of Contents\n- [Overview](#overview)\n- [Features](#features)\n- [Technologies Used](#technologies-used)\n- [Installation](#installation)\n    - [Prerequisites](#prerequisites)\n    - [Installing SFML on macOS](#installing-sfml-on-macos)\n- [Usage](#usage)\n- [Contributing](#contributing)\n- [Contact](#contact-)\n\n## Features\n- **Two-player gameplay**: Players take turns in a competitive match.\n- **Graphical Interface**: A simple and clear display of the Connect 4 grid.\n- **Winning and Draw Detection**: Automatic detection of win conditions and draws.\n- **Reset Option**: After a match, players can reset the game board and start again.\n\n## Technologies Used\n- **C++**: Programming language used to build the core game logic.\n- **SFML**: Simple and Fast Multimedia Library for graphical rendering, window management, and event handling.\n- **Git/GitHub**: Version control and hosting of the project repository.\n\n## Installation\n\n### Prerequisites\n- **C++ compiler** (e.g., g++, clang++)\n- **SFML** library installed (For installation details, see below)\n\n### Installing SFML on macOS\n1. Install SFML using Homebrew:\n   ```bash\n   brew install sfml\n2. Clone this repository:\n   ```bash\n   git clone https://github.com/mariarodr1136/VerticalVictory.git\n3. Navigate into the project directory:\n   ```bash\n   cd VerticalVictory\n4. Compile the code:\n   ```bash\n   g++ connect4.cpp -o connect4 -std=c++11 -I/opt/homebrew/include -L/opt/homebrew/lib -lsfml-graphics -lsfml-window -lsfml-system\n5. Run the game:\n   ```bash\n   ./connect4\n\n## Usage\n\n- Launch the game by running the compiled executable.\n- Players will take turns clicking to drop discs into the grid.\n- The game automatically detects if a player has won or if the game is a draw.\n- After a game ends, click to reset and start a new match.\n\n## Contributing\nFeel free to submit issues or pull requests for improvements or bug fixes. You can also open issues to discuss potential changes or enhancements. All contributions are welcome to enhance the app’s features or functionality!\n\nTo contribute, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch for your feature or bug fix:\n   ```bash\n   git checkout -b feat/your-feature-name\n- Alternatively, for bug fixes:\n   ```bash\n   git checkout -b fix/your-bug-fix-name\n3. Make your changes and run all tests before committing the changes and make sure all tests are passed.\n4. After all tests are passed, commit your changes with descriptive messages:\n   ```bash\n   git commit -m 'add your commit message'\n5. Push your changes to your forked repository:\n   ```bash\n   git push origin feat/your-feature-name.\n6. Submit a pull request to the main repository, explaining your changes and providing any necessary details.\n\n## Contact 🌐\nIf you have any questions or feedback, feel free to reach out at [mrodr.contact@gmail.com](mailto:mrodr.contact@gmail.com).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmariarodr1136%2Fverticalvictory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmariarodr1136%2Fverticalvictory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmariarodr1136%2Fverticalvictory/lists"}