This repository is a WIP on Applied Energistics 3.
So if you look at our latest commit or commit history, you will probably think that we are dead. We are not! All the work has moved to the ReOver repository. You see, some stuff just can't be ported and has to be fully rewritten. We are using ReOver repo just for that - a clean sheet where we can write and test stuff without worrying of breaking old stuff.
Go check it out! https://github.com/AEModernMCPort/Applied-Energistics-3-ReOver
Once time comes, the 2 repositories will be merged forming a new one.
Applied Energistics 3 has a whole new modular structure described in a dedicated file - structure.md. In this file you will also find repartition of AE features accross modules, along with features that were temporarily removed and ones that were removed and will not come back ヾ(^_^).
- And you are a modder - We would appreciate you helping us port and fix the code. Everything that should be done is described here - #113. PR your changes to us and eventually, you will be invited to join our team!
- And you are an artist - Although the current issue is the code, we still have a ton of models to do. All models that have to be done are listed here - #9. PR your models and/or textures to us and eventually, you will be invited to join our team!
- And you are neiter of above - Join our discord server! Suggest ideas! And be ready to test and submit bugs once everything is fixed!
Below is the old AE2 README kept for unknown purposes.
A Mod about Matter, Energy and using them to conquer the world..
- Applied Energistics 2 API
- (c) 2013 - 2015 AlgorithmX2 et al
- Applied Energistics 2
- (c) 2013 - 2015 AlgorithmX2 et al
- Textures and Models
- (c) 2013 - 2015 AlgorithmX2 et al
- Text and Translations
Downloads for the AE2 can be found on CurseForge or on the official website.
We don't have AE3 releases for now.
You install this mod by putting it into the minecraft/mods/ folder. It has no additional hard dependencies.
have a suggestion for Applied Energistics 3? Create an issue now!
- Make sure your issue has not already been answered or fixed and you are using the latest version. Also think about whether your issue is a valid one before submitting it.
- Go to the issues page and click new issue
- Enter your a title of your issue (something that summarizes your issue), and then create a detailed description of the issue.
- Do not tag it with something like
[Feature]or[Bug]. When it is applicable, we will take care of it. - The following details are required. Not including them can cause the issue to be closed.
- Forge version
- AE2 version
- Crash log, when reporting a crash (Please make sure to use pastebin)
- Do not post an excerpt of what you consider important, instead:
- Post the full log
- Other mods and their version, when reporting an issue between AE and another mod
- Also consider updating these before submitting a new issue, it might be already fixed
- A detailed description of the bug or feature
- To further help in resolving your issues please try to include the follow if applicable:
- What was expected?
- How to reproduce the problem?
- This is usually a great detail and allows us to fix it way faster
- Server or Single Player?
- Screen shots or Pictures of the problem
- Mod Pack using and version?
- Keep in mind that some mods might use an outdated version of AE2
- If so you should report it to your modpack
- Do not tag it with something like
- Click
Submit New Issue, and wait for feedback!
Providing as many details as possible does help us to find and resolve the issue faster and also you getting a fixed version as fast as possible.
- Clone this repository via
- SSH
git clone [email protected]:AEModernMCPort/Applied-Energistics-3.gitor - HTTPS
git clone https://github.com/AEModernMCPort/Applied-Energistics-3.git
- Setup workspace
- Decompiled source
gradlew setupDecompWorkspace - Obfuscated source
gradlew setupDevWorkspace - CI server
gradlew setupCIWorkspace
- Build
gradlew build. Jar will be inbuild/libs - For core developer: Setup IDE
- IntelliJ: Import into IDE and execute
gradlew genIntellijRunsafterwards - Eclipse: execute
gradlew eclipse
- For add-on developer: Core-Mod Detection
- In order to have FML detect AE from your dev environment, add the following VM Option to your run profile
-Dfml.coreMods.load=appeng.transformer.AppEngCore
Before you want to add major changes, you might want to discuss them with us first, before wasting your time. If you are still willing to contribute to this project, you can contribute via Pull-Request.
The guidelines for contributing contain more detailed information about topics like the used code style and should also be considered.
Here are a few things to keep in mind that will help get your PR approved.
- A PR should be focused on content. Any PRs where the changes are only syntax will be rejected.
- Use the file you are editing as a style guide.
- Consider your feature. Suggestion Guidelines
- Is your suggestion already possible using Vanilla + AE2?
- Make sure your feature isn't already in the works, or hasn't been rejected previously.
- Does your feature simplify another feature of AE2? These changes will not be accepted.
- If your feature can be done by any popular mod, discuss with us first.
Getting Started
- Fork this repository
- Clone the fork via
- SSH
git clone [email protected]:<your username>/Applied-Energistics-2.gitor - HTTPS
git clone https://github.com/<your username>/Applied-Energistics-2.git
- Change code base
- Add changes to git
git add -A - Commit changes to your clone
git commit -m "<summery of made changes>" - Push to your fork
git push - Create a Pull-Request on GitHub
- Wait for review
- Squash commits for cleaner history
If you are only doing single file pull requests, GitHub supports using a quick way without the need of cloning your fork. Also read up about synching if you plan to contribute on regular basis.
The API for Applied Energistics 2. It is open source to discuss changes, improve documentation, and provide better add-on support in general.
Development and standard builds can be obtained Here.
When compiling against the AE2 API you can use gradle dependencies, just add
dependencies {
compile "appeng:appliedenergistics2:rv_-_____-__:dev"
}
or add the compile line to your existing dependencies task to your build.gradle
Where the __ are filled in with the correct version criteria; AE2 is available from the default forge maven so no additional repositories are necessary.
An example string would be appeng:appliedenergistics2:rv2-alpha-30:dev
en_US is included in this repository, fixes to typos are welcome.
Files must be encoded as UTF-8.
You can provide any additional languages by creating a new file with the appropriate language code.
If you have have issues localizing something feel free to contact us on IRC, at #AppliedEnergistics on Esper.net
Thanks to everyone helping out to improve localization of AE2.
Thanks to
- Notch et al for Minecraft
- Lex et al for MinecraftForge
- AlgorithmX2 for AppliedEnergistics2
- all contributors