Resolves #19

What is the feature

Implement a battle environment that enables players to compete against each other in real-time, expanding the current functionality beyond the single-player score attack mode.

Why we need the feature

Introducing a battle environment will enhance user engagement by providing a competitive multiplayer experience. This feature will attract a broader user base, encourage community interaction, and add depth to the gameplay, making the application more appealing and enjoyable.

How to implement and why

To implement the battle environment, the following steps are proposed:

1. Modify game_manager Module:

   • Update the game_manager to handle multiple players simultaneously.
   • Implement game state synchronization to ensure all players experience consistent gameplay.
   • Incorporate match-making logic to pair players for battles.

2. Update block_controller.py:

   • Adjust the block controllers to process inputs from multiple players.
   • Manage interactions between players, such as blocking moves or special abilities.

3. Enhance Networking Capabilities:

   • Utilize sockets or a networking library to enable real-time communication between client and server.
   • Ensure low-latency communication to maintain a smooth gameplay experience.

4. Revise start.sh Script:

   • Add options to initiate the game in battle mode.
   • Allow configuration for server or client mode to facilitate networking setup.

5. Update Documentation in doc Directory:

   • Provide detailed instructions on setting up the battle environment.
   • Include guidelines for hosting games and connecting as a player.

6. Adjust Docker Configuration:

   • Modify Docker files to expose necessary network ports.
   • Ensure the containerized environment supports multiplayer networking requirements.

7. Implement Lobby and Match Management:

   • Create a lobby system where players can join or create matches.
   • Implement match management to handle game initiation and termination gracefully.

8. Conduct Thorough Testing:

   • Perform unit and integration tests to validate multiplayer functionality.
   • Test under various network conditions to ensure stability and reliability.

By following these steps, we can systematically build a robust battle environment. Each step ensures that the new feature integrates smoothly with the existing codebase while maintaining performance and code quality.

About backward compatibility

• Maintaining Existing Functionality: The current score attack mode will remain unchanged, allowing users to choose between single-player and multiplayer modes.
• Optional Feature Activation: The battle environment will be an optional mode that does not affect users who prefer the existing gameplay.
• Separate Configurations: Configuration files and scripts will be updated to handle both modes without interference.
• Rigorous Testing: Ensure all existing features work as intended through regression testing.

By keeping the new feature optional and ensuring it does not disrupt existing functionality, we maintain backward compatibility and respect the preferences of current users.

Test these changes locally

git checkout -b gitauto/issue-#19-74740e0d-e181-42c3-b67a-e057e17e5c60
git pull origin gitauto/issue-#19-74740e0d-e181-42c3-b67a-e057e17e5c60