ypandrew0907 / animal-simulation-game

Dive into Nature Simulation v1, a dynamic ecosystem game. Experience life's balance with interactive controls and stunning visuals of flora and fauna. Engage, learn, and enjoy nature's complexity in a vividly animated environment. Perfect for enthusiasts of simulations and nature.

Animal-Simulation-game

Dive into Nature Simulation v1, a dynamic ecosystem game. Experience life's balance with interactive controls and stunning visuals of flora and fauna. Engage, learn, and enjoy nature's complexity in a vividly animated environment. Perfect for enthusiasts of simulations and nature.

Nature Simulation v1

Introduction

Welcome to Nature Simulation v1, an immersive ecosystem simulation game. Experience the thrill of a dynamic ecosystem, where the balance of life unfolds before your eyes. Watch as rabbits, foxes, and wolves interact in a world filled with trees and survival challenges.

Features

• Dynamic Ecosystem: Experience the life cycle of flora and fauna, each with unique characteristics and survival needs.
• Interactive Simulation Control: Take control of the simulation with simple keystrokes, allowing you to step through the simulation or run it continuously.
• Beautiful Visualisation: Immerse yourself in a beautifully animated world, where every movement and interaction is meticulously rendered for a mesmerizing visual experience.

Getting Started

1. Installation

   • Ensure you have Python and Pygame installed.
   • Download or clone the repository to your local machine.

2. Running the Simulation

   • Navigate to the downloaded directory.
   • Run the simulation using the following command:

     python main.py
     

Controls

• <SPACE>: Run one step of the simulation.
• <ARROW UP>: Run the simulation continuously.

Modules

• main.py: The entry point of the game, handling the game loop and events.
• simulation.py: Contains the logic for the ecosystem, including entity behaviors and interactions.
• settings.py: Defines the settings, constants, and configurations for the game.

Contribution

Feel free to fork the project, submit issues, and send pull requests to help improve the game!

---

Enjoy exploring and understanding the intricacies of nature with Nature Simulation v1!

animal-simulation-game's Issues

Need improve game operation instruction for beginner players

Hello,

I a developer from China, recently find this project and try to play this game. I think it's very good simulation game, have beautiful visualisation, simulate animal life cycle is interesting. But I found a issue when I first time play this game, it's about operation instruction.

I think the operation instruction should have more detail. Now operation instruction only tell for run one step of simulation, for run simulation continuously. But, beginner player like me don't know what is the detail meaning of one step or run continuously when first time play. We don't know what will occur when we press these buttons, will animal move, will animal hunt or anything else? Also there no operation guide in game, beginner player maybe don't know can run simulation continuously.

So, I suggest to improve operation instruction, provide more detail, let beginner player more easy to understand and enjoy this game. If allow, I want open a pull request for this issue, try to contribute to this great project.

Thank you! Looking forward to your response 😄

Release and Tag Management for the game

Hello,

I am a keen user of your innovative Animal Simulation game, and I thoroughly enjoy the experience it provides. Your efforts in creating such an interactive and captivating ecosystem simulation is genuine and impressive. However, as an active participant in open source development and a regular GitHub user, I noticed a significant improvement area in your overall project structure - the lack of versioning through release and tag management.

Using GitHub's release/versioning system would offer numerous benefits:

1. Development Organization: Each release can have its unique tag(s), making it easier to track changes between versions.

2. Usability: End-users can choose to download and use specific versions of your software based on their preference or the stability of certain versions.

3. Troubleshooting: It will be easier for other open-source developers to help solve issues if they can isolate problems to a specific release.

4. Documentation: Users will have a clear understanding of the progress and evolution of your project as well as a detailed log of changes for each new version.

In conclusion, I highly suggest the use of GitHub's release and tagging system in your regular development workflow for the 'Animal-Simulation-game' project. This feature would help us all to stay at the same pace as your project evolves. And that brings added comfort to the many users who enjoy, contribute to, and learn from your project.

Thank you. Looking forward to more project updates soon!

Enhancement - Addition of Pause functionality for continuous simulation

Is your feature request related to a problem? Please describe.
While the continuous run simulation provides a great way to observe the dynamics of the ecosystem over time, there is currently no way to pause the simulation once it begins (unless by closing the application).

Describe the solution you'd like
It would be highly advantageous to have a 'Pause' feature that allows the user to freeze the simulation at any given point in time. This could be achieved by defining another key control such as <ARROW DOWN> or 'P' which once pressed, would pause the ongoing continuous simulation.

This not only enhances user control over the application but also allows for a more detailed study of the ecosystem at a particular instance, which aligns well with the project's aim to "engage, learn, and enjoy nature's complexity".

Describe alternatives you've considered
Another alternative could be to implement a toggle functionality on the <ARROW UP> key such that repetitive pressing of the arrow up key would start and pause the continuous simulation.

Additional context
This feature would likely require changes in the main.py module to handle the additional game event and potentially the update and render processes in the simulation.py module may need to be adapted to respect the pause state.

Looking forward to the community's thoughts on this proposed enhancement.

Implementing a User-Friendly Configuration System for Nature Simulation v1

I've been exploring the project and am excited about the potential for this dynamic ecosystem simulation game. I've noticed that while the current settings are well-defined in settings.py, they are not easily configurable by end-users who may want to customize their simulation experience without diving into the code.

To enhance the user experience and make the game more accessible, I propose the following feature:

Feature: User-Friendly Configuration Interface

Description:

• Goal: Allow users to modify simulation settings (e.g., population sizes, resource availability, predator-prey ratios) through a simple, intuitive interface without requiring them to edit the codebase.
• Implementation: Create a configuration menu within the game that users can access at the start or during the simulation. This menu would present sliders, toggles, and dropdowns for common settings, with the ability to save and load custom configurations.
• Benefits:
  • Users can tailor the simulation to their preferences or educational needs.
  • The game becomes more interactive and engaging, as users can see the immediate effects of their changes.
  • It reduces the barrier to entry for non-technical users who may be interested in the simulation but are not comfortable with coding.

Pull Request Plan:

1. Design: Draft a mockup of the configuration menu and discuss with the team to finalize the design.
2. Development: Implement the menu using Pygame's GUI capabilities, ensuring it is responsive and user-friendly.
3. Testing: Test the new feature extensively to ensure it works seamlessly with the existing game mechanics.
4. Documentation: Update the README.md to include instructions on how to use the new configuration menu.
5. Review: Submit a pull request for code review and merge once approved.

I believe this feature would significantly enhance the game's appeal and usability. I'm eager to contribute to this project and would love to collaborate with the team to bring this enhancement to life. Please let me know if you're interested in discussing this further or if there are any specific concerns or requirements I should be aware of before proceeding.

Thank you for your time and consideration!