From c8af9954d2b30af6d27003e8ff17762b81f71f3e Mon Sep 17 00:00:00 2001 From: MrTJP Date: Fri, 7 May 2021 01:05:57 -0700 Subject: [PATCH] docs: update README --- README.md | 87 +++++++++++++++++++++++++------------------------------ 1 file changed, 40 insertions(+), 47 deletions(-) diff --git a/README.md b/README.md index 13ca94ebc..eda07e7ea 100644 --- a/README.md +++ b/README.md @@ -1,47 +1,40 @@ -ProjectRed -========== -Project Red is a mod written for Forge Multipart. It brings vastly improved redstone control to Minecraft via compact wiring and integrated logic gates. -- [![Build Status](https://travis-ci.org/MrTJP/ProjectRed.png?branch=master)](https://travis-ci.org/MrTJP/ProjectRed) -- [Minecraft Forum Thread](http://www.minecraftforum.net/topic/1885652-) -- [Website](http://projectredwiki.com) - - - -CB’s policy for requesting new gates: -------------------------------------- - -For anyone wanting a new logic gate. Here's my proposal. - -1. It needs to have a purpose. You will need to provide examples of where this gate will be useful. -2. It needs to be something that cannot be constructed in 3 existing gates or less. -3. You must completely describe how it will function. - -As an example, here's the RS latch. -The gate has inputs on the left and right, outputs on the top and bottom. -When you activate the left or right input, it switches into that state. When in the right state, the top output is on, when in the left state, the bottom output is on. It will also output from the input sides based on state. -If both inputs are turned on, the gate should deactivate until they are both turned off. If both sides are turned off at the exact same time, it will pick a random state. -It can be flipped with the screwdriver. -It also has a second screwdriver mode where the inputs do not get powered based on state. - -While the RS latch could technically be made with 2 NOT/NOR gates, it is a very fundamental logic circuit. Additionally, having only a two tick delay, instead of a 4 tick is quite useful. - - -Should you be able to describe your proposed gate in this format, create a feature request on the GitHub repo for ProjectRed. MrTJP and I will be notified and will be able to provide you feedback on your proposal. - - - -Developing: ----------- -Setup is slightly different depending on what system and IDE you use. -This assumes you know how to run gradle commands on your system. -The base command, `./gradlew` being used below is for Linux or Unix based systems. For windows, this would simply change to `gradlew`. -Of course, if you dont need to use the wrapper (as in, you have gradle installed on your system), you can simply go right to `gradle`. - - -1. Clone repository to empty folder. -2. Cd to the repository (folder where `src` and `resources` are located). -3. Run `./gradlew setupDecompWorkspace` to set up an environment. -4. Run `./gradlew eclipse` or `./gradlew idea` appropriately. -5. Open your IDE using the generated files (i.e., for IDEA, a ProjectRed.ipr is generated in `./`) -6. Edit, run, and debug your new code. -7. Once its bug free and working, you may submit it as a PR to the main repo. \ No newline at end of file +# ProjectRed + +A Minecraft Forge mod all about Redstone circuity. + +| Release Branch | MC Version | Status | +| ---------------|------------| :---------: | +| release/beta | 1.15.2 | [![badge](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/MrTJP/3ef501bc64c896a86fd706dfea8ba367/raw/projectred-badge-beta.json)](https://www.curseforge.com/minecraft/mc-mods/project-red-core) | + +## Development Environment Setup + +Project Red uses a standard Forge Gradle environment. Setup steps should be the same as most other mods: + +1. Create a new folder and check out the repository: + ``` + mkdir ~/projectred && cd ~/projectred + git checkout https://github.com/MrTJP/ProjectRed.git . + ``` +2. Setup a new workspace with a decompiled copy of Minecraft: + ``` + ./gradlew setupDecompWorkspace + ``` +3. You can now either set up Eclipse or IntelliJ Idea as your IDE. + + For Eclipse: + * Generate an Eclipse project with `./gradlew eclipse` + * Import the generated project with `File > Import > General > Existing Projects into Workspace` + + For Intellij Idea: + * Open IntelliJ and from the splash screen, select `Import Project` + * Point IntelliJ to the `./build.gradle` file in the git repo + * Close IntelliJ and run `./gradlew genIntellijRuns` to complete setup + +4. If you'd like to contribute changes, you'll need to create your own fork of ProjectRed, push your changes, and then open a Pull Request for review. + +### Building Locally +You can build a locally checked out copy of the repository by simply running: +``` +./gradlew build +``` +The built jars will be found in `./build/libs`.