Joy Machine - Repo of Things

Currently Being Developed Alongside Steel Hunters

This is Joy Machine's public repository of everything that we can easily separate from our main engine and game source base that we think is useful for people. There are some proprietary things we'd adore to include as well, but alas, we have to have some secrets.

We're adding to this pretty regularly, so check in every now and then to see what's new. And, of course, if there is anything in particular that you're looking for, just put up an Issue in the repo and we'll see what we can do. Or we'll shoot your idea down instantly and viciously.

But, if you want to read more, check out the Joy Machine Development Blog's post about this repo you're looking at right now.

Most recent change log (which is poorly-updated until we finally find a good generator): CHANGELOG.md.

• assets — General-purpose game assets to do with as you please.
  • terrain — An older iteration of the landscape that I was using for the Nevada environment (the current one is much better, but I need to keep some things internal for obvious reasons). The main attraction here is the node graph for the entire landscape build... but it requires both World Machine 3 and GeoGlyph 2. So, in the spirit of things, I included the output of a previous build I did with that graph. However: the output is not as good as the actual node graph will export (I made did cleanup and made some improvements before putting it in this repo); I'll try and update these files with shiny, new data if I get a spare eight hours to build the thing.
• git — Some git configurations for ignoring files, LFS-managed files, and then detailed config settings for everyday interaction with git on the command line.
• joy-create (wip) — This is a work-in-progress Electron application (eventually a general web app as well) for using l-systems/turtle instantiation of shapes/meshes to create exportable OBJ/FBXs out of the results. As noted: very work-in-progress.
• scripts — Miscellaneous scripts (tools, powershell, visual studio extensions, batch files, etc.)
• ue4-source — Whatever C++ actors/components/utilities/etc. we end up being able to easily divorce from our projects. Or, if not easily divorced, whatever seems worth divorcing so others never have to know the pain that we did. This will likely be the least frequently-updated part of the repo.
  • NOTE: The source is kind of a free-for-all; I infrequently add some of the more generic/widely-useful stuff I can, but I can't include the full source integrations (such as, in the case of the anamorphic lens flares, the updated Scene.h|.cpp nor PostProcessing.cpp) due to a whole lot of custom work done.
  • The anamorphic lens flare code is also a very rough first-draft.
  • The object pooling code is not ready for production use by any means at the moment; it looked like it would be lovely and fine, but it is not. It is a wolf dressed up as a friendly grandmother and it will eat all joy from you.
• ue4 — Our general-purpose Unreal Engine 4 stockpile. Contains our team production conventions and, more interestingly at the moment, a variety of material functions and our "standard shader set" (they're just materials, but I call them shaders because they're pretty... intense).
  • NOTE: These assets are output from Unreal Engine 4.19; there are archived versions of them (without the changes) for 4.17 in the 4.17 subfolder.

Other Things of Note:

• RESEARCH PAPERS - For the nerdier among us (like me), here are some of the better research papers/presentations I've come across over the years. That have survived over time.
• RESOURCES — A list of general resources for game development across a number of disciplines. (Work-in-Progress at the moment)
• AWESOME_SOFTWARE — Has a list of all of the software that I (trent) have found to be the best solution within its given context.
• AWESOME_GAMEDEV_MENTORS — Technically, it's "twitter-mentors", but I like my name better. Anyway, this is @ishansharma's compilation of people (@trentpolack included) who offer game development mentoring to anyone that seeks it.
• Unreal Engine 4 - General Information — A collection of information, links, and whatever else seems helpful to include. It also contains a summary of the UE4 content contained therein.
• Unreal Engine 4 - Joy Machine Conventions — Our internal development conventions for working with UE4.

More to Come!

hugs, Joy Machine

If you have any questions, feel free to email us: [email protected] (or [email protected] if you prefer that).