KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

love2d_arkanoid_tutorial

★ 234 Open GitHub ↗

Tutorial on making a full-featured arkanoid (breakout)-type game with LÖVE framework.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

This tutorial describes how to write a more or less full-featured [Arkanoid](https://en.wikipedia.org/wiki/Arkanoid) ([Breakout](https://en.wikipedia.org/wiki/Breakout_%28video_game%29)) clone.

Here are several screenshots from various stages of the development process:
<p align="center">
<a href="https://github.com/noooway/love2d_arkanoid_tutorial/wiki/The-Ball,-The-Brick,-The-Platform"><img src="https://github.com/noooway/love2d_arkanoid_tutorial/blob/master/doc/img/1-01.png" width="300"/></a>
<a href="https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Levels"><img src="https://github.com/noooway/love2d_arkanoid_tutorial/blob/master/doc/img/1-06.png" width="300"/></a>
<br>
<a href="https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Add-New-Ball-Bonus"><img src="https://github.com/noooway/love2d_arkanoid_tutorial/blob/master/doc/img/3-07.png" width="300"/></a>
<a href="https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Wall-Tiles"><img src="https://github.com/noooway/love2d_arkanoid_tutorial/blob/master/doc/img/3-11.png" width="300"/></a>
<br>
<a href="https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Packaging"><img src="https://github.com/noooway/love2d_arkanoid_tutorial/blob/master/doc/img/3-17.png" width="300"/></a>
</p>

The intended audience are people, who have basic programming experience, but have
trouble structuring their code for projects bigger than "Hello World".
An Arkanoid, while simple, contains many elements found in more elaborate games.
My aim is to introduce a typical code structure,
and to provide a starting point for further modifications.

**Chapter 1** describes how to build a prototype for an Arkanoid-type 
game in the most straightforward way,
without relying too much on any external libraries or advanced language features.

**Chapter 2** expands the prototype, introducing gamestates, basic graphics and sound.
At the end of this chapter, the general frame of the game is complete. What is left
is to fill it with the details.

**Chapter 3** proceeds to add functionality to achieve a full-featured game. 
While the first two chapters are rather general, material in this chapter is mostly 
specific for Arkanoid-type games.

**Appendices** - which are not written yet :) - demonstrate some additional topics, such as how to use environments to 
define Lua modules, classes, and so on.

I realize that the length of the tutorial - almost 30 parts -
is probably a bit too much. On the other hand,
the amount of work necessary to write a game is
commonly underestimated and this tutorial 
clearly shows what it actually takes to develop even a simple one.

Lua programming language and [LÖVE](https://love2d.org/) framework are used.
Basic programming experience is assumed.
Familiarity with Lua and LÖVE is beneficial but not necessary.
Some non-obvious Lua idioms are briefly explained.

The code can be downloaded using `git` 
```
cd /your-path/
git clone https://github.com/noooway/love2d_arkanoid_tutorial
```
or by Github's ["Clone or download -> Download ZIP"](https://github.com/noooway/love2d_arkanoid_tutorial/archive/master.zip) button.

Each step can be run with the LÖVE interpreter by issuing a `love` 
command followed by the folder name, for example
```
cd /your-path/love2d_arkanoid_tutorial
love 1-01_TheBallTheBrickThePlatform 
```

One last thing before we start: feedback is crucial.
If you have any critique, suggestions, improvements or just any other ideas, please let me know.

Contents:

**Chapter 1: Prototype**

1. [The Ball, The Brick, The Platform](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/The-Ball,-The-Brick,-The-Platform)
2. [Game Objects as Lua Tables](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Game-Objects-as-Lua-Tables)
3. [Bricks and Walls](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Bricks-and-Walls)
4. [Detecting Collisions](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Detecting-Collisions)
5. [Resolving Collisions](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Resolving-Collisions)
6. [Levels](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Levels)

&nbsp;&nbsp;&nbsp; Appendix A: [Storing Levels as Strings](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Storing-Levels-as-Strings)  
&nbsp;&nbsp;&nbsp; Appendix B: Optimized Collision Detection ([draft](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Optimized-Collision-Detection))

**Chapter 2: General Code Structure**

1. [Splitting Code into Several Files](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Splitting-Code-Into-Several-Files)  
2. [Loading Levels from Files](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Loading-Levels-From-Files)
3. [Straightforward Gamestates](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Straightforward-Gamestates)
4. [Advanced Gamestates](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Advanced-Gamestates)    
5. [Basic Tiles](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Basic-Tiles)
6. [Different Brick Types](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Different-Brick-Types)  
7. [Basic Sound](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Basic-Sound)  
8. [Game Over](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Game-Over)

&nbsp;&nbsp;&nbsp; Appendix B: Stricter Modules  
&nbsp;&nbsp;&nbsp; Appendix C-1: Intro to Classes  
&nbsp;&nbsp;&nbsp; Appendix C-2: Chapter 2 Using Classes.

**Chapter 3 (deprecated): Details**

1. [Improved Ball Rebounds](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Improved-Ball-Rebounds)
2. [Ball Launch From Platform (Two Objects Moving Together)](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Ball-Launch-From-Platform)
3. [Mouse Controls](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Mouse-Controls)
4. [Spawning Bonuses](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Spawning-Bonuses)
5. [Bonus Effects](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Bonus-effects)
6. [Glue Bonus](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Glue-Bonus)
7. [Add New Ball Bonus](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Add-New-Ball-Bonus)
8. [Life and Next Level Bonuses](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Life-and-Next-Level-Bonuses)
9. [Random Bonuses](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Random-Bonuses)
10. [Menu Buttons](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Menu-Buttons)
11. [Wall Tiles](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Wall-Tiles)
12. [Side Panel](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Side-Panel)  
13. [Score](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Score)
14. [Fonts](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Fonts)
15. [More Sounds](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/More-Sounds)
16. [Final Screen](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Final-Screen)
17. [Packaging](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Packaging)

**Additional Topics:**

1. Game Design
2. Minimal Marketing ([draft](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Minimal-Marketing))  
3. Finding a Team

[Acknowledgements](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Acknowledgements)  
[Archive](https://github.com/noooway/love2d_arkanoid_tutorial/wiki/Archive)

love2d_arkanoid_tutorial

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README