Skip to content

sunnyday-technologies/egg-wars

Repository files navigation

EGG WARS 3D

A 3D educational game where you solve math and spelling challenges to power up, build bridges, and destroy the enemy egg.

Created by J_ware - Junior Developer & Test Engineer

The live web build supports single-player and practice modes. LAN multiplayer requires the Windows desktop build.

Use this build for classroom/home LAN multiplayer. The browser version cannot host or join LAN rooms.

What Is Egg Wars?

Two teams on floating islands, each with an Egg to protect. Solve challenges at Power Cores to earn resources, buy gear at the Shop, build a bridge across the void, and destroy the enemy egg. Beat Jerry the AI opponent if you can.

Features

Educational Challenges:

  • Power Core (easy), Energy Forge (medium), Crystal Nexus (hard)
  • Grade-scaled content: Kindergarten through 5th grade
  • Math: counting, addition, subtraction, multiplication, division
  • Spelling: grade-appropriate words with missing letters
  • 30/25/20 second timers by difficulty

Gameplay:

  • 3D first-person voxel world
  • Build bridges with cement blocks across the void
  • Shop system for cement, apples, and gear
  • Combat, enemy egg defense, and Jerry the AI opponent
  • Random power-ups: Speed Boost, Extra Hearts, Resource Rush

Multiplayer:

  • Desktop-only LAN multiplayer over the local network
  • One player hosts, the other joins with the four-letter room code shown on the host screen
  • Designed for classroom/home WiFi with no cloud relay or internet signaling
  • No game accounts or chat system
  • GitHub Pages/browser builds cannot host or join LAN rooms

Progression:

  • 8 character skins: Tiger, Axolotl, Panda, Bee, Frog, Dragon, Robot, Default
  • Win streak tracking with special messages
  • Local leaderboard
  • Victory confetti and fanfare
  • Difficulty auto-scales with grade and win streak

Mobile/Web:

  • Virtual D-pad for movement
  • Touch-drag to look around
  • On-screen buttons for attack, build, jump, and interact
  • Single-player and practice mode in the web build

Controls

Desktop

Action Key
Move WASD
Look Mouse
Jump Space
Sprint Shift
Attack / Mine Left Click
Place Block Right Click
Interact E (aim at station or shop)
Hotbar 1-9 or Scroll
Use Apple Q

Touch

Action Control
Move D-pad
Look Drag right side of screen
Jump JUMP button
Attack ATK button
Place BLD button
Interact E button

Tech

  • Godot 4.6 project with HTML5 and Windows desktop exports
  • Web build served by GitHub Pages
  • Desktop LAN build uses Godot ENet on port 28960
  • Procedural voxel world, stations, AI opponent, generated UI icons, and procedural sound effects

Version

v2.4.1 - Active-learning economy with LAN build, loot caches, team chests, synced building, and fairer Jerry bridging

License

MIT License - See LICENSE for details.


a sunnyday technologies project

About

3D voxel educational game — solve math & spelling challenges to defend your egg! Created by J_ware

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors