༼ つ ◕_◕ ༽つ Survival simulation

---

This Java project runs a simulation of a random population of peasants that are eating carrots and trying to survive. The concept is inspired by this video from CodeBH YouTube channel : https://youtu.be/qVOjXQUzOJw?si=32QMRubXAz1onQ3U

---

✨Features

• ✅ Main

  • The Main file, when run, displays the UI of the simulation. You can launch it, pause it as you want. The simulation data will be automatically saved in the log files in resources/logs.

• ✅ Logger

  • The Logger file, when run, runs a simulation of 100 days dans stores the logs automatically. This class is meant to give the possibility of generating quickly a large amount of data for analysis.

---

(●ˇ∀ˇ●) Usage

Just clone the repo, add javaFX 21 to your project and run the Main or the Logger and that's it! ✪ ω ✪

---

（＾-＾）How the simulation works ?

When you launch the Main, the simulation will initialize automatically, and you can launch it with the corresponding button. If you do so, the simulation will start and will be displayed on real time on the UI. You can stop/pause the simulation at any time with the same corresponding button.

During this simulation, the corresponding number of houses generated is random (from 2 to 15) and each house can contain a maximum of 10 peasants. At the initialisation, the base number of peasants in a house os also generated randomly between 2 and 10. The position of each house is also generated randomly all over the map excluding the last row, this exclusion is necessary to ensure the spawn coordinate from the house is in the map.

During each day, at each tick a peasant goes out form his house and tries to find food, to eat a carrot. The carrot dpawn randomly and when eaten they respawn automatically on a random cell during the next tick. To eat a carrot, the peasant has to go on the carrot's cell and then eats it in 1 tick. To survive the day, a peasant has to eat at least 3 carrots and get back to his house when the night (ARTEMIS period) starts.

How works the day/night cycle ? A day (HELIOS) lasts 100 ticks, when it finishes, the period passes to night (ARTEMIS). During the night, all peasants stop chasing carrots, and they run to their houses to go to sleep. Then, the peasants that have not eaten enough die and the others reproduce. Peasants can reproduce only in the same house, and they can't be more than the max number of peasants in a house.

What is HADES ? The Hades period is reached only if no peasants are alive anymore, it's a dead game !

---

Everything ahs been covered, how the simulation works, what you can do, what you can't, as your only live interaction is pause/play any parametrization is made through the constants in the code that you are free to change to see how will these simulations evolve (maybe with more houses, fewer carrots, longer days...). Moreover, each simulation is registered automatically in log files in the resources directory even if the simulation is closed non expectedly (the registration occurs while the simulation is done).

---

(☞ﾟヮﾟ)☞ Project Structure

src
└── main.java
    ├── Game.java                    # Core game simulation logic
    ├── components
    │    ├── Element.java            # Base part of each entity in the simulation
    │    ├── House.java              # House
    │    ├── Peasant.java            # Peasant
    │    └── eatable
    │         ├── Eatable.java       # Eatable abstract class
    │         └── Carrot.java        # Carrot 
    │
    ├── gui
    │    └── Main.java               # JavaFX application entry point
    │
    ├── logger
    │    └── Logger.java             # Log system implementation to save records, logs
    │
    └── utilities
        ├── Coordinates.java        # Definition of Coordinates
        ├── Movable.java            # Movable interface
        └── Preconditions.java      # Checking utility class


resources
├── logs
│    ├── data_exploitable            # Structured log data for analysis explotation
│    └── verbal                      # Logs more humand-readable
│
└── style.css
    └── simulation.css               # JavaFX stylesheet


test
└── main.java.utilities
    └── MyCoordinatesTest.java       # Unit tests for Coordinates

---

(╯°□°）╯︵ ┻━┻ Logs example

Verbal logs

============================================================
            SIMULATION ENGINE — STARTUP
============================================================

Simulation ID   : 2026-02-25T10:13:54.412498600
Launch Time     : 2026-02-25T10:13:54.412498600
Status          : INITIALIZING

--- WORLD SNAPSHOT -----------------------------------------

Houses          : 8
Max peasant per house : 10
(45,13);(29,20);(32,13);(22,17);(24,15);(46,30);(53,21);(15,24);
Population      : 48
Quantity to eat : 3

Eatables        : 160
Eatable ratio   : 20
Map Size        : 60 x 40
Period          : HELIOS

--- SYSTEM INFO --------------------------------------------

Thread          : JavaFX Application Thread
Java Version    : 22.0.2
============================================================
Day 0
============================================================

Period          : HELIOS
Status          : RUNNING

--- POPULATION ---------------------------------------------

Total Population: 48
============================================================
                        Day 1
============================================================
Period          : HELIOS
Status          : RUNNING
--- POPULATION ---------------------------------------------
Total Population: 66
Population evolution: 37.5 %

============================================================
Day 2
============================================================
Period          : HELIOS
Status          : RUNNING
--- POPULATION ---------------------------------------------
Total Population: 76
Population evolution: 15.151515151515152 %

============================================================

Data logs

# Simulation Metadata
# simulation_id=2026-02-25T10:10:38.452758600
# houses_count=15
# max_peasant_per_house=10
# eatables_ratio=20
# houses_coordinates=(25,4);(55,33);(9,6);(18,1);(22,11);(54,16);(25,25);(0,31);(58,28);(34,21);(54,1);(8,2);(53,25);(47,15);(55,23);
day,period,total_population,delta_population_percent
0,HELIOS,82
1,HELIOS,100,21.951219512195124
2,HELIOS,112,12.0
3,HELIOS,126,12.5
4,HELIOS,142,12.698412698412698
5,HELIOS,147,3.5211267605633805
6,HELIOS,150,2.0408163265306123
7,HELIOS,150,0.0

---

(┬┬﹏┬┬) Tests

We provided some basic tests in the test directory for Coordinates just to be sure the instantiation was good as well as the equals method but for the main code the only test is to try it and verify by hand. O_O

---

🔄 You can now make it your own and update it !!!

You can simply add new Eatable if you want or you can change all the parameters and static final constants in Game or in the other classes. Most of the constants are in Game but some aren't such as: MAX_HEALTH of a Carrot in Carrot class; DEFAULT_CREATION_GENERATED in House; or QUANTITY_TO_EAT in Peasant. The Logger is also quite simple to change to update so mae it yours !!!

---

⚠️ Performance Note
If you try to speed the JavaFX simulation, you'll reduce 'DELTA_TIME_MS' but if you reduce it a lot, as for example 
to 1ms, your simulation will just crash X﹏X .

---

Authors

salimek
🔗 GitHub – salimek

Sami Kabbaj
🔗 GitHub – Sami Kabbaj

---

📄 License

For more details, see the LICENSE file.