EcoSim

🏆 Best ML Project — BrisHack 2025

EcoSim is a Java-based simulation developed during BrisHack 2025. It models the interactions between various animal species and their environment, utilizing procedural terrain generation and intelligent agent behavior.

Features

• Procedural Terrain Generation: Uses Perlin noise to create realistic and dynamic terrain landscapes.
• Animal AI with Decision-Time Planning: Animals use Pure Monte Carlo Game Search to move intelligently, avoiding predators, seeking food, and reproducing.
• Predator-Prey Dynamics: Implements a food chain where animals interact based on hierarchical levels, engaging in hunting, fleeing, and breeding behaviors.
• Environmental Factors: Includes terrain types that influence movement and survival.
• Graphical Interface: Built using JavaFX, allowing users to visualize the ecosystem in real time.
• Event Logging and Statistics: Displays ecosystem events and population statistics in real-time.

Prerequisites

• Java Runtime Environment (JRE): Ensure you have Java installed. You can download it from the official Oracle website.

Running the Application

To execute the EcoSim JAR file, download the pre-built JAR file from the releases section:

Using the Command Line:

• Open a terminal or command prompt.

• Navigate to the directory containing ecosim.jar.

• Run the following command:

  java -jar ecosim-1.0.0.jar

• Ensure that the JAR file has execute permissions. If not, modify them using:

  chmod +x ecosim-1.0.0.jar

• If double-clicking the JAR file doesn't launch the application, running it via the command line as shown above is recommended.

Contributing

We welcome contributions! Please fork the repository and submit pull requests for any enhancements or bug fixes.

License

This project is licensed under the MIT License. See the LICENSE file for details.