Skip to content

raghul-tech/Neural-Forge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

19 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿง  NEURAL FORGE: MACHINE BUILDER

Gamedev.js Jam 2026 License Wavedash Open Source

Build a living machine brain that learns over time. Reach 1000 points within 15 loops to win!


๐ŸŽฎ ABOUT THE GAME

Neural Forge is a strategic builder game where you create a network of machines that learn and evolve. Each machine acts like a brain cell. Connected together, they "think" and produce SCORE points.

๐ŸŽฏ OBJECTIVE

  • Reach 1000 SCORE within 15 loops to achieve machine consciousness
  • Strategically place and connect machines to optimize your neural network
  • Balance resource management with network complexity

๐ŸŽฎ GAMEPLAY LOOP

  1. Select a machine from library
  2. Click on grid to place it
  3. Machines automatically connect nearby
  4. Press EVOLVE LOOP to end round
  5. Your machines produce resources and SCORE
  6. Repeat until you reach 1000 SCORE!

SCREENSHOTS

Game Layout

Game Layout

Game Play Area

Game Play Area


MACHINE TYPES

Machine Icon Cost Role Best Placement
SENSOR ๐Ÿ“ก 15 ๐Ÿ”ฉ Starts signal (like eyes) Beginning of network
PROCESSOR ๐Ÿง  25 ๐Ÿ”ฉ Thinks and calculates Middle of network
MEMORY ๐Ÿ’พ 30 ๐Ÿ”ฉ Remembers past loops After 5+ machines
ACTUATOR ๐Ÿฆพ 20 ๐Ÿ”ฉ PRODUCES SCORE! End of network
CONNECTOR ๐Ÿ”— 10 ๐Ÿ”ฉ Links far apart machines When network grows
MUTATOR ๐Ÿงฌ 40 ๐Ÿ”ฉ Evolves connections Late game

๐Ÿ† WINNING STRATEGY

Loops Strategy Goal
1-3 2 SENSORS + 2 PROCESSORS + 1 ACTUATOR Build foundation
4-7 Add 2 ACTUATORS + 1 MEMORY Double production
8-12 Add CONNECTORS + MUTATOR Boost learning
13-15 Maximize ACTUATORS Reach 1000 SCORE!

๐Ÿ•น๏ธ CONTROLS

Action How
Select machine Click on machine card
Place machine Left click on grid
Remove machine Right click on grid
Move camera Click + drag on grid
End loop Click EVOLVE LOOP
Auto-build Click AUTO-BUILD
Reset game Click RESET

๐Ÿš€ QUICK START

Play Online

  1. Visit live demo
  2. Click HELP to read instructions
  3. Start building your neural network!

Local Development

# Clone the repository
git clone https://github.com/raghul-tech/Neural-Forge.git
cd Neural-Forge

# Simply open index.html in your browser
# Double-click index.html or right-click โ†’ Open with browser

Note: This is a pure HTML/CSS/JavaScript game - no server required! Just open index.html directly.


๐Ÿ“ PROJECT STRUCTURE

Neural-Forge/
โ”œโ”€โ”€ index.html          # Main game page
โ”œโ”€โ”€ style.css           # Game styling & animations
|โ”€โ”€ js
|  โ”œโ”€โ”€ game.js             # Core game logic
|  โ”œโ”€โ”€ neural-net.js       # Neural network AI
|  โ”œโ”€โ”€ sounds.js           # Sound effects
|โ”€โ”€ img
|  โ”œโ”€โ”€ img1.png      # Game Layout
|  โ”œโ”€โ”€ img2.png   # Game Play area
โ”œโ”€โ”€ README.md           # This file
|โ”€โ”€ CHANGELOG.md        # Version history
|โ”€โ”€ CONTRIBUTING.md     # Contribution guidelines
|โ”€โ”€ wavedash.toml        # WaveDash configuration
โ””โ”€โ”€ LICENSE             # MIT License

๐Ÿ› ๏ธ TECHNICAL FEATURES

