reikonomusha a day ago

This was an incredibly enjoyable read. A lesson to take away is that many of the ideas of Lisp can be taken advantage of without reeling in the entirety of an existing stack.

Writing a Lisp parser is easy. Walking Lisp code is easy. Serializing Lisp code is easy. Adding a new primitive is easy. Adding very basic syntax transforming macros is easy. All of these are virtually trivial if your host language is a Lisp, as was the case with Co2.

What they didn’t do is what many people might think are table stakes with Lisp: writing a garbage collector, writing a runtime, supporting lambdas, and so on. Those are unreasonable asks for 2K RAM on a 6502. I wouldn’t say they wrote a bonafide Lisp, but they made use of many ideas of Lisp successfully to write a game that is very surprisingly readable while not being too abstract over assembly.

Since Lisp began in the 1950s, it has always needed to stay tied to the low level. Even today, with SBCL or CCL, you can write your own assembly code. One relevant thing to the article is Baker’s COMFY 6502 language for writing assembly code [0]. A few implementations can be found on GitHub.


  • tachyonbeam 33 minutes ago

    I think this is very true. It also wouldn't be hard to implement basic function pointers, lambdas that don't capture anything.

  • zozbot234 a day ago

    If you aren't going to have a GC, "rich" runtime or lambda support, what does LISP really bring you over FORTH? And implementations of the latter on 6502 have been commonplace since the 1980s...

    • neilv 19 hours ago

      I understand that Forth is powerful and elegant, and one of the last languages I'd want to take on in a fight when wielded by a master, so let me pretend you were asking about a stripped-down Lisp compared to, say, Pascal, instead:

      * The simple syntax of stripped-down Lisp is very amenable to application-specific or domain-specific macros. This turns out to be a convenient way to do things that often the language or compiler alone can't do as well, if you used only functions, data, and conventions.

      * That the syntax is so simple, and can also be first-class data that is displayed from the programming environment like it looks in syntax, makes it especially nice for things like intermediate representations that are refined incrementally. For example, you can show a translation series of steps that go from syntax parse, to resolutions, to phases of optimizations, to high-level assembler, to a very low-level target code (still represented with parentheses and "opcodes"), from which you write bytes. This can also be convenient.

      In this particular case, they're using Racket (an implementation of a dialect of Scheme) to implement a compiler for a Lisp dialect they invented. Using Racket gives them both a nice general-purpose language for implementing their compiler, and happens to already have a lot of tools for parsing their own stripped-down Lisp and manipulating it.

      IIUC, Naughty Dog used Racket for a similar purpose: to implement their own Lisp. For a narrative DSL for some AAA titles.

    • djmips 18 hours ago

      Hard reasons.

      Forth implementations on the 6502 uses a stack and require more RAM than Co2 which uses a compiled stack.

      I feel like Co2 would compile to faster code but of course I haven't benchmarked this. The reason I feel this is so is that I way I understand compiled forth is that the 'words' are still threaded so you don't escape the interpreter overhead.

      Soft reasons.

      Co2 takes away the chore of parsing, in Forth you are the parser. It's simpler but more error prone and harder to read (subjectively).

      Forth is postfix notation which for a lot of people is challenging.

      • asguy 15 hours ago

        > Forth implementations on the 6502 uses a stack and require more RAM than Co2 which uses a compiled stack.

        I don't know what you mean when you say this. Could you elaborate? Any function call is going to require putting the arguments somewhere.

        > The reason I feel this is so is that I way I understand compiled forth is that the 'words' are still threaded so you don't escape the interpreter overhead.

        Indirect/direct threading at runtime isn't required; it's up to the compiler. There are plenty of Forth cross-compilers (e.g. MPE's) that compile native code (and call it "subroutine threaded"). They don't have an explicit (inner) interpreter... they just use standard CPU opcodes to call/return.

        • saagarjha 15 hours ago

          > I don't know what you mean when you say this. Could you elaborate? Any function call is going to require putting the arguments somewhere.

          There's a footnote in the article that might be helpful:

          > this is thanks to a "compiled stack", a concept that's used in embedded programming, though I had a hard time finding much literature about it. In short, build the entire call graph of your project, sort from leaf nodes to roots, assign to each node memory equal to it's needs + the max(children)

    • pcwalton 18 hours ago

      Not having to think about a stack all the time.

  • cheez 15 hours ago

    They used Lisp to generate machine code. They didn't parse lisp at all. Imagine writing a library in your favorite language to do what they've done.

    • reikonomusha 13 hours ago

      They did parse it, albeit indirectly, by Racket’s reader. Co2 is a language, not a bunch of function calls, so it’s not quite the same as building a library in your favorite language. The article even gives examples of new syntax they produced.

      Parsing Lisp in Lisp is so easy because it’s free.

emptybits 21 hours ago

I loved Lisp upon my first exposure in the late 80s in university. Then I "had" to professionally abandon Lisp leanings because I entered the game industry which required, at the time, a commitment to 8-bit assembly code. No problem. Lisp remained a hobby. Fast forward! Unexpected intersect! I love this so much and thank you for the great writeup!

There's a podcast for present day NES developers called The Assembly Line.[1] I'm sure they'd enjoy this story and talking to you.


nudpiedo a day ago

This is a complete and absolute hack and I love it. When reading the README file of their github it is possible to see how "impure" pragmatic decisions were made like for loops and not supporting proper recursion. I wish there would be more projects like this one porting lisp runtimes to more and more hardware.

In the other hand the racket lisp behind the scenes _generates_ the assembly code based on some of the scheme primitives rather than porting its whole Racket runtime there, which in spite of not being the same as running a lisp in the NES hardware is still impressive.

  • TurboHaskal a day ago

    Most Lispers and some Schemers are quite pragmatic in that regard. With the former favouring OOP and looping over recursion and the latter using imperative code when it matters.

    With developer mindshare flocking to the Haskell view of FP, for the Lisp family, only the Clojure users seem to still hold purity in high regard.

    • agentultra a day ago

      Purity isn't in contrast with pragmatism; what Haskellers refer to as purity is referential transparency.

      You can still do this kind of work in Haskell as well. It is a great imperative language.

      Though as someone who has written assembler compilers in Common Lisp... it's felt relatively easy to do in CL. I've only heard people talk about writing control software for drones from Haskell. I have no idea how one would do that in practice though.

    • ska 21 hours ago

        With the former favouring OOP and looping over recursion
      Not my experience at all, fwiw.
      • TurboHaskal 4 hours ago

        While I will not try to debate your experience, I will provide some extra context for my previous assertion:

        You cannot program in CL without using the CLOS. Most CL books go into great detail explaining it and the MOP, they are also full of looping constructs, even using GOTO. The only exceptions are Graham's books.

        In open source, it is frowned upon to use recursion as TCO is not part of the standard. Some functions are even inlined for better performance.

drcode a day ago

I'm struggling with the same problem: I'm a Lisp programmer who's writing a commercial game, in my case a Unity engine game, which requires C#.

I've opted for a less elegant, but technically simple strategy: I'm writing all the build tools/content tools in Clojurescript, and then writing only the core game engine in raw C#.

Next, I'm using to cross-compile the game engine into javascript, which I can then link to from clojurescript so that all unit tests and 90% of all QA testing can be done via clojurescript tooling, without any C# in sight.

This allows me to deploy a commercial game in "native" C# without any performance penalty, but with as few lines of C# as humanly possible.

  • outworlder 19 hours ago

    That sounds like a great approach. I often wondered how to get Scheme code running in Unity.

    Can you fire up a REPL while the game is running? That would be huge.

    Many years ago I experimented with the idea of creating games for iOS in Chicken Scheme. Because I'm exceedingly lazy and did not want to bother with cross-compilation – unless it became a serious project – I just told Chicken's compiler to stop at the C code generation step. The Makefile would then copy the generated (and quite unreadable) C code to the XCode project, and then compile the whole thing together with any Objective-C code I had.

    With very little setup code, you could embed arbitrarily large Chicken programs. And given Chicken's excellent C interop, the Objective-C code could easily call Scheme functions (the reverse is not as trivial, so I just wrote wrappers for the handful of Objective-C functions I needed – which weren't many in a game).

    The only piece missing at the time was that Chicken did not have OpenGL-ES bindings. I solved that by copying code from Gambit Scheme, and using a couple of very trivial macros to make it compatible.

    That worked beautifully. I could even start a remote REPL and instantly change running code over the network, no matter if it was running in a real device or the simulator. And I mean instantly: the next rendered frame would already have the changes.

    Then I hit my roadblock: I had successfully solved the technical problem, so I lost interest in pursuing the game, which was ostensibly the reason why I had embarked on this detour to begin with. Oh well.

  • chasote 2 hours ago

    Have you explored Arcadia at all? It uses the Clojure CLR port to hook into Unity with some sweet repl goodness. There seems to be some active development and I hope it works out great.

    • drcode an hour ago

      It's a cool project, but I mad the judgement that it was too risky as a dependency for my game.

  • mikepurvis a day ago

    This seems really complicated, relative to using the Clojure CLR port. Is it just not mature enough, or were there other advantages to going via JS?

    • drcode a day ago

      Using Clojure CLR would make the build process simple, at the cost of some complexity and likely a performance penalty in the deployed application.

      On the other hand, my strategy makes the final deployed application dead simple and fast, but leads to a build process that's complex and messy.

      It seems objectively true that the latter approach is going to be less risky, because if the final deployed game doesn't work well, the whole project is f###ed.

      The only way to mitigate this risk and still stay with 100% Lisp is to create your own Lisp compiler, which is exactly what OP did... but that way lies insanity :)

