Log In  

Hi PICO-8 community! My name is Jay and I've been a PICO-8 fan for a long time and I wanted to gauge interest in a book I'm writing. The book takes you through the journey of creating a whole game using PICO-8. I start you from scratch and not only shows you the code, but I walk you through it with explanations and pictures. I also discuss design, game development process, offer insights and take you through the journey of making a game. I've attached a 3 page excerpt from my book so far and wanted to get thoughts from everyone. My goal is to teach you to make a game by walking you through one. I hope to give you an appreciation for game creation and in the process you learn something about design, art and code.

A year ago I wanted to clone one of my favorite arcade games Defender. Except that I had the idea of documenting what I did the whole time. It took a while but I have a stack of notes of not only the creation of it, but the design exercises of why things are they way they are and justifying the order of each feature. After I finished, I realized that I could write a book that walks you through the whole thing. I've written 5 chapters so far and I'm estimating how much work it would be to finish and thinking about if anyone would find it useful or interesting.

If you had a book like this, what would you want or expect from it?

A 4 page excerpt of what I'm thinking:

Gif of the final game:

Thanks in advance!

P#66668 2019-08-14 07:07 ( Edited 2019-08-14 07:18)

A zero-to-Defender book certainly makes sense.
Does your game touch on the map? (not obvious for such game) but would be a big gap in a pico8 book.
Do you plan to have advanced chapters, like sfx manipulation via poke or shading via peek/poke?

Coding style comment: you introduced the table in the chapter, yet youvare using the dot notation directly.
This is actually called a dictionary/hash map in a standard CS littérature.
May be the standard syntax could be clearer for noobs:


Note the table is also very close to the value vs reference concept, something that most would-be gamedev have a lot of difficulty to grasp.
Do you plan a chapter on that?

Good luck!

P#66670 2019-08-14 07:39 ( Edited 2019-08-14 07:41)


Yes I would do all of it including the radar. The book is targeted to everyone including beginners. Whether you can absorb all of it or have to just follow along I am explaining everything along the way.

Thanks for the comment on the notation. I start out being explicit so that there is no ambiguity for what’s going on for beginners. Then I introduce other notation as you describe.

As far as value vs reference concepts I try to teach them by example and show them the rules for how it works without going too far into the weeds. I am not expecting this to be a whole CS course. What I am expecting is that it will prime any new comer to then pursue programming and game making.

I’ve done research and learned that clear ideas are more useful than “right” ideas. For example, we all learn in elementary school that electrons “orbit” nuclei in atoms like planets orbit the sun. This is useful enough to have a discussion about matter but it’s wrong. Electrons move in probability clouds. But probability clouds is not useful to learn for non-physicists. So the solar model works fine. Im doing the same by explaining the mechanics of how it works without wading too deep into CS theory. I’m trying to be as simple as possible and I’m finding that to still be hard but not impossible. There are times where I think I need the user to just come along and type in a helper function and I don’t expect them to understand it, but I expect them to learn what it does and use it. That make sense? A tree this book, they can take their basic understanding and learn how it really works. Learn about probability clouds

P#66671 2019-08-14 07:57 ( Edited 2019-08-14 08:02)

Makes sense - looking forward for a hardcover print at my local library!

P#66675 2019-08-14 09:45
:: Felice

@freds72, when you asked about the map, did you mean the PICO-8 tile map, or the radar in the game?

I ask because I think @MasterHyjinx read it as the radar, while you meant the PICO-8 tile map.

P#66678 2019-08-14 18:29

I did mean the built-in pico tile map - yeah!

P#66680 2019-08-14 19:21 ( Edited 2019-08-14 19:28)

@Felice @freds72, Ah, you are correct I did misread that. I decided to not use the map. Instead I went for procedurally generating the terrain and walk the reader through a simple algorithm to do it. The way I was thinking about it, was that the topics go too far and too wide and I wanted to constrain the tools and what was needed to build. So therefore cloning an arcade game is a good idea. If this book ends up being worthwhile, then I already sketched out a second book that does a platformer that walks the user through that and makes extensive use of the map tool.

P#66682 2019-08-14 19:34

As a total beginner i couldn't be more interested! Looking forward to it!

P#73056 2020-02-13 09:16

That sounds like a great book! I kinda want to get a copy for my dad - he loved Defender in his youth and he was interested in learning more about PICO-8.

Awkward question: I think PICO-8 Lua variables are global by default? In the snippet, you talk about initializing a variable outside all the functions to make it global, but I've never had to do that. More the reverse - I've had to explicitly declare them local to make them not global.

That said: hope the build and the book go really really well!

P#73063 2020-02-13 13:16
:: dw817

I'm just waiting for when this great game of DEFENDER for Pico-8 is coming out so I can play it ... !

P#73090 2020-02-14 04:53 ( Edited 2020-02-14 04:53)
:: sparr

While I don't expect a book like this to be targeted at people like me, I'd love to read it, and to help proof and make suggestions if you'd like.

P#73094 2020-02-14 07:40

[Please log in to post a comment]

Follow Lexaloffle:        
Generated 2020-02-21 07:23 | 0.048s | 2097k | Q:34