Hey everyone. I'm iivii, founder of iivii.games. Currently, I'm working on a course which I hope to publish to the Skillshare platform which will serve as am introduction and eventually an in depth examination and structured learning resource on the Pico-8 platform. I have an extensive, privately cultivated wiki dedicated to all things Pico 8 which will likely be released publicly at some point.
The New and Improved Pico-8 API Documentation!
Alternatively, here's the link in text form: https://iiviigames.github.io/pico8-api
Why is it new?
I've been making a version of my own for some time now, just as I have updated the Sublime Text syntax for Pico-8. Since it's been 9 months since the original maintainer has updated it, I thought it was time to share my version. This work is based on the forked original API made by Neko250.
- Clear version number and more intuitively located information
- New and more specific tabs for content
- Reformatted & rearranged the existing data
- Heavily modified aesthetics, now more like PICO-8 itself
- Many (not all) new functions have been added
- Clear and concise annotations in code blocks
- Pico-8 built-ins highlight,just like they would in the IDE
- Keyboard shortcuts added
- this section needs the most work
- including 1 never found or documented previously, as far as I know
...and lots of love!
I am writing a book, a bible, for Pico-8 at the moment. I needed a reference that was up to date just for this reason alone, as that book has its own (more in depth) reference for the entire API. That said, I will maintain this bad boy for the foreseeable future very, very quickly after Pico 8 updates.
When the day comes I can't or don't wish to, or someone more skilled than myself or Neko250 in the making of API cheatsheets comes along - I will pass it on to a new maintainer. Hell, anyone can fork this and do what they wish, as this project is licensed under creative commons.
Thank you,and please bookmark the API for future use!
A Quick Example
Use the arrow/action keys to move through values and show the outcomes of the new functions:
Printing Without Linebreaks
A redditor posted on the PICO-8 subreddit, and I spent 30 minutes trying to solve his/her problem.
I have a function that prints several numbers, but with each iteration there's a linebreak (\n) when I print. How do I make the printouts come right after each other, instead of on separate lines?
My solution, was the above. It's not perfect, but I didn't have a lot of time to work on it.
I'd like to see anyone fix my code, or come up with a better way, as I found this an interesting
IT DOESN'T WORK YET ON PURPOSE, BUT WILL BE FIXED SOON!
Today, while playing with the default settings on the CLI on Windows, I found a series of colors that I started to really like. So, what does that have to do with this?
Basically, when this cartridge is done, it's going to be a lot of things: but PICO-8 is going to serve as the first star, and from then on, sadly, I believe I will have to write a program of my own. Unless I find a way to display more than the 16 colors - and that's the only reason why.
I have written a program in python that allows one to select any color they see, from anywhere at any time, or simply play around with them til the find one on their own. Then I pipe that on over to a modified form of lua - the Aseprite variety actually.
(I'M ALSO WRITING A SYNTAX HIGHLIGHTER FOR THE ASEPRITE API AND I WOULD LOVE SOME ASSISTANCE IF ANYONE OUT THERE WANTS TO HELP OUT! Its for ST3!)
The aseprite script I have allows one to load a palette from existing .gpl or .pal (which aren't technically supported anymore) files and make use of them in a project, or export them in a wizard-like manner for easy sharing and storage. (IE, it will ask how large you want each square to be, then the max width and length and try its best to make it work within your parameters, if it can't it will suggest the next best thing.) The script can also make a single sprite strip from nothing, and it can be initialized from many places in many ways. Aseprite, Python, Lua, and even Pico-8 with some AHK in there.
In any case, I would love to work on this with a single partner, 2 at the most. If interested, please get back to me! You can reach me here or at my home in Merveilles.
The Growing Collection of Raspberry's...
And I Made One Into a Pi-Co
Except the only problem is...
I can't seem to figure out how to use get it online. It boots right into Pico 8, and was the simplest process I've ever followed for a Pi project. Not even any image writing, just pasting files onto the SD card, which was a first for me. The image/process I followed is here and it works amazingly otherwise. If anyone has any suggestions as to how to alter the boot code (which is open source and listed on Guillermo's github, link is on the same site I already linked to), I'd really appreciate the help!
(Ps, the history of magic book is my attempt at researching "real magic" to help bring some authenticity into an alternate history DND style campaign I'm working on. It is...actually pretty much a very dull book honestly, I was hoping it would be a bit different than it is.)