j_m_b a day ago

One of the advantages of lisp is REPL-driven development. I imagine you can't just edit a fn, eval it and then see the changes immediately. What is the workflow like when creating a NES game using co2?

  • bitwize 13 hours ago

    I dunno about Co2, but the last time I heard about a project like this -- Naughty Dog's GOAL -- they absolutely could compile GOAL on the fly on the development PC and send it immediately to run on the PS2 dev kit inside an already running game. REPL-driven development directly on a game console. It was awesome.

jasperpilgrim a day ago

This is impressive. I appreciate you documenting the development of it and giving an overview of what's going on inside. I wish there were more blog posts like this. Have you reached out to the Racket community about the game and co2? Also, would you say this Lisp is geared more toward people who already know 6502 assembly, and not toward people who just want to write a NES game in a Lisp?

  • djmips 19 hours ago

    With only looking through the article and being a 6502/NES programmer myself, you can't escape having to know 6502 and the NES hardware to write a NES game. This Lisp is cool and it will certainly smooth the process and is a good fit for an Adventure game and other parts of NES game development where you aren't counting cycles (like UI).

    • jasperpilgrim 8 hours ago

      Good to know. Assuming it's true that 6502 asm is not too difficult to learn, co2 looks like it would be fun to work with on a simple game. Really neat project.