Core Technologies

  • Pure JavaScript - No external frameworks
  • HTML5 Canvas - Smooth grid-based rendering
  • CSS3 - Modern UI with neon animations
  • Web Audio API - Dynamic sound effects

Game Systems

  • Neural Network - Machines that learn and adapt
  • Camera Panning - Drag to move around large grid
  • Resource Management - Strategic spending
  • Auto-save - Progress persists across sessions
  • Win/Loss States - Persistent game results

Visual Design

  • Cyberpunk aesthetic with neon cyan/gold colors
  • Smooth animations and visual feedback
  • Responsive layout for all screen sizes
  • Mini-map shows your position in the world

GAME FEATURES

Feature Description
35x25 World Large grid you can pan around
6 Machine Types Each with unique role
15 Loops Limited rounds to reach goal
Learning System Machines adapt over time
Auto-build AI Computer helps with placement
Sound Effects Audio feedback for actions
Confetti Celebration on victory!
Persistent Saves Game state survives refresh

๐ŸŒ CHALLENGES ENTERED

This game is submitted to the following Gamedev.js Jam 2026 challenges:

Challenge Status
๐ŸŸข Open Source by GitHub โœ… Code on GitHub with MIT license
๐ŸŸข YouTube Playables โœ… Works in 2 minutes, mobile friendly
๐ŸŸข Deploy to Wavedash โœ… Leaderboard & analytics integrated

๐Ÿ“Š STATISTICS TRACKED

Stat What It Means
SCORE Your progress toward 1000 goal ๐Ÿ†
RESOURCES Currency to buy machines ๐Ÿ”ฉ
LOOP Current round (max 15)
INTELLIGENCE How smart your network has become
MACHINES Number of machines placed
CONNECTIONS Links between machines
LEARNING RATE How fast machines adapt

๐Ÿ’ก TIPS FOR BEGINNERS

  • Start simple - Just build SENSOR โ†’ PROCESSOR โ†’ ACTUATOR first
  • Actuators win games - They're the only machines that produce SCORE
  • Keep machines close - They auto-connect within 2 spaces
  • Use AUTO-BUILD - The AI helps when you're stuck
  • Read the HELP menu - Full strategy guide inside the game

๐ŸŒ BROWSER SUPPORT

Browser Support
Chrome 60+ โœ… Full
Firefox 55+ โœ… Full
Safari 12+ โœ… Full
Edge 79+ โœ… Full
Mobile browsers โœ… Touch support

๐Ÿ“ VERSION HISTORY

Version Date Changes
1.0.0 April 2026 Initial release for Gamedev.js Jam 2026

๐Ÿ™ ACKNOWLEDGMENTS

  • Gamedev.js Jam 2026 - For the amazing event and theme "Machines"
  • Wavedash - For leaderboard and analytics platform
  • Open Source Community - For inspiration and tools
  • All playtesters - For valuable feedback

๐Ÿ“„ LICENSE

This project is licensed under the MIT License - see the LICENSE file for details.

You are free to:

  • โœ… Use this code commercially
  • โœ… Modify and distribute
  • โœ… Use privately
  • โŒ Hold liable (use at your own risk)

๐Ÿ”— LINKS

Platform Link
Play Online GitHub Pages
Itch.io Entry raghul-tech.itch.io
GitHub Repo github.com/raghul-tech/neural-forge
Wavedash wavedash.com/games/neural-forge

๐Ÿ‘จโ€๐Ÿ’ป DEVELOPER

Created with โค๏ธ for Gamedev.js Jam 2026

Theme: "Machines"
Year: 2026
Duration: 13 days


๐Ÿ“ž CONTACT


โญ RATING & REVIEWS

If you enjoy Neural Forge, please:

  • โญ Star the GitHub repository
  • ๐ŸŽฎ Rate on Itch.io
  • ๐Ÿ“ข Share with friends

Build your machine brain. Reach 1000 score. Win the jam. ๐Ÿ†

Made for Gamedev.js Jam 2026 - Theme: "MACHINES"

About

Build a living machine brain that learns over time. Reach 1000 score in 15 loops. Made for Gamedev.js Jam 2026.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors