# owenashurst/agar.io-clone

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/owenashurst-agar-io-clone).**

2,964 stars · 1,184 forks · JavaScript · MIT

## Links

- GitHub: https://github.com/owenashurst/agar.io-clone
- awesome-repositories: https://awesome-repositories.com/repository/owenashurst-agar-io-clone.md

## Description

This project is a browser-based, real-time multiplayer action game where players control a character on a 2D canvas to absorb objects and grow in size. It utilizes a Node.js game server and WebSockets to synchronize game state, player movement, and chat across all connected participants.

The application is delivered as a dockerized game application, ensuring consistent hosting and deployment across different cloud environments through containerized server environments.

The system implements an authoritative server model that processes all game logic and physics to prevent cheating and maintain a single source of truth. Core gameplay mechanics include consumption-based growth, character movement control, and a real-time chat system for broadcasting messages between players.

Additional capabilities include player identity assignment, network latency measurement via request-response handshaking, and client-side canvas rendering for visual feedback.

## Tags

### Networking & Communication

- [Multiplayer Game Servers](https://awesome-repositories.com/f/networking-communication/real-time-communication/multiplayer-game-servers.md) — Builds a shared real-time world where multiple players interact and move via a central authoritative server.
- [Game State Synchronization](https://awesome-repositories.com/f/networking-communication/packet-engines/packet-redirection/game-state-synchronization.md) — Streams calculated game logic results from the authoritative server to clients to ensure consistent visual rendering of all entities. ([source](https://cdn.jsdelivr.net/gh/owenashurst/agar.io-clone@master/README.md))
- [Socket Communication](https://awesome-repositories.com/f/networking-communication/socket-communication.md) — Uses persistent WebSocket connections to synchronize real-time positions and actions between the server and clients. ([source](https://github.com/owenashurst/agar.io-clone/wiki))
- [Real-time Messaging](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/communication-platforms/real-time-collaboration-suites/real-time-messaging.md) — Provides a real-time chat interface for players to exchange text and server commands during active gameplay. ([source](https://cdn.jsdelivr.net/gh/owenashurst/agar.io-clone@master/README.md))
- [Broadcast Messaging](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/real-time-communication/broadcast-messaging.md) — Implements a messaging system that broadcasts chat text from a single sender to all participants via the server. ([source](https://github.com/owenashurst/agar.io-clone/wiki/Game-Architecture))
- [In-Game Chat Systems](https://awesome-repositories.com/f/networking-communication/in-game-chat-systems.md) — Integrates a real-time text communication system that allows players to chat during active gameplay.

### Part of an Awesome List

- [Character Controllers](https://awesome-repositories.com/f/awesome-lists/devtools/character-controllers.md) — Provides a controller system for moving avatars via pointer position and handling mass-splitting shortcuts. ([source](https://github.com/owenashurst/agar.io-clone/wiki/How-to-Play))

### Game Development

- [Browser Action Games](https://awesome-repositories.com/f/game-development/browser-action-games.md) — Provides a browser-based action game where players control a character to absorb objects on a 2D plane.
- [Consumption Mechanics](https://awesome-repositories.com/f/game-development/consumption-mechanics.md) — Implements a mechanic where characters increase in size by consuming food particles or smaller opponents. ([source](https://github.com/owenashurst/agar.io-clone/wiki/How-to-Play))
- [Growth Mechanics](https://awesome-repositories.com/f/game-development/growth-mechanics.md) — Tracks mass gained from consuming objects to dynamically adjust the character's size and movement speed. ([source](https://cdn.jsdelivr.net/gh/owenashurst/agar.io-clone@master/README.md))
- [Authoritative Game Logic Hosts](https://awesome-repositories.com/f/game-development/online-multiplayer/game-servers/authoritative-game-logic-hosts.md) — Implements an authoritative server that validates all movement and combat logic to prevent cheating.
- [Web Game Servers](https://awesome-repositories.com/f/game-development/web-game-servers.md) — Uses a Node.js-based web game server to manage connections and broadcast state updates.
- [Containerized Game Deployment](https://awesome-repositories.com/f/game-development/game-engines-frameworks/cross-platform-engines/containerized-game-deployment.md) — Provides a containerized deployment of the game server and client for consistent cloud hosting.
- [Containerized Deployments](https://awesome-repositories.com/f/game-development/online-multiplayer/game-servers/containerized-deployments.md) — Packages the server environment into portable Docker images for consistent cloud deployment.

### Graphics & Multimedia

- [Canvas Rendering](https://awesome-repositories.com/f/graphics-multimedia/canvas-rendering.md) — Uses client-side canvas rendering to draw the game world and provide smooth visual feedback.

### Software Engineering & Architecture

- [Server-Side Logic Frameworks](https://awesome-repositories.com/f/software-engineering-architecture/server-side-logic-frameworks.md) — Implements server-side logic to calculate movement and combat, preventing client-side manipulation. ([source](https://github.com/owenashurst/agar.io-clone/wiki/Game-Architecture))

### Web Development

- [WebSocket State Synchronization](https://awesome-repositories.com/f/web-development/state-syncing-reactivity/websocket-state-synchronization.md) — Uses persistent WebSocket connections to synchronize real-time game state across all clients.

### Data & Databases

- [Chat Message Broadcasting](https://awesome-repositories.com/f/data-databases/record-updating/live-update-subscriptions/event-stream-broadcasters/custom-event-broadcasting/chat-message-broadcasting.md) — Provides a real-time chat system for broadcasting messages between all connected players.