Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/TeamNoComplyGames/pico8Grunt

A build system for pico8 games, using gruntjs
https://github.com/TeamNoComplyGames/pico8Grunt

Last synced: 6 days ago
JSON representation

A build system for pico8 games, using gruntjs

Awesome Lists containing this project

README

        

# pico8Grunt
A build system for pico 8 using GruntJS

# What is pico8Grunt?
pico8Grunt is a very simple build system utilizing grunt to make writing code for pico8 a bit easier. pico8Grunt will watch all .lua files in the src/ directory, concatenate them into one file, and then regex the contents of this concatenated file back into the cart. This allows for multiple .lua files to be used with a single cart, and watching for file changes.

# How do I used pico8Grunt?
**Steps:**

1. Install [Nodejs, NPM](https://nodejs.org/en/download/package-manager/), with the alternative of using [NVM](https://github.com/creationix/nvm) for an easier/better way to install

2. Install [grunt-cli](http://gruntjs.com/getting-started)

3. Download this project as a zip, and extract in your desired location.

4. Run `npm install` inside of the project

5. Copy the contents of your pico 8 cart (****.p8) into the file cart.p8, and place at the root of the project

6. Take the lua code in your cart, and divide it up into as many .lua files as you would like under the src/ directory

7. run `grunt` to build the code into the cart, or use `grunt watch` to watch the .lua files and automatically build them

8. Within pico8, navigate to the project, and run `load cart.p8`, and then enter `run`, and the cart should work great! **Note:** If you make any art/audio changes to the project, you should run `save cart.p8` before running load again. You could lose your changes!

**If you would like to try the project first, it already has a "Hello world" that you can play with :)**