This project is an interactive agent-based model simulating consumption of a shared, renewable resource using a game-theoretic framework with environmental feedback. Although its original use was to simulate a ToC scenario with water as the shared resource, it can be applicable for a variety of scenarios including simulating climate disasters, environmental sensitivity to resource consumption, or influence of environmental degradation to agent behaviour. The primary goal of the model is to explore the socio-environmental feedback loops that lead to complex emergent system dynamics. It was inspired by the Weitz et. al. (2016, https://pubmed.ncbi.nlm.nih.gov/27830651/) use of environmental feedback in their paper, as well as the Demographic Prisoner’s Dilemma on a Grid model (https://mesa.readthedocs.io/stable/examples/advanced/pd_grid.html#demographic-prisoner-s-dilemma-on-a-grid). The main innovation of this model is the added environmental feedback with local resource replenishment.

Beyond its theoretical insights into coevolutionary dynamics, this ABM serves as a versatile tool with several practical applications. For urban planners and policymakers, the model can function as a ”digital sandbox” for testing the impacts of locating high-consumption industrial agents, such as data centers, in proximity to residential communities. It allows for the exploration of different urban densities, and the evaluation of policy interventions—such as taxes on defection or subsidies for cooperation—by directly modifying the agents’ resource consumptions to observe effects on resource health. Furthermore, the model provides a framework for assessing the resilience of such socio-environmental systems to external shocks.

The model is built using Mesa 1.2.1 for the model and Solara for the interactive web-based dashboard. While Mesa version 3.0 was available at the time of this project’s finalization, version 1.2.1 was used to ensure functional correctness and maintain compatibility. Initial testing with Mesa 3.0 revealed significant, non-backward-compatible API changes relative to the 1.x series, which would have required a substantial rewrite of the existing, validated codebase. Therefore, to guarantee the stability and reproducibility of the results based on the original model implementation, version 1.2.1 was retained as the foundational dependency for this research.

A model to investigate the Evolution of Conditional Cooperation in a Spatial Public Goods Game. We consider two conditional cooperation strategies: one based on thresholds (Battu & Srinivasan, 2020) and another based on independent decisions for each number of cooperating neighbors. We examine the effects of productivity and conditional cooperation criteria on the trajectory of cooperation. Cooperation is evolving with no need for additional mechanisms apart from spatial structure when agents follow conditional strategies. We confirm the positive influence of productivity and cluster formation on the evolution of cooperation in spatial models. Results are robust for the two types of conditional cooperation strategies.

The emergence of cooperation in human societies is often linked to environmental constraints, yet the specific conditions that promote cooperative behavior remain an open question. This study examines how resource unpredictability and spatial dispersion influence the evolution of cooperation using an agent-based model (ABM). Our simulations test the effects of rainfall variability and resource distribution on the survival of cooperative and non-cooperative strategies. The results show that cooperation is most likely to emerge when resources are patchy, widely spaced, and rainfall is unpredictable. In these environments, non-cooperators rapidly deplete local resources and face high mortality when forced to migrate between distant patches. In contrast, cooperators—who store and share resources—can better endure extended droughts and irregular resource availability. While rainfall stochasticity alone does not directly select for cooperation, its interaction with resource patchiness and spatial constraints creates conditions where cooperative strategies provide a survival advantage. These findings offer broader insights into how environmental uncertainty shapes social organization in resource-limited settings. By integrating ecological constraints into computational modeling, this study contributes to a deeper understanding of the conditions that drive cooperation across diverse human and animal systems.

The Soy2Grow ABM aims to simulate the adoption of soybean production in Flanders, Belgium. The model primarily considers two types of agents as farmers: 1) arable and 2) dairy farmers. Each farmer, based on its type, assesses the feasibility of adopting soybean cultivation. The feasibility assessment depends on many interrelated factors, including price, production costs, yield, disease, drought (i.e., environmental stress), social pressure, group formations, learning and skills, risk-taking, subsidies, target profit margins, tolerance to bad experiences, etc. Moreover, after adopting soybean production, agents will reassess their performance. If their performance is unsatisfactory, an agent may opt out of soy production. Therefore, one of the main outcomes to look for in the model is the number of adopters over time.

