A modular system for creating Portal 2 testing chambers in Lego
This repository is a place for any person to create and modify the Modular Portal Testing Chamber project. See "Contributing to the project" for how to share your modifications with everyone.
It's as easy as downloading them! The fastest way might be to clone the entire repository, so you get everything. There are tutorials how to do this online. If you want a few specific files, it might be easiest to download those on their own. I'd ask that you also download the license from this repository.
Here's the process we'll use to incorporate community improvements to the project:
- Fork the repository to your account
- Clone the forked repository to your local computer
- Make your own branch (name it something unique, maybe "yourusername-working")
- Switch to your new branch
- Make changes to files on your local branch. It's a good idea to write down all the changes you make to post them later in yuor pull request.
- Add and commit your changes locally (committing involves writing a message of what you changed; it's a good idea to add and commit often, for small changes).
- Push your changes
- Back on github, create a pull request from your forked repo branch to the main repository's main branch. This is the place where to paste your changes to help us review your changes.
This is a video walkthrough to contributing to an open-source project: https://www.youtube.com/watch?v=c6b6B9oN4Vg
Be cool, and don't be uncool. Let's make this a good experience for everyone involved, we're here to design and discuss the ultimate Lego version of modular aperture from Portal and Portal 2.
Files representing the most atomic elements are most useful. They allow easier comparisons between versions of an element. If proposing a new design, or modifying an element design, please submit a file containing only the element designed. Feel free to also submit example test chambers where the element is incorporated.
A "current" version of each element will live in a current folder, while previous replaced versions will be stored in an archive folder containing versions of previous elements. A subfolder will contain current example tests. When a piece of an example test is replaced, that test will be relegated to the archive folder. This preserves the invariant that "everything in the current folder is current".
A tutorial folder will exist to share information about topics like rendering.