anon9001 21 hours ago

If you like this, you should also check out the work around Retro City Rampage. RCR is a GTA1 clone for multiple platforms from a few years back, but the developer also made a real NES ROM of it. Here's a great talk about that process:

(I'm not related to the project, but it's one of the few games I've 100% completed because it was just so good)

  • djmips 19 hours ago

    I don't think they finished the NES version?

edmoffo 2 hours ago

Lisp is and was the best programming language. I moved to Java many years ago and still regret :)

fouc 13 hours ago

Looking at the code examples of the entity system in this article made me wonder what it'd be like to code a MUD in this language or in lisp generally.

Does anyone know if there are any MUDs out there coded in lisp? I didn't find any good results in google aside from the MPI lisp-like language built on top of FurryMUCK.

gautamcgoel a day ago

Really cool article. I appreciated the "engineering on the battlefield" vibe. I'm curious why they first went with Lisp.

CoolGuySteve a day ago

I’d like to hear more about the compiled stack.

In extremely latency sensitive applications, the mix of stack and instruction cacheline faults can cause significant overhead.

  • zozbot234 a day ago

    No cache lines on a 6502, though!

    • CoolGuySteve 21 hours ago

      I'm talking about modern architectures

seisvelas a day ago

They made their language using Racket! Great to see Racket style Language Oriented Programming being used for something so cool

soulofmischief 15 hours ago

Cool! Thanks for sharing! Just picked up the game, it looks awesome.

ngcc_hk a day ago

Very impressive and readable. Congratulations!!!

ninkendo a day ago

I know it's off-topic but I appreciate so much when somebody hosts their own blog rather than using Medium or some nag-ware hosting service.

I didn't get any pop-up "pardon[ing] the interruption" or asking me to join a mailing list, or anything! To think this used to be the normal way of doing things on the web.

  • scrollaway a day ago

    The other side of that coin is that on mobile the article is painful to read and the layout is horrible.

    For what it's worth I hate medium as well. But I would recommend if you want to go with self hosting.

    • shantly a day ago

      > The other side of that coin is that on mobile the article is painful to read and the layout is horrible.

      Looks reader-mode-compatible in Safari, which solves the problem for any site that's mostly content.

    • ngcc_hk a day ago

      Seems ok reading in my mobile safari, not even using reader mode.

      • saagarjha 15 hours ago

        The code causes the page to scroll horizontally, unfortunately. Not a big deal, though: Reader Mode solves this on the client-side, and the website just needs to add CSS that lets the code scroll.