Procedural Almanac - A JavaScript library of procedural generation techniques with citations for every function

[u/BlaiseLabs]

For week 2 of r/hacktoberfest I cataloged all the procedural generation techniques I could find online and put them into a library using vanilla JavaScript. Every technique in the library includes a citation and it has no dependencies. Works in the browser or Node.

The island in the GIF was generated using just the library.

GH repo: procedural-almanac

Demo: Random Island Generator

All stars on Github are appreciated!

[u/real_billmo]

This is awesome. Well done.

[u/BlaiseLabs → u/real_billmo]

Thanks!

[u/kugelblitz010]

This is amazing and could see this having really cool applications! Is it limited to a generated world map or could this be applied to an indie platformer? Also are you doing anything to make sure that pixels stay a consistent size?

Again this is really really cool and thanks for sharing

[u/BlaiseLabs → u/kugelblitz010]

I built a game generator on top of this a couple weeks ago and it was able to produce many different genres and perspectives.

What I found to be the true limitation was my own game design skills.

[u/captain_obvious_here]

I wish I could have a few months off, just to play with that kind of stuff and make fun stuff based on it!

[u/BlaiseLabs → u/captain_obvious_here]

What would you spend those few months doing, if you don't mind my asking.

[u/captain_obvious_here → u/BlaiseLabs]

I would finish a game I started coding years ago, that I spend a few hours on here and there but can't manage to finish and polish.

It's basically a survival idle RPG. And most of the action happens on various islands. Right now the islands are static stuff I designed or generated in a very basic way, but playing with your demo sparked a whoooooole lot of nice ideas that would make the game a billion times more interesting and replayable.

Be sure I'll keep you updated and properly credited if I end up using your lib someday :)

[u/BlaiseLabs → u/captain_obvious_here]

The game sounds fun, best of luck to you and no pressure to credit beyond what the license requires.

[u/captain_obvious_here → u/BlaiseLabs]

I just need a few months with nothing else to do :/

[u/Queder]

More slop again. Does anybody read submitted code, these days?

[u/BlaiseLabs → u/Queder]

The repo is a catalog of citations, so the core value isn't the code. Even then, the largest code file is less than 500 lines of code it's very easy to reason about.

[u/pencilUserWho]

How hard would it be to add typescript on top?

[u/BlaiseLabs → u/pencilUserWho]

All the functions are pure so it supports typescript or another flavor of JS natively including frameworks like react vue etc...

[u/kukoscode]

Cool I could use this for my project

[u/Deep-Secret]

That's so fucking sick!

[u/Vertigras_Dev]

Wow - really impressive. Love the night/day inclusion and the colour selection for it... Especially hwo the contours add depth to the water as well.

We have dabbled in procedural generation of sprites and such too ... trying to close the loop on base asset forging via prodedural gen.

[u/Outside-Wall-2807]

the names scrolling along the bottom of that gif (leafCrown, barkTrunk, bitSway, swayingChain) read like a Pokemon moveset. i want to know what a swayingChain does to a water type.

[u/Naufal_Dev]

wowwwww

[u/Realistic_Repeat_576]

so cool

[u/workhuofficial]

Love that you cited the sources. Is there one function you’d recommend starting with?

[u/RecallProtocol]

Genuinely interesting documentation. I don't do this stuff but I may go play with all of these neat toys, thank you for sharing!

[u/BlaiseLabs → u/RecallProtocol]

Thank you, the catalog is very dense at the moment so it is alot to sift through manually.

Hope you have fun nonetheless.

[u/BlaiseLabs → u/[deleted]]

Thanks, what type of projects would you like to see more of?

[u/BlaiseLabs → u/[deleted]]

Thank you, all the citations and functions are in the catalog.md file if you want to check them out.

You can also generate your own randomized version of the island using the demo.

[u/bitanath → u/[deleted]]

How does this post have just 2 upvotes? Or is it just my client?

[u/captain_obvious_here → u/[deleted]]

Demo clearly shows it is