Tooth is a microscopic multiplayer "space trader" kind of game with a biological twist. Players take on the role of microscopic goblins living inside bacteria cells, navigating through a liquid medium in someone's mouth.

• Players: Microscopic goblins that inhabit and control bacteria cells
• Environment: A living ecosystem within someone's mouth
• Planets: Larger cells or groups of cells that serve as hubs
• Movement: Fluid dynamics in a liquid medium
• Gameplay: "Space trader" mechanics adapted to a microscopic biological setting

This project is based on a series of "tooth goblin" comics that explore themes of isolation and communication. The comics follow a goblin living in a big metropolitan bacterial colony within a tooth, who learns to use radio equipment to communicate within and beyond the human host. The main inspiration comes from the song "Stay Tuned" covered by Robert Wyatt.

The game brings this comic world to life as an interactive multiplayer experience, expanding on the themes of connection, isolation, and the search for communication in unexpected places.

• Add energy property to entities (max energy: 100)
• Energy consumption rate (1.5 energy per second while moving)
• Visual energy indicator (entity size/color changes with energy)
• Death when energy reaches 0

Current Implementation:

• Entities start with 100 energy and lose 1.5 energy per second while moving
• Visual feedback: Green (healthy) → Yellow (moderate) → Red (low energy)
• Size scales with energy level (0.5x to 1.2x normal size)
• Dead entities become gray corpses (20% opacity) and remain in the world
• No respawning - creates survival pressure for future resource systems

• Add resource nodes (nutrient particles scattered around world)
• Resource consumption (entities gain energy when touching resources)
• Resource respawning (new resources spawn periodically)
• Resource competition (multiple entities compete for same resources)

Current Implementation:

• Blue pulsing nutrient particles scattered throughout the world
• Resources provide 25 energy when consumed by entities or players
• Resources respawn after 5-10 seconds when consumed
• Minimum of 30 active resources maintained in the world
• Visual feedback with pulsing animation and glow effects
• Players and entities compete for the same resources
• Energy consumption continues while moving (1.5 energy/second)

• Growth mechanics (entities grow larger as they gain energy)
• Division threshold (max energy + size triggers division)
• Division process (split into two smaller entities with half energy each)
• Division cooldown (prevent rapid division spam)

Current Implementation:

• Growth System: Entities grow when energy is above 50% of max energy
  • Growth rate: 0.1 radius units per energy point above 50%
  • Base radius: 18 units, can grow significantly larger
  • Shrinking: Entities shrink when energy drops below 50%
• Division System: Entities divide when they reach a combined energy + size threshold
  • Division threshold: 150 points (energy + (radius - baseRadius) * 10)
  • Division cooldown: 10 seconds between divisions
  • Division process: Creates offspring with 40% of parent's energy and 70% of parent's size
  • Parent retains 40% energy and 70% size after division
  • Offspring have slightly lower division thresholds (90% of parent's threshold)
• Visual Indicators:
  • Entities ready to divide show pulsing magenta rings
  • Generation counter displayed below divided entities (G1, G2, etc.)
  • Size directly reflects growth state
• Population Dynamics:
  • Successful entities can create exponential growth
  • Resource competition limits population growth
  • Generational decay in division thresholds prevents infinite growth

• Health property (separate from energy, represents structural integrity)
• Health decay (entities slowly lose health over time - aging)
• Health regeneration (heal when excess energy available)
• Death from low health (entities die if health reaches 0)

• Environmental interactions (pH, temperature, pressure zones)
• Social behavior (colony formation, communication, symbiosis)
• Advanced environmental effects (fluid dynamics, saliva flow, oxygen levels)

1. Install dependencies:

   npm install

2. Start the server:

   npm start

3. Open your browser at http://localhost:3000

   • Open in multiple tabs or devices to test multiplayer.

• server/: Node.js + Express + Socket.IO server
  • index.js: Main server entry point
  • app.js: Express app configuration
  • game/: Game logic and state management
  • network/: Socket.IO event handlers
• client/: Client-side code
  • index.html: Main HTML file
  • client.js: Client entry point
  • game/: Game rendering and logic
  • ui/: User interface components
  • network/: Client-side networking

• Multiplayer: Players can join and see each other in real-time
• Movement: WASD or arrow keys to move, mouse to look around
• Entities: AI-controlled bacteria that consume energy while moving
• Resources: Blue nutrient particles that provide energy when consumed
• Energy System: Players and entities lose energy while moving, gain energy from resources
• Survival: Entities and players die when energy depletes, creating pressure for resource systems
• Visual Feedback: Energy levels shown through color and size changes, energy UI display
• Resource Competition: Multiple players and entities compete for the same limited resources
• Growth & Division: Entities grow when well-fed and can divide to create offspring
• Population Dynamics: Successful bacteria can create exponential growth, limited by resource competition

• Add more game logic, sync entities, handle disconnects, etc.