🔫 ShooterSam

A dynamic first-person shooter game developed with Unreal Engine 5.6.

📖 Overview

ShooterSam is an engaging shooter game project in development using UE 5.6 and C++. This repository serves as a foundation for a modern game, leveraging Unreal Engine's advanced rendering, physics, and gameplay systems to deliver an immersive experience. It features core shooter mechanics, providing a robust starting point for further game development or for exploring Unreal Engine capabilities.

✨ Features

• Responsive Shooter Mechanics: Core gameplay loop with precise shooting, aiming, and movement.
• Weapon System: Basic weapon handling, including firing, reloading, and ammo management.
• Weapon System: Basic weapon handling, including firing, reloading, and ammo management.
• Basic AI System: Placeholder for enemy AI, demonstrating simple enemy behavior.
• Interactive Level Design: Example game levels crafted within Unreal Engine, showcasing environmental interactions.
• C++ Driven Logic: Utilizes C++ for robust and performant gameplay systems and custom components.
• Unreal Engine 5.6: Built on the latest Unreal Engine version, taking advantage of its cutting-edge features.

🛠️ Tech Stack

Game Engine:

Programming Language:

Development Environment:

🚀 Quick Start

To get this Unreal Engine project up and running on your local machine for development and testing, follow these steps.

Prerequisites

• Unreal Engine 5.6: Ensure you have Unreal Engine 5.6 installed via the Epic Games Launcher.
• C++ Development Environment:
  • Windows: Visual Studio 2022 with "Game development with C++" workload installed.
  • macOS: Xcode with the necessary command-line tools.
  • Linux: Clang, GCC, and other build tools as required by Unreal Engine.

Installation

1. Clone the repository

   git clone https://github.com/youssefjango/ShooterSam.git
   cd ShooterSam

2. Generate Project Files For Unreal Engine C++ projects, you need to generate solution/project files for your IDE.

   • Windows: Right-click on ShooterSam.uproject and select "Generate Visual Studio project files".
   • macOS: Right-click on ShooterSam.uproject and select "Services" > "Generate Xcode Project".
   • Linux: Run GenerateProjectFiles.sh from the root of the Unreal Engine installation.

   If you don't see the option to generate project files, ensure the "Unreal Engine Installer" or "Game Development" component is correctly installed with your IDE and Unreal Engine is properly associated with .uproject files.

3. Build the Project Open the generated solution file (ShooterSam.sln for Visual Studio, ShooterSam.xcodeproj for Xcode) in your C++ IDE. Build the Development Editor configuration for your platform. This compiles the C++ game code.

4. Open in Unreal Editor After a successful build, double-click ShooterSam.uproject to open the project in the Unreal Engine 5.6 Editor.

5. Play the Game Once the editor is open, you can:

   • Click the "Play" button in the editor toolbar to play in the editor viewport.
   • Use "Launch" to run a standalone game instance.
   • To create a distributable build, go to File > Package Project > Windows/Mac/Linux.

📁 Project Structure

This project follows the standard Unreal Engine project structure:

ShooterSam/
├── Config/             # Unreal Engine configuration files (.ini files for project settings, input, etc.)
├── Content/            # All game assets (maps, blueprints, meshes, textures, sounds, UI, materials, etc.)
├── Source/             # C++ source code for the game, organized into modules and classes
│   └── ShooterSam/     # Main game module containing C++ classes for characters, weapons, game modes, etc.
│       ├── Public/     # Header files (.h) for C++ classes
│       └── Private/    # Source files (.cpp) for C++ classes
├── ShooterSam.uproject # Main project file, defines engine version and enabled plugins
└── .gitignore          # Standard Git ignore file for Unreal Engine projects

🧪 Testing

Unreal Engine projects typically involve a mix of manual testing within the editor and automated tests.

• Play In Editor (PIE): The most common way to test gameplay changes quickly.
• Standalone Game: Launch the game as a separate executable for more realistic testing.

Development Setup for Contributors

Follow the Quick Start instructions above to set up your development environment. Ensure your Unreal Engine 5.6 installation is up-to-date.

🙏 Acknowledgments

• Built with Unreal Engine 5.6.
• Special thanks to the open-source community for countless learning resources and tools.

📞 Support & Contact

• 🐛 Issues: If you find any bugs or have feature requests, please open an issue on GitHub Issues.
• 📧 Contact: benmounyyoussef@gmail.com

---

⭐ Star this repo if you find it helpful or interesting!

Made by youssefjango