The main agents are farmers. Generally, factors influencing farmers’ decision-making are divided into seven main areas: 1) external environmental factors, 2) cooperation and learning (with slight differences depending on whether they are arable or dairy farmers), 3) crop-specific factors, 4) economics, 5) support frameworks, 6) behavioral factors, and 7) the role of mobile toasters (applicable only to dairy farmers).
Moreover, factors not only influence decision-making but also interact with each other. Specifically, external environmental factors (i.e., stress) will result in lower yield and quality (protein content). The reducing effect, identified during participatory workshops, can reach 50 %. Skills can grow and improve yield; however, their growth has a limit and follows different learning curves depending on how individualistic a farmer is. During participatory workshops, it was identified that, contrary to cooperative farmers, individualistic farmers may learn faster and reach their limits more quickly. Furthermore, subsidies directly affect revenues and profit margins; however, their impact may disappear when they are removed. In the case of dairy farmers, mobile toasters play an important role, adding toasting and processing costs to those producing soy for their animal feed consumption.
Last but not least, behavioral factors directly influence the final adoption decision. For example, high risk-taking farmers may adopt faster, whereas more conservative farmers may wait for their neighbors to adopt first. Farmers may evaluate their success based on their own targets and may also consider other crops rather than soy.

This repository contains an agent-based simulation model exploring how status hierarchies influence the emergence and sustainability of cooperation in task-oriented groups. The model builds on evolutionary game theory to examine the dynamics of cooperation under single-leader and multi-leader hierarchies, investigating factors such as group size, assortativity, and hierarchical clarity. Key findings highlight the trade-offs between different leadership structures in fostering group cooperation and reveal the conditions under which cooperation is most stable.

The repository includes code for simulations, numerical analysis scripts, and visualization tools to replicate the results presented in the manuscript titled “Status hierarchies and the emergence of cooperation in task groups.”

Feel free to explore, reproduce the findings, or adapt the model for further research!

Model of influence of access to social information spread via social network on decisions in a two-person game.

This model simulates different trade dynamics in shellmound (sambaqui) builder communities in coastal Southern Brazil. It features two simulation scenarios, one in which every site is the same and another one testing different rates of cooperation. The purpose of the model is to analyze the networks created by the trade dynamics and explore the different ways in which sambaqui communities were articulated in the past.

How it Works?
There are a few rules operating in this model. In either mode of simulation, each tick the agents will produce an amount of resources based on the suitability of the patches inside their occupation-radius, after that the procedures depend on the trade dynamic selected. For BRN? the agents will then repay their owed resources, update their reputation value and then trade again if they need to. For GRN? the agents will just trade with a connected agent if they need to. After that the agents will then consume a random amount of resources that they own and based on that they will grow (split) into a new site or be removed from the simulation. The simulation runs for 1000 ticks. Each patch correspond to a 300x300m square of land in the southern coast of Santa Catarina State in Brazil. Each agent represents a shellmound (sambaqui) builder community. The data for the world were made from a SRTM raster image (1 arc-second) in ArcMap. The sites can be exported into a shapefile (.shp) vector to display in ArcMap. It uses a UTM Sirgas 2000 22S projection system.

ViSA 2.0.0 is an updated version of ViSA 1.0.0 aiming at integrating empirical data of a new use case that is much smaller than in the first version to include field scale analysis. Further, the code of the model is simplified to make the model easier and faster. Some features from the previous version have been removed.
It simulates decision behaviors of different stakeholders showing demands for ecosystem services (ESS) in agricultural landscape. It investigates conditions and scenarios that can increase the supply of ecosystem services while keeping the viability of the social system by suggesting different mixes of initial unit utilities and decision rules.

NeoCOOP is an iteration-based ABM that uses Reinforcement Learning and Artificial Evolution as adaptive-mechanisms to simulate the emergence of resource trading beliefs among Neolithic-inspired households.

The model explores food distribution patterns that emerge in a small-scale non-agricultural group when individuals follow a set of spatially explicit sharing interaction rules derived from a theory on the evolution of the egalitarian social instinct.