🌍 Agent-Based Civilization Simulation
Autonomous AI • Emergent Civilizations • Diplomacy • Dynasties • Rebellions
⭐ Support
If you found this project interesting, consider giving it a star. It helps others discover the project and motivates future development.
An agent-based civilization simulation built entirely with Vanilla JavaScript, where autonomous individuals create kingdoms, wage wars, establish cities, build dynasties and generate unique histories through their interactions.
📖 Overview
This project explores how complex civilizations can emerge from relatively simple autonomous rules.
Instead of relying on scripted gameplay or predefined stories, every individual acts independently based on its own needs, relationships and environment.
From these interactions emerge:
- Kingdoms
- Alliances
- Cities
- Dynasties
- Wars
- Legends
- Civil Wars
- Rebellions
Every simulation produces a different history.
✨ Features
🤖 Autonomous AI Agents
Every citizen is simulated independently.
Each individual can:
- Gather resources, trade, fight, heal, spy
- Age naturally and die naturally
- Have a personality (Big Five) and values, inherited from both parents
- Make friends and rivals, fall in love, marry and raise children
- Remember: grief, pride and hunger shape mood and fear
- Pursue goals: revenge, finding a mate, staying close to family
- Become rulers, found dynasties and become legendary figures
👑 Kingdom AI
Kingdoms make strategic decisions based on the current state of the world.
Features include:
- Territory expansion
- Diplomacy
- Alliances
- Warfare
- Reputation
- Legitimacy
- City founding
- Internal stability
- Rebellions
🌍 Emergent Simulation
Nothing is scripted.
Large-scale events arise naturally from interactions between independent systems.
Examples include:
- Border changes
- Political alliances
- Kingdom collapse
- Civil wars
- Dynastic succession
- Historical legends
📸 Screenshots
World Overview
Late Game
Legends
🏗 Project Evolution
| Version | Major Improvements |
|---|
| V1 | Initial civilization simulation |
| V2 | Technology system & named individuals |
| V3 | Utility AI & specialized roles |
| V4 | Diplomacy, trade and espionage |
| V5 | Reputation, alliances and city management |
| V6 | Dynasties, legitimacy, legends and rebellions |
| V7 | Seeded history, Epstein-style rebellion, personalities, relationships, memory, goals, rulers as individuals, droughts |
Earlier versions are preserved in the versions/ directory.
🛠 Technologies
- HTML5
- CSS3
- Vanilla JavaScript
- HTML5 Canvas
No external frameworks or game engines were used.
🎯 Project Goals
The primary objective of this project is to explore:
- Agent-Based Modeling
- Emergent Behaviour
- Utility-Based AI
- Simulation Design
- Complex Systems
Rather than scripting historical events, the goal is to allow believable civilizations to emerge through autonomous decision-making.
🚀 Future Roadmap
- Economy simulation
- Religion
- Cultural evolution
- Richer climate (beyond droughts)
- Procedural world generation
- Save / Load system
- Optional LLM narrator for legends
- Smarter diplomacy
💡 Development Philosophy
This project was developed iteratively over multiple versions, with each iteration introducing new mechanics, improving AI behaviour, and refining the overall simulation.
The focus has always been on building systems that interact naturally, allowing complex behaviours to emerge from relatively simple rules rather than relying on scripted events.
📚 Research & Inspiration
The project was inspired by concepts from:
- Agent-Based Modeling
- Artificial Intelligence
- Emergent Behaviour
- Simulation Design
- Game AI
Development was supported by continuous experimentation, research, technical reading, and iterative refinement throughout the project.
🤝 Development Workflow
This project was developed using modern software development practices.
Claude Code was used as a development assistant for brainstorming ideas, discussing architecture, reviewing implementations and accelerating iteration.
The overall system architecture, simulation mechanics, implementation, balancing, debugging and feature integration were designed, implemented and continuously refined throughout the development of the project.
▶️ Running
Clone the repository:
git clone https://github.com/acarbayk/agent-based-civilization-simulation.git
Open:
index.html
using any modern web browser.
No installation or external dependencies are required.
📄 License
Released under the MIT License.
