A terminal-based snake game written in Odin, featuring smooth gameplay, colorful graphics, and responsive controls.

This snake game was created to:

• Learn Odin Programming: Explore the Odin programming language through a practical, fun project
• Practice Data-Oriented Design: Implement efficient game logic using structured data types
• Terminal Graphics: Create an engaging visual experience using ANSI escape sequences
• Game Development: Understand core game mechanics like collision detection, input handling, and game loops

• Smooth Gameplay: Fixed-timestep game loop for consistent movement
• Colorful Graphics: ANSI color codes for visual appeal (green snake, red food, gray borders)
• Responsive Controls: Support for both arrow keys and WASD
• Score System: Track your progress with points for each food item
• Game States: Proper game over and restart functionality
• Clean Terminal: Automatic cursor hiding and screen clearing

You need the Odin compiler installed on your system. Visit odin-lang.org for installation instructions.

1. Clone or download the project:

   git clone https://github.com/pmbanugo/snake_game.odin
   cd snake_game.odin

2. Compile the game:

   odin build main.odin

3. Run the executable:

   ./snake_game

Or compile and run in one command:

odin run main.odin

1. Control the snake to eat food (red circles)
2. Avoid hitting the walls or your own body
3. Grow longer each time you eat food
4. Score points - 10 points per food item
5. Game over when you collide with walls or yourself

The game follows a data-oriented design approach:

• Game State: Central state structure containing snake position, direction, food location, and score
• Terminal Handling: Raw terminal mode for direct input without buffering
• Fixed Timestep: Consistent game timing using 120ms tick rate
• Collision Detection: Efficient boundary and self-collision checking

• Vec2: 2D vector for positions
• Direction: Enum for snake movement
• Game_State: Main game data structure
• Terminal Control: ANSI escape sequences for rendering
• Input System: Non-blocking keyboard input handling

• Memory Efficient: Dynamic arrays for snake segments
• CPU Optimized: Small sleep intervals prevent excessive CPU usage
• Smooth Rendering: Double buffering effect with clear screen and redraw

snake_game.odin/
├── main.odin          # Main game source code
├── snake_game         # Compiled executable
├── .gitignore         # Git ignore file
└── README.md          # This documentation

• Data-Oriented: Structured approach with clear data types
• Modular: Separated concerns (input, rendering, game logic)
• Documented: Clear section headers and comments
• Error Handling: Proper cleanup with defer statements

You can easily modify:

• Game dimensions: Change WIDTH and HEIGHT constants in main()
• Game speed: Adjust tick_rate in the main loop
• Colors: Modify ANSI color codes in rendering functions
• Starting position: Change snake initialization in init_game()

If the game doesn't display correctly:

• Ensure your terminal supports ANSI escape sequences
• Try resizing your terminal to at least 40x20 characters
• Some terminals may require enabling raw mode support

If compilation fails:

• Verify Odin is properly installed and in your PATH
• Check that you're using a compatible Odin version
• Ensure all dependencies are available (core Odin packages)

If the game feels laggy:

• Close other applications that might be using CPU
• Try a smaller terminal window
• Adjust the tick rate for faster/slower gameplay

This project is open source. Feel free to learn from, modify, and distribute the code.

Interested in contributing? Consider:

• Adding new features (power-ups, obstacles, levels)
• Improving performance or code quality
• Adding sound effects or music
• Creating different game modes

Enjoy playing! 🎮