Leave a fluid alone when an air position is emptied

Water, lava and every Forge fluid block can now be placed by survival autoplace, paid for with fluid instead of with an item.

* Fluid costs are registered per block state, water and lava are registered by default, and a registration can ask for fluid even when the block also has an item form.
* A fluid is only placed once the rest of the structure is in place, so it cannot flow out of a half built multiblock, and only the fluid missing from a position is charged, so topping up a leak costs the difference instead of a whole bucket.
* The fluid comes from the player: their fluid containers, plus whatever mods contribute through the new fluid container extractor and fluid source provider registries.
* Existing structure definitions need no change, as ofBlock and the other block elements become fluid elements when the block has no item form.

.editorconfig

@@ -0,0 +1,19 @@
+# This is the universal Text Editor Configuration
+# for all GTNewHorizons projects
+# See: https://editorconfig.org/
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{bat,ini}]
+end_of_line = crlf
+
+[*.{dtd,json,info,mcmeta,md,sh,svg,xml,xsd,xsl,yaml,yml}]
+indent_size = 2

.git-blame-ignore-revs

@@ -0,0 +1,2 @@
+# Ignore spotlessApply reformat
+464e44de8541a46833f50c3bd363d50e1677a685

.gitattributes

@@ -1,22 +1,44 @@
-# Auto detect text files and perform LF normalization
-* text=auto
+* text eol=lf
 
-# Custom for Visual Studio
-*.cs     diff=csharp
-*.sln    merge=union
-*.csproj merge=union
-*.vbproj merge=union
-*.fsproj merge=union
-*.dbproj merge=union
+*.[jJ][aA][rR]          binary
 
-# Standard to msysgit
-*.doc	 diff=astextplain
-*.DOC	 diff=astextplain
-*.docx diff=astextplain
-*.DOCX diff=astextplain
-*.dot  diff=astextplain
-*.DOT  diff=astextplain
-*.pdf  diff=astextplain
-*.PDF	 diff=astextplain
-*.rtf	 diff=astextplain
-*.RTF	 diff=astextplain
+*.[pP][nN][gG]          binary
+*.[jJ][pP][gG]          binary
+*.[jJ][pP][eE][gG]      binary
+*.[gG][iI][fF]          binary
+*.[tT][iI][fF]          binary
+*.[tT][iI][fF][fF]      binary
+*.[iI][cC][oO]          binary
+*.[sS][vV][gG]          text
+*.[eE][pP][sS]          binary
+*.[xX][cC][fF]          binary
+
+*.[kK][aA][rR]          binary
+*.[mM]4[aA]             binary
+*.[mM][iI][dD]          binary
+*.[mM][iI][dD][iI]      binary
+*.[mM][pP]3             binary
+*.[oO][gG][gG]          binary
+*.[rR][aA]              binary
+
+*.7[zZ]                 binary
+*.[gG][zZ]              binary
+*.[tT][aA][rR]          binary
+*.[tT][gG][zZ]          binary
+*.[zZ][iI][pP]          binary
+
+*.[tT][cC][nN]          binary
+*.[sS][oO]              binary
+*.[dD][lL][lL]          binary
+*.[dD][yY][lL][iI][bB]  binary
+*.[pP][sS][dD]          binary
+*.[tT][tT][fF]          binary
+*.[oO][tT][fF]          binary
+
+*.[pP][aA][tT][cC][hH]  -text
+
+*.[bB][aA][tT]          text eol=crlf
+*.[cC][mM][dD]          text eol=crlf
+*.[pP][sS]1             text eol=crlf
+
+*[aA][uU][tT][oO][gG][eE][nN][eE][rR][aA][tT][eE][dD]* binary

.github/scripts/test-no-crash-reports.sh

@@ -1,9 +0,0 @@
-directory="run/crash-reports"
-if [ -d $directory ]; then
-  echo "Crash reports detected:"
-  cat $directory/*
-  exit 1
-else
-  echo "No crash reports detected"
-  exit 0
-fi

.github/scripts/test_no_error_reports

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+
+# bashsupport disable=BP5006 # Global environment variables
+RUNDIR="run" \
+  CRASH="crash-reports" \
+  SERVERLOG="server.log"
+
+# enable nullglob to get 0 results when no match rather than the pattern
+shopt -s nullglob
+
+# store matches in array
+crash_reports=("$RUNDIR/$CRASH/crash"*.txt)
+
+# if array not empty there are crash_reports
+if [ "${#crash_reports[@]}" -gt 0 ]; then
+  # get the latest crash_report from array
+  latest_crash_report="${crash_reports[-1]}"
+  {
+    printf 'Latest crash report detected %s:\n' "${latest_crash_report##*/}"
+    cat "$latest_crash_report"
+  } >&2
+  exit 1
+fi
+
+if grep --quiet --fixed-strings 'Fatal errors were detected' "$SERVERLOG"; then
+  {
+    printf 'Fatal errors detected:\n'
+    cat server.log
+  } >&2
+  exit 1
+fi
+
+if grep --quiet --fixed-strings 'The state engine was in incorrect state ERRORED and forced into state SERVER_STOPPED' \
+  "$SERVERLOG"; then
+  {
+    printf 'Server force stopped:'
+    cat server.log
+  } >&2
+  exit 1
+fi
+
+if ! grep --quiet --perl-regexp --only-matching '.+Done \(.+\)\! For help, type "help" or "\?"' "$SERVERLOG"; then
+  {
+    printf 'Server did not finish startup:'
+    cat server.log
+  } >&2
+  exit 1
+fi
+
+printf 'No crash reports detected'
+exit 0

.github/workflows/build-and-test.yml

@@ -1,5 +1,3 @@
-# This workflow will build a Java project with Gradle and cache/restore any dependencies to improve the workflow execution time
-# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-gradle
 
 name: Build and test
 
@@ -11,35 +9,5 @@ on:
 
 jobs:
   build-and-test:
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v2
-      with: 
-        fetch-depth: 0
-    
-    - name: Set up JDK 8
-      uses: actions/setup-java@v2
-      with:
-        java-version: '8'
-        distribution: 'adopt'
-        cache: gradle
-        
-    - name: Grant execute permission for gradlew
-      run: chmod +x gradlew
-
-    - name: Setup the workspace
-      run: ./gradlew setupCIWorkspace
-    
-    - name: Build the mod
-      run: ./gradlew build
-
-    - name: Run server for 1 minute
-      run: |
-        mkdir run
-        echo "eula=true" > run/eula.txt  
-        timeout 10 ./gradlew runServer || true
-
-    - name: Test no crashes happend
-      run: |
-        chmod +x .github/scripts/test-no-crash-reports.sh
-        .github/scripts/test-no-crash-reports.sh
+    uses: GTNewHorizons/GTNH-Actions-Workflows/.github/workflows/build-and-test.yml@master
+    secrets: inherit

.github/workflows/optimize-images.yml

@@ -0,0 +1,17 @@
+name: Optimize images
+
+on:
+  pull_request:
+    branches: [ master, main, release/** ]
+    paths:
+      - "**/*.png"
+
+  push:
+    branches: [ master, main, release/** ]
+    paths:
+      - "**/*.png"
+
+jobs:
+  optimize-images:
+    uses: GTNewHorizons/GTNH-Actions-Workflows/.github/workflows/optimize-images.yml@master
+    secrets: inherit

.github/workflows/publish-javadoc.yaml

@@ -0,0 +1,98 @@
+name: Deploy Javadoc
+
+on:
+  push:
+    branches:
+      - master
+      - feature/doc
+      - '**/*-javadoc'
+    tags:
+      - '*'
+  delete:
+
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+jobs:
+  prune:
+    if: github.event_name == 'delete'
+    concurrency: javadoc-publish
+    runs-on: ubuntu-latest
+    outputs:
+      result_hash: ${{ steps.deploy.outputs.hash }}
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+          ref: gh-pages
+
+      - name: Deploy 🚀
+        id: deploy
+        shell: bash
+        run: |
+          if git rm -r $TARGET_FOLDER ; then
+            echo Nothing to clean up
+          fi
+
+          find . -name javadoc -type d -print | sed 's#^\./\(.*\)/javadoc$#\1#' | sort --version-sort --reverse > index.txt
+          git add index.txt
+          git config user.name "${GITHUB_ACTOR}"
+          git config user.email "${GITHUB_ACTOR_ID}-${GITHUB_ACTOR}@users.noreply.github.com"
+          git commit -m "Clean up javadoc after ref $TARGET_FOLDER is deleted"
+          git push
+          echo "hash=$(git rev-parse HEAD)" >> $GITHUB_OUTPUT
+        env:
+          TARGET_FOLDER: ${{ github.ref_name }}
+
+  javadoc:
+    if: github.event_name == 'push'
+    concurrency: javadoc-publish
+    runs-on: ubuntu-latest
+    outputs:
+      result_hash: ${{ steps.deploy.outputs.hash }}
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-java@v3
+        with:
+          java-version: |
+            8
+            11
+            17
+          distribution: 'temurin'
+          cache: gradle
+
+      - name: Grant execute permission for gradlew
+        run: chmod +x gradlew
+
+      - name: Generate Javadoc
+        run: ./gradlew --no-daemon spotlessCheck javadoc
+
+      - name: Deploy 🚀
+        id: deploy
+        shell: bash
+        run: |
+          mv build/docs $RUNNER_TEMP/docs_output
+          rm build -rf
+          git checkout gh-pages
+          mkdir -p $TARGET_FOLDER
+          rm -rf $TARGET_FOLDER
+          mv $RUNNER_TEMP/docs_output $TARGET_FOLDER -v
+          git add $TARGET_FOLDER
+          if git diff --cached --exit-code > /dev/null ; then
+            echo Nothing to deploy
+            exit 0
+          fi
+          find . -name javadoc -type d -print | sed 's#^\./\(.*\)/javadoc$#\1#' | sort --version-sort --reverse > index.txt
+          git add index.txt
+          git config user.name "${GITHUB_ACTOR}"
+          git config user.email "${GITHUB_ACTOR_ID}-${GITHUB_ACTOR}@users.noreply.github.com"
+          git commit -m "Deploy javadoc from ref $TARGET_FOLDER"
+          git push
+          echo "hash=$(git rev-parse HEAD)" >> $GITHUB_OUTPUT
+        env:
+          TARGET_FOLDER: ${{ github.ref_name }}

.github/workflows/release-latest.yml

@@ -1,44 +0,0 @@
-# This workflow will build a Java project with Gradle and cache/restore any dependencies to improve the workflow execution time
-# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-gradle
-
-name: Release latest build
-
-on:
-  push:
-    branches: [ master, main ]
-
-jobs:
-  build-and-release:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-        with:
-          fetch-depth: 0
-
-      - name: Set release version
-        run: echo "RELEASE_VERSION=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
-
-      - name: Set up JDK 8
-        uses: actions/setup-java@v2
-        with:
-          java-version: '8'
-          distribution: 'adopt'
-          cache: gradle
-
-      - name: Grant execute permission for gradlew
-        run: chmod +x gradlew
-
-      - name: Setup the workspace
-        run: ./gradlew setupCIWorkspace
-
-      - name: Build the mod
-        run: ./gradlew build
-
-      - name: Update latest tag
-        uses: "marvinpinto/action-automatic-releases@latest"
-        with:
-          repo_token: "${{ secrets.GITHUB_TOKEN }}"
-          automatic_release_tag: "latest"
-          prerelease: false
-          title: "Latest build"
-          files: build/libs/*.jar

.github/workflows/release-tags.yml

@@ -1,45 +1,14 @@
-# This workflow will build a Java project with Gradle and cache/restore any dependencies to improve the workflow execution time
-# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-gradle
 
 name: Release tagged build
 
 on:
   push:
-    tags:
-      - '*'
+    tags: [ '*' ]
+
+permissions:
+  contents: write
 
 jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-        with:
-          fetch-depth: 0
-
-      - name: Set release version
-        run: echo "RELEASE_VERSION=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
-
-      - name: Set up JDK 8
-        uses: actions/setup-java@v2
-        with:
-          java-version: '8'
-          distribution: 'adopt'
-          cache: gradle
-
-      - name: Grant execute permission for gradlew
-        run: chmod +x gradlew
-
-      - name: Setup the workspace
-        run: ./gradlew setupCIWorkspace
-
-      - name: Build the mod
-        run: ./gradlew build
-
-      - name: Release under current tag
-        uses: "marvinpinto/action-automatic-releases@latest"
-        with:
-          repo_token: "${{ secrets.GITHUB_TOKEN }}"
-          automatic_release_tag: "${{ env.RELEASE_VERSION }}"
-          prerelease: false
-          title: "${{ env.RELEASE_VERSION }}"
-          files: build/libs/*.jar
+  release-tags:
+    uses: GTNewHorizons/GTNH-Actions-Workflows/.github/workflows/release-tags.yml@master
+    secrets: inherit

.gitignore

@@ -26,3 +26,5 @@ whitelist.json
 *.ipr
 *.iws
 src/main/resources/mixins.*.json
+*.bat
+layout.json

CODEOWNERS

@@ -0,0 +1,3 @@
+# Any Github changes require admin approval
+/.github/** @GTNewHorizons/admin
+

LICENSE

@@ -0,0 +1,674 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    <program>  Copyright (C) <year>  <name of author>
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<https://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<https://www.gnu.org/licenses/why-not-lgpl.html>.

LICENSE.LESSER

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

README.md

@@ -21,9 +21,16 @@ Originally created by TecTech authors, taken with permission. It's under MIT lic
     }
     ```
    Replace `master-SNAPSHOT` with a commit hash or a tag name (if any) of your choice to prevent unexpected upstream changes.
-2. Add `required-after:structurelib;` to your `@Mod(dependencies = "..")` tring. 
+2. Add `required-after:structurelib;` to your `@Mod(dependencies = "..")` tring.
 3. Add `structurelib` to your `mcmod.info`.
 
 ## Contribution
 
 The project is developed using IDEA. Please manually configure the build to not delegate to gradle for textures to show up in dev.
+
+## Current license
+Due to me adding in ItemStackMap, which was derived from code from CodeChicken's LGPL mod NEI. This mod is effectively considered
+licensed under LGPL in its entirety since commit ebef584b8c518f8202cfe0984fb28a6d23e52b3d or any squash commit containing it, e.g.
+609e50428ee4e293f65f67f554a70b9fcfae97c4.
+
+Note while the LICENSE.txt is added by a much later commit, all code on previous commits are covered by this as well.

addon.gradle

@@ -0,0 +1,41 @@
+javadoc {
+    javadocTool = javaToolchains.javadocToolFor {
+        // Last version with frames, but it also has search
+        languageVersion = JavaLanguageVersion.of(25)
+        vendor = JvmVendorSpec.ADOPTIUM
+    }
+
+    inputs.file  "src/main/javadoc/overview.html"
+
+    include "com/gtnewhorizon/structurelib/alignment/**"
+    include "com/gtnewhorizon/structurelib/constructable/**"
+    include "com/gtnewhorizon/structurelib/structure/**"
+    include "com/gtnewhorizon/structurelib/util/**"
+    include "com/gtnewhorizon/structurelib/StructureLibAPI.java"
+    include "com/gtnewhorizon/structurelib/StructureEvent.java"
+
+    classpath += sourceSets.patchedMc.output
+
+    options {
+        overview "src/main/javadoc/overview.html"
+        links 'https://docs.oracle.com/en/java/javase/25/docs/api/'
+        links 'https://skmedix.github.io/ForgeJavaDocs/javadoc/forge/1.7.10-10.13.4.1614/'
+    }
+}
+
+tasks.register('javadocJar', Jar) {
+    dependsOn javadoc
+    archiveClassifier = 'javadoc'
+    from javadoc.destinationDir
+}
+
+artifacts {
+    archives javadocJar
+}
+
+test {
+    useJUnitPlatform()
+    testLogging {
+        events "passed", "skipped", "failed"
+    }
+}

build.gradle

@@ -1,521 +1,5 @@
-//version: 4f3d1b46cf51f9d4ded5379b5d817a2a6f6b302d
-/*
-DO NOT CHANGE THIS FILE!
-
-Also, you may replace this file at any time if there is an update available.
-Please check https://github.com/SinTh0r4s/ExampleMod1.7.10/blob/main/build.gradle for updates.
- */
-
-
-import com.github.jengelman.gradle.plugins.shadow.tasks.ConfigureShadowRelocation
-import com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar
-
-import java.util.concurrent.TimeUnit
-
-buildscript {
-    repositories {
-        maven {
-            name = "forge"
-            url = "https://maven.minecraftforge.net"
-        }
-        maven {
-            name = "sonatype"
-            url = "https://oss.sonatype.org/content/repositories/snapshots/"
-        }
-        maven {
-            name = "Scala CI dependencies"
-            url = "https://repo1.maven.org/maven2/"
-        }
-        maven {
-            name = "jitpack"
-            url = "https://jitpack.io"
-        }
-    }
-    dependencies {
-        classpath 'com.github.GTNewHorizons:ForgeGradle:1.2.4'
-    }
-}
+//version: 1707058017
 
 plugins {
-    id 'idea'
-    id 'scala'
-    id("org.ajoberstar.grgit") version("3.1.1")
-    id("com.github.johnrengelman.shadow") version("4.0.4")
-    id("com.palantir.git-version") version("0.12.3")
-}
-
-apply plugin: 'forge'
-
-def projectJavaVersion = JavaLanguageVersion.of(8)
-
-java {
-    toolchain {
-        languageVersion.set(projectJavaVersion)
-    }
-}
-
-idea {
-    module {
-        inheritOutputDirs = true
-        downloadJavadoc = true
-        downloadSources = true
-    }
-}
-
-checkPropertyExists("modName")
-checkPropertyExists("modId")
-checkPropertyExists("modGroup")
-checkPropertyExists("autoUpdateBuildScript")
-checkPropertyExists("minecraftVersion")
-checkPropertyExists("forgeVersion")
-checkPropertyExists("replaceGradleTokenInFile")
-checkPropertyExists("gradleTokenModId")
-checkPropertyExists("gradleTokenModName")
-checkPropertyExists("gradleTokenVersion")
-checkPropertyExists("gradleTokenGroupName")
-checkPropertyExists("apiPackage")
-checkPropertyExists("accessTransformersFile")
-checkPropertyExists("usesMixins")
-checkPropertyExists("mixinPlugin")
-checkPropertyExists("mixinsPackage")
-checkPropertyExists("coreModClass")
-checkPropertyExists("containsMixinsAndOrCoreModOnly")
-checkPropertyExists("usesShadowedDependencies")
-checkPropertyExists("developmentEnvironmentUserName")
-
-def checkPropertyExists(String propertyName) {
-    if (project.hasProperty(propertyName) == false) {
-        throw new GradleException("This project requires a property \"" + propertyName + "\"! Please add it your \"gradle.properties\". You can find all properties and their description here: https://github.com/SinTh0r4s/ExampleMod1.7.10/blob/main/gradle.properties")
-    }
-}
-
-
-String javaSourceDir = "src/main/java/"
-String scalaSourceDir = "src/main/scala/"
-
-String targetPackageJava = javaSourceDir + modGroup.toString().replaceAll("\\.", "/")
-String targetPackageScala = scalaSourceDir + modGroup.toString().replaceAll("\\.", "/")
-if((new File(targetPackageJava).exists() || new File(targetPackageScala).exists()) == false) {
-    throw new GradleException("Could not resolve \"modGroup\"! Could not find " + targetPackageJava + " or " + targetPackageScala)
-}
-
-if(apiPackage) {
-    targetPackageJava = javaSourceDir + modGroup.toString().replaceAll("\\.", "/") + "/" + apiPackage.toString().replaceAll("\\.", "/")
-    targetPackageScala = scalaSourceDir + modGroup.toString().replaceAll("\\.", "/") + "/" + apiPackage.toString().replaceAll("\\.", "/")
-    if((new File(targetPackageJava).exists() || new File(targetPackageScala).exists()) == false) {
-        throw new GradleException("Could not resolve \"apiPackage\"! Could not find " + targetPackageJava + " or " + targetPackageScala)
-    }
-}
-
-if(accessTransformersFile) {
-    String targetFile = "src/main/resources/META-INF/" + accessTransformersFile
-    if(new File(targetFile).exists() == false) {
-        throw new GradleException("Could not resolve \"accessTransformersFile\"! Could not find " + targetFile)
-    }
-}
-
-if(usesMixins.toBoolean()) {
-    if(mixinsPackage.isEmpty() || mixinPlugin.isEmpty()) {
-        throw new GradleException("\"mixinPlugin\" requires \"mixinsPackage\" and \"mixinPlugin\" to be set!")
-    }
-
-    targetPackageJava = javaSourceDir + modGroup.toString().replaceAll("\\.", "/") + "/" + mixinsPackage.toString().replaceAll("\\.", "/")
-    targetPackageScala = scalaSourceDir + modGroup.toString().replaceAll("\\.", "/") + "/" + mixinsPackage.toString().replaceAll("\\.", "/")
-    if((new File(targetPackageJava).exists() || new File(targetPackageScala).exists()) == false) {
-        throw new GradleException("Could not resolve \"mixinsPackage\"! Could not find " + targetPackageJava + " or " + targetPackageScala)
-    }
-
-    String targetFileJava = javaSourceDir + modGroup.toString().replaceAll("\\.", "/") + "/" + mixinPlugin.toString().replaceAll("\\.", "/") + ".java"
-    String targetFileScala = scalaSourceDir + modGroup.toString().replaceAll("\\.", "/") + "/" + mixinPlugin.toString().replaceAll("\\.", "/") + ".scala"
-    String targetFileScalaJava = scalaSourceDir + modGroup.toString().replaceAll("\\.", "/") + "/" + mixinPlugin.toString().replaceAll("\\.", "/") + ".java"
-    if((new File(targetFileJava).exists() || new File(targetFileScala).exists() || new File(targetFileScalaJava).exists()) == false) {
-        throw new GradleException("Could not resolve \"mixinPlugin\"! Could not find " + targetFileJava + " or " + targetFileScala + " or " + targetFileScalaJava)
-    }
-}
-
-if(coreModClass) {
-    String targetFileJava = javaSourceDir + modGroup.toString().replaceAll("\\.", "/") + "/" + coreModClass.toString().replaceAll("\\.", "/") + ".java"
-    String targetFileScala = scalaSourceDir + modGroup.toString().replaceAll("\\.", "/") + "/" + coreModClass.toString().replaceAll("\\.", "/") + ".scala"
-    String targetFileScalaJava = scalaSourceDir + modGroup.toString().replaceAll("\\.", "/") + "/" + coreModClass.toString().replaceAll("\\.", "/") + ".java"
-    if((new File(targetFileJava).exists() || new File(targetFileScala).exists() || new File(targetFileScalaJava).exists()) == false) {
-        throw new GradleException("Could not resolve \"coreModClass\"! Could not find " + targetFileJava + " or " + targetFileScala + " or " + targetFileScalaJava)
-    }
-}
-
-configurations.all {
-    resolutionStrategy.cacheChangingModulesFor(0, TimeUnit.SECONDS)
-
-    // Make sure GregTech build won't time out
-    System.setProperty("org.gradle.internal.http.connectionTimeout", 120000 as String)
-    System.setProperty("org.gradle.internal.http.socketTimeout", 120000 as String)
-}
-
-// Fix Jenkins' Git: chmod a file should not be detected as a change and append a '.dirty' to the version
-'git config core.fileMode false'.execute()
-// Pulls version from git tag
-version = minecraftVersion + "-" + gitVersion()
-group = modGroup
-archivesBaseName = modId
-
-minecraft {
-    version = minecraftVersion + "-" + forgeVersion + "-" + minecraftVersion
-    runDir = "run"
-
-    if (replaceGradleTokenInFile) {
-        replaceIn replaceGradleTokenInFile
-        if(gradleTokenModId) {
-            replace gradleTokenModId, modId
-        }
-        if(gradleTokenModName) {
-            replace gradleTokenModName, modName
-        }
-        if(gradleTokenVersion) {
-            replace gradleTokenVersion, versionDetails().lastTag
-        }
-        if(gradleTokenGroupName) {
-            replace gradleTokenGroupName, modGroup
-        }
-    }
-}
-
-if(file("addon.gradle").exists()) {
-    apply from: "addon.gradle"
-}
-
-apply from: 'repositories.gradle'
-
-configurations {
-    implementation.extendsFrom(shadowImplementation)
-}
-
-repositories {
-    maven {
-        name = "Overmind forge repo mirror"
-        url = "https://gregtech.overminddl1.com/"
-    }
-    if(usesMixins.toBoolean()) {
-        maven {
-            name = "sponge"
-            url = "https://repo.spongepowered.org/repository/maven-public"
-        }
-        maven {
-            url = "https://jitpack.io"
-        }
-    }
-}
-
-dependencies {
-    if(usesMixins.toBoolean()) {
-        annotationProcessor("org.ow2.asm:asm-debug-all:5.0.3")
-        annotationProcessor("com.google.guava:guava:24.1.1-jre")
-        annotationProcessor("com.google.code.gson:gson:2.8.6")
-        annotationProcessor("org.spongepowered:mixin:0.8-SNAPSHOT")
-        // using 0.8 to workaround a issue in 0.7 which fails mixin application
-        compile("org.spongepowered:mixin:0.7.11-SNAPSHOT") {
-            // Mixin includes a lot of dependencies that are too up-to-date
-            exclude module: "launchwrapper"
-            exclude module: "guava"
-            exclude module: "gson"
-            exclude module: "commons-io"
-            exclude module: "log4j-core"
-        }
-        compile("com.github.GTNewHorizons:SpongeMixins:1.3.3:dev")
-    }
-}
-
-apply from: 'dependencies.gradle'
-
-def mixinConfigJson = "mixins." + modId + ".json"
-def mixingConfigRefMap = "mixins." + modId + ".refmap.json"
-def refMap = "${tasks.compileJava.temporaryDir}" + File.separator + mixingConfigRefMap
-def mixinSrg = "${tasks.reobf.temporaryDir}" + File.separator + "mixins.srg"
-
-task generateAssets {
-    if(usesMixins.toBoolean()) {
-        new File(projectDir.toString() + "/src/main/resources/", mixinConfigJson).text = """{
-  "required": true,
-  "minVersion": "0.7.11",
-  "package": "${modGroup}.${mixinsPackage}",
-  "plugin": "${modGroup}.${mixinPlugin}",
-  "refmap": "${mixingConfigRefMap}",
-  "target": "@env(DEFAULT)",
-  "compatibilityLevel": "JAVA_8"
-}
-
-"""
-    }
-}
-
-task relocateShadowJar(type: ConfigureShadowRelocation) {
-    target = tasks.shadowJar
-    prefix = modGroup + ".shadow"
-}
-
-shadowJar {
-    manifest {
-        attributes(getManifestAttributes())
-    }
-
-    minimize()  // This will only allow shading for actually used classes
-    configurations = [project.configurations.shadowImplementation]
-    dependsOn(relocateShadowJar)
-}
-
-jar {
-    manifest {
-        attributes(getManifestAttributes())
-    }
-
-    if(usesShadowedDependencies.toBoolean()) {
-        dependsOn(shadowJar)
-        enabled = false
-    }
-}
-
-reobf {
-    if(usesMixins.toBoolean()) {
-        addExtraSrgFile mixinSrg
-    }
-}
-
-afterEvaluate {
-    if(usesMixins.toBoolean()) {
-        tasks.compileJava {
-            options.compilerArgs += [
-                    "-AreobfSrgFile=${tasks.reobf.srg}",
-                    "-AoutSrgFile=${mixinSrg}",
-                    "-AoutRefMapFile=${refMap}",
-                    // Elan: from what I understand they are just some linter configs so you get some warning on how to properly code
-                    "-XDenableSunApiLintControl",
-                    "-XDignore.symbol.file"
-            ]
-        }
-    }
-}
-
-runClient {
-    def arguments = []
-
-    if(usesMixins.toBoolean()) {
-        arguments += [
-                "--mods=../build/libs/$modId-${version}.jar",
-                "--tweakClass org.spongepowered.asm.launch.MixinTweaker"
-        ]
-    }
-
-    if(developmentEnvironmentUserName) {
-        arguments += [
-                "--username",
-                developmentEnvironmentUserName
-        ]
-    }
-
-    args(arguments)
-}
-
-runServer {
-    def arguments = []
-
-    if (usesMixins.toBoolean()) {
-        arguments += [
-                "--mods=../build/libs/$modId-${version}.jar",
-                "--tweakClass org.spongepowered.asm.launch.MixinTweaker"
-        ]
-    }
-
-    args(arguments)
-}
-
-tasks.withType(JavaExec).configureEach {
-    javaLauncher.set(
-            javaToolchains.launcherFor {
-                languageVersion = projectJavaVersion
-            }
-    )
-}
-
-processResources
-        {
-            // this will ensure that this task is redone when the versions change.
-            inputs.property "version", project.version
-            inputs.property "mcversion", project.minecraft.version
-
-            // replace stuff in mcmod.info, nothing else
-            from(sourceSets.main.resources.srcDirs) {
-                include 'mcmod.info'
-
-                // replace version and mcversion
-                expand "minecraftVersion": project.minecraft.version,
-                        "modVersion": versionDetails().lastTag,
-                        "modId": modId,
-                        "modName": modName
-            }
-
-            // copy everything else, thats not the mcmod.info
-            from(sourceSets.main.resources.srcDirs) {
-                exclude 'mcmod.info'
-            }
-        }
-
-def getManifestAttributes() {
-    def manifestAttributes = [:]
-    if(containsMixinsAndOrCoreModOnly.toBoolean() == false && (usesMixins.toBoolean() || coreModClass)) {
-        manifestAttributes += ["FMLCorePluginContainsFMLMod": true]
-    }
-
-    if(accessTransformersFile) {
-        manifestAttributes += ["FMLAT" : accessTransformersFile.toString()]
-    }
-
-    if(coreModClass) {
-        manifestAttributes += ["FMLCorePlugin": modGroup + "." + coreModClass]
-    }
-
-    if(usesMixins.toBoolean()) {
-        manifestAttributes += [
-                "TweakClass" : "org.spongepowered.asm.launch.MixinTweaker",
-                "MixinConfigs" : mixinConfigJson,
-                "ForceLoadAsMod" : containsMixinsAndOrCoreModOnly.toBoolean() == false
-        ]
-    }
-    return manifestAttributes
-}
-
-task sourcesJar(type: Jar) {
-    from (sourceSets.main.allJava)
-    from (file("$projectDir/LICENSE"))
-    getArchiveClassifier().set('sources')
-}
-
-task shadowDevJar(type: ShadowJar) {
-    from sourceSets.main.output
-    getArchiveClassifier().set("dev")
-
-    manifest {
-        attributes(getManifestAttributes())
-    }
-
-    minimize()  // This will only allow shading for actually used classes
-    configurations = [project.configurations.shadowImplementation]
-}
-
-task relocateShadowDevJar(type: ConfigureShadowRelocation) {
-    target = tasks.shadowDevJar
-    prefix = modGroup + ".shadow"
-}
-
-task circularResolverJar(type: Jar) {
-    dependsOn(relocateShadowDevJar)
-    dependsOn(shadowDevJar)
-    enabled = false
-}
-
-task devJar(type: Jar) {
-    from sourceSets.main.output
-    getArchiveClassifier().set("dev")
-
-    manifest {
-        attributes(getManifestAttributes())
-    }
-
-    if(usesShadowedDependencies.toBoolean()) {
-        dependsOn(circularResolverJar)
-        enabled = false
-    }
-}
-
-task apiJar(type: Jar) {
-    from (sourceSets.main.allJava) {
-        include modGroup.toString().replaceAll("\\.", "/") + "/" + apiPackage.toString() + '/**'
-    }
-
-    from (sourceSets.main.output) {
-        include modGroup.toString().replaceAll("\\.", "/") + "/" + apiPackage.toString() + '/**'
-    }
-
-    from (sourceSets.main.resources.srcDirs) {
-        include("LICENSE")
-    }
-
-    getArchiveClassifier().set('api')
-}
-
-artifacts {
-    archives sourcesJar
-    archives devJar
-    if(apiPackage) {
-        archives apiJar
-    }
-}
-
-// Crude handler to append custom maven repositories to maven dependency
-install{
-    repositories{
-        mavenInstaller{
-            pom.withXml {
-                def repositoriesNode = asNode().appendNode("repositories")
-                project.repositories.each { repository ->
-                    def repositoryNode = repositoriesNode.appendNode("repository")
-                    repositoryNode.appendNode("name", repository.name)
-                    repositoryNode.appendNode("url", repository.properties.get("url"))
-                }
-            }
-        }
-    }
-}
-
-// Updating
-task updateBuildScript {
-    doLast {
-        if (updateBuildScript()) return
-
-        print("Build script already up-to-date!")
-    }
-}
-
-if (isNewBuildScriptVersionAvailable()) {
-    if (autoUpdateBuildScript.toBoolean()) {
-        updateBuildScript()
-    } else {
-        println("Build script update available! Run 'gradle updateBuildScript'")
-    }
-}
-
-static URL availableBuildScriptUrl() {
-    new URL("https://raw.githubusercontent.com/SinTh0r4s/ExampleMod1.7.10/main/build.gradle")
-}
-
-static boolean updateBuildScript() {
-    if (isNewBuildScriptVersionAvailable()) {
-        def buildscriptFile = new File("build.gradle")
-        availableBuildScriptUrl().withInputStream { i -> buildscriptFile.withOutputStream { it << i } }
-        print("Build script updated. Please REIMPORT the project or RESTART your IDE!")
-        return true
-    }
-    return false
-}
-
-static boolean isNewBuildScriptVersionAvailable() {
-    Map parameters = ["connectTimeout": 2000, "readTimeout": 2000]
-
-    String currentBuildScript = new File("build.gradle").getText()
-    String currentBuildScriptHash = getVersionHash(currentBuildScript)
-    String availableBuildScript = availableBuildScriptUrl().newInputStream(parameters).getText()
-    String availableBuildScriptHash = getVersionHash(availableBuildScript)
-
-    boolean isUpToDate = currentBuildScriptHash.empty || availableBuildScriptHash.empty || currentBuildScriptHash == availableBuildScriptHash
-    return !isUpToDate
-}
-
-static String getVersionHash(String buildScriptContent) {
-    String versionLine = buildScriptContent.find("^//version: [a-z0-9]*")
-    if(versionLine != null) {
-        return versionLine.split(": ").last()
-    }
-    return ""
-}
-
-configure(updateBuildScript) {
-    group = 'forgegradle'
-    description = 'Updates the build script to the latest version'
+    id 'com.gtnewhorizons.gtnhconvention'
 }

dependencies.gradle

@@ -1,5 +1,10 @@
 // Add your dependencies here
 
 dependencies {
+    api("com.github.GTNewHorizons:GTNHLib:0.11.21:dev")
+    implementation("com.github.GTNewHorizons:NotEnoughItems:2.8.110-GTNH:dev")
 
+    testImplementation(platform('org.junit:junit-bom:5.9.2'))
+    testImplementation('org.junit.jupiter:junit-jupiter')
+	testRuntimeOnly ('org.junit.platform:junit-platform-launcher')
 }

gradle.properties

@@ -1,60 +1,238 @@
+# ExampleMod tag to use as Blowdryer (Spotless, etc.) settings version, leave empty to disable.
+# LOCAL to test local config updates.
+gtnh.settings.blowdryerTag = 0.2.0
+
+# Human-readable mod name, available for mcmod.info population.
 modName = StructureLib
 
-# This is a case-sensitive string to identify your mod. Convention is to use lower case.
+# Case-sensitive identifier string, available for mcmod.info population and used for automatic mixin JSON generation.
+# Conventionally lowercase.
 modId = structurelib
 
+# Root package of the mod, used to find various classes in other properties,
+# mcmod.info substitution, enabling assertions in run tasks, etc.
 modGroup = com.gtnewhorizon.structurelib
 
-# WHY is there no version field?
-# The build script relies on git to provide a version via tags. It is super easy and will enable you to always know the
-# code base or your binary. Check out this tutorial: https://blog.mattclemente.com/2017/10/13/versioning-with-git-tags/
+# Whether to use modGroup as the maven publishing group.
+# When false, com.github.GTNewHorizons is used.
+useModGroupForPublishing = false
 
-# Will update your build.gradle automatically whenever an update is available
+# Updates your build.gradle and settings.gradle automatically whenever an update is available.
 autoUpdateBuildScript = false
 
+# Version of Minecraft to target
 minecraftVersion = 1.7.10
+
+# Version of Minecraft Forge to target
 forgeVersion = 10.13.4.1614
 
-# Select a username for testing your mod with breakpoints. You may leave this empty for a random user name each time you
-# restart Minecraft in development. Choose this dependent on your mod:
-# Do you need consistent player progressing (for example Thaumcraft)? -> Select a name
-# Do you need to test how your custom blocks interacts with a player that is not the owner? -> leave name empty
-developmentEnvironmentUserName = "Developer"
+# Specify an MCP channel for dependency deobfuscation and the deobfParams task.
+channel = stable
 
-# Define a source file of your project with:
-# public static final String VERSION = "GRADLETOKEN_VERSION";
-# The string's content will be replaced with your mods version when compiled. You should use this to specify your mod's
-# version in @Mod([...], version = VERSION, [...])
-# Leave these properties empty to skip individual token replacements
-replaceGradleTokenInFile = StructureLib.java
+# Specify an MCP mappings version for dependency deobfuscation and the deobfParams task.
+mappingsVersion = 12
+
+# Defines other MCP mappings for dependency deobfuscation.
+remoteMappings = https\://raw.githubusercontent.com/MinecraftForge/FML/1.7.10/conf/
+
+# Select a default username for testing your mod. You can always override this per-run by running
+# `./gradlew runClient --username=AnotherPlayer`, or configuring this command in your IDE.
+developmentEnvironmentUserName = Developer
+
+# Enables modern Java syntax support. Valid values:
+# - false: No modern syntax, Java 8 only
+# - jabel: Jabel syntax-only support, compiles to J8 bytecode
+# - jvmDowngrader: Full modern Java via JVM Downgrader (syntax + stdlib APIs)
+# - modern: Native modern Java bytecode, no downgrading
+enableModernJavaSyntax = jabel
+
+# If set, ignores the above setting and compiles with the given toolchain. This may cause unexpected issues,
+# and should *not* be used in most situations. -1 disables this.
+# forceToolchainVersion = -1
+
+# Target JVM version for JVM Downgrader bytecode downgrading.
+# Only used when enableModernJavaSyntax = jvmDowngrader
+# downgradeTargetVersion = 8
+
+# Comma-separated list of Java versions for multi-release jar support (JVM Downgrader only).
+# Classes will be available in META-INF/versions/N/ for each version N in this list.
+# Default: "21,25" (J25+ gets native classes, J21-24 gets partial downgrade, J8-20 gets full downgrade).
+# jvmDowngraderMultiReleaseVersions = 21,25
+
+# Specifies how JVM Downgrader API stubs are provided. Options:
+# - shade: Shade minimized stubs into the jar
+# - gtnhlib: GTNHLib provides stubs at runtime (adds version constraint)
+# - external: Another dependency provides stubs (no constraint, no warning)
+# - (empty): Warning reminding you to configure stubs
+# Note: 'shade' option requires you to verify license compliance, see: https://github.com/unimined/JvmDowngrader/blob/main/LICENSE.md
+# jvmDowngraderStubsProvider =
+
+# Enables injecting missing generics into the decompiled source code for a better coding experience.
+# Turns most publicly visible List, Map, etc. into proper List<E>, Map<K, V> types.
+enableGenericInjection = true
+
+# Generate a class with a String field for the mod version named as defined below.
+# If generateGradleTokenClass is empty or not missing, no such class will be generated.
+# If gradleTokenVersion is empty or missing, the field will not be present in the class.
+generateGradleTokenClass = com.gtnewhorizon.structurelib.Tags
+
+# Name of the token containing the project's current version to generate/replace.
+gradleTokenVersion = VERSION
+
+# [DEPRECATED] Mod ID replacement token.
 gradleTokenModId =
+
+# [DEPRECATED] Mod name replacement token.
 gradleTokenModName =
-gradleTokenVersion = GRADLETOKEN_VERSION
+
+# [DEPRECATED] Mod Group replacement token.
 gradleTokenGroupName =
 
-# In case your mod provides an API for other mods to implement you may declare its package here. Otherwise you can
+# [DEPRECATED]
+# Multiple source files can be defined here by providing a comma-separated list: Class1.java,Class2.java,Class3.java
+# public static final String VERSION = "GRADLETOKEN_VERSION";
+# The string's content will be replaced with your mod's version when compiled. You should use this to specify your mod's
+# version in @Mod([...], version = VERSION, [...]).
+# Leave these properties empty to skip individual token replacements.
+replaceGradleTokenInFile =
+
+# In case your mod provides an API for other mods to implement you may declare its package here. Otherwise, you can
 # leave this property empty.
-# Example value: apiPackage = api + modGroup = com.myname.mymodid -> com.myname.mymodid.api
+# Example value: (apiPackage = api) + (modGroup = com.myname.mymodid) -> com.myname.mymodid.api
 apiPackage =
 
-# Specify the configuration file for Forge's access transformers here. I must be placed into /src/main/resources/META-INF/
-# Example value: mymodid_at.cfg
+# Specify the configuration file for Forge's access transformers here. It must be placed into /src/main/resources/META-INF/
+# There can be multiple files in a space-separated list.
+# Example value: mymodid_at.cfg nei_at.cfg
 accessTransformersFile =
 
 # Provides setup for Mixins if enabled. If you don't know what mixins are: Keep it disabled!
-usesMixins = false
+usesMixins = true
+
+# Set to a non-empty string to configure mixins in a separate source set under src/VALUE, instead of src/main.
+# This can speed up compile times thanks to not running the mixin annotation processor on all input sources.
+# Mixin classes will have access to "main" classes, but not the other way around.
+separateMixinSourceSet =
+
+# Adds some debug arguments like verbose output and class export.
+usesMixinDebug = false
+
 # Specify the location of your implementation of IMixinConfigPlugin. Leave it empty otherwise.
 mixinPlugin =
-# Specify the package that contains all of your Mixins. You may only place Mixins in this package or the build will fail!
-mixinsPackage =
+
+# Specify the package that contains all of your Mixins. The package must exist or
+# the build will fail. If you have a package property defined in your mixins.<modid>.json,
+# it must match with this or the build will fail.
+mixinsPackage = mixins
+
 # Specify the core mod entry class if you use a core mod. This class must implement IFMLLoadingPlugin!
-# This parameter is for legacy compatability only
-# Example value: coreModClass = asm.FMLPlugin + modGroup = com.myname.mymodid -> com.myname.mymodid.asm.FMLPlugin
-coreModClass =
+# This parameter is for legacy compatibility only
+# Example value: (coreModClass = asm.FMLPlugin) + (modGroup = com.myname.mymodid) -> com.myname.mymodid.asm.FMLPlugin
+coreModClass = core.StructureLibCore
+
 # If your project is only a consolidation of mixins or a core mod and does NOT contain a 'normal' mod ( = some class
 # that is annotated with @Mod) you want this to be true. When in doubt: leave it on false!
 containsMixinsAndOrCoreModOnly = false
 
-# If enabled, you may use 'shadowImplementation' for dependencies. They will be integrated in your jar. It is your
-# responsibility check the licence and request permission for distribution, if required.
+# Enables Mixins even if this mod doesn't use them, useful if one of the dependencies uses mixins.
+forceEnableMixins = false
+
+# If enabled, you may use 'shadowCompile' for dependencies. They will be integrated into your jar. It is your
+# responsibility to check the license and request permission for distribution if required.
 usesShadowedDependencies = false
+
+# If disabled, won't remove unused classes from shadowed dependencies. Some libraries use reflection to access
+# their own classes, making the minimization unreliable.
+minimizeShadowedDependencies = true
+
+# If disabled, won't rename the shadowed classes.
+relocateShadowedDependencies = true
+
+# Adds CurseMaven, Modrinth, and some more well-known 1.7.10 repositories.
+includeWellKnownRepositories = true
+
+# A list of repositories to exclude from the includeWellKnownRepositories setting. Should be a space separated
+# list of strings, with the acceptable keys being(case does not matter):
+# cursemaven
+# modrinth
+excludeWellKnownRepositories =
+
+# Change these to your Maven coordinates if you want to publish to a custom Maven repository instead of the default GTNH Maven.
+# Authenticate with the MAVEN_USER and MAVEN_PASSWORD environment variables.
+# If you need a more complex setup disable maven publishing here and add a publishing repository to addon.gradle.
+usesMavenPublishing = true
+
+# Maven repository to publish the mod to.
+# mavenPublishUrl = https\://nexus.gtnewhorizons.com/repository/releases/
+
+# Publishing to Modrinth requires you to set the MODRINTH_TOKEN environment variable to your current Modrinth API token.
+#
+# The project's ID on Modrinth. Can be either the slug or the ID.
+# Leave this empty if you don't want to publish to Modrinth.
+modrinthProjectId =
+
+# The project's relations on Modrinth. You can use this to refer to other projects on Modrinth.
+# Syntax: scope1-type1:name1;scope2-type2:name2;...
+# Where scope can be one of [required, optional, incompatible, embedded],
+#       type can be one of [project, version],
+#       and the name is the Modrinth project or version slug/id of the other mod.
+# Example: required-project:fplib;optional-project:gasstation;incompatible-project:gregtech
+# Note: UniMixins is automatically set as a required dependency if usesMixins = true.
+modrinthRelations =
+
+# Publishing to CurseForge requires you to set the CURSEFORGE_TOKEN environment variable to one of your CurseForge API tokens.
+#
+# The project's numeric ID on CurseForge. You can find this in the About Project box.
+# Leave this empty if you don't want to publish on CurseForge.
+curseForgeProjectId =
+
+# The project's relations on CurseForge. You can use this to refer to other projects on CurseForge.
+# Syntax: type1:name1;type2:name2;...
+# Where type can be one of [requiredDependency, embeddedLibrary, optionalDependency, tool, incompatible],
+#       and the name is the CurseForge project slug of the other mod.
+# Example: requiredDependency:railcraft;embeddedLibrary:cofhlib;incompatible:buildcraft
+# Note: UniMixins is automatically set as a required dependency if usesMixins = true.
+curseForgeRelations =
+
+# Optional parameter to customize the produced artifacts. Use this to preserve artifact naming when migrating older
+# projects. New projects should not use this parameter.
+# customArchiveBaseName =
+
+# Optional parameter to customize the default working directory used by the runClient* tasks. Relative to the project directory.
+# runClientWorkingDirectory = run/client
+
+# Optional parameter to customize the default working directory used by the runServer* tasks. Relative to the project directory.
+# runServerWorkingDirectory = run/server
+
+# Optional parameter to have the build automatically fail if an illegal version is used.
+# This can be useful if you e.g. only want to allow versions in the form of '1.1.xxx'.
+# The check is ONLY performed if the version is a git tag.
+# Note: the specified string must be escaped, so e.g. 1\\.1\\.\\d+ instead of 1\.1\.\d+
+# versionPattern =
+
+# Uncomment to prevent the source code from being published.
+# noPublishedSources = true
+
+# Uncomment this to disable Spotless checks.
+# This should only be uncommented to keep it easier to sync with upstream/other forks.
+# That is, if there is no other active fork/upstream, NEVER change this.
+# disableSpotless = true
+
+# Uncomment this to disable Checkstyle checks (currently wildcard import check).
+# disableCheckstyle = true
+
+# Override the IDEA build type. Valid values are: "" (leave blank, do not override), "idea" (force use native IDEA build), "gradle"
+# (force use delegated build).
+# This is meant to be set in $HOME/.gradle/gradle.properties.
+# e.g. add "systemProp.org.gradle.project.ideaOverrideBuildType=idea" will override the build type to be native build.
+# WARNING: If you do use this option, it will overwrite whatever you have in your existing projects. This might not be what you want!
+# Usually there is no need to uncomment this here as other developers do not necessarily use the same build type as you.
+# ideaOverrideBuildType = idea
+
+# Whether IDEA should run spotless checks when pressing the Build button.
+# This is meant to be set in $HOME/.gradle/gradle.properties.
+# ideaCheckSpotlessOnBuild = true
+
+# Non-GTNH properties
+org.gradle.configuration-cache = true
+org.gradle.parallel = true

gradle/gradle-daemon-jvm.properties

@@ -0,0 +1,12 @@
+#This file is generated by updateDaemonJvm
+toolchainUrl.FREE_BSD.AARCH64=https\://api.foojay.io/disco/v3.0/ids/cf726b4a1c84b50457225f9bba6d7650/redirect
+toolchainUrl.FREE_BSD.X86_64=https\://api.foojay.io/disco/v3.0/ids/fa1e318c287360478e3c83a9a3ef1007/redirect
+toolchainUrl.LINUX.AARCH64=https\://api.foojay.io/disco/v3.0/ids/cf726b4a1c84b50457225f9bba6d7650/redirect
+toolchainUrl.LINUX.X86_64=https\://api.foojay.io/disco/v3.0/ids/fa1e318c287360478e3c83a9a3ef1007/redirect
+toolchainUrl.MAC_OS.AARCH64=https\://api.foojay.io/disco/v3.0/ids/c2dd35c9d0aaf0ba6ad0791320f99dfc/redirect
+toolchainUrl.MAC_OS.X86_64=https\://api.foojay.io/disco/v3.0/ids/e5810bd7fd1f8a586644409d395a7e55/redirect
+toolchainUrl.UNIX.AARCH64=https\://api.foojay.io/disco/v3.0/ids/cf726b4a1c84b50457225f9bba6d7650/redirect
+toolchainUrl.UNIX.X86_64=https\://api.foojay.io/disco/v3.0/ids/fa1e318c287360478e3c83a9a3ef1007/redirect
+toolchainUrl.WINDOWS.AARCH64=https\://api.foojay.io/disco/v3.0/ids/7b3c4877c0749019e6805bb61e421497/redirect
+toolchainUrl.WINDOWS.X86_64=https\://api.foojay.io/disco/v3.0/ids/d76df094a9cbbabd3b08251f9e61444a/redirect
+toolchainVersion=25

gradle/wrapper/gradle-wrapper.properties

@@ -1,5 +1,7 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-6.9.1-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.4.0-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

gradlew

@@ -1,7 +1,7 @@
-#!/usr/bin/env sh
+#!/bin/sh
 
 #
-# Copyright 2015 the original author or authors.
+# Copyright © 2015 the original authors.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,80 +15,114 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+# SPDX-License-Identifier: Apache-2.0
+#
 
 ##############################################################################
-##
-##  Gradle start up script for UN*X
-##
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/b631911858264c0b6e4d6603d677ff5218766cee/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
 ##############################################################################
 
 # Attempt to set APP_HOME
+
 # Resolve links: $0 may be a link
-PRG="$0"
-# Need this for relative symlinks.
-while [ -h "$PRG" ] ; do
-    ls=`ls -ld "$PRG"`
-    link=`expr "$ls" : '.*-> \(.*\)$'`
-    if expr "$link" : '/.*' > /dev/null; then
-        PRG="$link"
-    else
-        PRG=`dirname "$PRG"`"/$link"
-    fi
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
 done
-SAVED="`pwd`"
-cd "`dirname \"$PRG\"`/" >/dev/null
-APP_HOME="`pwd -P`"
-cd "$SAVED" >/dev/null
 
-APP_NAME="Gradle"
-APP_BASE_NAME=`basename "$0"`
-
-# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
-DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit
 
 # Use the maximum available, or set MAX_FD != -1 to use that value.
-MAX_FD="maximum"
+MAX_FD=maximum
 
 warn () {
     echo "$*"
-}
+} >&2
 
 die () {
     echo
     echo "$*"
     echo
     exit 1
-}
+} >&2
 
 # OS specific support (must be 'true' or 'false').
 cygwin=false
 msys=false
 darwin=false
 nonstop=false
-case "`uname`" in
-  CYGWIN* )
-    cygwin=true
-    ;;
-  Darwin* )
-    darwin=true
-    ;;
-  MINGW* )
-    msys=true
-    ;;
-  NONSTOP* )
-    nonstop=true
-    ;;
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
 esac
 
-CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
 
 # Determine the Java command to use to start the JVM.
 if [ -n "$JAVA_HOME" ] ; then
     if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
         # IBM's JDK on AIX uses strange locations for the executables
-        JAVACMD="$JAVA_HOME/jre/sh/java"
+        JAVACMD=$JAVA_HOME/jre/sh/java
     else
-        JAVACMD="$JAVA_HOME/bin/java"
+        JAVACMD=$JAVA_HOME/bin/java
     fi
     if [ ! -x "$JAVACMD" ] ; then
         die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
@@ -97,92 +131,118 @@ Please set the JAVA_HOME variable in your environment to match the
 location of your Java installation."
     fi
 else
-    JAVACMD="java"
-    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+    JAVACMD=java
+    if ! command -v java >/dev/null 2>&1
+    then
+        die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
 
 Please set the JAVA_HOME variable in your environment to match the
 location of your Java installation."
+    fi
 fi
 
 # Increase the maximum file descriptors if we can.
-if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
-    MAX_FD_LIMIT=`ulimit -H -n`
-    if [ $? -eq 0 ] ; then
-        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
-            MAX_FD="$MAX_FD_LIMIT"
-        fi
-        ulimit -n $MAX_FD
-        if [ $? -ne 0 ] ; then
-            warn "Could not set maximum file descriptor limit: $MAX_FD"
-        fi
-    else
-        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
-    fi
-fi
-
-# For Darwin, add options to specify how the application appears in the dock
-if $darwin; then
-    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
-fi
-
-# For Cygwin or MSYS, switch paths to Windows format before running java
-if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
-    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
-    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
-    JAVACMD=`cygpath --unix "$JAVACMD"`
-
-    # We build the pattern for arguments to be converted via cygpath
-    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
-    SEP=""
-    for dir in $ROOTDIRSRAW ; do
-        ROOTDIRS="$ROOTDIRS$SEP$dir"
-        SEP="|"
-    done
-    OURCYGPATTERN="(^($ROOTDIRS))"
-    # Add a user-defined pattern to the cygpath arguments
-    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
-        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
-    fi
-    # Now convert the arguments - kludge to limit ourselves to /bin/sh
-    i=0
-    for arg in "$@" ; do
-        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
-        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
-
-        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
-            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
-        else
-            eval `echo args$i`="\"$arg\""
-        fi
-        i=$((i+1))
-    done
-    case $i in
-        (0) set -- ;;
-        (1) set -- "$args0" ;;
-        (2) set -- "$args0" "$args1" ;;
-        (3) set -- "$args0" "$args1" "$args2" ;;
-        (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
-        (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
-        (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
-        (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
-        (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
-        (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
     esac
 fi
 
-# Escape application args
-save () {
-    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
-    echo " "
-}
-APP_ARGS=$(save "$@")
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
 
-# Collect all arguments for the java command, following the shell quoting and substitution rules
-eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
 
-# by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong
-if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then
-  cd "$(dirname "$0")"
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
+        fi
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
+    done
 fi
 
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Collect all arguments for the java command:
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+#     and any embedded shellness will be escaped.
+#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+#     treated as '${Hostname}' itself on the command line.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \
+        "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+    die "xargs is not available"
+fi
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
+
 exec "$JAVACMD" "$@"

gradlew.bat

@@ -13,8 +13,10 @@
 @rem See the License for the specific language governing permissions and
 @rem limitations under the License.
 @rem
+@rem SPDX-License-Identifier: Apache-2.0
+@rem
 
-@if "%DEBUG%" == "" @echo off
+@if "%DEBUG%"=="" @echo off
 @rem ##########################################################################
 @rem
 @rem  Gradle startup script for Windows
@@ -25,10 +27,14 @@
 if "%OS%"=="Windows_NT" setlocal
 
 set DIRNAME=%~dp0
-if "%DIRNAME%" == "" set DIRNAME=.
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
 set APP_BASE_NAME=%~n0
 set APP_HOME=%DIRNAME%
 
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
 @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
 set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
 
@@ -37,13 +43,13 @@ if defined JAVA_HOME goto findJavaFromJavaHome
 
 set JAVA_EXE=java.exe
 %JAVA_EXE% -version >NUL 2>&1
-if "%ERRORLEVEL%" == "0" goto init
+if %ERRORLEVEL% equ 0 goto execute
 
-echo.
-echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
-echo.
-echo Please set the JAVA_HOME variable in your environment to match the
-echo location of your Java installation.
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
 
 goto fail
 
@@ -51,48 +57,35 @@ goto fail
 set JAVA_HOME=%JAVA_HOME:"=%
 set JAVA_EXE=%JAVA_HOME%/bin/java.exe
 
-if exist "%JAVA_EXE%" goto init
+if exist "%JAVA_EXE%" goto execute
 
-echo.
-echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
-echo.
-echo Please set the JAVA_HOME variable in your environment to match the
-echo location of your Java installation.
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
 
 goto fail
 
-:init
-@rem Get command-line arguments, handling Windows variants
-
-if not "%OS%" == "Windows_NT" goto win9xME_args
-
-:win9xME_args
-@rem Slurp the command line arguments.
-set CMD_LINE_ARGS=
-set _SKIP=2
-
-:win9xME_args_slurp
-if "x%~1" == "x" goto execute
-
-set CMD_LINE_ARGS=%*
-
 :execute
 @rem Setup the command line
 
-set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
 
 @rem Execute Gradle
-"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
 
 :end
 @rem End local scope for the variables with windows NT shell
-if "%ERRORLEVEL%"=="0" goto mainEnd
+if %ERRORLEVEL% equ 0 goto mainEnd
 
 :fail
 rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
 rem the _cmd.exe /c_ return code!
-if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
-exit /b 1
+set EXIT_CODE=%ERRORLEVEL%
+if %EXIT_CODE% equ 0 set EXIT_CODE=1
+if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
+exit /b %EXIT_CODE%
 
 :mainEnd
 if "%OS%"=="Windows_NT" endlocal

repositories.gradle

@@ -1,5 +1,4 @@
 // Add any additional repositiroes for your dependencies here
 
 repositories {
-
 }

settings.gradle

@@ -0,0 +1,23 @@
+
+pluginManagement {
+    repositories {
+        maven {
+            // RetroFuturaGradle
+            name "GTNH Maven"
+            url "https://nexus.gtnewhorizons.com/repository/public/"
+            mavenContent {
+                includeGroup("com.gtnewhorizons")
+                includeGroupByRegex("com\\.gtnewhorizons\\..+")
+            }
+        }
+        gradlePluginPortal()
+        mavenCentral()
+        mavenLocal()
+    }
+}
+
+plugins {
+    id 'com.gtnewhorizons.gtnhsettingsconvention' version '2.0.26'
+}
+
+

src/main/java/com/gtnewhorizon/structurelib/ChannelDescription.java

@@ -0,0 +1,94 @@
+package com.gtnewhorizon.structurelib;
+
+import java.util.AbstractMap;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+import net.minecraft.item.ItemStack;
+
+import com.gtnewhorizon.gtnhlib.util.map.ItemStackMap;
+
+import cpw.mods.fml.common.Loader;
+
+// this is not an API! go check StructureLibAPI instead!
+public class ChannelDescription {
+
+    private static final ItemStackMap<Set<ChannelDescription>> itemToChannels = new ItemStackMap<>(true);
+    private static final Map<String, ChannelDescription> registry = new HashMap<>();
+    private final String channel;
+    private final Map<String, String> descriptions = new HashMap<>();
+    private final ItemStackMap<Integer> items = new ItemStackMap<>(true);
+
+    public static ChannelDescription get(final String channel) {
+        if (StructureLibAPI.isDebugEnabled() && !channel.toLowerCase(Locale.ROOT).equals(channel))
+            throw new IllegalArgumentException("Channel name can be lower case ONLY");
+        return registry.computeIfAbsent(channel, ChannelDescription::new);
+    }
+
+    public static boolean has(final String channel) {
+        if (StructureLibAPI.isDebugEnabled() && !channel.toLowerCase(Locale.ROOT).equals(channel))
+            throw new IllegalArgumentException("Channel name can be lower case ONLY");
+        return registry.containsKey(channel);
+    }
+
+    public static Collection<Map.Entry<String, Integer>> iterate(final ItemStack block) {
+        Set<ChannelDescription> channels = itemToChannels.get(block);
+        if (channels == null) return Collections.emptySet();
+        return channels.stream().map(d -> new AbstractMap.SimpleImmutableEntry<>(d.channel, d.items.get(block)))
+                .collect(Collectors.toList());
+    }
+
+    public static void set(final String channel, final String modid, final String description) {
+        if (StructureLibAPI.isDebugEnabled() && !channel.toLowerCase(Locale.ROOT).equals(channel))
+            throw new IllegalArgumentException("Channel name can be lower case ONLY");
+        registry.computeIfAbsent(channel, ChannelDescription::new).add(modid, description);
+    }
+
+    public static void item(final String channel, int channelValue, ItemStack stack) {
+        if (StructureLibAPI.isDebugEnabled()) {
+            if (!channel.toLowerCase(Locale.ROOT).equals(channel)) {
+                throw new IllegalArgumentException("Channel name can be lower case ONLY");
+            }
+            if (channelValue <= 0) {
+                throw new IllegalArgumentException("Channel value must be greater than 0");
+            }
+        }
+        ChannelDescription inst = registry.computeIfAbsent(channel, ChannelDescription::new);
+        inst.items.put(stack, channelValue);
+        itemToChannels.computeIfAbsent(stack, s -> new HashSet<>()).add(inst);
+    }
+
+    public static Map<String, ChannelDescription> getAll() {
+        return Collections.unmodifiableMap(registry);
+    }
+
+    private ChannelDescription(String channel) {
+        this.channel = channel;
+    }
+
+    public String getChannel() {
+        return channel;
+    }
+
+    public ChannelDescription add(String modid, String description) {
+        if (Loader.instance().getIndexedModList().get(modid) == null) {
+            throw new IllegalArgumentException("Mod not found: " + modid);
+        }
+        descriptions.put(modid, description);
+        return this;
+    }
+
+    public Map<String, String> getDescriptions() {
+        return Collections.unmodifiableMap(descriptions);
+    }
+
+    public Map<ItemStack, Integer> getItems() {
+        return Collections.unmodifiableMap(items);
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/ClientProxy.java

@@ -0,0 +1,653 @@
+package com.gtnewhorizon.structurelib;
+
+import static com.gtnewhorizon.structurelib.StructureLib.RANDOM;
+
+import java.lang.ref.WeakReference;
+import java.util.ArrayList;
+import java.util.Comparator;
+import java.util.HashMap;
+import java.util.LinkedList;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+
+import net.minecraft.block.Block;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.entity.EntityClientPlayerMP;
+import net.minecraft.client.gui.GuiNewChat;
+import net.minecraft.client.particle.EntityFX;
+import net.minecraft.client.renderer.Tessellator;
+import net.minecraft.client.renderer.culling.Frustrum;
+import net.minecraft.client.renderer.texture.TextureMap;
+import net.minecraft.client.resources.I18n;
+import net.minecraft.entity.Entity;
+import net.minecraft.entity.player.EntityPlayer;
+import net.minecraft.entity.player.EntityPlayerMP;
+import net.minecraft.item.ItemStack;
+import net.minecraft.profiler.Profiler;
+import net.minecraft.util.ChatComponentText;
+import net.minecraft.util.IChatComponent;
+import net.minecraft.util.IIcon;
+import net.minecraft.util.Vec3;
+import net.minecraft.world.World;
+import net.minecraftforge.client.event.RenderWorldLastEvent;
+import net.minecraftforge.common.MinecraftForge;
+import net.minecraftforge.common.config.ConfigElement;
+import net.minecraftforge.event.entity.EntityJoinWorldEvent;
+import net.minecraftforge.event.world.WorldEvent;
+
+import org.apache.commons.lang3.tuple.Pair;
+import org.lwjgl.opengl.GL11;
+
+import com.gtnewhorizon.structurelib.entity.fx.WeightlessParticleFX;
+import com.gtnewhorizon.structurelib.net.RegistryOrderSyncMessage;
+import com.gtnewhorizon.structurelib.net.SetChannelDataMessage;
+
+import cpw.mods.fml.client.config.GuiConfig;
+import cpw.mods.fml.client.event.ConfigChangedEvent;
+import cpw.mods.fml.common.FMLCommonHandler;
+import cpw.mods.fml.common.event.FMLLoadCompleteEvent;
+import cpw.mods.fml.common.event.FMLPreInitializationEvent;
+import cpw.mods.fml.common.eventhandler.EventPriority;
+import cpw.mods.fml.common.eventhandler.SubscribeEvent;
+import cpw.mods.fml.common.gameevent.TickEvent.ClientTickEvent;
+import cpw.mods.fml.common.gameevent.TickEvent.Phase;
+import cpw.mods.fml.common.network.FMLNetworkEvent;
+
+public class ClientProxy extends CommonProxy {
+
+    private static final short[] RGBA_NO_TINT = { 255, 255, 255, 255 };
+    private static final short[] RGBA_RED_TINT = { 255, 128, 128, 0 };
+    private static final Map<HintParticleInfo, HintGroup> allHints = new HashMap<>();
+    /**
+     * All batches of hints.
+     */
+    private static final List<HintGroup> allGroups = new ArrayList<>();
+
+    /**
+     * Current batch of hints. Belongs to the same logical multiblock.
+     */
+    private static HintGroup currentHints;
+    /**
+     * Collection of all hints. Sorted from farthest (index 0) to nearest (index size - 1)
+     * <p>
+     * 10k should be more than enough, if not a bit wasteful
+     */
+    private static final List<HintParticleInfo> allHintsForRender = new ArrayList<>(10000);
+    /**
+     * If the diff to current player position is too great sort the allHints. Initial value is very far off below y=0
+     * but not huge enough to make a NaN.
+     * <p>
+     * We are using this supposedly immutable object as a mutable object here. So be aware.
+     */
+    private static final Vec3 lastPlayerPos = Vec3.createVectorHelper(0, -1e30, 0);
+    /**
+     * if true rebuild the allHints list from all hintOwners (and sort it)
+     */
+    private static boolean allHintsDirty = false;
+    /**
+     * counter keeping track of how many renderThrough hint particle we have. enable optimization if no renderThrough
+     */
+    private static int renderThrough;
+    /**
+     * A throttle map for local player. Integrated server will use the throttle map in super class instead.
+     */
+    private static final Map<Object, Long> localThrottleMap = new HashMap<>();
+
+    @Override
+    public void hintParticleTinted(World w, int x, int y, int z, IIcon[] icons, short[] RGBa) {
+        ensureHinting();
+        HintParticleInfo info = new HintParticleInfo(w, x, y, z, icons, RGBa);
+
+        // check and remove colliding holograms
+        if (ConfigurationHandler.INSTANCE.isRemoveCollidingHologram()) {
+            HintGroup dupe = allHints.get(info);
+            if (dupe != null && dupe != currentHints) {
+                allGroups.remove(dupe);
+                removeGroup(dupe);
+            }
+        }
+        allHints.put(info, currentHints);
+        currentHints.getHints().add(info);
+        allHintsDirty = true;
+
+        EntityFX particle = new WeightlessParticleFX(
+                w,
+                x + RANDOM.nextFloat() * 0.5F,
+                y + RANDOM.nextFloat() * 0.5F,
+                z + RANDOM.nextFloat() * 0.5F,
+                0,
+                0,
+                0);
+        particle.setRBGColorF(0, 0.6F * RANDOM.nextFloat(), 0.8f);
+        Minecraft.getMinecraft().effectRenderer.addEffect(particle);
+    }
+
+    @Override
+    public void hintParticleTinted(World w, int x, int y, int z, Block block, int meta, short[] RGBa) {
+        hintParticleTinted(w, x, y, z, createIIconFromBlock(block, meta), RGBa);
+    }
+
+    @Override
+    public void hintParticle(World w, int x, int y, int z, IIcon[] icons) {
+        hintParticleTinted(w, x, y, z, icons, RGBA_NO_TINT);
+    }
+
+    @Override
+    public void hintParticle(World w, int x, int y, int z, Block block, int meta) {
+        hintParticleTinted(w, x, y, z, createIIconFromBlock(block, meta), RGBA_NO_TINT);
+    }
+
+    @Override
+    public boolean updateHintParticleTint(EntityPlayer player, World w, int x, int y, int z, short[] rgBa) {
+        if (player instanceof EntityPlayerMP) return super.updateHintParticleTint(player, w, x, y, z, rgBa);
+        if (player != getCurrentPlayer()) return false; // how?
+        HintParticleInfo hint = getHintParticleInfo(w, x, y, z);
+        if (hint == null) {
+            return false;
+        }
+        hint.setTint(rgBa);
+        return true;
+    }
+
+    private static HintParticleInfo getHintParticleInfo(World w, int x, int y, int z) {
+        HintParticleInfo info = new HintParticleInfo(w, x, y, z, null, null);
+        HintGroup existing = allHints.get(info);
+        if (existing != null) {
+            for (HintParticleInfo hint : existing.getHints()) {
+                if (hint.equals(info)) {
+                    return hint;
+                }
+            }
+        }
+        return null;
+    }
+
+    @Override
+    public boolean markHintParticleError(EntityPlayer player, World w, int x, int y, int z) {
+        if (player instanceof EntityPlayerMP) return super.markHintParticleError(player, w, x, y, z);
+        if (player != getCurrentPlayer()) return false; // how?
+        HintParticleInfo hint = getHintParticleInfo(w, x, y, z);
+        if (hint == null) {
+            return false;
+        }
+        hint.setTint(RGBA_RED_TINT);
+        hint.setRenderThrough();
+        return true;
+    }
+
+    @Override
+    public void addThrottledChat(Object throttleKey, EntityPlayer player, IChatComponent text, short intervalRequired,
+            boolean forceUpdateLastSend) {
+        if (player instanceof EntityPlayerMP)
+            super.addThrottledChat(throttleKey, player, text, intervalRequired, forceUpdateLastSend);
+        else if (player != null)
+            addThrottledChat(throttleKey, player, text, intervalRequired, forceUpdateLastSend, localThrottleMap);
+    }
+
+    static void removeGroup(HintGroup group) {
+        for (HintParticleInfo hintParticleInfo : group.getHints()) {
+            allHints.remove(hintParticleInfo);
+            if (hintParticleInfo.renderThrough) renderThrough--;
+        }
+        allHintsDirty = true;
+    }
+
+    private static IIcon[] createIIconFromBlock(Block block, int meta) {
+        IIcon[] ret = new IIcon[6];
+        for (int i = 0; i < 6; i++) {
+            ret[i] = block.getIcon(i, meta);
+        }
+        return ret;
+    }
+
+    @Override
+    public void addClientSideChatMessages(String... messages) {
+        GuiNewChat chat = Minecraft.getMinecraft().ingameGUI.getChatGUI();
+        for (String s : messages) {
+            chat.printChatMessage(new ChatComponentText(s));
+        }
+    }
+
+    @Override
+    public EntityPlayer getCurrentPlayer() {
+        return Minecraft.getMinecraft().thePlayer;
+    }
+
+    @Override
+    public boolean isCurrentPlayer(EntityPlayer player) {
+        return player == Minecraft.getMinecraft().thePlayer;
+    }
+
+    @Override
+    public void startHinting(World w) {
+        if (!w.isRemote) return;
+        if (currentHints != null) endHinting(w);
+        currentHints = new HintGroup();
+    }
+
+    private void ensureHinting() {
+        if (currentHints == null) currentHints = new HintGroup();
+    }
+
+    @Override
+    public void endHinting(World w) {
+        if (!w.isRemote || currentHints == null) return;
+        while (!allGroups.isEmpty() && allGroups.size() >= ConfigurationHandler.INSTANCE.getMaxCoexistingHologram()) {
+            allGroups.remove(0);
+        }
+        if (!currentHints.getHints().isEmpty()) allGroups.add(currentHints);
+        // we use the player existence time here as some worlds don't really advance the time ticker
+        currentHints.setCreationTime(getCurrentPlayer().ticksExisted);
+        currentHints = null;
+    }
+
+    @Override
+    public long getOverworldTime() {
+        // there is no overworld, better just hope current world time is ok...
+        return Minecraft.getMinecraft().theWorld.getTotalWorldTime();
+    }
+
+    @Override
+    public void uploadChannels(ItemStack trigger) {
+        StructureLib.net.sendToServer(new SetChannelDataMessage(trigger));
+    }
+
+    @Override
+    public void preInit(FMLPreInitializationEvent e) {
+        FMLCommonHandler.instance().bus().register(new FMLEventHandler());
+        MinecraftForge.EVENT_BUS.register(new ForgeEventHandler());
+    }
+
+    static void markTextureUsed(IIcon icon) {
+        if (StructureLib.COMPAT instanceof IStructureCompat)
+            ((IStructureCompat) StructureLib.COMPAT).markTextureUsed(icon);
+    }
+
+    static void sendRegistryOrderToServer() {
+        if (FMLEventHandler.configSent) return;
+        FMLEventHandler.configSent = true;
+        for (String s : SortedRegistry.ALL_REGISTRIES.keySet()) {
+            Pair<List<String>, List<String>> registryOrder = ConfigurationHandler.INSTANCE.getRegistryOrder(s);
+            if (registryOrder == null || registryOrder.getKey().isEmpty() && registryOrder.getValue().isEmpty())
+                continue;
+            StructureLib.net
+                    .sendToServer(new RegistryOrderSyncMessage(s, registryOrder.getKey(), registryOrder.getValue()));
+        }
+    }
+
+    @Override
+    public void loadComplete(FMLLoadCompleteEvent evt) {
+        super.loadComplete(evt);
+        for (Map.Entry<String, WeakReference<SortedRegistry<?>>> e : SortedRegistry.ALL_REGISTRIES.entrySet()) {
+            SortedRegistry<?> r = e.getValue().get();
+            if (r == null) continue;
+            Pair<List<String>, List<String>> p = ConfigurationHandler.INSTANCE.getRegistryOrder(e.getKey());
+            r.registerOrdering(getSPPlayerUUID(), p.getKey(), p.getValue());
+        }
+    }
+
+    public UUID getSPPlayerUUID() {
+        return EntityPlayer.func_146094_a(Minecraft.getMinecraft().getSession().func_148256_e());
+    }
+
+    public void displayConfigGUI(String category) {
+        ConfigElement<Object> element = new ConfigElement<>(
+                ConfigurationHandler.INSTANCE.getConfig().getCategory(category));
+        GuiConfig guiConfig = new GuiConfig(
+                null,
+                element.getChildElements(),
+                StructureLibAPI.MOD_ID,
+                null,
+                false,
+                false,
+                I18n.format(element.getLanguageKey()));
+        Minecraft.getMinecraft().displayGuiScreen(guiConfig);
+    }
+
+    private static class HintGroup {
+
+        private final List<HintParticleInfo> hints = new LinkedList<>();
+        private int creationTime = -1;
+
+        public List<HintParticleInfo> getHints() {
+            return hints;
+        }
+
+        public void setCreationTime(int creationTime) {
+            this.creationTime = creationTime;
+        }
+
+        public int getCreationTime() {
+            return creationTime;
+        }
+    }
+
+    private static class HintParticleInfo {
+
+        private final World w;
+        // these are the block coordinate for e.g. w.getBlock()
+        private final int x, y, z;
+        private final IIcon[] icons;
+        private short[] tint;
+        private boolean renderThrough;
+
+        private final long creationTime = System.currentTimeMillis(); // use tick time instead maybe
+
+        public HintParticleInfo(World w, int x, int y, int z, IIcon[] icons, short[] tint) {
+            this.w = w;
+            this.x = x;
+            this.y = y;
+            this.z = z;
+            this.icons = icons;
+            this.tint = tint;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (!(o instanceof HintParticleInfo that)) return false;
+
+            return x == that.x && y == that.y && z == that.z;
+        }
+
+        public void setTint(short[] tint) {
+            this.tint = tint;
+        }
+
+        public void setRenderThrough() {
+            if (!this.renderThrough) {
+                ClientProxy.renderThrough += 1;
+                allHintsDirty = true;
+            }
+            this.renderThrough = true;
+        }
+
+        @Override
+        public int hashCode() {
+            int result = x;
+            result = 31 * result + y;
+            result = 31 * result + z;
+            return result;
+        }
+
+        public boolean isInFrustrum(Frustrum frustrum) {
+            return frustrum.isBoxInFrustum(x + 0.25, y + 0.25, z + 0.25, x + 0.75, y + 0.75, z + 0.75);
+        }
+
+        public void draw(Tessellator tes, double eyeX, double eyeY, double eyeZ, int eyeXint, int eyeYint,
+                int eyeZint) {
+            double size = 0.5;
+
+            int brightness = w.blockExists(x, 0, z) ? w.getLightBrightnessForSkyBlocks(x, y, z, 0) : 0;
+            tes.setBrightness(brightness);
+
+            tes.setColorRGBA(
+                    (int) (tint[0] * .9F),
+                    (int) (tint[1] * .95F),
+                    (int) (tint[2] * 1F),
+                    ConfigurationHandler.INSTANCE.getHintTransparency());
+
+            double X = (x - eyeXint) + 0.25;
+            double Y = (y - eyeYint) + 0.25;
+            double Z = (z - eyeZint) + 0.25;
+            double worldX = x + 0.25;
+            double worldY = y + 0.25;
+            double worldZ = z + 0.25;
+
+            // cube is a very special model. its facings can be rendered correctly by viewer distance without using
+            // surface normals and view vector
+            // here we do a 2 pass render.
+            // first pass we draw obstructed faces (i.e. faces that are further away from player)
+            // second pass we draw unobstructed faces
+            for (int j = 0; j < 2; j++) {
+                boolean unobstructedPass = j == 1;
+                for (int i = 0; i < 6; i++) {
+                    if (icons[i] == null) continue;
+
+                    markTextureUsed(icons[i]);
+
+                    double u = icons[i].getMinU();
+                    double U = icons[i].getMaxU();
+                    double v = icons[i].getMinV();
+                    double V = icons[i].getMaxV();
+                    switch (i) { // {DOWN, UP, NORTH, SOUTH, WEST, EAST}
+                        case 0:
+                            // all these ifs is in form if ((is face unobstructed) != (is in unobstructred pass))
+                            if ((worldY >= eyeY) != unobstructedPass) continue;
+                            tes.setNormal(0, -1, 0);
+                            tes.addVertexWithUV(X, Y, Z + size, u, V);
+                            tes.addVertexWithUV(X, Y, Z, u, v);
+                            tes.addVertexWithUV(X + size, Y, Z, U, v);
+                            tes.addVertexWithUV(X + size, Y, Z, U, v);
+                            tes.addVertexWithUV(X + size, Y, Z + size, U, V);
+                            tes.addVertexWithUV(X, Y, Z + size, u, V);
+                            break;
+                        case 1:
+                            if ((worldY + size <= eyeY) != unobstructedPass) continue;
+                            tes.setNormal(0, 1, 0);
+                            tes.addVertexWithUV(X, Y + size, Z, u, v);
+                            tes.addVertexWithUV(X, Y + size, Z + size, u, V);
+                            tes.addVertexWithUV(X + size, Y + size, Z + size, U, V);
+                            tes.addVertexWithUV(X + size, Y + size, Z + size, U, V);
+                            tes.addVertexWithUV(X + size, Y + size, Z, U, v);
+                            tes.addVertexWithUV(X, Y + size, Z, u, v);
+                            break;
+                        case 2:
+                            if ((worldZ >= eyeZ) != unobstructedPass) continue;
+                            tes.setNormal(0, 0, -1);
+                            tes.addVertexWithUV(X, Y, Z, U, V);
+                            tes.addVertexWithUV(X, Y + size, Z, U, v);
+                            tes.addVertexWithUV(X + size, Y + size, Z, u, v);
+                            tes.addVertexWithUV(X + size, Y + size, Z, u, v);
+                            tes.addVertexWithUV(X + size, Y, Z, u, V);
+                            tes.addVertexWithUV(X, Y, Z, U, V);
+                            break;
+                        case 3:
+                            if ((worldZ + size <= eyeZ) != unobstructedPass) continue;
+                            tes.setNormal(0, 0, 1);
+                            tes.addVertexWithUV(X + size, Y, Z + size, U, V);
+                            tes.addVertexWithUV(X + size, Y + size, Z + size, U, v);
+                            tes.addVertexWithUV(X, Y + size, Z + size, u, v);
+                            tes.addVertexWithUV(X, Y + size, Z + size, u, v);
+                            tes.addVertexWithUV(X, Y, Z + size, u, V);
+                            tes.addVertexWithUV(X + size, Y, Z + size, U, V);
+                            break;
+                        case 4:
+                            if ((worldX >= eyeX) != unobstructedPass) continue;
+                            tes.setNormal(-1, 0, 0);
+                            tes.addVertexWithUV(X, Y, Z + size, U, V);
+                            tes.addVertexWithUV(X, Y + size, Z + size, U, v);
+                            tes.addVertexWithUV(X, Y + size, Z, u, v);
+                            tes.addVertexWithUV(X, Y + size, Z, u, v);
+                            tes.addVertexWithUV(X, Y, Z, u, V);
+                            tes.addVertexWithUV(X, Y, Z + size, U, V);
+                            break;
+                        case 5:
+                            if ((worldX + size <= eyeX) != unobstructedPass) continue;
+                            tes.setNormal(1, 0, 0);
+                            tes.addVertexWithUV(X + size, Y, Z, U, V);
+                            tes.addVertexWithUV(X + size, Y + size, Z, U, v);
+                            tes.addVertexWithUV(X + size, Y + size, Z + size, u, v);
+                            tes.addVertexWithUV(X + size, Y + size, Z + size, u, v);
+                            tes.addVertexWithUV(X + size, Y, Z + size, u, V);
+                            tes.addVertexWithUV(X + size, Y, Z, U, V);
+                            break;
+                    }
+                }
+            }
+        }
+
+        public long getCreationTime() {
+            return creationTime;
+        }
+
+        public double getSquareDistanceTo(Vec3 point) {
+            return point.squareDistanceTo(x + 0.5, y + 0.5, z + 0.5);
+        }
+    }
+
+    public static class FMLEventHandler {
+
+        static boolean connected = false;
+        static boolean configSent = false;
+
+        private void resetPlayerLocation() {
+            lastPlayerPos.xCoord = Minecraft.getMinecraft().thePlayer.posX;
+            lastPlayerPos.yCoord = Minecraft.getMinecraft().thePlayer.posY;
+            lastPlayerPos.zCoord = Minecraft.getMinecraft().thePlayer.posZ;
+        }
+
+        @SubscribeEvent
+        public void onPlayerLogIn(FMLNetworkEvent.ClientConnectedToServerEvent e) {
+            connected = true;
+            configSent = false;
+        }
+
+        @SubscribeEvent
+        public void onPlayerLogOut(FMLNetworkEvent.ClientDisconnectionFromServerEvent e) {
+            connected = false;
+        }
+
+        @SubscribeEvent(priority = EventPriority.LOWEST)
+        public void onConfigChange(ConfigChangedEvent.PostConfigChangedEvent e) {
+            if (connected && e.modID.equals(StructureLibAPI.MOD_ID)) {
+                configSent = false;
+                sendRegistryOrderToServer();
+            }
+        }
+
+        @SubscribeEvent
+        public void onClientTick(ClientTickEvent e) {
+            if (e.phase == Phase.END && Minecraft.getMinecraft().thePlayer != null) {
+                Vec3 playerPos = Minecraft.getMinecraft().thePlayer.getPosition(1);
+                boolean sortRequired = false;
+                // The allGroups is implicitly sorted by creationTime
+                // here we exploit this ordering to reduce iteration size
+                int deadline = Minecraft.getMinecraft().thePlayer.ticksExisted
+                        - ConfigurationHandler.INSTANCE.getHintLifespan();
+                int i;
+                for (i = 0; i < allGroups.size(); i++) {
+                    if (allGroups.get(i).getCreationTime() > deadline) {
+                        break;
+                    }
+                }
+                if (i != 0) {
+                    sortRequired = true;
+                    // clear this block and go no further
+                    List<HintGroup> toRemove = allGroups.subList(0, i);
+                    toRemove.forEach(ClientProxy::removeGroup);
+                    toRemove.clear();
+                }
+                if (allHintsDirty) {
+                    allHintsForRender.clear();
+                    // we need greatly efficient sequential access and mildly efficient sorting
+                    // rebuild is sort of rare, and it's expected to lag anyway
+                    // so no min-heap here
+                    for (HintGroup c : allGroups) allHintsForRender.addAll(c.getHints());
+                    sortRequired = true;
+                }
+                if (sortRequired || playerPos.squareDistanceTo(lastPlayerPos) > 1e-2) {
+                    // only redo sort if player moved some distance
+                    // default is 0.1 block
+                    // if there was a full rebuild, go sort it as well
+                    allHintsForRender.sort(Comparator.comparingDouble(info -> -info.getSquareDistanceTo(playerPos)));
+                    resetPlayerLocation();
+                }
+            }
+        }
+    }
+
+    public static class ForgeEventHandler {
+
+        @SubscribeEvent
+        public void onEntityJoinWorld(EntityJoinWorldEvent e) {
+            if (e.world.isRemote && e.entity instanceof EntityClientPlayerMP) {
+                sendRegistryOrderToServer();
+            }
+        }
+
+        @SubscribeEvent
+        public void onWorldLoad(WorldEvent.Load e) {
+            if (e.world.isRemote) {
+                // flush hints. we are in a different world now.
+                allHintsForRender.clear();
+                allGroups.clear();
+                lastPlayerPos.yCoord = -1e30;
+                renderThrough = 0;
+                // clear throttles. hopefully a world switch is enough long as a cool down.
+                localThrottleMap.clear();
+            }
+        }
+
+        @SubscribeEvent
+        public void onRenderWorldLast(RenderWorldLastEvent e) {
+            if (allHintsForRender.isEmpty()) return;
+
+            // seriously, I'm not a OpenGL expert, so I'm probably doing a lot of very stupid stuff here.
+            // Please consider contributing patches if you find something to optimize.
+
+            Profiler p = Minecraft.getMinecraft().mcProfiler;
+
+            p.startSection("HintParticle");
+            p.startSection("Prepare");
+            Frustrum frustrum = new Frustrum();
+            Entity entitylivingbase = Minecraft.getMinecraft().renderViewEntity;
+            double d0 = entitylivingbase.lastTickPosX
+                    + (entitylivingbase.posX - entitylivingbase.lastTickPosX) * e.partialTicks;
+            double d1 = entitylivingbase.lastTickPosY
+                    + (entitylivingbase.posY - entitylivingbase.lastTickPosY) * e.partialTicks;
+            double d2 = entitylivingbase.lastTickPosZ
+                    + (entitylivingbase.posZ - entitylivingbase.lastTickPosZ) * e.partialTicks;
+            int i0 = (int) d0, i1 = (int) d1, i2 = (int) d2;
+            frustrum.setPosition(d0, d1, d2);
+
+            GL11.glPushMatrix();
+            GL11.glPushAttrib(GL11.GL_ENABLE_BIT | GL11.GL_COLOR_BUFFER_BIT); // TODO figure out original states
+            // we need the back facing rendered because the thing is transparent
+            GL11.glDisable(GL11.GL_CULL_FACE);
+            GL11.glDisable(GL11.GL_ALPHA_TEST);
+            GL11.glEnable(GL11.GL_BLEND); // enable blend so it is transparent
+            GL11.glBlendFunc(GL11.GL_ONE_MINUS_SRC_ALPHA, GL11.GL_SRC_ALPHA);
+            // depth test begin as enabled
+            boolean renderThrough = false;
+            Minecraft.getMinecraft().renderEngine.bindTexture(TextureMap.locationBlocksTexture);
+            GL11.glTranslated(-d0 + i0, -d1 + i1, -d2 + i2);
+            Tessellator tes = Tessellator.instance;
+            tes.startDrawing(GL11.GL_TRIANGLES);
+            for (int i = 0, allHintsForRenderSize = allHintsForRender.size(), cubeDrawn = 0; i
+                    < allHintsForRenderSize; i++, cubeDrawn++) {
+                HintParticleInfo hint = allHintsForRender.get(i);
+                if (!hint.isInFrustrum(frustrum)) continue;
+                if (renderThrough != hint.renderThrough) {
+                    if (i > 0) {
+                        p.endStartSection("Draw");
+                        tes.draw();
+                        tes.startDrawing(GL11.GL_TRIANGLES);
+                        cubeDrawn = 0;
+                        p.endStartSection("Prepare");
+                    }
+                    if (hint.renderThrough) GL11.glDisable(GL11.GL_DEPTH_TEST);
+                    else GL11.glEnable(GL11.GL_DEPTH_TEST);
+                    renderThrough = hint.renderThrough;
+                }
+                // Minecraft Tessellator draw in batch of 4096. This plays nicely with quads, but for trigs
+                // it might occasionally end up with one half in first batch and the other half in later batch.
+                // so we manually flush the buffer here if that would happen.
+                // 6 faces per particle, 2 trig per face, 3 vertex per trig
+                if ((cubeDrawn + 1) >= 4096 / (6 * 2 * 3)) {
+                    tes.draw();
+                    tes.startDrawing(GL11.GL_TRIANGLES);
+                }
+                hint.draw(tes, d0, d1, d2, i0, i1, i2);
+            }
+            p.endStartSection("Draw");
+            tes.draw();
+            p.endSection();
+
+            GL11.glPopAttrib();
+            GL11.glPopMatrix();
+            p.endSection();
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/CommonProxy.java

@@ -0,0 +1,128 @@
+package com.gtnewhorizon.structurelib;
+
+import java.util.HashMap;
+import java.util.Map;
+import java.util.WeakHashMap;
+
+import net.minecraft.block.Block;
+import net.minecraft.entity.player.EntityPlayer;
+import net.minecraft.entity.player.EntityPlayerMP;
+import net.minecraft.item.ItemStack;
+import net.minecraft.server.MinecraftServer;
+import net.minecraft.util.IChatComponent;
+import net.minecraft.util.IIcon;
+import net.minecraft.world.World;
+import net.minecraftforge.common.MinecraftForge;
+
+import com.gtnewhorizon.structurelib.net.ErrorHintParticleMessage;
+import com.gtnewhorizon.structurelib.net.UpdateHintParticleMessage;
+
+import cpw.mods.fml.common.event.FMLLoadCompleteEvent;
+import cpw.mods.fml.common.event.FMLPreInitializationEvent;
+import cpw.mods.fml.common.eventhandler.SubscribeEvent;
+import cpw.mods.fml.common.gameevent.TickEvent;
+
+public class CommonProxy {
+
+    public CommonProxy() {
+        super();
+        MinecraftForge.EVENT_BUS.register(new ForgeEventHandler());
+    }
+
+    public void hintParticleTinted(World w, int x, int y, int z, IIcon[] icons, short[] RGBa) {}
+
+    public void hintParticleTinted(World w, int x, int y, int z, Block block, int meta, short[] RGBa) {}
+
+    public void hintParticle(World w, int x, int y, int z, IIcon[] icons) {}
+
+    public void hintParticle(World w, int x, int y, int z, Block block, int meta) {}
+
+    public boolean updateHintParticleTint(EntityPlayer player, World w, int x, int y, int z, short[] rgBa) {
+        if (player instanceof EntityPlayerMP) { // just in case
+            StructureLib.net.sendTo(
+                    new UpdateHintParticleMessage(x, (short) y, z, rgBa[0], rgBa[1], rgBa[2], rgBa[3]),
+                    (EntityPlayerMP) player);
+            return true;
+        } else {
+            return false;
+        }
+    }
+
+    public EntityPlayer getCurrentPlayer() {
+        return null;
+    }
+
+    public boolean isCurrentPlayer(EntityPlayer player) {
+        return false;
+    }
+
+    public void addClientSideChatMessages(String... messages) {}
+
+    public void startHinting(World w) {}
+
+    public void endHinting(World w) {}
+
+    public void preInit(FMLPreInitializationEvent e) {}
+
+    public long getOverworldTime() {
+        return MinecraftServer.getServer().getEntityWorld().getTotalWorldTime();
+    }
+
+    public void uploadChannels(ItemStack trigger) {}
+
+    public boolean markHintParticleError(EntityPlayer player, World w, int x, int y, int z) {
+        if (player instanceof EntityPlayerMP) { // just in case
+            StructureLib.net.sendTo(new ErrorHintParticleMessage(x, (short) y, z), (EntityPlayerMP) player);
+            return true;
+        } else {
+            return false;
+        }
+    }
+
+    public void loadComplete(FMLLoadCompleteEvent e) {
+        ConfigurationHandler.INSTANCE.loadRegistryOrder();
+    }
+
+    private final Map<EntityPlayerMP, Map<Object, Long>> throttleMap = new WeakHashMap<>();
+
+    public void addThrottledChat(Object throttleKey, EntityPlayer player, IChatComponent text, short intervalRequired,
+            boolean forceUpdateLastSend) {
+        if (player instanceof EntityPlayerMP) {
+            Map<Object, Long> submap = throttleMap.computeIfAbsent((EntityPlayerMP) player, p -> new HashMap<>());
+            addThrottledChat(throttleKey, player, text, intervalRequired, forceUpdateLastSend, submap);
+        }
+    }
+
+    protected static void addThrottledChat(Object throttleKey, EntityPlayer player, IChatComponent text,
+            short intervalRequired, boolean forceUpdateLastSend, Map<Object, Long> submap) {
+        long now = System.currentTimeMillis();
+        Long old;
+        if (forceUpdateLastSend) {
+            old = submap.put(throttleKey, now);
+        } else {
+            old = submap.get(throttleKey);
+        }
+        if (old == null || now - old >= intervalRequired) {
+            player.addChatComponentMessage(text);
+            if (!forceUpdateLastSend) submap.put(throttleKey, now);
+        }
+    }
+
+    public void displayConfigGUI(String category) {}
+
+    public static class ForgeEventHandler {
+
+        private int ticksSinceLastPurge;
+
+        @SubscribeEvent
+        public void onServerTickEnd(TickEvent.ServerTickEvent e) {
+            if (e.phase != TickEvent.Phase.END) return;
+            if (++ticksSinceLastPurge < 20 * 60 * 10) return;
+            ticksSinceLastPurge = 0;
+            MinecraftServer server = MinecraftServer.getServer();
+            // it's hard to tell why server could be null in a server tick handler, but who knows?
+            if (server == null) return;
+            SortedRegistry.cleanup(server);
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/ConfigurationHandler.java

@@ -1,21 +1,42 @@
 package com.gtnewhorizon.structurelib;
 
-import cpw.mods.fml.client.event.ConfigChangedEvent;
-import cpw.mods.fml.common.FMLCommonHandler;
-import cpw.mods.fml.common.eventhandler.SubscribeEvent;
+import java.io.File;
+import java.lang.ref.WeakReference;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
 import net.minecraftforge.common.config.ConfigCategory;
 import net.minecraftforge.common.config.Configuration;
 import net.minecraftforge.common.config.Property;
 
-import java.io.File;
-import java.util.Map;
+import org.apache.commons.lang3.tuple.Pair;
+
+import com.google.common.collect.Iterables;
+import com.google.common.collect.Lists;
+import com.gtnewhorizon.structurelib.structure.FluidAutoplace;
+
+import cpw.mods.fml.client.event.ConfigChangedEvent;
+import cpw.mods.fml.common.FMLCommonHandler;
+import cpw.mods.fml.common.eventhandler.SubscribeEvent;
+import cpw.mods.fml.relauncher.FMLLaunchHandler;
 
 public enum ConfigurationHandler {
+
     INSTANCE;
 
     private Configuration config;
     private int maxCoexistingHologram;
     private boolean removeCollidingHologram;
+    private int hintLifespan;
+    private int hintTransparency;
+    private int autoPlaceBudget;
+    private int autoPlaceInterval;
+    private boolean fluidAutoplace = true;
+    private FluidAutoplace.GateMode fluidGateMode = FluidAutoplace.GateMode.STRICT;
+    private Map<String, Pair<List<String>, List<String>>> registryOrders;
 
     ConfigurationHandler() {
         FMLCommonHandler.instance().bus().register(this);
@@ -39,11 +60,115 @@ public enum ConfigurationHandler {
     }
 
     private void loadConfig() {
-        maxCoexistingHologram = config.getInt("maxCoexisting", "client.hologram", 1, 1, 100, "An attempt will be made to prune old holograms when a new hologram is about to be projected");
-        removeCollidingHologram = config.getBoolean("removeColliding", "client.hologram", true, "An attempt will be made to remove an existing hologram if it collides with a new hologram.");
+        maxCoexistingHologram = config.getInt(
+                "maxCoexisting",
+                "client.hologram",
+                1,
+                1,
+                100,
+                "An attempt will be made to prune old holograms when a new hologram is about to be projected");
+        removeCollidingHologram = config.getBoolean(
+                "removeColliding",
+                "client.hologram",
+                true,
+                "An attempt will be made to remove an existing hologram if it collides with a new hologram.");
+        hintLifespan = config
+                .getInt("hintLifespan", "client.hologram", 400, 1, 20000, "Ticks before a hologram disappears.");
+        hintTransparency = config.getInt(
+                "hintTransparency",
+                "client.hologram",
+                192,
+                1,
+                255,
+                "Alpha value of hologram particles. Higher the value, the more \"ghostly\" the hologram will appear to be.");
+        autoPlaceBudget = config.getInt(
+                "autoPlaceBudget",
+                "common.hologram",
+                25,
+                1,
+                200,
+                "Max number of elements can be placed in one round of auto place.\n"
+                        + "As expected, server side settings will overrides client settings.\n"
+                        + "Certain larger multi might increase these values beyond this configured value.");
+        autoPlaceInterval = config.getInt(
+                "autoPlaceInterval",
+                "common.hologram",
+                300,
+                0,
+                20000,
+                "Unit: millisecond. Minimal interval between two auto place round.\n"
+                        + "As expected, server side settings will overrides client settings.\n"
+                        + "Note this relates to the wall clock, not in game ticks.\n"
+                        + "Value smaller than default is likely to be perceived as no minimal interval whatsoever.");
+        fluidAutoplace = config.getBoolean(
+                "fluidAutoplace",
+                "common.autoplace",
+                true,
+                "Whether survival autoplace may place fluid blocks, e.g. the water a multiblock needs inside itself, by draining fluid from the player's fluid containers.\n"
+                        + "A multiblock can also provide its own fluid source, see IFluidSource.\n"
+                        + "This only disables fluid blocks. Multiblocks keep working, they just cannot have those positions filled by autoplace.");
+        fluidGateMode = readFluidGateMode();
 
+        loadRegistryOrder();
+
+        saveConfig();
+    }
+
+    private FluidAutoplace.GateMode readFluidGateMode() {
+        String value = config.getString(
+                "fluidGateMode",
+                "common.autoplace",
+                FluidAutoplace.GateMode.STRICT.name(),
+                "How careful autoplace is about placing a fluid into a structure that is not finished yet, as a fluid would flow out of it.\n"
+                        + "NONE: place the fluid right away.\n"
+                        + "LENIENT: only place the fluid when it cannot flow out of the structure.\n"
+                        + "STRICT: only place the fluid once every non fluid element of the structure is satisfied. Note that this makes a fluid at worst one auto place round late.");
+        for (FluidAutoplace.GateMode mode : FluidAutoplace.GateMode.values()) {
+            if (mode.name().equalsIgnoreCase(value)) return mode;
+        }
+        StructureLib.LOGGER.warn("Unknown fluidGateMode '{}', falling back to STRICT", value);
+        return FluidAutoplace.GateMode.STRICT;
+    }
+
+    void loadRegistryOrder() {
+        loadRegistryOrderImpl();
+        setLanguageKeys();
+        saveConfig();
+    }
+
+    private void loadRegistryOrderImpl() {
+        registryOrders = new HashMap<>();
+        for (Map.Entry<String, WeakReference<SortedRegistry<?>>> e : SortedRegistry.ALL_REGISTRIES.entrySet()) {
+            SortedRegistry<?> r = e.getValue().get();
+            if (r == null) continue;
+            String category = "registries." + e.getKey();
+            if (FMLLaunchHandler.side().isClient()) {
+                // only meaningful on client, and would crash on server
+                config.setCategoryConfigEntryClass(category, RegistryOrderEntry.class);
+            }
+            Property pOrder = config.get(
+                    category,
+                    "ordering",
+                    Iterables.toArray(r.getCurrentOrdering(), String.class),
+                    "stuff not in this list will be automatically available after all entries listed here in their natural order, unless explicitly disabled in disabled config below.");
+            Property pDisable = config.get(category, "disabled", new String[0], "stuff in this list will be disabled");
+            List<String> all = Lists.newArrayList(r.getCurrentOrdering());
+            List<String> curVal = new ArrayList<>(Arrays.asList(pOrder.getStringList()));
+            List<String> disabled = new ArrayList<>(Arrays.asList(pDisable.getStringList()));
+            curVal.removeAll(disabled);
+            all.removeAll(disabled);
+            curVal.removeIf(s -> !all.remove(s));
+            curVal.addAll(all);
+            pOrder.set(curVal.toArray(new String[0]));
+            registryOrders.put(e.getKey(), Pair.of(curVal, disabled));
+        }
+        saveConfig();
+    }
+
+    private void saveConfig() {
         if (config.hasChanged()) {
             config.save();
+            config.load();
         }
     }
 
@@ -62,7 +187,42 @@ public enum ConfigurationHandler {
         return removeCollidingHologram;
     }
 
+    public int getHintLifespan() {
+        return hintLifespan;
+    }
+
+    public int getHintTransparency() {
+        return hintTransparency;
+    }
+
+    public int getAutoPlaceBudget() {
+        return autoPlaceBudget;
+    }
+
+    public int getAutoPlaceInterval() {
+        return autoPlaceInterval;
+    }
+
+    /**
+     * Whether survival autoplace may place fluid blocks by draining fluid from a fluid source.
+     */
+    public boolean isFluidAutoplaceEnabled() {
+        return fluidAutoplace;
+    }
+
+    /**
+     * How careful autoplace is about placing a fluid into a structure that is not finished yet.
+     */
+    public FluidAutoplace.GateMode getFluidGateMode() {
+        return fluidGateMode;
+    }
+
+    public Pair<List<String>, List<String>> getRegistryOrder(String name) {
+        return registryOrders.get(name);
+    }
+
     Configuration getConfig() {
         return config;
     }
+
 }

src/main/java/com/gtnewhorizon/structurelib/ConfigurationVersion.java

@@ -1,16 +1,18 @@
 package com.gtnewhorizon.structurelib;
 
-import net.minecraftforge.common.config.Configuration;
-
-import javax.annotation.Nullable;
 import java.util.Arrays;
 import java.util.Objects;
 
+import javax.annotation.Nullable;
+
+import net.minecraftforge.common.config.Configuration;
+
 enum ConfigurationVersion {
+
     V1 {
+
         @Override
-        protected void step(Configuration c) {
-        }
+        protected void step(Configuration c) {}
     };
 
     private static final ConfigurationVersion[] VALUES = values();
@@ -32,7 +34,8 @@ enum ConfigurationVersion {
     }
 
     public static ConfigurationVersion identify(Configuration c) {
-        return Arrays.stream(VALUES).filter(v -> Objects.equals(c.getLoadedConfigVersion(), v.getVersionMarker())).findFirst().orElse(V1);
+        return Arrays.stream(VALUES).filter(v -> Objects.equals(c.getLoadedConfigVersion(), v.getVersionMarker()))
+                .findFirst().orElse(V1);
     }
 
     @Nullable

src/main/java/com/gtnewhorizon/structurelib/DevelopHelper.java

@@ -0,0 +1,48 @@
+package com.gtnewhorizon.structurelib;
+
+import net.minecraft.init.Blocks;
+import net.minecraft.item.ItemStack;
+import net.minecraft.nbt.NBTTagCompound;
+import net.minecraft.nbt.NBTTagList;
+
+import cpw.mods.fml.common.event.FMLInterModComms;
+
+public class DevelopHelper {
+
+    private static final boolean DEBUG = Boolean.getBoolean("structurelib.develop_helper");
+
+    public static void onPreInit() {
+        if (!DEBUG) return;
+        StructureLib.LOGGER.info("Running develop helper");
+        StructureLibAPI.registerChannelDescription("sandstone", StructureLibAPI.MOD_ID, "variants of Sandstone");
+        StructureLibAPI.registerChannelItem("sandstone", StructureLibAPI.MOD_ID, 1, new ItemStack(Blocks.sandstone));
+        StructureLibAPI
+                .registerChannelItem("sandstone", StructureLibAPI.MOD_ID, 2, new ItemStack(Blocks.sandstone, 1, 1));
+        StructureLibAPI
+                .registerChannelItem("sandstone", StructureLibAPI.MOD_ID, 3, new ItemStack(Blocks.sandstone, 1, 2));
+        StructureLibAPI.registerChannelDescription("sandbricks", StructureLibAPI.MOD_ID, "variants of Sandbricks");
+        StructureLibAPI.registerChannelDescription("apple", StructureLibAPI.MOD_ID, "apple");
+        StructureLibAPI.registerChannelDescription("bright", StructureLibAPI.MOD_ID, "bright");
+        StructureLibAPI.registerChannelDescription("apple_blight", StructureLibAPI.MOD_ID, "apple_blight");
+        StructureLibAPI.registerChannelDescription("app_eagle", StructureLibAPI.MOD_ID, "app_eagle");
+    }
+
+    public void x() {
+        NBTTagCompound command = new NBTTagCompound();
+        NBTTagList items = new NBTTagList();
+        int[] metas = { 0, 1, 2 };
+        for (int meta : metas) {
+            NBTTagCompound tag = new NBTTagCompound();
+            tag.setTag("Item", new ItemStack(Blocks.sandstone, 1, meta).writeToNBT(new NBTTagCompound()));
+            NBTTagList channels = new NBTTagList();
+            NBTTagCompound channel = new NBTTagCompound();
+            channel.setString("Channel", "sandstone");
+            channel.setInteger("Value", meta + 1);
+            channels.appendTag(channel);
+            tag.setTag("Channels", channels);
+            items.appendTag(tag);
+        }
+        command.setTag("Items", items);
+        FMLInterModComms.sendMessage("structurelib", "register_channel_item", command);
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/GuiEditRegistryConfig.java

@@ -0,0 +1,695 @@
+/*
+ * Forge Mod Loader Copyright (c) 2012-2014 cpw. All rights reserved. This program and the accompanying materials are
+ * made available under the terms of the GNU Lesser Public License v2.1 which accompanies this distribution, and is
+ * available at http://www.gnu.org/licenses/old-licenses/gpl-2.0.html Contributors (this class): bspkrs - implementation
+ */
+
+package com.gtnewhorizon.structurelib;
+
+import static cpw.mods.fml.client.config.GuiUtils.RESET_CHAR;
+import static cpw.mods.fml.client.config.GuiUtils.UNDO_CHAR;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.WeakHashMap;
+
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.gui.FontRenderer;
+import net.minecraft.client.gui.GuiButton;
+import net.minecraft.client.gui.GuiListExtended;
+import net.minecraft.client.gui.GuiScreen;
+import net.minecraft.client.gui.ScaledResolution;
+import net.minecraft.client.renderer.OpenGlHelper;
+import net.minecraft.client.renderer.Tessellator;
+import net.minecraft.client.resources.I18n;
+import net.minecraft.util.EnumChatFormatting;
+import net.minecraft.util.MathHelper;
+import net.minecraft.util.ResourceLocation;
+
+import org.lwjgl.input.Keyboard;
+import org.lwjgl.opengl.GL11;
+
+import cpw.mods.fml.client.config.GuiButtonExt;
+import cpw.mods.fml.client.config.GuiConfig;
+import cpw.mods.fml.client.config.GuiUnicodeGlyphButton;
+import cpw.mods.fml.client.config.GuiUtils;
+import cpw.mods.fml.client.config.HoverChecker;
+import cpw.mods.fml.client.config.IConfigElement;
+import cpw.mods.fml.client.event.ConfigChangedEvent;
+import cpw.mods.fml.client.event.ConfigChangedEvent.OnConfigChangedEvent;
+import cpw.mods.fml.client.event.ConfigChangedEvent.PostConfigChangedEvent;
+import cpw.mods.fml.common.FMLCommonHandler;
+import cpw.mods.fml.common.Loader;
+import cpw.mods.fml.common.eventhandler.Event.Result;
+
+/**
+ * This class is the base GuiScreen for all config GUI screens. It can be extended by mods to provide the top-level
+ * config screen that will be called when the Config button is clicked from the Main Menu Mods list.
+ *
+ * @author bspkrs
+ */
+public class GuiEditRegistryConfig extends GuiScreen {
+
+    public static final String OMITTED = "..";
+    public static final int LIST_WINDOW_PADDING = 20;
+    public static final int MID_SECTION_WIDTH = 10;
+    /**
+     * A reference to the screen object that created this. Used for navigating between screens.
+     */
+    public final GuiScreen parentScreen;
+    private final IConfigElement<String> disabledElement;
+    private final String[] beforeDisabledValue;
+    private final IConfigElement<String> orderElement;
+    private final String[] beforeOrderValue;
+    final Collection<EntriesList> lists;
+    private final String registryName;
+    EntriesList disabledEntries;
+    EntriesList orderEntries;
+    public String title = "Config GUI";
+    public String titleLine2;
+    private GuiButtonExt btnDefault;
+    private GuiButtonExt btnUndoAll;
+    public final String modID;
+    /**
+     * When set to a non-null value the OnConfigChanged and PostConfigChanged events will be posted when the Done button
+     * is pressed if any configElements were changed (includes child screens). If not defined, the events will be posted
+     * if the parent gui is null or if the parent gui is not an instance of GuiConfig.
+     */
+    public final String configID;
+    public final boolean isWorldRunning;
+    public final boolean allRequireWorldRestart;
+    public final boolean allRequireMcRestart;
+    public boolean needsRefresh = true;
+    private HoverChecker undoHoverChecker;
+    private HoverChecker resetHoverChecker;
+
+    @SuppressWarnings({ "rawtypes", "unchecked" })
+    public GuiEditRegistryConfig(GuiScreen parentScreen, IConfigElement disabled, IConfigElement order,
+            String registryName, String modID, String configID, boolean allRequireWorldRestart,
+            boolean allRequireMcRestart, String title, String titleLine2) {
+        this.mc = parentScreen.mc;
+        this.lists = Collections.newSetFromMap(new WeakHashMap<>());
+        this.disabledElement = disabled;
+        this.beforeDisabledValue = (String[]) this.disabledElement.getList();
+        this.orderElement = order;
+        this.beforeOrderValue = (String[]) this.orderElement.getList();
+        this.parentScreen = parentScreen;
+        this.allRequireWorldRestart = allRequireWorldRestart;
+        this.allRequireMcRestart = allRequireMcRestart;
+        this.registryName = registryName;
+        this.modID = modID;
+        this.configID = configID;
+        this.isWorldRunning = mc.theWorld != null;
+        if (title != null) this.title = title;
+        this.titleLine2 = titleLine2;
+        if (this.titleLine2 != null && this.titleLine2.startsWith(" > "))
+            this.titleLine2 = this.titleLine2.replaceFirst(" > ", "");
+    }
+
+    /**
+     * Adds the buttons (and other controls) to the screen in question.
+     */
+    @Override
+    public void initGui() {
+        Keyboard.enableRepeatEvents(true);
+        if (this.disabledEntries == null || this.needsRefresh) {
+            this.disabledEntries = new EntriesList(
+                    (width - MID_SECTION_WIDTH) / 2 - LIST_WINDOW_PADDING,
+                    LIST_WINDOW_PADDING,
+                    I18n.format("structurelib.configgui.disabled"));
+            this.disabledEntries.initEntries(Arrays.asList(disabledElement.getList()));
+        } else {
+            this.disabledEntries.reinit((width - MID_SECTION_WIDTH) / 2 - LIST_WINDOW_PADDING, LIST_WINDOW_PADDING);
+        }
+        if (this.orderEntries == null || this.needsRefresh) {
+            this.orderEntries = new EntriesList(
+                    (width - MID_SECTION_WIDTH) / 2 - LIST_WINDOW_PADDING,
+                    (width + MID_SECTION_WIDTH) / 2,
+                    I18n.format("structurelib.configgui.enabled"));
+            this.orderEntries.initEntries(Arrays.asList(orderElement.getList()));
+        } else {
+            this.orderEntries
+                    .reinit((width - MID_SECTION_WIDTH) / 2 - LIST_WINDOW_PADDING, (width + MID_SECTION_WIDTH) / 2);
+        }
+        this.needsRefresh = false;
+
+        int undoGlyphWidth = mc.fontRenderer.getStringWidth(UNDO_CHAR) * 2;
+        int resetGlyphWidth = mc.fontRenderer.getStringWidth(RESET_CHAR) * 2;
+        int doneWidth = Math.max(mc.fontRenderer.getStringWidth(I18n.format("gui.done")) + 20, 100);
+        int undoWidth = mc.fontRenderer.getStringWidth(" " + I18n.format("fml.configgui.tooltip.undoChanges"))
+                + undoGlyphWidth
+                + 20;
+        int resetWidth = mc.fontRenderer.getStringWidth(" " + I18n.format("fml.configgui.tooltip.resetToDefault"))
+                + resetGlyphWidth
+                + 20;
+        int buttonWidthHalf = (doneWidth + 5 + undoWidth + 5 + resetWidth + 5) / 2;
+        this.buttonList.add(
+                new GuiButtonExt(
+                        2000,
+                        this.width / 2 - buttonWidthHalf,
+                        this.height - 29,
+                        doneWidth,
+                        20,
+                        I18n.format("gui.done")));
+        this.buttonList.add(
+                this.btnDefault = new GuiUnicodeGlyphButton(
+                        2001,
+                        this.width / 2 - buttonWidthHalf + doneWidth + 5 + undoWidth + 5,
+                        this.height - 29,
+                        resetWidth,
+                        20,
+                        " " + I18n.format("fml.configgui.tooltip.resetToDefault"),
+                        RESET_CHAR,
+                        2.0F));
+        this.buttonList.add(
+                btnUndoAll = new GuiUnicodeGlyphButton(
+                        2002,
+                        this.width / 2 - buttonWidthHalf + doneWidth + 5,
+                        this.height - 29,
+                        undoWidth,
+                        20,
+                        " " + I18n.format("fml.configgui.tooltip.undoChanges"),
+                        UNDO_CHAR,
+                        2.0F));
+
+        this.undoHoverChecker = new HoverChecker(this.btnUndoAll, 800);
+        this.resetHoverChecker = new HoverChecker(this.btnDefault, 800);
+    }
+
+    /**
+     * Called when the screen is unloaded. Used to disable keyboard repeat events
+     */
+    @Override
+    public void onGuiClosed() {
+        if (this.configID != null && this.parentScreen instanceof GuiConfig parentGuiConfig) {
+            parentGuiConfig.needsRefresh = true;
+            parentGuiConfig.initGui();
+        }
+
+        if (!(this.parentScreen instanceof GuiConfig)) Keyboard.enableRepeatEvents(false);
+    }
+
+    public boolean saveConfigElements() {
+        if (isChanged()) {
+            disabledElement.set(disabledEntries.entries.stream().map(e -> e.name).toArray(String[]::new));
+            orderElement.set(orderEntries.entries.stream().map(e -> e.name).toArray(String[]::new));
+        }
+        return false;
+    }
+
+    @Override
+    protected void actionPerformed(GuiButton button) {
+        if (button.id == 2000) {
+            try {
+                if ((configID != null || this.parentScreen == null || !(this.parentScreen instanceof GuiConfig))
+                        && isChanged()) {
+                    saveConfigElements();
+                    if (Loader.isModLoaded(modID)) {
+                        ConfigChangedEvent event = new OnConfigChangedEvent(modID, configID, isWorldRunning, false);
+                        FMLCommonHandler.instance().bus().post(event);
+                        if (!event.getResult().equals(Result.DENY)) FMLCommonHandler.instance().bus()
+                                .post(new PostConfigChangedEvent(modID, configID, isWorldRunning, false));
+
+                        if (this.parentScreen instanceof GuiConfig) ((GuiConfig) this.parentScreen).needsRefresh = true;
+                    }
+                }
+            } catch (Throwable e) {
+                e.printStackTrace();
+            }
+
+            this.mc.displayGuiScreen(this.parentScreen);
+        } else if (button.id == 2001) {
+            setToDefault();
+        } else if (button.id == 2002) {
+            undoChanges();
+        }
+    }
+
+    public boolean isInitialized() {
+        return disabledEntries != null && orderEntries != null;
+    }
+
+    public void undoChanges() {
+        disabledEntries.initEntries(Arrays.asList(beforeDisabledValue));
+        orderEntries.initEntries(Arrays.asList(beforeOrderValue));
+    }
+
+    public void setToDefault() {
+        disabledEntries.initEntries(Arrays.asList(disabledElement.getList()));
+        orderEntries.initEntries(Arrays.asList(orderElement.getList()));
+    }
+
+    public boolean isDefault() {
+        return !orderEntries.areContentEqual(orderElement.getDefaults())
+                || !disabledEntries.areContentEqual(disabledElement.getDefaults());
+    }
+
+    public boolean isChanged() {
+        return !orderEntries.areContentEqual(beforeOrderValue) || !disabledEntries.areContentEqual(beforeDisabledValue);
+    }
+
+    /**
+     * Called when the mouse is clicked.
+     */
+    @Override
+    protected void mouseClicked(int x, int y, int mouseEvent) {
+        if (mouseEvent != 0 || !this.disabledEntries.func_148179_a(x, y, mouseEvent)
+                && !this.orderEntries.func_148179_a(x, y, mouseEvent)) {
+            super.mouseClicked(x, y, mouseEvent);
+        }
+    }
+
+    /**
+     * Called when the mouse is moved or a mouse button is released. Signature: (mouseX, mouseY, which) which==-1 is
+     * mouseMove, which==0 or which==1 is mouseUp
+     */
+    @Override
+    protected void mouseMovedOrUp(int x, int y, int mouseEvent) {
+        if (mouseEvent != 0 || !this.disabledEntries.func_148181_b(x, y, mouseEvent)
+                && !this.orderEntries.func_148181_b(x, y, mouseEvent)) {
+            super.mouseMovedOrUp(x, y, mouseEvent);
+        }
+    }
+
+    /**
+     * Fired when a key is typed. This is the equivalent of KeyListener.keyTyped(KeyEvent e).
+     */
+    @Override
+    protected void keyTyped(char eventChar, int eventKey) {
+        if (eventKey == Keyboard.KEY_ESCAPE) this.mc.displayGuiScreen(parentScreen);
+    }
+
+    String trimStringToWidth(String str, int width) {
+        int strwidth = mc.fontRenderer.getStringWidth(str);
+        int elipsisWidth = mc.fontRenderer.getStringWidth(OMITTED);
+        if (strwidth > width - elipsisWidth && elipsisWidth > strwidth) {
+            return mc.fontRenderer.trimStringToWidth(str, width - elipsisWidth).trim() + OMITTED;
+        }
+        return str;
+    }
+
+    /**
+     * Draws the screen and all the components in it.
+     */
+    @Override
+    public void drawScreen(int mouseX, int mouseY, float partialTicks) {
+        for (EntriesList list : lists) {
+            list.handleDrag(mouseX, mouseY, partialTicks);
+        }
+        this.drawDefaultBackground();
+        for (EntriesList list : lists) {
+            list.drawScreen(mouseX, mouseY, partialTicks);
+        }
+        this.drawCenteredString(this.fontRendererObj, this.title, this.width / 2, 8, 16777215);
+        String title2 = this.titleLine2;
+
+        if (title2 != null) {
+            title2 = trimStringToWidth(title2, width - 6);
+            this.drawCenteredString(this.fontRendererObj, title2, this.width / 2, 18, 16777215);
+        }
+
+        this.btnUndoAll.enabled = isChanged();
+        this.btnDefault.enabled = isDefault();
+        super.drawScreen(mouseX, mouseY, partialTicks);
+        for (EntriesList list : lists) {
+            list.drawScreenPost(mouseX, mouseY, partialTicks);
+        }
+        if (this.undoHoverChecker.checkHover(mouseX, mouseY)) this.func_146283_a(
+                this.mc.fontRenderer.listFormattedStringToWidth(I18n.format("fml.configgui.tooltip.undoAll"), 300),
+                mouseX,
+                mouseY);
+        if (this.resetHoverChecker.checkHover(mouseX, mouseY)) this.func_146283_a(
+                this.mc.fontRenderer.listFormattedStringToWidth(I18n.format("fml.configgui.tooltip.resetAll"), 300),
+                mouseX,
+                mouseY);
+    }
+
+    private class EntriesList extends GuiListExtended {
+
+        final String heading;
+        final List<ListEntry> entries = new ArrayList<>();
+        int controlX;
+
+        public EntriesList(int width, int left, String heading) {
+            super(
+                    mc,
+                    width,
+                    GuiEditRegistryConfig.this.height,
+                    titleLine2 != null ? 33 : 23,
+                    GuiEditRegistryConfig.this.height - 32,
+                    20);
+            this.heading = heading;
+            if (heading != null) {
+                setHasListHeader(true, mc.fontRenderer.FONT_HEIGHT + 4);
+            }
+            setSlotXBoundsFromLeft(left);
+            this.controlX = this.getScrollBarX() - 20;
+            lists.add(this);
+        }
+
+        @Override
+        public void drawScreen(int p_148128_1_, int p_148128_2_, float p_148128_3_) {
+            GL11.glEnable(GL11.GL_SCISSOR_TEST);
+            ScaledResolution scaledresolution = new ScaledResolution(mc, mc.displayWidth, mc.displayHeight);
+            GL11.glScissor(
+                    (left - 4) * scaledresolution.getScaleFactor(),
+                    (int) ((scaledresolution.getScaledHeight_double() - (bottom + 4))
+                            * scaledresolution.getScaleFactor()),
+                    (width + 8) * scaledresolution.getScaleFactor(),
+                    (height + 8) * scaledresolution.getScaleFactor());
+            super.drawScreen(p_148128_1_, p_148128_2_, p_148128_3_);
+            GL11.glDisable(GL11.GL_SCISSOR_TEST);
+        }
+
+        @Override
+        public void overlayBackground(int p_148136_1_, int p_148136_2_, int p_148136_3_, int p_148136_4_) {}
+
+        @Override
+        protected void drawContainerBackground(Tessellator tessellator) {
+            GL11.glEnable(GL11.GL_BLEND);
+            OpenGlHelper.glBlendFunc(GL11.GL_SRC_ALPHA, GL11.GL_ONE_MINUS_SRC_ALPHA, 0, 1);
+            GL11.glDisable(GL11.GL_ALPHA_TEST);
+            GL11.glShadeModel(GL11.GL_SMOOTH);
+            GL11.glDisable(GL11.GL_TEXTURE_2D);
+            tessellator.startDrawingQuads();
+            tessellator.setColorRGBA_I(0, 64);
+            tessellator.addVertex(left, bottom, 0);
+            tessellator.addVertex(right, bottom, 0);
+            tessellator.addVertex(right, top, 0);
+            tessellator.addVertex(left, top, 0);
+            tessellator.draw();
+            GL11.glEnable(GL11.GL_TEXTURE_2D);
+            GL11.glShadeModel(GL11.GL_FLAT);
+            GL11.glEnable(GL11.GL_ALPHA_TEST);
+            GL11.glDisable(GL11.GL_BLEND);
+        }
+
+        @Override
+        protected void drawListHeader(int p_148129_1_, int p_148129_2_, Tessellator p_148129_3_) {
+            if (heading == null) {
+                return;
+            }
+            FontRenderer fr = mc.fontRenderer;
+            fr.drawString(
+                    this.heading,
+                    p_148129_1_ + this.width / 2 - fr.getStringWidth(this.heading) / 2,
+                    Math.min(this.top + 3, p_148129_2_),
+                    0xffffff);
+        }
+
+        void reinit(int width, int left) {
+            this.width = width;
+            this.bottom = GuiEditRegistryConfig.this.height - 32;
+            this.setSlotXBoundsFromLeft(left);
+            this.controlX = this.getScrollBarX() - 20;
+        }
+
+        void initEntries(Iterable<?> entries) {
+            this.controlX = this.getScrollBarX() - 20;
+            this.entries.clear();
+            for (Object entry : entries) {
+                addEntry(new ListEntry(entry.toString()));
+            }
+        }
+
+        void addEntry(ListEntry entry) {
+            entry.entriesList = this;
+            this.entries.add(entry);
+            this.controlX = Math.min(this.controlX, this.getScrollBarX() - entry.getControlSetWidth() - 2);
+        }
+
+        @Override
+        public IGuiListEntry getListEntry(int i) {
+            return entries.get(i);
+        }
+
+        @Override
+        protected int getSize() {
+            return entries.size();
+        }
+
+        int getLabelX() {
+            return left + 2;
+        }
+
+        int getControlX() {
+            return controlX;
+        }
+
+        @Override
+        public int getListWidth() {
+            return width;
+        }
+
+        @Override
+        protected int getScrollBarX() {
+            return left + getListWidth() - 6;
+        }
+
+        public void handleDrag(int mouseX, int mouseY, float partialTicks) {
+            for (int i = 0, entriesSize = entries.size(); i < entriesSize; i++) {
+                ListEntry entry = entries.get(i);
+                if (entry.handleDrag(i, mouseX, mouseY, partialTicks)) {
+                    return;
+                }
+            }
+        }
+
+        public void drawScreenPost(int mouseX, int mouseY, float partialTicks) {
+            for (ListEntry entry : entries) {
+                entry.drawToolTip(mouseX, mouseY);
+            }
+        }
+
+        public boolean areContentEqual(Object[] vals) {
+            if (vals.length != entries.size()) return false;
+            for (int i = 0; i < entries.size(); i++) {
+                ListEntry entry = entries.get(i);
+                if (!entry.name.equals(vals[i])) return false;
+            }
+            return true;
+        }
+    }
+
+    class ListEntry implements GuiListExtended.IGuiListEntry {
+
+        private EntriesList entriesList;
+        private final HoverChecker hoverCheckerText = new HoverChecker(0, 0, 0, 0, 0);
+        final String name;
+        final String localizedName;
+        private final String tooltip;
+        public boolean modified = false;
+
+        private final GuiButtonExt btnDrag = new GuiButtonDrag(1, 0, 0, 20, 20);
+        private final HoverChecker hoverCheckerBtnDrag = new HoverChecker(btnDrag, 800);
+        private boolean isDragging = false;
+        private long lastScroll = 0;
+
+        ListEntry(String name) {
+            this.name = name;
+            String nameKey = "structurelib.sortedregistry." + registryName + "." + name;
+            this.localizedName = trans(nameKey, name);
+
+            String tooltipKey = nameKey + ".tooltip";
+            String tooltip = trans(tooltipKey, null);
+            StringBuilder tooltipBuilder = new StringBuilder();
+            tooltipBuilder.append(EnumChatFormatting.GREEN);
+            tooltipBuilder.append(this.localizedName);
+            if (tooltip != null) {
+                tooltipBuilder.append('\n').append(EnumChatFormatting.YELLOW).append(tooltip);
+            }
+            tooltipBuilder.append('\n');
+            tooltipBuilder.append(EnumChatFormatting.DARK_GRAY);
+            tooltipBuilder.append(this.name);
+            this.tooltip = tooltipBuilder.toString();
+        }
+
+        @Override
+        public void drawEntry(int slotIndex, int x, int y, int listWidth, int slotHeight, Tessellator tessellator,
+                int mouseX, int mouseY, boolean isSelected) {
+            drawOutlineBox(x, y, listWidth, slotHeight, tessellator);
+            drawLabel(y, slotHeight);
+            drawControlSet(y, slotHeight, mouseX, mouseY);
+        }
+
+        private void drawOutlineBox(int x, int y, int listWidth, int slotHeight, Tessellator tessellator) {
+            if (isDragging) {
+                // left x, right x, top y, bottom y
+                int lx = x, rx = entriesList.getScrollBarX() - 4, ty = y, by = y + slotHeight;
+                GL11.glColor4f(1.0F, 1.0F, 1.0F, 1.0F);
+                GL11.glDisable(GL11.GL_TEXTURE_2D);
+                tessellator.startDrawingQuads();
+                tessellator.setColorOpaque_I(0x808080);
+                tessellator.addVertexWithUV(lx - 4, by + 4, 0.0D, 0.0D, 1.0D);
+                tessellator.addVertexWithUV(rx + 4, by + 4, 0.0D, 1.0D, 1.0D);
+                tessellator.addVertexWithUV(rx + 4, ty - 4, 0.0D, 1.0D, 0.0D);
+                tessellator.addVertexWithUV(lx - 4, ty - 4, 0.0D, 0.0D, 0.0D);
+                tessellator.setColorOpaque_I(0x202020);
+                tessellator.addVertexWithUV(lx - 2, by + 2, 0.0D, 0.0D, 1.0D);
+                tessellator.addVertexWithUV(rx + 2, by + 2, 0.0D, 1.0D, 1.0D);
+                tessellator.addVertexWithUV(rx + 2, ty - 2, 0.0D, 1.0D, 0.0D);
+                tessellator.addVertexWithUV(lx - 2, ty - 2, 0.0D, 0.0D, 0.0D);
+                tessellator.draw();
+                GL11.glEnable(GL11.GL_TEXTURE_2D);
+            }
+        }
+
+        private void drawControlSet(int y, int slotHeight, int mouseX, int mouseY) {
+            btnDrag.xPosition = entriesList.getControlX();
+            btnDrag.yPosition = y + (slotHeight - btnDrag.height) / 2;
+            btnDrag.drawButton(mc, mouseX, mouseY);
+        }
+
+        private void drawLabel(int y, int slotHeight) {
+            String label = modified ? EnumChatFormatting.ITALIC + localizedName : localizedName;
+            int allowedWidth = entriesList.getControlX() - entriesList.getLabelX() - 4;
+            // probably not very wise to recompute this every render tick, but it doesn't matter for now
+            String toDraw = trimStringToWidth(label, allowedWidth);
+            hoverCheckerText.updateBounds(
+                    y + slotHeight / 2 - mc.fontRenderer.FONT_HEIGHT / 2,
+                    y + slotHeight / 2 + mc.fontRenderer.FONT_HEIGHT / 2,
+                    entriesList.getLabelX(),
+                    entriesList.getLabelX() + mc.fontRenderer.getStringWidth(toDraw));
+
+            mc.fontRenderer.drawString(
+                    toDraw,
+                    entriesList.getLabelX(),
+                    y + slotHeight / 2 - mc.fontRenderer.FONT_HEIGHT / 2,
+                    getLabelColor());
+        }
+
+        void drawToolTip(int mouseX, int mouseY) {
+            // ensure checkHover() is always called, or the hover threshold might fail under certain corner cases
+            if (hoverCheckerText.checkHover(mouseX, mouseY)) {
+                GuiEditRegistryConfig.this.func_146283_a(
+                        mc.fontRenderer.listFormattedStringToWidth(tooltip, entriesList.getListWidth()),
+                        mouseX,
+                        mouseY);
+            }
+            if (hoverCheckerBtnDrag.checkHover(mouseX, mouseY) && !isDragging) {
+                GuiEditRegistryConfig.this.func_146283_a(
+                        mc.fontRenderer.listFormattedStringToWidth(
+                                I18n.format("structurelib.configgui.drag.tooltip"),
+                                entriesList.getListWidth()),
+                        mouseX,
+                        mouseY);
+            }
+        }
+
+        protected int getLabelColor() {
+            return isDragging ? 0x888888 : 0xffffff;
+        }
+
+        int getControlSetWidth() {
+            return this.btnDrag.getButtonWidth();
+        }
+
+        public boolean handleDrag(int index, int mouseX, int mouseY, float partialTicks) {
+            if (!isDragging) {
+                return false;
+            }
+            for (EntriesList list : lists) {
+                if (list == entriesList) continue;
+                if (mouseX > list.left && mouseX < list.right && mouseY > list.top && mouseY < list.bottom) {
+                    int l;
+                    if (list.entries.isEmpty()) l = 0;
+                    else l = list.func_148124_c(mouseX, mouseY);
+                    if (l < 0) {
+                        if (mouseY < (list.bottom + list.top) / 2) {
+                            l = 0;
+                        } else {
+                            l = list.entries.size();
+                        }
+                    }
+                    entriesList.func_148143_b(true);
+                    entriesList.entries.remove(index);
+                    list.func_148143_b(false);
+                    list.entries.add(l, this);
+                    this.entriesList = list;
+                    return true;
+                }
+            }
+            long now = System.currentTimeMillis();
+            if (now - lastScroll > 20) {
+                if (mouseY < entriesList.top) {
+                    entriesList.scrollBy(-3);
+                    lastScroll = now;
+                } else if (mouseY > entriesList.bottom) {
+                    entriesList.scrollBy(3);
+                    lastScroll = now;
+                }
+            }
+            int l = entriesList.func_148124_c(
+                    MathHelper.clamp_int(mouseX, entriesList.left, entriesList.right),
+                    MathHelper.clamp_int(mouseY, entriesList.top, entriesList.bottom));
+            if (l < 0 || l == index) return true;
+            entriesList.entries.remove(index);
+            entriesList.entries.add(l, this);
+            return true;
+        }
+
+        @Override
+        public void mouseReleased(int index, int x, int y, int mouseEvent, int relativeX, int relativeY) {
+            isDragging = false;
+        }
+
+        @Override
+        public boolean mousePressed(int index, int x, int y, int mouseEvent, int relativeX, int relativeY) {
+            if (btnDrag.mousePressed(mc, x, y)) {
+                isDragging = true;
+                return true;
+            }
+            return false;
+        }
+    }
+
+    private static String trans(String transKey, String fallback) {
+        String translated = I18n.format(transKey);
+        return translated.equals(transKey) ? fallback : translated;
+    }
+
+    private static class GuiButtonDrag extends GuiButtonExt {
+
+        public GuiButtonDrag(int id, int xPos, int yPos, int width, int height) {
+            super(id, xPos, yPos, width, height, null);
+        }
+
+        @Override
+        public void drawButton(Minecraft mc, int mouseX, int mouseY) {
+            if (this.visible) {
+                this.field_146123_n = mouseX >= this.xPosition && mouseY >= this.yPosition
+                        && mouseX < this.xPosition + this.width
+                        && mouseY < this.yPosition + this.height;
+                int k = this.getHoverState(this.field_146123_n);
+                GuiUtils.drawContinuousTexturedBox(
+                        buttonTextures,
+                        this.xPosition,
+                        this.yPosition,
+                        0,
+                        46 + k * 20,
+                        this.width,
+                        this.height,
+                        200,
+                        20,
+                        2,
+                        3,
+                        2,
+                        2,
+                        this.zLevel);
+                mc.renderEngine.bindTexture(new ResourceLocation("structurelib", "textures/gui/fourwayarrow2.png"));
+                int x = this.xPosition + (this.width - 12) / 2;
+                int y = this.yPosition + (this.height - 12) / 2;
+                Tessellator tessellator = Tessellator.instance;
+                tessellator.startDrawingQuads();
+                tessellator.addVertexWithUV(x, y + 12, zLevel, 0, 1);
+                tessellator.addVertexWithUV(x + 12, y + 12, zLevel, 1, 1);
+                tessellator.addVertexWithUV(x + 12, y, zLevel, 1, 0);
+                tessellator.addVertexWithUV(x, y, zLevel, 0, 0);
+                tessellator.draw();
+            }
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/GuiFactory.java

@@ -1,15 +1,16 @@
 package com.gtnewhorizon.structurelib;
 
-import cpw.mods.fml.client.IModGuiFactory;
-import net.minecraft.client.Minecraft;
-import net.minecraft.client.gui.GuiScreen;
-
 import java.util.Set;
 
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.gui.GuiScreen;
+
+import cpw.mods.fml.client.IModGuiFactory;
+
 public class GuiFactory implements IModGuiFactory {
+
     @Override
-    public void initialize(Minecraft minecraftInstance) {
-    }
+    public void initialize(Minecraft minecraftInstance) {}
 
     @Override
     public Class<? extends GuiScreen> mainConfigGuiClass() {
@@ -25,4 +26,4 @@ public class GuiFactory implements IModGuiFactory {
     public RuntimeOptionGuiHandler getHandlerFor(RuntimeOptionCategoryElement element) {
         return null;
     }
-}
+}

src/main/java/com/gtnewhorizon/structurelib/GuiHandler.java

@@ -0,0 +1,32 @@
+package com.gtnewhorizon.structurelib;
+
+import net.minecraft.entity.player.EntityPlayer;
+import net.minecraft.world.World;
+
+import com.gtnewhorizon.structurelib.gui.EmptyContainer;
+import com.gtnewhorizon.structurelib.gui.GuiScreenConfigureChannels;
+
+import cpw.mods.fml.common.network.IGuiHandler;
+
+public class GuiHandler implements IGuiHandler {
+
+    @Override
+    public Object getServerGuiElement(int ID, EntityPlayer player, World world, int x, int y, int z) {
+        switch (ID) {
+            case 0:
+                return new EmptyContainer(player);
+            default:
+                return null;
+        }
+    }
+
+    @Override
+    public Object getClientGuiElement(int ID, EntityPlayer player, World world, int x, int y, int z) {
+        switch (ID) {
+            case 0:
+                return new GuiScreenConfigureChannels(new EmptyContainer(player), player.inventory.getStackInSlot(x));
+            default:
+                return null;
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/GuiModConfig.java

@@ -1,25 +1,31 @@
 package com.gtnewhorizon.structurelib;
 
-import cpw.mods.fml.client.config.GuiConfig;
-import cpw.mods.fml.client.config.IConfigElement;
-import net.minecraft.client.gui.GuiScreen;
-import net.minecraftforge.common.config.ConfigElement;
-import net.minecraftforge.common.config.Configuration;
-
 import java.util.List;
 import java.util.stream.Collectors;
 
+import net.minecraft.client.gui.GuiScreen;
+import net.minecraftforge.common.config.ConfigElement;
+import net.minecraftforge.common.config.Configuration;
+
+import cpw.mods.fml.client.config.GuiConfig;
+import cpw.mods.fml.client.config.IConfigElement;
+
 public class GuiModConfig extends GuiConfig {
+
     public GuiModConfig(GuiScreen guiScreen) {
-        super(guiScreen, getConfigElements(), StructureLibAPI.MOD_ID, false, false, GuiConfig.getAbridgedConfigPath(ConfigurationHandler.INSTANCE.getConfig().toString()));
+        super(
+                guiScreen,
+                getConfigElements(),
+                StructureLibAPI.MOD_ID,
+                false,
+                false,
+                GuiConfig.getAbridgedConfigPath(ConfigurationHandler.INSTANCE.getConfig().toString()));
     }
 
     @SuppressWarnings("rawtypes")
     private static List<IConfigElement> getConfigElements() {
         final Configuration config = ConfigurationHandler.INSTANCE.getConfig();
-        return config.getCategoryNames().stream()
-                .filter(name -> name.indexOf('.') == -1)
-                .map(name -> new ConfigElement(config.getCategory(name)))
-                .collect(Collectors.toList());
+        return config.getCategoryNames().stream().filter(name -> name.indexOf('.') == -1)
+                .map(name -> new ConfigElement(config.getCategory(name))).collect(Collectors.toList());
     }
 }

src/main/java/com/gtnewhorizon/structurelib/IStructureCompat.java

@@ -0,0 +1,8 @@
+package com.gtnewhorizon.structurelib;
+
+import net.minecraft.util.IIcon;
+
+public interface IStructureCompat {
+
+    void markTextureUsed(IIcon o);
+}

src/main/java/com/gtnewhorizon/structurelib/RegistryOrderEntry.java

@@ -0,0 +1,77 @@
+package com.gtnewhorizon.structurelib;
+
+import java.util.List;
+
+import net.minecraft.client.gui.GuiScreen;
+
+import cpw.mods.fml.client.config.GuiConfig;
+import cpw.mods.fml.client.config.GuiConfigEntries;
+import cpw.mods.fml.client.config.IConfigElement;
+
+@SuppressWarnings({ "unchecked" })
+public final class RegistryOrderEntry extends GuiConfigEntries.CategoryEntry {
+
+    public RegistryOrderEntry(GuiConfig owningScreen, GuiConfigEntries owningEntryList,
+            IConfigElement<?> configElement) {
+        super(owningScreen, owningEntryList, configElement);
+    }
+
+    @Override
+    protected GuiScreen buildChildScreen() {
+        List<IConfigElement<?>> childElements = this.configElement.getChildElements();
+        IConfigElement<?> disabled = null, order = null;
+        for (IConfigElement<?> e : childElements) {
+            if (e.getName().equals("disabled")) disabled = e;
+            else if (e.getName().equals("ordering")) order = e;
+        }
+        if (disabled == null || order == null) {
+            throw new IllegalArgumentException("Did not find expected config entires");
+        }
+        return new GuiEditRegistryConfig(
+                this.owningScreen,
+                disabled,
+                order,
+                configElement.getName(),
+                this.owningScreen.modID,
+                null,
+                owningScreen.allRequireWorldRestart || this.configElement.requiresWorldRestart(),
+                owningScreen.allRequireMcRestart || this.configElement.requiresMcRestart(),
+                this.owningScreen.title,
+                ((this.owningScreen.titleLine2 == null ? "" : this.owningScreen.titleLine2) + " > " + this.name));
+    }
+
+    private GuiEditRegistryConfig getChildScreen() {
+        return (GuiEditRegistryConfig) childScreen;
+    }
+
+    @Override
+    public boolean saveConfigElement() {
+        GuiEditRegistryConfig c = getChildScreen();
+        if (c != null && c.isInitialized()) return c.saveConfigElements();
+        return false;
+    }
+
+    @Override
+    public boolean isChanged() {
+        GuiEditRegistryConfig c = getChildScreen();
+        return c != null && c.isInitialized() && c.isChanged();
+    }
+
+    @Override
+    public boolean isDefault() {
+        GuiEditRegistryConfig c = getChildScreen();
+        return c != null && c.isInitialized() && c.isDefault();
+    }
+
+    @Override
+    public void setToDefault() {
+        GuiEditRegistryConfig c = getChildScreen();
+        if (c != null && c.isInitialized()) c.setToDefault();
+    }
+
+    @Override
+    public void undoChanges() {
+        GuiEditRegistryConfig c = getChildScreen();
+        if (c != null && c.isInitialized()) c.undoChanges();
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/SortedRegistry.java

@@ -0,0 +1,197 @@
+package com.gtnewhorizon.structurelib;
+
+import java.lang.ref.WeakReference;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.IdentityHashMap;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Map;
+import java.util.NavigableMap;
+import java.util.Set;
+import java.util.Spliterator;
+import java.util.TreeMap;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.function.Consumer;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+
+import javax.annotation.Nullable;
+
+import net.minecraft.entity.player.EntityPlayerMP;
+import net.minecraft.server.MinecraftServer;
+
+import org.apache.commons.lang3.tuple.Pair;
+
+import com.gtnewhorizon.structurelib.net.RegistryOrderSyncMessage;
+
+import cpw.mods.fml.common.FMLCommonHandler;
+import cpw.mods.fml.common.eventhandler.SubscribeEvent;
+import cpw.mods.fml.common.gameevent.PlayerEvent;
+
+public class SortedRegistry<V> implements Iterable<V> {
+
+    static final ConcurrentHashMap<String, WeakReference<SortedRegistry<?>>> ALL_REGISTRIES = new ConcurrentHashMap<>();
+    static {
+        RegistryOrderSyncMessage.Handler.setAllRegistries(ALL_REGISTRIES);
+    }
+    private final NavigableMap<String, V> store = new TreeMap<>();
+    /**
+     * Store stuff in an array for faster iteration access than a red black tree
+     */
+    private List<V> baked = Collections.emptyList();
+
+    private final Map<UUID, Pair<List<String>, List<String>>> playerOrdering = new HashMap<>();
+    private final Map<UUID, List<V>> playerBaked = new HashMap<>();
+
+    /**
+     * Construct an unsynchronized registry
+     */
+    public SortedRegistry() {}
+
+    /**
+     * Construct a synchronized registry whose ordering will be synced to the server
+     *
+     * @param name network name
+     */
+
+    public SortedRegistry(String name) {
+        WeakReference<SortedRegistry<?>> oldValue = ALL_REGISTRIES.put(name, new WeakReference<>(this));
+        if (oldValue != null && oldValue.get() != null) {
+            throw new IllegalArgumentException("duplicate name");
+        }
+        FMLCommonHandler.instance().bus().register(this);
+    }
+
+    public static Set<String> getRegistryNames() {
+        return ALL_REGISTRIES.keySet();
+    }
+
+    public static SortedRegistry<?> getRegistry(String name) {
+        WeakReference<SortedRegistry<?>> ref = ALL_REGISTRIES.get(name);
+        return ref != null ? ref.get() : null;
+    }
+
+    static void cleanup(MinecraftServer server) {
+        List<EntityPlayerMP> players = server.getConfigurationManager().playerEntityList;
+        Set<UUID> onlinePlayerIDs = players.stream().map(EntityPlayerMP::getUniqueID).collect(Collectors.toSet());
+        int removed = 0;
+        for (WeakReference<SortedRegistry<?>> ref : ALL_REGISTRIES.values()) {
+            SortedRegistry<?> registry = ref.get();
+            if (registry == null) continue;
+            for (Iterator<UUID> iterator = registry.playerOrdering.keySet().iterator(); iterator.hasNext();) {
+                UUID uuid = iterator.next();
+                if (!onlinePlayerIDs.contains(uuid)) {
+                    iterator.remove();
+                    registry.playerBaked.remove(uuid);
+                    removed++;
+                }
+            }
+        }
+        if (removed > 0) {
+            StructureLib.LOGGER.debug("Removed {} registry record for logged out players", removed);
+        }
+    }
+
+    @SubscribeEvent
+    public void onPlayerLogOut(PlayerEvent.PlayerLoggedOutEvent e) {
+        playerOrdering.remove(e.player.getUniqueID());
+        playerBaked.remove(e.player.getUniqueID());
+    }
+
+    public void register(String key, V val) {
+        if (key == null || val == null) throw new NullPointerException();
+        V old = store.putIfAbsent(key, val);
+        if (old != null) {
+            throw new IllegalArgumentException("Duplicate key: " + key);
+        }
+        baked = new ArrayList<>(store.values());
+        for (Map.Entry<UUID, Pair<List<String>, List<String>>> e : playerOrdering.entrySet()) {
+            makePlayerBaked(e.getKey(), e.getValue().getKey(), e.getValue().getValue());
+        }
+    }
+
+    public void registerOrdering(EntityPlayerMP player, List<String> ordering, List<String> disabled) {
+        registerOrdering(player.getUniqueID(), ordering, disabled);
+    }
+
+    public void registerOrdering(UUID playerID, List<String> ordering, List<String> disabled) {
+        playerOrdering.put(playerID, Pair.of(ordering, disabled));
+        makePlayerBaked(playerID, ordering, disabled);
+    }
+
+    private void makePlayerBaked(UUID player, List<String> ordering, List<String> disabled) {
+        TreeMap<String, V> copy = new TreeMap<>(store);
+        for (String s : disabled) {
+            copy.remove(s);
+        }
+        List<V> b = new ArrayList<>();
+        for (String k : ordering) {
+            V v = copy.remove(k);
+            if (v != null) {
+                b.add(v);
+            }
+        }
+        b.addAll(copy.values());
+        playerBaked.put(player, b);
+    }
+
+    public int size() {
+        return store.size();
+    }
+
+    public boolean isEmpty() {
+        return store.isEmpty();
+    }
+
+    public boolean containsKey(String key) {
+        return store.containsKey(key);
+    }
+
+    public boolean containsValue(V value) {
+        return store.containsValue(value);
+    }
+
+    public V get(String key) {
+        return store.get(key);
+    }
+
+    public Iterable<V> getPlayerOrdering(@Nullable EntityPlayerMP player) {
+        if (player == null) return baked;
+        List<V> playerPreference = playerBaked.get(player.getUniqueID());
+        if (playerPreference == null) return baked;
+        return playerPreference;
+    }
+
+    public Stream<String> getPlayerOrderingKeys(@Nullable EntityPlayerMP player) {
+        if (player == null) return store.keySet().stream();
+        List<V> playerOrder = playerBaked.get(player.getUniqueID());
+        if (playerOrder == null) return store.keySet().stream();
+
+        // rebuild the order from the baked map
+        Map<V, String> reverseMap = new IdentityHashMap<>();
+        store.forEach((k, v) -> reverseMap.put(v, k));
+        return playerOrder.stream().map(reverseMap::get);
+    }
+
+    Iterable<String> getCurrentOrdering() {
+        return store.keySet();
+    }
+
+    @Override
+    public Iterator<V> iterator() {
+        return baked.iterator();
+    }
+
+    @Override
+    public void forEach(Consumer<? super V> action) {
+        baked.forEach(action);
+    }
+
+    @Override
+    public Spliterator<V> spliterator() {
+        return baked.spliterator();
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/StructureEvent.java

@@ -0,0 +1,160 @@
+package com.gtnewhorizon.structurelib;
+
+import net.minecraft.world.World;
+import net.minecraftforge.common.MinecraftForge;
+
+import com.gtnewhorizon.structurelib.structure.IStructureElement;
+
+import cpw.mods.fml.common.eventhandler.Event;
+
+/**
+ * Subscribers are <b>required</b> to not keep reference to these events, nor to depend on values of these events after
+ * the method call returns.
+ * <p>
+ * All of these events will be fired on the {@link net.minecraftforge.common.MinecraftForge#EVENT_BUS}, if they are
+ * enabled by {@link StructureLibAPI#enableInstrument(Object)}.
+ * <p>
+ * All public stuff in this class and its enclosed classes are considered part of the public API. Backwards
+ * compatibility is maintained to the maximum extend possible.
+ */
+public abstract class StructureEvent extends Event {
+
+    /*
+     * In case the event is passed to another thread for processing.
+     */
+    private final Object identifier = StructureLibAPI.instrument.get();
+
+    StructureEvent() {}
+
+    /**
+     * The instrument identifier. Subscribers should filter by these identifiers to prevent listening to a structure
+     * event for other people.
+     */
+    public Object getInstrumentIdentifier() {
+        return identifier;
+    }
+
+    /**
+     * Fired <b>just before</b> any structure element is visited.
+     */
+    public static final class StructureElementVisitedEvent extends StructureEvent {
+
+        private final World world;
+        private final int x, y, z;
+        private final int a, b, c;
+        private final IStructureElement<?> element;
+
+        /**
+         * Fire this event on {@link MinecraftForge#EVENT_BUS} by populating it with given arguments. Do nothing if
+         * instrumenting isn't enabled for current thread.
+         * <p>
+         * Any {@link Exception} thrown by event listeners will be logged and ignored. {@link Error} will be propagated
+         * as is.
+         */
+        public static void fireEvent(World world, int x, int y, int z, int a, int b, int c,
+                IStructureElement<?> element) {
+            if (StructureLibAPI.isInstrumentEnabled()) {
+                try {
+                    MinecraftForge.EVENT_BUS.post(new StructureElementVisitedEvent(world, x, y, z, a, b, c, element));
+                } catch (Exception e) {
+                    // logging is done by event bus, we just ignore the consequence here
+                }
+            }
+        }
+
+        StructureElementVisitedEvent(World world, int x, int y, int z, int a, int b, int c,
+                IStructureElement<?> element) {
+            this.world = world;
+            this.x = x;
+            this.y = y;
+            this.z = z;
+            this.a = a;
+            this.b = b;
+            this.c = c;
+            this.element = element;
+        }
+
+        /**
+         * A position in ABC coordinate, relative to (0,0,0) in the piece, i.e. without baseOffset
+         * <p>
+         * Submit a feature request if you need the baseOffset.
+         */
+        public int getA() {
+            return a;
+        }
+
+        /**
+         * B position in ABC coordinate, relative to (0,0,0) in the piece, i.e. without baseOffset
+         * <p>
+         * Submit a feature request if you need the baseOffset.
+         */
+        public int getB() {
+            return b;
+        }
+
+        /**
+         * C position in ABC coordinate, relative to (0,0,0) in the piece, i.e. without baseOffset
+         * <p>
+         * Submit a feature request if you need the baseOffset.
+         */
+        public int getC() {
+            return c;
+        }
+
+        /**
+         * Element being visited.
+         */
+        public IStructureElement<?> getElement() {
+            return element;
+        }
+
+        @Override
+        public String toString() {
+            return "StructureElementVisitedEvent{" + "a="
+                    + a
+                    + ", b="
+                    + b
+                    + ", c="
+                    + c
+                    + ", element="
+                    + element
+                    + ", world="
+                    + getWorld()
+                    + ", x="
+                    + getX()
+                    + ", y="
+                    + getY()
+                    + ", z="
+                    + getZ()
+                    + '}';
+        }
+
+        /**
+         * Location of this event.
+         */
+        public World getWorld() {
+            return world;
+        }
+
+        /**
+         * Location of this event. Absolute world coordinate.
+         */
+        public int getX() {
+            return x;
+        }
+
+        /**
+         * Location of this event. Absolute world coordinate.
+         */
+        public int getY() {
+            return y;
+        }
+
+        /**
+         * Location of this event. Absolute world coordinate.
+         */
+        public int getZ() {
+            return z;
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/StructureLib.java

@@ -1,78 +1,257 @@
 package com.gtnewhorizon.structurelib;
 
-import com.gtnewhorizon.structurelib.net.AlignmentMessage;
-import com.gtnewhorizon.structurelib.block.BlockHint;
-import com.gtnewhorizon.structurelib.item.ItemBlockHint;
-import com.gtnewhorizon.structurelib.item.ItemConstructableTrigger;
-import com.gtnewhorizon.structurelib.item.ItemFrontRotationTool;
-import com.gtnewhorizon.structurelib.proxy.CommonProxy;
-import com.gtnewhorizon.structurelib.util.XSTR;
-import cpw.mods.fml.common.Mod;
-import cpw.mods.fml.common.SidedProxy;
-import cpw.mods.fml.common.event.FMLPreInitializationEvent;
-import cpw.mods.fml.common.network.NetworkRegistry;
-import cpw.mods.fml.common.network.simpleimpl.SimpleNetworkWrapper;
-import cpw.mods.fml.common.registry.GameRegistry;
-import cpw.mods.fml.relauncher.Side;
-import cpw.mods.fml.relauncher.SideOnly;
+import static com.gtnewhorizon.structurelib.StructureLibAPI.CHANNEL_SHOW_ERROR;
+import static com.gtnewhorizon.structurelib.StructureLibAPI.MOD_ID;
+
 import net.minecraft.block.Block;
 import net.minecraft.creativetab.CreativeTabs;
 import net.minecraft.entity.player.EntityPlayer;
 import net.minecraft.item.Item;
 import net.minecraft.item.ItemBlock;
+import net.minecraft.item.ItemStack;
+import net.minecraft.launchwrapper.Launch;
+import net.minecraft.nbt.NBTTagCompound;
+import net.minecraft.nbt.NBTTagList;
+import net.minecraftforge.common.util.Constants;
+import net.minecraftforge.fluids.Fluid;
+import net.minecraftforge.fluids.FluidRegistry;
+import net.minecraftforge.fluids.FluidStack;
+
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 
+import com.gtnewhorizon.structurelib.block.BlockHint;
+import com.gtnewhorizon.structurelib.command.CommandConfigureChannels;
+import com.gtnewhorizon.structurelib.command.CommandRegistryDebug;
+import com.gtnewhorizon.structurelib.fluid.FluidPlacementRegistry;
+import com.gtnewhorizon.structurelib.fluid.FluidSourceProviders;
+import com.gtnewhorizon.structurelib.fluid.FluidStackExtractors;
+import com.gtnewhorizon.structurelib.item.ItemBlockHint;
+import com.gtnewhorizon.structurelib.item.ItemConstructableTrigger;
+import com.gtnewhorizon.structurelib.item.ItemFrontRotationTool;
+import com.gtnewhorizon.structurelib.net.AlignmentMessage;
+import com.gtnewhorizon.structurelib.net.ErrorHintParticleMessage;
+import com.gtnewhorizon.structurelib.net.RegistryOrderSyncMessage;
+import com.gtnewhorizon.structurelib.net.SetChannelDataMessage;
+import com.gtnewhorizon.structurelib.net.UpdateHintParticleMessage;
+import com.gtnewhorizon.structurelib.util.InventoryUtility;
+import com.gtnewhorizon.structurelib.util.XSTR;
+
+import cpw.mods.fml.common.Mod;
+import cpw.mods.fml.common.SidedProxy;
+import cpw.mods.fml.common.event.FMLInterModComms;
+import cpw.mods.fml.common.event.FMLLoadCompleteEvent;
+import cpw.mods.fml.common.event.FMLPreInitializationEvent;
+import cpw.mods.fml.common.event.FMLServerStartingEvent;
+import cpw.mods.fml.common.network.NetworkRegistry;
+import cpw.mods.fml.common.network.simpleimpl.SimpleNetworkWrapper;
+import cpw.mods.fml.common.registry.GameRegistry;
+import cpw.mods.fml.relauncher.Side;
+import cpw.mods.fml.relauncher.SideOnly;
+
 /**
  * This class does not contain a stable API. Refrain from using this class.
  */
-@Mod(modid = StructureLibAPI.MOD_ID, name = "StructureLib", version = "GRADLETOKEN_VERSION", acceptableRemoteVersions = "*", guiFactory = "com.gtnewhorizon.structurelib.GuiFactory")
+@Mod(
+        modid = MOD_ID,
+        name = "StructureLib",
+        version = Tags.VERSION,
+        acceptableRemoteVersions = "*",
+        guiFactory = "com.gtnewhorizon.structurelib.GuiFactory")
 public class StructureLib {
-	public static boolean DEBUG_MODE = Boolean.getBoolean("structurelib.debug");
-	public static Logger LOGGER = LogManager.getLogger("StructureLib");
 
-	@SidedProxy(serverSide = "com.gtnewhorizon.structurelib.proxy.CommonProxy", clientSide = "com.gtnewhorizon.structurelib.proxy.ClientProxy")
-	static CommonProxy proxy;
-	static SimpleNetworkWrapper net = NetworkRegistry.INSTANCE.newSimpleChannel(StructureLibAPI.MOD_ID);
+    private static final String STRUCTURECOMPAT_MODID = "structurecompat";
+    public static boolean DEBUG_MODE;
+    public static boolean PANIC_MODE = Boolean.getBoolean("structurelib.panic");
+    public static final Logger LOGGER = LogManager.getLogger("StructureLib");
 
-	static {
-		net.registerMessage(AlignmentMessage.ServerHandler.class, AlignmentMessage.AlignmentQuery.class, 0, Side.SERVER);
-		net.registerMessage(AlignmentMessage.ClientHandler.class, AlignmentMessage.AlignmentData.class, 1, Side.CLIENT);
-	}
+    @SidedProxy(
+            serverSide = "com.gtnewhorizon.structurelib.CommonProxy",
+            clientSide = "com.gtnewhorizon.structurelib.ClientProxy")
+    static CommonProxy proxy;
 
-	public static final XSTR RANDOM = new XSTR();
+    static final SimpleNetworkWrapper net = NetworkRegistry.INSTANCE.newSimpleChannel(MOD_ID);
 
-	static Block blockHint;
-	static Item itemBlockHint;
-	static Item itemFrontRotationTool;
-	static Item itemConstructableTrigger;
-	public static final CreativeTabs creativeTab = new CreativeTabs("structurelib") {
-		@Override
-		@SideOnly(Side.CLIENT)
-		public Item getTabIconItem() {
-			return StructureLibAPI.getItemBlockHint();
-		}
-	};
+    static {
+        net.registerMessage(
+                AlignmentMessage.ServerHandler.class,
+                AlignmentMessage.AlignmentQuery.class,
+                0,
+                Side.SERVER);
+        net.registerMessage(AlignmentMessage.ClientHandler.class, AlignmentMessage.AlignmentData.class, 1, Side.CLIENT);
+        net.registerMessage(UpdateHintParticleMessage.Handler.class, UpdateHintParticleMessage.class, 2, Side.CLIENT);
+        net.registerMessage(SetChannelDataMessage.Handler.class, SetChannelDataMessage.class, 3, Side.SERVER);
+        net.registerMessage(ErrorHintParticleMessage.Handler.class, ErrorHintParticleMessage.class, 4, Side.CLIENT);
+        net.registerMessage(RegistryOrderSyncMessage.Handler.class, RegistryOrderSyncMessage.class, 5, Side.SERVER);
 
-	@Mod.EventHandler
-	public void preInit(FMLPreInitializationEvent e) {
-		ConfigurationHandler.INSTANCE.init(e.getSuggestedConfigurationFile());
-		GameRegistry.registerBlock(blockHint = new BlockHint(), ItemBlockHint.class, "blockhint");
-		itemBlockHint = ItemBlock.getItemFromBlock(StructureLibAPI.getBlockHint());
-		GameRegistry.registerItem(itemFrontRotationTool = new ItemFrontRotationTool(), itemFrontRotationTool.getUnlocalizedName());
-		GameRegistry.registerItem(itemConstructableTrigger = new ItemConstructableTrigger(), itemConstructableTrigger.getUnlocalizedName());
-		proxy.preInit(e);
-	}
+        try {
+            DEBUG_MODE = Boolean.parseBoolean(System.getProperty("structurelib.debug"));
+        } catch (IllegalArgumentException | NullPointerException e) {
+            // turn on debug by default in dev mode
+            // this will be overridden if above property is present and set to false
+            DEBUG_MODE = (Boolean) Launch.blackboard.get("fml.deobfuscatedEnvironment");
+        }
+    }
 
-	public static void addClientSideChatMessages(String... messages) {
-		proxy.addClientSideChatMessages(messages);
-	}
+    public static final XSTR RANDOM = new XSTR();
 
-	public static EntityPlayer getCurrentPlayer() {
-		return proxy.getCurrentPlayer();
-	}
+    @Mod.Instance
+    static StructureLib INSTANCE;
+    @Mod.Instance(STRUCTURECOMPAT_MODID)
+    static Object COMPAT;
 
-	public static boolean isCurrentPlayer(EntityPlayer player) {
-		return proxy.isCurrentPlayer(player);
-	}
+    static Block blockHint;
+    static Item itemBlockHint;
+    static Item itemFrontRotationTool;
+    static Item itemConstructableTrigger;
+    public static final CreativeTabs creativeTab = new CreativeTabs("structurelib") {
+
+        @Override
+        @SideOnly(Side.CLIENT)
+        public Item getTabIconItem() {
+            return StructureLibAPI.getItemBlockHint();
+        }
+    };
+
+    @Mod.EventHandler
+    public void preInit(FMLPreInitializationEvent e) {
+        InventoryUtility.init();
+        FluidStackExtractors.init();
+        FluidSourceProviders.init();
+        FluidPlacementRegistry.init();
+        ConfigurationHandler.INSTANCE.init(e.getSuggestedConfigurationFile());
+        GameRegistry.registerBlock(blockHint = new BlockHint(), ItemBlockHint.class, "blockhint");
+        itemBlockHint = ItemBlock.getItemFromBlock(StructureLibAPI.getBlockHint());
+        GameRegistry.registerItem(
+                itemFrontRotationTool = new ItemFrontRotationTool(),
+                itemFrontRotationTool.getUnlocalizedName());
+        GameRegistry.registerItem(
+                itemConstructableTrigger = new ItemConstructableTrigger(),
+                itemConstructableTrigger.getUnlocalizedName());
+        proxy.preInit(e);
+        NetworkRegistry.INSTANCE.registerGuiHandler(instance(), new GuiHandler());
+
+        ChannelDescription.set(CHANNEL_SHOW_ERROR, MOD_ID, "channels.structurelib.show_errors");
+
+        DevelopHelper.onPreInit();
+    }
+
+    @Mod.EventHandler
+    public void loadComplete(FMLLoadCompleteEvent e) {
+        proxy.loadComplete(e);
+    }
+
+    @Mod.EventHandler
+    public void serverStarting(FMLServerStartingEvent e) {
+        e.registerServerCommand(new CommandConfigureChannels());
+        e.registerServerCommand(new CommandRegistryDebug());
+    }
+
+    @Mod.EventHandler
+    public void handleIMC(FMLInterModComms.IMCEvent event) {
+        for (FMLInterModComms.IMCMessage message : event.getMessages()) {
+            switch (message.key) {
+                case "register_channel":
+                    processRegisterChannel(message);
+                    break;
+                case "register_channel_item":
+                    processRegisterChannelItem(message);
+                    break;
+                case "register_fluid_block_cost":
+                    processRegisterFluidBlockCost(message);
+                    break;
+            }
+        }
+    }
+
+    /**
+     * Teach StructureLib what it costs to place a fluid block, without having to link against StructureLib.
+     * <p>
+     * The message must hold a compound with {@code Block} (registry name), {@code Fluid} (fluid name), optionally
+     * {@code Meta} (default 0), {@code Amount} (default one bucket) and {@code ForceFluid} (default false).
+     */
+    private void processRegisterFluidBlockCost(FMLInterModComms.IMCMessage message) {
+        if (!message.isNBTMessage()) {
+            LOGGER.warn("{} sent a register_fluid_block_cost message without any data", message.getSender());
+            return;
+        }
+        NBTTagCompound tag = message.getNBTValue();
+        String blockName = tag.getString("Block");
+        String fluidName = tag.getString("Fluid");
+        Object block = Block.blockRegistry.getObject(blockName);
+        Fluid fluid = FluidRegistry.getFluid(fluidName);
+        if (!(block instanceof Block)) {
+            LOGGER.warn("{} tried to register a fluid block cost for unknown block {}", message.getSender(), blockName);
+            return;
+        }
+        if (fluid == null) {
+            LOGGER.warn("{} tried to register a fluid block cost for unknown fluid {}", message.getSender(), fluidName);
+            return;
+        }
+        int meta = tag.getInteger("Meta");
+        int amount = tag.hasKey("Amount") ? tag.getInteger("Amount") : FluidPlacementRegistry.DEFAULT_FLUID_AMOUNT;
+        boolean forceFluid = tag.getBoolean("ForceFluid");
+        try {
+            FluidPlacementRegistry.register((Block) block, meta, new FluidStack(fluid, amount), forceFluid);
+        } catch (IllegalArgumentException e) {
+            // never let a badly formed message from another mod break the game
+            LOGGER.warn(
+                    "{} tried to register a fluid block cost for {}:{} twice",
+                    message.getSender(),
+                    blockName,
+                    meta);
+        }
+    }
+
+    private void processRegisterChannel(FMLInterModComms.IMCMessage message) {
+        NBTTagList tags = message.getNBTValue().getTagList("Channels", Constants.NBT.TAG_COMPOUND);
+        for (int i = 0; i < tags.tagCount(); i++) {
+            NBTTagCompound tag = tags.getCompoundTagAt(i);
+            StructureLibAPI.registerChannelDescription(
+                    tag.getString("Channel"),
+                    message.getSender(),
+                    tag.getString("Description"));
+        }
+    }
+
+    private void processRegisterChannelItem(FMLInterModComms.IMCMessage message) {
+        NBTTagList items = message.getNBTValue().getTagList("Items", Constants.NBT.TAG_COMPOUND);
+        for (int i = 0; i < items.tagCount(); i++) {
+            NBTTagCompound itemTag = items.getCompoundTagAt(i);
+            ItemStack item = ItemStack.loadItemStackFromNBT(itemTag.getCompoundTag("Item"));
+            NBTTagList tags = itemTag.getTagList("Channels", Constants.NBT.TAG_COMPOUND);
+            for (int j = 0; j < tags.tagCount(); j++) {
+                NBTTagCompound tag = tags.getCompoundTagAt(j);
+                StructureLibAPI.registerChannelItem(
+                        tag.getString("Channel"),
+                        message.getSender(),
+                        tag.getInteger("Value"),
+                        item);
+            }
+        }
+    }
+
+    public static void addClientSideChatMessages(String... messages) {
+        proxy.addClientSideChatMessages(messages);
+    }
+
+    public static EntityPlayer getCurrentPlayer() {
+        return proxy.getCurrentPlayer();
+    }
+
+    public static boolean isCurrentPlayer(EntityPlayer player) {
+        return proxy.isCurrentPlayer(player);
+    }
+
+    public static long getOverworldTime() {
+        return proxy.getOverworldTime();
+    }
+
+    public static StructureLib instance() {
+        return INSTANCE;
+    }
+
+    public CommonProxy proxy() {
+        return proxy;
+    }
 }

src/main/java/com/gtnewhorizon/structurelib/StructureLibAPI.java

@@ -1,131 +1,548 @@
 package com.gtnewhorizon.structurelib;
 
-import com.gtnewhorizon.structurelib.net.AlignmentMessage;
-import com.gtnewhorizon.structurelib.alignment.IAlignmentProvider;
-import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
-import cpw.mods.fml.common.network.NetworkRegistry;
+import static com.gtnewhorizon.structurelib.StructureLib.proxy;
+
+import javax.annotation.Nullable;
+
 import net.minecraft.block.Block;
 import net.minecraft.entity.player.EntityPlayer;
 import net.minecraft.entity.player.EntityPlayerMP;
 import net.minecraft.item.Item;
 import net.minecraft.item.ItemStack;
+import net.minecraft.util.IChatComponent;
 import net.minecraft.util.IIcon;
 import net.minecraft.world.World;
+import net.minecraftforge.fluids.FluidStack;
 
-import static com.gtnewhorizon.structurelib.StructureLib.proxy;
+import com.gtnewhorizon.gtnhlib.util.AnimatedTooltipHandler;
+import com.gtnewhorizon.structurelib.alignment.IAlignment;
+import com.gtnewhorizon.structurelib.alignment.IAlignmentProvider;
+import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
+import com.gtnewhorizon.structurelib.fluid.FluidBlockPlacement;
+import com.gtnewhorizon.structurelib.fluid.FluidBlockPlacer;
+import com.gtnewhorizon.structurelib.fluid.FluidPlacementRegistry;
+import com.gtnewhorizon.structurelib.fluid.FluidSourceProviders;
+import com.gtnewhorizon.structurelib.fluid.FluidStackExtractor;
+import com.gtnewhorizon.structurelib.fluid.FluidStackExtractors;
+import com.gtnewhorizon.structurelib.fluid.IFluidSourceProvider;
+import com.gtnewhorizon.structurelib.net.AlignmentMessage;
+import com.gtnewhorizon.structurelib.structure.AutoPlaceEnvironment;
+import com.gtnewhorizon.structurelib.structure.IStructureDefinition;
+
+import cpw.mods.fml.common.network.NetworkRegistry;
 
 /**
- * A stable interface into the structure lib's internals. Backwards compatibility is maintained to the maximum extend possible.
+ * A stable interface into the structure lib's internals. Backwards compatibility is maintained to the maximum extend
+ * possible.
  */
 public class StructureLibAPI {
-	public static final String MOD_ID = "structurelib";
-	public static final int HINT_BLOCK_META_GENERIC_0 = 0;
-	public static final int HINT_BLOCK_META_GENERIC_1 = 1;
-	public static final int HINT_BLOCK_META_GENERIC_2 = 2;
-	public static final int HINT_BLOCK_META_GENERIC_3 = 3;
-	public static final int HINT_BLOCK_META_GENERIC_4 = 4;
-	public static final int HINT_BLOCK_META_GENERIC_5 = 5;
-	public static final int HINT_BLOCK_META_GENERIC_6 = 6;
-	public static final int HINT_BLOCK_META_GENERIC_7 = 7;
-	public static final int HINT_BLOCK_META_GENERIC_8 = 8;
-	public static final int HINT_BLOCK_META_GENERIC_9 = 9;
-	public static final int HINT_BLOCK_META_GENERIC_10 = 10;
-	public static final int HINT_BLOCK_META_GENERIC_11 = 11;
-	public static final int HINT_BLOCK_META_DEFAULT = 12;
-	public static final int HINT_BLOCK_META_AIR = 13;
-	public static final int HINT_BLOCK_META_NOT_AIR = 14;
-	public static final int HINT_BLOCK_META_ERROR = 15;
 
-	/**
-	 * Start a batch of hinting. All hints particles generated during one batch will be considered to belong to one hologram.
-	 *
-	 * You don't need to call this unless your constructable tool didn't call {@link com.gtnewhorizon.structurelib.alignment.constructable.ConstructableUtility#handle(ItemStack, EntityPlayer, World, int, int, int, int)}
-	 */
-	public static void startHinting(World w) {
-		proxy.startHinting(w);
-	}
+    public static final String MOD_ID = "structurelib";
+    public static final int HINT_BLOCK_META_GENERIC_0 = 0;
+    public static final int HINT_BLOCK_META_GENERIC_1 = 1;
+    public static final int HINT_BLOCK_META_GENERIC_2 = 2;
+    public static final int HINT_BLOCK_META_GENERIC_3 = 3;
+    public static final int HINT_BLOCK_META_GENERIC_4 = 4;
+    public static final int HINT_BLOCK_META_GENERIC_5 = 5;
+    public static final int HINT_BLOCK_META_GENERIC_6 = 6;
+    public static final int HINT_BLOCK_META_GENERIC_7 = 7;
+    public static final int HINT_BLOCK_META_GENERIC_8 = 8;
+    public static final int HINT_BLOCK_META_GENERIC_9 = 9;
+    public static final int HINT_BLOCK_META_GENERIC_10 = 10;
+    public static final int HINT_BLOCK_META_GENERIC_11 = 11;
+    public static final int HINT_BLOCK_META_DEFAULT = 12;
+    public static final int HINT_BLOCK_META_AIR = 13;
+    public static final int HINT_BLOCK_META_NOT_AIR = 14;
+    public static final int HINT_BLOCK_META_ERROR = 15;
+    public static final String CHANNEL_SHOW_ERROR = "show_error";
+    static final ThreadLocal<Object> instrument = new ThreadLocal<>();
 
-	/**
-	 * Start current batch of hinting. All hints particles generated during one batch will be considered to belong to one hologram.
-	 *
-	 * You don't need to call this unless your constructable tool didn't call {@link com.gtnewhorizon.structurelib.alignment.constructable.ConstructableUtility#handle(ItemStack, EntityPlayer, World, int, int, int, int)}
-	 */
-	public static void endHinting(World w) {
-		proxy.endHinting(w);
-	}
+    /**
+     * Start instrumenting <b>for the current thread only</b>. When instrumentation is enabled,
+     * {@link IStructureDefinition}'s builtin iteration methods will send {@link StructureEvent} and its subclasses when
+     * appropriate. Otherwise, these events will not be sent at all, regardless of whether a listener for these events
+     * are registered.
+     * <p>
+     * Identifiers are required to be value-comparable, i.e. overrides {@link Object#equals(Object)}. Suggested
+     * identifier includes
+     * <ul>
+     * <li>Mod Instance or {@link cpw.mods.fml.common.ModContainer}</li>
+     * <li>{@link com.gtnewhorizon.structurelib.alignment.constructable.IConstructable} and its friends, if you are
+     * triggering structure check via this interface.</li>
+     * <li>{@link net.minecraft.util.ResourceLocation}</li>
+     * </ul>
+     * <p>
+     * It's an API abuse for normal {@link IStructureDefinition} users to depend on this feature. They have full control
+     * and full knowledge of the {@link IStructureDefinition} they are using. Using events to instrument the structure
+     * check/autoplace is completely unnecessary and does nothing but add overhead.
+     * <p>
+     * Instruments are required to call {@link #disableInstrument()} whenever it is done with its business, as there can
+     * be only one instrument for any given thread.
+     *
+     * @param identifier an identifier sent along the actual event.
+     * @throws IllegalStateException if instrument has already been enabled.
+     */
+    public static void enableInstrument(Object identifier) {
+        if (isInstrumentEnabled()) throw new IllegalStateException();
+        instrument.set(identifier);
+    }
 
-	public static void hintParticleTinted(World w, int x, int y, int z, IIcon[] icons, short[] RGBa) {
-		proxy.hintParticleTinted(w, x, y, z, icons, RGBa);
-	}
+    /**
+     * Stop instrumenting.
+     *
+     * @throws IllegalStateException if instrumenting hasn't been enabled.
+     */
+    public static void disableInstrument() {
+        if (!isInstrumentEnabled()) throw new IllegalStateException();
+        instrument.set(null);
+    }
 
-	public static void hintParticleTinted(World w, int x, int y, int z, Block block, int meta, short[] RGBa) {
-		proxy.hintParticleTinted(w, x, y, z, block, meta, RGBa);
-	}
+    /**
+     * Check if instrumenting is enabled.
+     *
+     * @return true if enabled, false otherwise
+     */
+    public static boolean isInstrumentEnabled() {
+        return instrument.get() != null;
+    }
 
-	public static void hintParticle(World w, int x, int y, int z, IIcon[] icons) {
-		proxy.hintParticle(w, x, y, z, icons);
-	}
+    /**
+     * Start a batch of hinting. All hints particles generated during one batch will be considered to belong to one
+     * hologram.
+     * <p>
+     * You don't need to call this unless your constructable tool didn't call
+     * {@link com.gtnewhorizon.structurelib.alignment.constructable.ConstructableUtility#handle(ItemStack, EntityPlayer, World, int, int, int, int)}
+     */
+    public static void startHinting(World w) {
+        proxy.startHinting(w);
+    }
 
-	public static void hintParticle(World w, int x, int y, int z, Block block, int meta) {
-		proxy.hintParticle(w, x, y, z, block, meta);
-	}
+    /**
+     * End current batch of hinting. All hints particles generated during one batch will be considered to belong to one
+     * hologram.
+     * <p>
+     * You don't need to call this unless your constructable tool didn't call
+     * {@link com.gtnewhorizon.structurelib.alignment.constructable.ConstructableUtility#handle(ItemStack, EntityPlayer, World, int, int, int, int)}
+     */
+    public static void endHinting(World w) {
+        proxy.endHinting(w);
+    }
 
-	/**
-	 * Query the ExtendedFacing of this tile entity.
-	 * The ExtendedFacing will later be set onto given tile entity via {@link com.gtnewhorizon.structurelib.alignment.IAlignment#setExtendedFacing(ExtendedFacing)}
-	 * upon arrival of server reply.
-	 * @throws IllegalArgumentException if is not tile entity or provided a null alignment
-	 */
-	public static void queryAlignment(IAlignmentProvider provider) {
-		StructureLib.net.sendToServer(new AlignmentMessage.AlignmentQuery(provider));
-	}
+    /**
+     * Generate a new hint particle on client side at given location using given textures with a tint.
+     *
+     * @param w     World to spawn. Usually the client world.
+     * @param x     x coord
+     * @param y     y coord
+     * @param z     z coord
+     * @param icons 6 texture. in forge direction order.
+     * @param RGBa  a 4 short array. tint in rgba form. currently alpha channel is ignored, but we might change this
+     *              later on.
+     */
+    public static void hintParticleTinted(World w, int x, int y, int z, IIcon[] icons, short[] RGBa) {
+        proxy.hintParticleTinted(w, x, y, z, icons, RGBa);
+    }
 
-	/**
-	 * Send the ExtendedFacing of this Tile Entity to all players. Can be called on server side only.
-	 * @throws IllegalArgumentException if is not tile entity or provided a null alignment
-	 */
-	public static void sendAlignment(IAlignmentProvider provider) {
-		StructureLib.net.sendToAll(new AlignmentMessage.AlignmentData(provider));
-	}
+    /**
+     * Generate a new hint particle on client side at given location using textures from given block with a tint.
+     *
+     * @param w     World to spawn. Usually the client world.
+     * @param x     x coord
+     * @param y     y coord
+     * @param z     z coord
+     * @param block block to take texture from
+     * @param meta  the meta of block to take texture from
+     * @param RGBa  a 4 short array. tint in rgba form. currently alpha channel is ignored, but we might change this
+     *              later on.
+     */
+    public static void hintParticleTinted(World w, int x, int y, int z, Block block, int meta, short[] RGBa) {
+        proxy.hintParticleTinted(w, x, y, z, block, meta, RGBa);
+    }
 
-	/**
-	 * Send the ExtendedFacing of this Tile Entity to given player. Can be called on server side only.
-	 * @throws IllegalArgumentException if is not tile entity or provided a null alignment
-	 */
-	public static void sendAlignment(IAlignmentProvider provider, EntityPlayerMP player) {
-		StructureLib.net.sendTo(new AlignmentMessage.AlignmentData(provider), player);
-	}
+    /**
+     * Generate a new hint particle on client side at given location using given textures.
+     *
+     * @param w     World to spawn. Usually the client world.
+     * @param x     x coord
+     * @param y     y coord
+     * @param z     z coord
+     * @param icons 6 texture. in forge direction order.
+     */
+    public static void hintParticle(World w, int x, int y, int z, IIcon[] icons) {
+        proxy.hintParticle(w, x, y, z, icons);
+    }
 
-	/**
-	 * Send the ExtendedFacing of this Tile Entity to all players around target point. Can be called on server side only.
-	 * @throws IllegalArgumentException if is not tile entity or provided a null alignment
-	 */
-	public static void sendAlignment(IAlignmentProvider provider, NetworkRegistry.TargetPoint targetPoint) {
-		StructureLib.net.sendToAllAround(new AlignmentMessage.AlignmentData(provider), targetPoint);
-	}
+    /**
+     * Generate a new hint particle on client side at given location using textures from given block.
+     *
+     * @param w     World to spawn. Usually the client world.
+     * @param x     x coord
+     * @param y     y coord
+     * @param z     z coord
+     * @param block block to take texture from
+     * @param meta  the meta of block to take texture from
+     */
+    public static void hintParticle(World w, int x, int y, int z, Block block, int meta) {
+        proxy.hintParticle(w, x, y, z, block, meta);
+    }
 
+    /**
+     * Update the tint of given hint particle. Do nothing if particle not found.
+     * <p>
+     * Can be called on either client side or server side. Server side will schedule a network message to update it for
+     * this player only. Will do nothing if no hint particle is found at given location.
+     *
+     * @return false if nothing updated. true if updated or update instruction sent.
+     */
+    public static boolean markHintParticleError(EntityPlayer player, World w, int x, int y, int z) {
+        return proxy.markHintParticleError(player, w, x, y, z);
+    }
 
-	/**
-	 * Send the ExtendedFacing of this Tile Entity to all players in that dimension. Can be called on server side only.
-	 * @throws IllegalArgumentException if is not tile entity or provided a null alignment
-	 */
-	public static void sendAlignment(IAlignmentProvider provider, World dimension) {
-		StructureLib.net.sendToDimension(new AlignmentMessage.AlignmentData(provider), dimension.provider.dimensionId);
-	}
+    /**
+     * Update the tint of given hint particle. Do nothing if particle not found.
+     *
+     * @return false if nothing updated. true if updated.
+     */
+    public static boolean updateHintParticleTint(EntityPlayer player, World w, int x, int y, int z, short[] RGBa) {
+        return proxy.updateHintParticleTint(player, w, x, y, z, RGBa);
+    }
 
-	public static Block getBlockHint() {
-		return StructureLib.blockHint;
-	}
+    /**
+     * Query the ExtendedFacing of this tile entity from client side. Can be sent only on client side. The
+     * ExtendedFacing will later be set onto given tile entity via
+     * {@link com.gtnewhorizon.structurelib.alignment.IAlignment#setExtendedFacing(ExtendedFacing)} upon arrival of
+     * server reply.
+     * <p>
+     * The server side will query the {@link ExtendedFacing} of this provider using
+     * {@link IAlignment#getExtendedFacing()}
+     *
+     * @throws IllegalArgumentException if is not tile entity or provided a null alignment
+     */
+    public static void queryAlignment(IAlignmentProvider provider) {
+        StructureLib.net.sendToServer(new AlignmentMessage.AlignmentQuery(provider));
+    }
 
-	public static Item getItemBlockHint() {
-		return StructureLib.itemBlockHint;
-	}
+    /**
+     * Send the ExtendedFacing of this Tile Entity to all players. Can be called on server side only.
+     * <p>
+     * The receiving tile entity will receive the {@link ExtendedFacing} via its
+     * {@link com.gtnewhorizon.structurelib.alignment.IAlignment#setExtendedFacing(ExtendedFacing)} method.
+     *
+     * @throws IllegalArgumentException if is not tile entity or provided a null alignment
+     */
+    public static void sendAlignment(IAlignmentProvider provider) {
+        StructureLib.net.sendToAll(new AlignmentMessage.AlignmentData(provider));
+    }
 
-	public static boolean isDebugEnabled() {
-		return StructureLib.DEBUG_MODE;
-	}
+    /**
+     * Send the ExtendedFacing of this Tile Entity to given player. Can be called on server side only.
+     * <p>
+     * The receiving tile entity will receive the {@link ExtendedFacing} via its
+     * {@link com.gtnewhorizon.structurelib.alignment.IAlignment#setExtendedFacing(ExtendedFacing)} method.
+     *
+     * @throws IllegalArgumentException if is not tile entity or provided a null alignment
+     */
+    public static void sendAlignment(IAlignmentProvider provider, EntityPlayerMP player) {
+        StructureLib.net.sendTo(new AlignmentMessage.AlignmentData(provider), player);
+    }
 
-	public static void setDebugEnabled(boolean enabled) {
-		StructureLib.DEBUG_MODE = enabled;
-	}
+    /**
+     * Send the ExtendedFacing of this Tile Entity to all players around target point. Can be called on server side
+     * only.
+     * <p>
+     * The receiving tile entity will receive the {@link ExtendedFacing} via its
+     * {@link com.gtnewhorizon.structurelib.alignment.IAlignment#setExtendedFacing(ExtendedFacing)} method.
+     *
+     * @throws IllegalArgumentException if is not tile entity or provided a null alignment
+     */
+    public static void sendAlignment(IAlignmentProvider provider, NetworkRegistry.TargetPoint targetPoint) {
+        StructureLib.net.sendToAllAround(new AlignmentMessage.AlignmentData(provider), targetPoint);
+    }
+
+    /**
+     * Send the ExtendedFacing of this Tile Entity to all players in that dimension. Can be called on server side only.
+     * <p>
+     * The receiving tile entity will receive the {@link ExtendedFacing} via its
+     * {@link com.gtnewhorizon.structurelib.alignment.IAlignment#setExtendedFacing(ExtendedFacing)} method.
+     *
+     * @throws IllegalArgumentException if is not tile entity or provided a null alignment
+     */
+    public static void sendAlignment(IAlignmentProvider provider, World dimension) {
+        StructureLib.net.sendToDimension(new AlignmentMessage.AlignmentData(provider), dimension.provider.dimensionId);
+    }
+
+    /**
+     * Get the Block for StructureLib supplied hint block.
+     */
+    public static Block getBlockHint() {
+        return StructureLib.blockHint;
+    }
+
+    /**
+     * Get the ItemBlock for StructureLib supplied hint block.
+     */
+    public static Item getItemBlockHint() {
+        return StructureLib.itemBlockHint;
+    }
+
+    /**
+     * Get the hologram item.
+     */
+    public static Item getDefaultHologramItem() {
+        return StructureLib.itemConstructableTrigger;
+    }
+
+    /**
+     * Check if structure debug mode is on.
+     *
+     * @return true if debug mode is on
+     */
+    public static boolean isDebugEnabled() {
+        return StructureLib.DEBUG_MODE;
+    }
+
+    public static void setDebugEnabled(boolean enabled) {
+        StructureLib.DEBUG_MODE = enabled;
+    }
+
+    /**
+     * Determines if given block can be replaced without much effort. The exact predicate clauses is not stable and will
+     * be changed, but the general idea will always stay the same.
+     * <p>
+     * Use this in your
+     * {@link com.gtnewhorizon.structurelib.structure.IStructureElement#survivalPlaceBlock(Object, World, int, int, int, ItemStack, AutoPlaceEnvironment)}
+     */
+    @Deprecated
+    public static boolean isBlockTriviallyReplaceable(World w, int x, int y, int z, EntityPlayerMP actor) {
+        return isBlockTriviallyReplaceable(w, x, y, z, (EntityPlayer) actor);
+    }
+
+    /**
+     * Determines if given block can be replaced without much effort. The exact predicate clauses is not stable and will
+     * be changed, but the general idea will always stay the same.
+     * <p>
+     * Use this in your
+     * {@link com.gtnewhorizon.structurelib.structure.IStructureElement#survivalPlaceBlock(Object, World, int, int, int, ItemStack, AutoPlaceEnvironment)}
+     */
+    public static boolean isBlockTriviallyReplaceable(World w, int x, int y, int z, EntityPlayer actor) {
+        // TODO extend this function a bit
+        Block block = w.getBlock(x, y, z);
+        return block.isAir(w, x, y, z) || block.isReplaceable(w, x, y, z);
+    }
+
+    /**
+     * Put back the block that was at a position, which is what a placement that could not be paid for should roll back
+     * to.
+     * <p>
+     * Restoring the previous state instead of clearing the position matters whenever the position held something
+     * autoplace is allowed to replace, e.g. a fluid that is not a source block: the player would otherwise be left with
+     * a hole where their fluid used to be.
+     *
+     * @param world world to write to
+     * @param x     x coord
+     * @param y     y coord
+     * @param z     z coord
+     * @param block the block that was there, or null for air
+     * @param meta  the meta that was there
+     */
+    public static void restoreBlock(World world, int x, int y, int z, @Nullable Block block, int meta) {
+        if (block == null || block.isAir(world, x, y, z)) world.setBlockToAir(x, y, z);
+        else world.setBlock(x, y, z, block, meta, 3);
+    }
+
+    /**
+     * Send chat to player, but throttled.
+     *
+     * @param throttleKey      throttle key. Must properly implement {@link Object#hashCode()} and
+     *                         {@link Object#equals(Object)} to handle value equality.
+     * @param player           player to send chat to
+     * @param text             chat to send
+     * @param intervalRequired interval required before last recorded time to actually send the message. unit in
+     *                         millisecond. we purposefully chose to not use a bigger data type to limit how long this
+     *                         interval can be
+     */
+    public static void addThrottledChat(Object throttleKey, EntityPlayer player, IChatComponent text,
+            short intervalRequired) {
+        addThrottledChat(throttleKey, player, text, intervalRequired, false);
+    }
+
+    /**
+     * Send chat to player, but throttled.
+     *
+     * @param throttleKey         throttle key. Must properly implement {@link Object#hashCode()} and
+     *                            {@link Object#equals(Object)} to handle value equality.
+     * @param player              player to send chat to
+     * @param text                chat to send
+     * @param intervalRequired    interval required before last recorded time to actually send the message. unit in
+     *                            millisecond. we purposefully chose to not use a bigger data type to limit how long
+     *                            this interval can be
+     * @param forceUpdateLastSend if true, always update the last send time, even if the message isn't actually sent.
+     */
+    public static void addThrottledChat(Object throttleKey, EntityPlayer player, IChatComponent text,
+            short intervalRequired, boolean forceUpdateLastSend) {
+        proxy.addThrottledChat(throttleKey, player, text, intervalRequired, forceUpdateLastSend);
+    }
+
+    /**
+     * Register a channel description here. The description should describe how a channel will be used inside your mod.
+     *
+     * @param channel     channel key
+     * @param modid       your modid
+     * @param description localization key for your description
+     */
+    public static void registerChannelDescription(final String channel, final String modid, final String description) {
+        ChannelDescription.set(channel, modid, description);
+    }
+
+    /**
+     * Register what it costs to place a fluid block, and how to place it.
+     * <p>
+     * Water and lava are registered by default, and every Forge fluid block is recognised automatically, so this is
+     * only needed for a fluid block that costs something else than one bucket, for a fluid block that has to be written
+     * into the world in a special way, or for a block that has an item form but should always be paid for with fluid.
+     *
+     * @param block     the fluid block
+     * @param meta      the block meta. {@link net.minecraftforge.oredict.OreDictionary#WILDCARD_VALUE} covers every
+     *                  meta of this block.
+     * @param placement what this block state costs and how to place it
+     */
+    public static void registerFluidBlockCost(Block block, int meta, FluidBlockPlacement placement) {
+        FluidPlacementRegistry.register(block, meta, placement);
+    }
+
+    /**
+     * Register what it costs to place a fluid block, preferring the item form when the block has one.
+     *
+     * @param block the fluid block
+     * @param meta  the block meta
+     * @param cost  how much fluid one block of this state costs
+     * @see #registerFluidBlockCost(Block, int, FluidBlockPlacement)
+     */
+    public static void registerFluidBlockCost(Block block, int meta, FluidStack cost) {
+        FluidPlacementRegistry.register(block, meta, cost);
+    }
+
+    /**
+     * Register what it costs to place a fluid block.
+     *
+     * @param block      the fluid block
+     * @param meta       the block meta
+     * @param cost       how much fluid one block of this state costs
+     * @param forceFluid whether to always pay with fluid, even when this block also has an item form
+     * @see #registerFluidBlockCost(Block, int, FluidBlockPlacement)
+     */
+    public static void registerFluidBlockCost(Block block, int meta, FluidStack cost, boolean forceFluid) {
+        FluidPlacementRegistry.register(block, meta, cost, forceFluid);
+    }
+
+    /**
+     * Register what it costs to place a fluid block, with {@link FluidPlacementRegistry#DEFAULT_FLUID_AMOUNT} of the
+     * fluid the block holds, preferring the item form when the block has one.
+     * <p>
+     * The amount is the whole cost of that state, so a block whose meta says how full it is wants one registration per
+     * meta it can be in, or no registration at all, in which case the default amount is scaled down for a partially
+     * filled position.
+     *
+     * @param block the fluid block
+     * @param meta  the block meta. {@link net.minecraftforge.oredict.OreDictionary#WILDCARD_VALUE} covers every meta of
+     *              this block.
+     * @throws IllegalArgumentException if the block holds no fluid, or this state is already registered
+     * @see #registerFluidBlockCost(Block, int, FluidBlockPlacement)
+     */
+    public static void registerFluidBlockCost(Block block, int meta) {
+        FluidPlacementRegistry.register(block, meta);
+    }
+
+    /**
+     * Register what it costs to place a fluid block, with {@link FluidPlacementRegistry#DEFAULT_FLUID_AMOUNT} of the
+     * fluid the block holds.
+     *
+     * @param block      the fluid block
+     * @param meta       the block meta. {@link net.minecraftforge.oredict.OreDictionary#WILDCARD_VALUE} covers every
+     *                   meta of this block.
+     * @param forceFluid whether to always pay with fluid, even when this block also has an item form
+     * @see #registerFluidBlockCost(Block, int)
+     */
+    public static void registerFluidBlockCost(Block block, int meta, boolean forceFluid) {
+        FluidPlacementRegistry.register(block, meta, forceFluid);
+    }
+
+    /**
+     * Register the whole block, i.e. every meta of it that has no registration of its own, with
+     * {@link FluidPlacementRegistry#DEFAULT_FLUID_AMOUNT} of the fluid it holds.
+     *
+     * @param block the fluid block
+     * @see #registerFluidBlockCost(Block, int)
+     */
+    public static void registerFluidBlockCost(Block block) {
+        FluidPlacementRegistry.register(block);
+    }
+
+    /**
+     * Register what it costs to place a fluid block, with {@link FluidPlacementRegistry#DEFAULT_FLUID_AMOUNT} of the
+     * fluid the block holds, and placed the way the given placer says.
+     * <p>
+     * Use this for a fluid block that cannot be placed with a plain block set, e.g. one that has to be filled through
+     * its own API.
+     *
+     * @param block  the fluid block
+     * @param meta   the block meta. {@link net.minecraftforge.oredict.OreDictionary#WILDCARD_VALUE} covers every meta
+     *               of this block.
+     * @param placer how to write the block into the world
+     * @see #registerFluidBlockCost(Block, int, FluidBlockPlacement)
+     */
+    public static void registerFluidBlockCost(Block block, int meta, FluidBlockPlacer placer) {
+        FluidPlacementRegistry.register(block, meta, placer);
+    }
+
+    /**
+     * Register a way to pull fluid out of an item, so that autoplace can pay for a fluid block with it.
+     * <p>
+     * Forge's fluid container item and Forge's fluid container registry are both supported out of the box, which covers
+     * buckets and most modded cells. Register your own extractor for a container that exposes its fluid by other means.
+     *
+     * @param key       unique key. Matches the key shown in the config gui.
+     * @param extractor the extractor
+     */
+    public static void registerFluidStackExtractor(String key, FluidStackExtractor extractor) {
+        FluidStackExtractors.register(key, extractor);
+    }
+
+    /**
+     * Register a way to hand StructureLib fluid without the player having to carry a fluid container, e.g. the ME
+     * network behind a wireless terminal the player has on them.
+     * <p>
+     * Providers are asked before the fluid containers the player is carrying, in the order the player configured, so
+     * the player can reorder or disable every provider in StructureLib's config. A provider should look up what it
+     * drains from every time it is asked for fluid rather than when it is created, as the player can walk out of range
+     * or put a terminal away between two rounds of autoplace.
+     *
+     * @param key      unique key. Matches the key shown in the config gui.
+     * @param provider the provider
+     */
+    public static void registerFluidSourceProvider(String key, IFluidSourceProvider provider) {
+        FluidSourceProviders.register(key, provider);
+    }
+
+    /**
+     * Register an item stack as an indicator for a (channel, value) pair.
+     *
+     * @param channel      channel key
+     * @param modid        your modid
+     * @param channelValue value
+     * @param stack        item stack. having a metadata of
+     *                     {@link net.minecraftforge.oredict.OreDictionary#WILDCARD_VALUE} will match without comparing
+     *                     NBT or metadata value. having a tag with {@code tag.getBoolean("*") == true} will match
+     *                     without comparing NBT.
+     */
+    public static void registerChannelItem(final String channel, final String modid, final int channelValue,
+            final ItemStack stack) {
+        ChannelDescription.item(channel, channelValue, stack);
+        AnimatedTooltipHandler.addItemTooltip(
+                stack,
+                AnimatedTooltipHandler.translatedText("structurelib.tooltip.channelvalue", channelValue, channel));
+        AnimatedTooltipHandler.addItemTooltip(
+                stack,
+                AnimatedTooltipHandler.translatedText("structurelib.tooltip.indicator_dnd", channelValue, channel));
+    }
 }

src/main/java/com/gtnewhorizon/structurelib/alignment/AlignmentLimits.java

@@ -1,8 +1,9 @@
 package com.gtnewhorizon.structurelib.alignment;
 
+import net.minecraftforge.common.util.ForgeDirection;
+
 import com.gtnewhorizon.structurelib.alignment.enumerable.Flip;
 import com.gtnewhorizon.structurelib.alignment.enumerable.Rotation;
-import net.minecraftforge.common.util.ForgeDirection;
 
 class AlignmentLimits implements IAlignmentLimits {
 

src/main/java/com/gtnewhorizon/structurelib/alignment/AlignmentUtility.java

@@ -7,10 +7,10 @@ import net.minecraft.world.World;
 import net.minecraftforge.common.util.FakePlayer;
 
 public class AlignmentUtility {
-    private AlignmentUtility(){
-    }
 
-    public static boolean handle(EntityPlayer aPlayer, World aWorld, int aX, int aY, int aZ){
+    private AlignmentUtility() {}
+
+    public static boolean handle(EntityPlayer aPlayer, World aWorld, int aX, int aY, int aZ) {
         TileEntity tTileEntity = aWorld.getTileEntity(aX, aY, aZ);
         if (tTileEntity == null || aPlayer instanceof FakePlayer) {
             return aPlayer instanceof EntityPlayerMP;

src/main/java/com/gtnewhorizon/structurelib/alignment/IAlignment.java

@@ -1,66 +1,73 @@
 package com.gtnewhorizon.structurelib.alignment;
 
+import net.minecraftforge.common.util.ForgeDirection;
+
 import com.gtnewhorizon.structurelib.alignment.enumerable.Direction;
 import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
 import com.gtnewhorizon.structurelib.alignment.enumerable.Flip;
 import com.gtnewhorizon.structurelib.alignment.enumerable.Rotation;
-import net.minecraftforge.common.util.ForgeDirection;
 
-public interface IAlignment extends IAlignmentLimits,IAlignmentProvider {
-    int DIRECTIONS_COUNT= Direction.VALUES.length;
-    int ROTATIONS_COUNT= Rotation.VALUES.length;
-    int FLIPS_COUNT= Flip.VALUES.length;
+public interface IAlignment extends IAlignmentLimits, IAlignmentProvider {
+
+    int DIRECTIONS_COUNT = Direction.VALUES.length;
+    int ROTATIONS_COUNT = Rotation.VALUES.length;
+    int FLIPS_COUNT = Flip.VALUES.length;
     int STATES_COUNT = ExtendedFacing.STATES_COUNT;
 
     ExtendedFacing getExtendedFacing();
 
+    /**
+     * Set the facing without additional checks. Tools altering facing should use
+     * {@link #toolSetExtendedFacing(ExtendedFacing)} instead.
+     */
     void setExtendedFacing(ExtendedFacing alignment);
 
     IAlignmentLimits getAlignmentLimits();
 
     @Override
-    default IAlignment getAlignment(){
+    default IAlignment getAlignment() {
         return this;
     }
 
-    static int getAlignmentIndex(ForgeDirection direction, Rotation rotation, Flip flip){
-        return (direction.ordinal()*ROTATIONS_COUNT+rotation.getIndex())*FLIPS_COUNT+flip.getIndex();
+    static int getAlignmentIndex(ForgeDirection direction, Rotation rotation, Flip flip) {
+        return (direction.ordinal() * ROTATIONS_COUNT + rotation.getIndex()) * FLIPS_COUNT + flip.getIndex();
     }
 
-    default ForgeDirection getDirection(){
+    default ForgeDirection getDirection() {
         return getExtendedFacing().getDirection();
     }
 
-    default void setDirection(ForgeDirection direction){
+    default void setDirection(ForgeDirection direction) {
         setExtendedFacing(getExtendedFacing().with(direction));
     }
 
-    default Rotation getRotation(){
+    default Rotation getRotation() {
         return getExtendedFacing().getRotation();
     }
 
-    default void setRotation(Rotation rotation){
+    default void setRotation(Rotation rotation) {
         setExtendedFacing(getExtendedFacing().with(rotation));
     }
 
-    default Flip getFlip(){
+    default Flip getFlip() {
         return getExtendedFacing().getFlip();
     }
 
-    default void setFlip(Flip flip){
+    default void setFlip(Flip flip) {
         setExtendedFacing(getExtendedFacing().with(flip));
     }
 
-    default boolean toolSetDirection(ForgeDirection direction){
-        if(direction==null || direction==ForgeDirection.UNKNOWN){
-            for (int i = 0,j=getDirection().ordinal()+1, valuesLength = Direction.VALUES.length; i < valuesLength; i++) {
+    default boolean toolSetDirection(ForgeDirection direction) {
+        if (direction == null || direction == ForgeDirection.UNKNOWN) {
+            for (int i = 0, j = getDirection().ordinal() + 1, valuesLength = Direction.VALUES.length; i
+                    < valuesLength; i++) {
                 if (toolSetDirection(Direction.VALUES[(j + i) % valuesLength].getForgeDirection())) {
                     return true;
                 }
             }
-        }else {
+        } else {
             for (ExtendedFacing extendedFacing : ExtendedFacing.FOR_FACING.get(direction)) {
-                if(checkedSetExtendedFacing(extendedFacing)){
+                if (checkedSetExtendedFacing(extendedFacing)) {
                     return true;
                 }
             }
@@ -68,17 +75,17 @@ public interface IAlignment extends IAlignmentLimits,IAlignmentProvider {
         return false;
     }
 
-    default boolean checkedSetDirection(ForgeDirection direction){
-        if (isNewDirectionValid(direction)){
+    default boolean checkedSetDirection(ForgeDirection direction) {
+        if (isNewDirectionValid(direction)) {
             setDirection(direction);
             return true;
         }
         return false;
     }
 
-    default boolean canSetToDirectionAny(ForgeDirection direction){
+    default boolean canSetToDirectionAny(ForgeDirection direction) {
         for (ExtendedFacing extendedFacing : ExtendedFacing.FOR_FACING.get(direction)) {
-            if(isNewExtendedFacingValid(extendedFacing)){
+            if (isNewExtendedFacingValid(extendedFacing)) {
                 return true;
             }
         }
@@ -86,66 +93,71 @@ public interface IAlignment extends IAlignmentLimits,IAlignmentProvider {
     }
 
     default boolean toolSetRotation(Rotation rotation) {
-        if(rotation==null){
+        if (rotation == null) {
             int flips = Flip.VALUES.length;
             int rotations = Rotation.VALUES.length;
-            for (int ii = 0,jj=getFlip().ordinal(); ii < flips; ii++) {
+            for (int ii = 0, jj = getFlip().ordinal(); ii < flips; ii++) {
                 for (int i = 1, j = getRotation().ordinal(); i < rotations; i++) {
-                    if (checkedSetExtendedFacing(ExtendedFacing.of(getDirection(), Rotation.VALUES[(j + i) % rotations], Flip.VALUES[(jj + ii) % flips]))) {
+                    if (checkedSetExtendedFacing(
+                            ExtendedFacing.of(
+                                    getDirection(),
+                                    Rotation.VALUES[(j + i) % rotations],
+                                    Flip.VALUES[(jj + ii) % flips]))) {
                         return true;
                     }
                 }
             }
             return false;
-        }else {
+        } else {
             return checkedSetRotation(rotation);
         }
     }
 
-    default boolean checkedSetRotation(Rotation rotation){
-        if (isNewRotationValid(rotation)){
+    default boolean checkedSetRotation(Rotation rotation) {
+        if (isNewRotationValid(rotation)) {
             setRotation(rotation);
             return true;
         }
         return false;
     }
 
-    default boolean toolSetFlip(Flip flip){
-        if(flip==null){
+    default boolean toolSetFlip(Flip flip) {
+        if (flip == null) {
             for (int i = 1, j = getFlip().ordinal(), valuesLength = Flip.VALUES.length; i < valuesLength; i++) {
                 if (checkedSetFlip(Flip.VALUES[(j + i) % valuesLength])) {
                     return true;
                 }
             }
             return false;
-        }else {
+        } else {
             return checkedSetFlip(flip);
         }
     }
 
-    default boolean checkedSetFlip(Flip flip){
-        if (isNewFlipValid(flip)){
+    default boolean checkedSetFlip(Flip flip) {
+        if (isNewFlipValid(flip)) {
             setFlip(flip);
             return true;
         }
         return false;
     }
 
-    default boolean toolSetExtendedFacing(ExtendedFacing extendedFacing){
-        if(extendedFacing==null){
-            for (int i = 0,j=getExtendedFacing().ordinal()+1, valuesLength = ExtendedFacing.VALUES.length; i < valuesLength; i++) {
-                if (checkedSetExtendedFacing(ExtendedFacing.VALUES[(j + i)%valuesLength])){
+    default boolean toolSetExtendedFacing(ExtendedFacing extendedFacing) {
+        if (extendedFacing == null) {
+            for (int i = 0, j = getExtendedFacing().ordinal() + 1, valuesLength = ExtendedFacing.VALUES.length; i
+                    < valuesLength; i++) {
+                if (checkedSetExtendedFacing(ExtendedFacing.VALUES[(j + i) % valuesLength])) {
                     return true;
                 }
             }
             return false;
-        }else {
+        } else {
             return checkedSetExtendedFacing(extendedFacing);
         }
     }
 
-    default boolean checkedSetExtendedFacing(ExtendedFacing alignment){
-        if (isNewExtendedFacingValid(alignment)){
+    default boolean checkedSetExtendedFacing(ExtendedFacing alignment) {
+        if (isNewExtendedFacingValid(alignment)) {
             setExtendedFacing(alignment);
             return true;
         }
@@ -153,31 +165,53 @@ public interface IAlignment extends IAlignmentLimits,IAlignmentProvider {
     }
 
     default boolean isNewDirectionValid(ForgeDirection direction) {
-        return isNewExtendedFacingValid(direction,getRotation(),getFlip());
+        return isNewExtendedFacingValid(direction, getRotation(), getFlip());
     }
 
-    default boolean isNewRotationValid(Rotation rotation){
-        return isNewExtendedFacingValid(getDirection(),rotation,getFlip());
+    default boolean isNewRotationValid(Rotation rotation) {
+        return isNewExtendedFacingValid(getDirection(), rotation, getFlip());
     }
 
-    default boolean isNewFlipValid(Flip flip){
-        return isNewExtendedFacingValid(getDirection(),getRotation(),flip);
+    default boolean isNewFlipValid(Flip flip) {
+        return isNewExtendedFacingValid(getDirection(), getRotation(), flip);
     }
 
     default boolean isExtendedFacingValid() {
-        return isNewExtendedFacingValid(getDirection(),getRotation(),getFlip());
+        return isNewExtendedFacingValid(getDirection(), getRotation(), getFlip());
     }
 
     @Override
-    default boolean isNewExtendedFacingValid(ForgeDirection direction, Rotation rotation, Flip flip){
+    default boolean isNewExtendedFacingValid(ForgeDirection direction, Rotation rotation, Flip flip) {
         return getAlignmentLimits().isNewExtendedFacingValid(direction, rotation, flip);
     }
 
     @Override
-    default boolean isNewExtendedFacingValid(ExtendedFacing alignment){
-        return getAlignmentLimits().isNewExtendedFacingValid(
-                alignment.getDirection(),
-                alignment.getRotation(),
-                alignment.getFlip());
+    default boolean isNewExtendedFacingValid(ExtendedFacing alignment) {
+        return getAlignmentLimits()
+                .isNewExtendedFacingValid(alignment.getDirection(), alignment.getRotation(), alignment.getFlip());
     }
-}
+
+    /**
+     * Check if this object support a flip change, assuming both direction and rotation is not changed.
+     */
+    default boolean isFlipChangeAllowed() {
+        ExtendedFacing facing = getExtendedFacing();
+        for (Flip flip : Flip.VALUES) {
+            if (flip == getFlip()) continue;
+            if (isNewExtendedFacingValid(facing.with(flip))) return true;
+        }
+        return false;
+    }
+
+    /**
+     * Check if this object support a rotation change, assuming both direction and flip is not changed.
+     */
+    default boolean isRotationChangeAllowed() {
+        ExtendedFacing facing = getExtendedFacing();
+        for (Rotation rotation : Rotation.VALUES) {
+            if (rotation == getRotation()) continue;
+            if (isNewExtendedFacingValid(facing.with(rotation))) return true;
+        }
+        return false;
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/alignment/IAlignmentLimits.java

@@ -1,26 +1,45 @@
 package com.gtnewhorizon.structurelib.alignment;
-import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
-import com.gtnewhorizon.structurelib.alignment.enumerable.Flip;
-import com.gtnewhorizon.structurelib.alignment.enumerable.Rotation;
-import net.minecraftforge.common.util.ForgeDirection;
+
+import static com.gtnewhorizon.structurelib.alignment.IAlignment.STATES_COUNT;
 
 import java.util.Arrays;
 import java.util.Optional;
 import java.util.function.Function;
 
-import static com.gtnewhorizon.structurelib.alignment.IAlignment.STATES_COUNT;
+import net.minecraftforge.common.util.ForgeDirection;
+
+import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
+import com.gtnewhorizon.structurelib.alignment.enumerable.Flip;
+import com.gtnewhorizon.structurelib.alignment.enumerable.Rotation;
 
 public interface IAlignmentLimits {
 
+    /**
+     * Can be placed in any orientation.
+     */
     IAlignmentLimits UNLIMITED = (direction, rotation, flip) -> true;
 
+    /**
+     * Must be standing upright; i.e., top side of the block facing up.
+     */
+    IAlignmentLimits UPRIGHT = (direction, rotation, flip) -> direction.offsetY == 0
+            && (flip.isVerticallyFliped() ? rotation.isUpsideDown() : rotation.isNotRotated());
+
+    /**
+     * Can be in any orientation except upside down; i.e., top side of the block facing down.
+     */
+    IAlignmentLimits NOT_UPSIDE_DOWN = (direction, rotation, flip) -> direction.offsetY != 0
+            || (flip.isVerticallyFliped() ? !rotation.isNotRotated() : !rotation.isUpsideDown());
+
+    /**
+     * Front side of the block must be facing up.
+     */
+    IAlignmentLimits FACING_UP = (direction, rotation, flip) -> direction == ForgeDirection.UP;
+
     boolean isNewExtendedFacingValid(ForgeDirection direction, Rotation rotation, Flip flip);
 
     default boolean isNewExtendedFacingValid(ExtendedFacing alignment) {
-        return isNewExtendedFacingValid(
-                alignment.getDirection(),
-                alignment.getRotation(),
-                alignment.getFlip());
+        return isNewExtendedFacingValid(alignment.getDirection(), alignment.getRotation(), alignment.getFlip());
     }
 
     static IAlignmentLimits allowOnly(ExtendedFacing... allowedFacings) {
@@ -40,6 +59,7 @@ public interface IAlignmentLimits {
     }
 
     class Builder {
+
         protected final boolean[] validStates = new boolean[STATES_COUNT];
 
         private Builder() {}
@@ -57,12 +77,14 @@ public interface IAlignmentLimits {
         }
 
         public Builder deny(ForgeDirection fd) {
-            ExtendedFacing.getAllWith(fd).stream().mapToInt(ExtendedFacing::getIndex).forEach(v -> validStates[v] = false);
+            ExtendedFacing.getAllWith(fd).stream().mapToInt(ExtendedFacing::getIndex)
+                    .forEach(v -> validStates[v] = false);
             return this;
         }
 
         public Builder allow(ForgeDirection fd) {
-            ExtendedFacing.getAllWith(fd).stream().mapToInt(ExtendedFacing::getIndex).forEach(v -> validStates[v] = true);
+            ExtendedFacing.getAllWith(fd).stream().mapToInt(ExtendedFacing::getIndex)
+                    .forEach(v -> validStates[v] = true);
             return this;
         }
 
@@ -77,22 +99,26 @@ public interface IAlignmentLimits {
         }
 
         public Builder deny(Rotation fd) {
-            ExtendedFacing.getAllWith(fd).stream().mapToInt(ExtendedFacing::getIndex).forEach(v -> validStates[v] = false);
+            ExtendedFacing.getAllWith(fd).stream().mapToInt(ExtendedFacing::getIndex)
+                    .forEach(v -> validStates[v] = false);
             return this;
         }
 
         public Builder allow(Rotation fd) {
-            ExtendedFacing.getAllWith(fd).stream().mapToInt(ExtendedFacing::getIndex).forEach(v -> validStates[v] = true);
+            ExtendedFacing.getAllWith(fd).stream().mapToInt(ExtendedFacing::getIndex)
+                    .forEach(v -> validStates[v] = true);
             return this;
         }
 
         public Builder deny(Flip fd) {
-            ExtendedFacing.getAllWith(fd).stream().mapToInt(ExtendedFacing::getIndex).forEach(v -> validStates[v] = false);
+            ExtendedFacing.getAllWith(fd).stream().mapToInt(ExtendedFacing::getIndex)
+                    .forEach(v -> validStates[v] = false);
             return this;
         }
 
         public Builder allow(Flip fd) {
-            ExtendedFacing.getAllWith(fd).stream().mapToInt(ExtendedFacing::getIndex).forEach(v -> validStates[v] = true);
+            ExtendedFacing.getAllWith(fd).stream().mapToInt(ExtendedFacing::getIndex)
+                    .forEach(v -> validStates[v] = true);
             return this;
         }
 
@@ -113,7 +139,7 @@ public interface IAlignmentLimits {
         }
 
         /**
-         * Prefers rotation over flip, so both flip will get translated to opposite rotation and no flip
+         * Prefers rotation to flip, so both flip will get translated to opposite rotation and no flip
          *
          * @param flip the preferred flip to be used Horizontal or vertical
          * @return this

src/main/java/com/gtnewhorizon/structurelib/alignment/IAlignmentProvider.java

@@ -3,6 +3,7 @@ package com.gtnewhorizon.structurelib.alignment;
 import javax.annotation.Nullable;
 
 public interface IAlignmentProvider {
+
     @Nullable
     IAlignment getAlignment();
-}
+}

src/main/java/com/gtnewhorizon/structurelib/alignment/IntegerAxisSwap.java

@@ -1,13 +1,15 @@
 package com.gtnewhorizon.structurelib.alignment;
 
-import com.gtnewhorizon.structurelib.util.Vec3Impl;
-import com.gtnewhorizon.structurelib.alignment.enumerable.Direction;
-import net.minecraft.util.Vec3;
-import net.minecraftforge.common.util.ForgeDirection;
-
 import static java.lang.Math.abs;
 
+import net.minecraft.util.Vec3;
+import net.minecraftforge.common.util.ForgeDirection;
+
+import com.gtnewhorizon.structurelib.alignment.enumerable.Direction;
+import com.gtnewhorizon.structurelib.util.Vec3Impl;
+
 public class IntegerAxisSwap {
+
     private final Vec3Impl forFirstAxis;
     private final Vec3Impl forSecondAxis;
     private final Vec3Impl forThirdAxis;
@@ -16,69 +18,77 @@ public class IntegerAxisSwap {
         this.forFirstAxis = Direction.getAxisVector(forFirstAxis);
         this.forSecondAxis = Direction.getAxisVector(forSecondAxis);
         this.forThirdAxis = Direction.getAxisVector(forThirdAxis);
-        if(abs(this.forFirstAxis.get0())+abs(this.forSecondAxis.get0())+abs(this.forThirdAxis.get0())!=1 ||
-                abs(this.forFirstAxis.get1())+abs(this.forSecondAxis.get1())+abs(this.forThirdAxis.get1())!=1 ||
-                abs(this.forFirstAxis.get2())+abs(this.forSecondAxis.get2())+abs(this.forThirdAxis.get2())!=1){
-            throw new IllegalArgumentException("Axis are overlapping/missing! "+
-                    forFirstAxis.name()+" "+
-                    forSecondAxis.name()+" "+
-                    forThirdAxis.name());
+        if (abs(this.forFirstAxis.get0()) + abs(this.forSecondAxis.get0()) + abs(this.forThirdAxis.get0()) != 1
+                || abs(this.forFirstAxis.get1()) + abs(this.forSecondAxis.get1()) + abs(this.forThirdAxis.get1()) != 1
+                || abs(this.forFirstAxis.get2()) + abs(this.forSecondAxis.get2()) + abs(this.forThirdAxis.get2())
+                        != 1) {
+            throw new IllegalArgumentException(
+                    "Axis are overlapping/missing! " + forFirstAxis
+                            .name() + " " + forSecondAxis.name() + " " + forThirdAxis.name());
         }
     }
 
-    public Vec3Impl translate(Vec3Impl point){
+    public Vec3Impl translate(Vec3Impl point) {
         return new Vec3Impl(
-                forFirstAxis.get0()*point.get0() +forFirstAxis.get1()*point.get1() +forFirstAxis.get2()*point.get2(),
-                forSecondAxis.get0()*point.get0()+forSecondAxis.get1()*point.get1()+forSecondAxis.get2()*point.get2(),
-                forThirdAxis.get0()*point.get0() +forThirdAxis.get1()*point.get1() +forThirdAxis.get2()*point.get2()
-        );
+                forFirstAxis.get0() * point.get0() + forFirstAxis.get1() * point.get1()
+                        + forFirstAxis.get2() * point.get2(),
+                forSecondAxis.get0() * point.get0() + forSecondAxis.get1() * point.get1()
+                        + forSecondAxis.get2() * point.get2(),
+                forThirdAxis.get0() * point.get0() + forThirdAxis.get1() * point.get1()
+                        + forThirdAxis.get2() * point.get2());
     }
 
-    public Vec3Impl inverseTranslate(Vec3Impl point){
+    public Vec3Impl inverseTranslate(Vec3Impl point) {
         return new Vec3Impl(
-                forFirstAxis.get0()*point.get0()+forSecondAxis.get0()*point.get1()+forThirdAxis.get0()*point.get2(),
-                forFirstAxis.get1()*point.get0()+forSecondAxis.get1()*point.get1()+forThirdAxis.get1()*point.get2(),
-                forFirstAxis.get2()*point.get0()+forSecondAxis.get2()*point.get1()+forThirdAxis.get2()*point.get2()
-        );
+                forFirstAxis.get0() * point.get0() + forSecondAxis.get0() * point.get1()
+                        + forThirdAxis.get0() * point.get2(),
+                forFirstAxis.get1() * point.get0() + forSecondAxis.get1() * point.get1()
+                        + forThirdAxis.get1() * point.get2(),
+                forFirstAxis.get2() * point.get0() + forSecondAxis.get2() * point.get1()
+                        + forThirdAxis.get2() * point.get2());
     }
 
-    public Vec3 translate(Vec3 point){
+    public Vec3 translate(Vec3 point) {
         return Vec3.createVectorHelper(
-                forFirstAxis.get0()*point.xCoord +forFirstAxis.get1()*point.yCoord +forFirstAxis.get2()*point.zCoord,
-                forSecondAxis.get0()*point.xCoord+forSecondAxis.get1()*point.yCoord+forSecondAxis.get2()*point.zCoord,
-                forThirdAxis.get0()*point.xCoord +forThirdAxis.get1()*point.yCoord +forThirdAxis.get2()*point.zCoord
-        );
+                forFirstAxis.get0() * point.xCoord + forFirstAxis.get1() * point.yCoord
+                        + forFirstAxis.get2() * point.zCoord,
+                forSecondAxis.get0() * point.xCoord + forSecondAxis.get1() * point.yCoord
+                        + forSecondAxis.get2() * point.zCoord,
+                forThirdAxis.get0() * point.xCoord + forThirdAxis.get1() * point.yCoord
+                        + forThirdAxis.get2() * point.zCoord);
     }
 
-    public Vec3 inverseTranslate(Vec3 point){
+    public Vec3 inverseTranslate(Vec3 point) {
         return Vec3.createVectorHelper(
-                forFirstAxis.get0()*point.xCoord+forSecondAxis.get0()*point.yCoord+forThirdAxis.get0()*point.zCoord,
-                forFirstAxis.get1()*point.xCoord+forSecondAxis.get1()*point.yCoord+forThirdAxis.get1()*point.zCoord,
-                forFirstAxis.get2()*point.xCoord+forSecondAxis.get2()*point.yCoord+forThirdAxis.get2()*point.zCoord
-        );
-    }
-    
-    public void translate(int[] point,int[] out){
-        out[0]=forFirstAxis.get0()*point[0] +forFirstAxis.get1()*point[1] +forFirstAxis.get2()*point[2];
-        out[1]=forSecondAxis.get0()*point[0]+forSecondAxis.get1()*point[1]+forSecondAxis.get2()*point[2];
-        out[2]=forThirdAxis.get0()*point[0] +forThirdAxis.get1()*point[1] +forThirdAxis.get2()*point[2];
+                forFirstAxis.get0() * point.xCoord + forSecondAxis.get0() * point.yCoord
+                        + forThirdAxis.get0() * point.zCoord,
+                forFirstAxis.get1() * point.xCoord + forSecondAxis.get1() * point.yCoord
+                        + forThirdAxis.get1() * point.zCoord,
+                forFirstAxis.get2() * point.xCoord + forSecondAxis.get2() * point.yCoord
+                        + forThirdAxis.get2() * point.zCoord);
     }
 
-    public void inverseTranslate(int[] point,int[] out){
-        out[0]=forFirstAxis.get0()*point[0]+forSecondAxis.get0()*point[1]+forThirdAxis.get0()*point[2];
-        out[1]=forFirstAxis.get1()*point[0]+forSecondAxis.get1()*point[1]+forThirdAxis.get1()*point[2];
-        out[2]=forFirstAxis.get2()*point[0]+forSecondAxis.get2()*point[1]+forThirdAxis.get2()*point[2];
+    public void translate(int[] point, int[] out) {
+        out[0] = forFirstAxis.get0() * point[0] + forFirstAxis.get1() * point[1] + forFirstAxis.get2() * point[2];
+        out[1] = forSecondAxis.get0() * point[0] + forSecondAxis.get1() * point[1] + forSecondAxis.get2() * point[2];
+        out[2] = forThirdAxis.get0() * point[0] + forThirdAxis.get1() * point[1] + forThirdAxis.get2() * point[2];
     }
 
-    public void translate(double[] point,double[] out){
-        out[0]=forFirstAxis.get0()*point[0] +forFirstAxis.get1()*point[1] +forFirstAxis.get2()*point[2];
-        out[1]=forSecondAxis.get0()*point[0]+forSecondAxis.get1()*point[1]+forSecondAxis.get2()*point[2];
-        out[2]=forThirdAxis.get0()*point[0] +forThirdAxis.get1()*point[1] +forThirdAxis.get2()*point[2];
+    public void inverseTranslate(int[] point, int[] out) {
+        out[0] = forFirstAxis.get0() * point[0] + forSecondAxis.get0() * point[1] + forThirdAxis.get0() * point[2];
+        out[1] = forFirstAxis.get1() * point[0] + forSecondAxis.get1() * point[1] + forThirdAxis.get1() * point[2];
+        out[2] = forFirstAxis.get2() * point[0] + forSecondAxis.get2() * point[1] + forThirdAxis.get2() * point[2];
     }
 
-    public void inverseTranslate(double[] point,double[] out){
-        out[0]=forFirstAxis.get0()*point[0]+forSecondAxis.get0()*point[1]+forThirdAxis.get0()*point[2];
-        out[1]=forFirstAxis.get1()*point[0]+forSecondAxis.get1()*point[1]+forThirdAxis.get1()*point[2];
-        out[2]=forFirstAxis.get2()*point[0]+forSecondAxis.get2()*point[1]+forThirdAxis.get2()*point[2];
+    public void translate(double[] point, double[] out) {
+        out[0] = forFirstAxis.get0() * point[0] + forFirstAxis.get1() * point[1] + forFirstAxis.get2() * point[2];
+        out[1] = forSecondAxis.get0() * point[0] + forSecondAxis.get1() * point[1] + forSecondAxis.get2() * point[2];
+        out[2] = forThirdAxis.get0() * point[0] + forThirdAxis.get1() * point[1] + forThirdAxis.get2() * point[2];
+    }
+
+    public void inverseTranslate(double[] point, double[] out) {
+        out[0] = forFirstAxis.get0() * point[0] + forSecondAxis.get0() * point[1] + forThirdAxis.get0() * point[2];
+        out[1] = forFirstAxis.get1() * point[0] + forSecondAxis.get1() * point[1] + forThirdAxis.get1() * point[2];
+        out[2] = forFirstAxis.get2() * point[0] + forSecondAxis.get2() * point[1] + forThirdAxis.get2() * point[2];
     }
 }

src/main/java/com/gtnewhorizon/structurelib/alignment/constructable/ChannelDataAccessor.java

@@ -0,0 +1,177 @@
+package com.gtnewhorizon.structurelib.alignment.constructable;
+
+import static com.gtnewhorizon.structurelib.util.MiscUtils.getTagKeys;
+import static net.minecraftforge.common.util.Constants.NBT.TAG_COMPOUND;
+
+import java.util.Locale;
+import java.util.Map.Entry;
+import java.util.stream.Stream;
+
+import net.minecraft.init.Items;
+import net.minecraft.item.ItemStack;
+import net.minecraft.nbt.NBTTagCompound;
+import net.minecraftforge.common.util.Constants.NBT;
+
+import org.apache.commons.lang3.StringUtils;
+import org.apache.commons.lang3.tuple.ImmutablePair;
+
+import com.gtnewhorizon.structurelib.StructureLibAPI;
+
+/**
+ * Provide accessor methods for channel data from trigger item.
+ *
+ * <a href="{@docRoot}/overview-summary.html#channels">Channels section on overview</a>
+ */
+public class ChannelDataAccessor {
+
+    private static final String SECONDARY_HINT_TAG = "channels";
+
+    private ChannelDataAccessor() {}
+
+    /**
+     * Return a trigger item that
+     * <ul>
+     * <li>Still carry all the subchannel in some unspecified ways</li>
+     * <li>Have its master channel data replaced with specified subchannel's data</li>
+     * </ul>
+     *
+     * If given subchannel does not exist, masterStack may or may not be returned to save performance. Code within
+     * StructureLib can depend on this behavior, you cannot.
+     *
+     * @param masterStack trigger item. can be the return value of another {@link #withChannel(ItemStack, String)} call
+     * @param channel     subchannel to use. will use current master channel data instead if this channel does not exist
+     *                    Note: all channel identifiers are supposed to be lower case and not empty.
+     * @return a trigger item with new master channel
+     */
+    public static ItemStack withChannel(ItemStack masterStack, String channel) {
+        if (StringUtils.isEmpty(channel) || masterStack == null) throw new IllegalArgumentException();
+        if (StructureLibAPI.isDebugEnabled() && !channel.toLowerCase(Locale.ROOT).equals(channel))
+            throw new IllegalArgumentException("Channel name can be lower case ONLY");
+        if (!masterStack.hasTagCompound() || !masterStack.stackTagCompound.hasKey(SECONDARY_HINT_TAG, TAG_COMPOUND)
+                || !masterStack.stackTagCompound.getCompoundTag(SECONDARY_HINT_TAG).hasKey(channel, NBT.TAG_INT))
+            return masterStack;
+        ItemStack ret = new ItemStack(
+                masterStack.getItem(),
+                masterStack.stackTagCompound.getCompoundTag(SECONDARY_HINT_TAG).getInteger(channel),
+                Items.feather.getDamage(masterStack));
+        ret.setTagCompound(masterStack.stackTagCompound);
+        return ret;
+    }
+
+    /**
+     * Check if given trigger item contains any subchannel
+     * 
+     * @param masterStack trigger stack to check
+     * @return true if contains any subchannel
+     */
+    public static boolean hasSubChannel(ItemStack masterStack) {
+        if (masterStack == null) throw new IllegalArgumentException();
+        return masterStack.hasTagCompound() && masterStack.stackTagCompound.hasKey(SECONDARY_HINT_TAG, TAG_COMPOUND);
+    }
+
+    /**
+     * Check if given trigger item contains specified subchannel
+     * 
+     * @param masterStack trigger stack to check
+     * @param channel     channel identifier. Note: all channel identifiers are supposed to be lower case and not empty.
+     * @return true if contains specified subchannel
+     */
+    public static boolean hasSubChannel(ItemStack masterStack, String channel) {
+        if (StringUtils.isEmpty(channel) || masterStack == null) throw new IllegalArgumentException();
+        if (StructureLibAPI.isDebugEnabled() && !channel.toLowerCase(Locale.ROOT).equals(channel))
+            throw new IllegalArgumentException("Channel name can be lower case ONLY");
+        return !channel.isEmpty() && masterStack.hasTagCompound()
+                && masterStack.stackTagCompound.hasKey(SECONDARY_HINT_TAG, TAG_COMPOUND)
+                && masterStack.stackTagCompound.getCompoundTag(SECONDARY_HINT_TAG).hasKey(channel, NBT.TAG_INT);
+    }
+
+    /**
+     * Get the subchannel data from given trigger item. Will use master channel instead if not present.
+     * 
+     * @param masterStack trigger stack to query from
+     * @param channel     channel identifier. Note: all channel identifiers are supposed to be lower case and not empty.
+     * @return channel data
+     */
+    public static int getChannelData(ItemStack masterStack, String channel) {
+        if (StringUtils.isEmpty(channel) || masterStack == null) throw new IllegalArgumentException();
+        if (StructureLibAPI.isDebugEnabled() && !channel.toLowerCase(Locale.ROOT).equals(channel))
+            throw new IllegalArgumentException("Channel name can be lower case ONLY");
+        if (!masterStack.hasTagCompound() || !masterStack.stackTagCompound.hasKey(SECONDARY_HINT_TAG, TAG_COMPOUND)
+                || !masterStack.stackTagCompound.getCompoundTag(SECONDARY_HINT_TAG).hasKey(channel, NBT.TAG_INT))
+            return masterStack.stackSize;
+        return masterStack.stackTagCompound.getCompoundTag(SECONDARY_HINT_TAG).getInteger(channel);
+    }
+
+    /**
+     * Set the subchannel data on given trigger item
+     * 
+     * @param masterStack trigger stack to check
+     * @param channel     channel identifier. Note: all channel identifiers are supposed to be lower case and not empty.
+     * @param data        subchannel data. should always be a positive value
+     */
+    public static void setChannelData(ItemStack masterStack, String channel, int data) {
+        if (StringUtils.isEmpty(channel) || masterStack == null) throw new IllegalArgumentException();
+        if (StructureLibAPI.isDebugEnabled() && !channel.toLowerCase(Locale.ROOT).equals(channel))
+            throw new IllegalArgumentException("Channel name can be lower case ONLY");
+        if (data <= 0) throw new IllegalArgumentException();
+        if (masterStack.stackTagCompound == null) masterStack.stackTagCompound = new NBTTagCompound();
+        NBTTagCompound main = masterStack.stackTagCompound;
+        if (!main.hasKey(SECONDARY_HINT_TAG, TAG_COMPOUND)) main.setTag(SECONDARY_HINT_TAG, new NBTTagCompound());
+        main.getCompoundTag(SECONDARY_HINT_TAG).setInteger(channel, data);
+    }
+
+    /**
+     * Clear the given subchannel from given trigger item, if it exists
+     * 
+     * @param masterStack trigger stack to unset
+     * @param channel     channel identifier. Note: all channel identifiers are supposed to be lower case and not empty.
+     */
+    public static void unsetChannelData(ItemStack masterStack, String channel) {
+        if (StringUtils.isEmpty(channel) || masterStack == null) throw new IllegalArgumentException();
+        if (StructureLibAPI.isDebugEnabled() && !channel.toLowerCase(Locale.ROOT).equals(channel))
+            throw new IllegalArgumentException("Channel name can be lower case ONLY");
+        if (masterStack.stackTagCompound == null) masterStack.stackTagCompound = new NBTTagCompound();
+        NBTTagCompound main = masterStack.stackTagCompound;
+        if (!main.hasKey(SECONDARY_HINT_TAG, TAG_COMPOUND)) main.setTag(SECONDARY_HINT_TAG, new NBTTagCompound());
+        NBTTagCompound tag = main.getCompoundTag(SECONDARY_HINT_TAG);
+        tag.removeTag(channel);
+        if (tag.hasNoTags()) main.removeTag(SECONDARY_HINT_TAG);
+        if (main.hasNoTags()) masterStack.stackTagCompound = null;
+    }
+
+    /**
+     * Wipe all subchannel data on given trigger item
+     * 
+     * @param masterStack trigger stack to wipe
+     */
+    public static void wipeChannelData(ItemStack masterStack) {
+        if (masterStack == null) throw new IllegalArgumentException();
+        if (masterStack.stackTagCompound != null) masterStack.stackTagCompound.removeTag(SECONDARY_HINT_TAG);
+    }
+
+    /**
+     * Iterate over all subchannel data on trigger stack. Does not include master channel!!
+     * 
+     * @param masterStack trigger stack to check
+     * @return A java8 stream of pairs. Key is channel identifier and value is channel data. Pairs do not support
+     *         mutation nor removal. Can still cause {@link java.util.ConcurrentModificationException} if underlying
+     *         channel data is modified while stream is working.
+     */
+    public static Stream<Entry<String, Integer>> iterateChannelData(ItemStack masterStack) {
+        if (!hasSubChannel(masterStack)) return Stream.empty();
+        NBTTagCompound tag = masterStack.stackTagCompound.getCompoundTag(SECONDARY_HINT_TAG);
+        return getTagKeys(tag).stream().map(s -> new ImmutablePair<>(s, tag.getInteger(s)));
+    }
+
+    /**
+     * Get the number of subchannels present on given trigger item. Does not include master channel.
+     * 
+     * @param masterStack trigger stack to query from
+     * @return subchannel count
+     */
+    public static int countChannelData(ItemStack masterStack) {
+        if (!hasSubChannel(masterStack)) return 0;
+        NBTTagCompound tag = masterStack.stackTagCompound.getCompoundTag(SECONDARY_HINT_TAG);
+        return tag.func_150296_c().size();
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/alignment/constructable/ConstructableUtility.java

@@ -1,82 +1,123 @@
 package com.gtnewhorizon.structurelib.alignment.constructable;
 
-import com.gtnewhorizon.structurelib.StructureLib;
-import com.gtnewhorizon.structurelib.StructureLibAPI;
-import com.gtnewhorizon.structurelib.alignment.IAlignment;
-import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
+import java.util.WeakHashMap;
+
 import net.minecraft.entity.player.EntityPlayer;
 import net.minecraft.entity.player.EntityPlayerMP;
 import net.minecraft.item.ItemStack;
 import net.minecraft.tileentity.TileEntity;
+import net.minecraft.util.ChatComponentTranslation;
 import net.minecraft.world.World;
 import net.minecraftforge.common.util.FakePlayer;
 import net.minecraftforge.common.util.ForgeDirection;
 
+import com.gtnewhorizon.structurelib.ConfigurationHandler;
+import com.gtnewhorizon.structurelib.StructureLib;
+import com.gtnewhorizon.structurelib.StructureLibAPI;
+import com.gtnewhorizon.structurelib.alignment.IAlignment;
+import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
+import com.gtnewhorizon.structurelib.fluid.FluidSourceProviders;
+import com.gtnewhorizon.structurelib.structure.IItemSource;
+import com.gtnewhorizon.structurelib.structure.ISurvivalBuildEnvironment;
+
 public class ConstructableUtility {
-    private ConstructableUtility() {
 
-    }
+    private static final WeakHashMap<EntityPlayerMP, Long> lastUse = new WeakHashMap<>();
+    private static long clientSideLastUse = 0;
 
-    public static boolean handle(ItemStack aStack, EntityPlayer aPlayer, World aWorld, int aX, int aY, int aZ, int aSide) {
+    private ConstructableUtility() {}
+
+    public static boolean handle(ItemStack aStack, EntityPlayer aPlayer, World aWorld, int aX, int aY, int aZ,
+            int aSide) {
         StructureLibAPI.startHinting(aWorld);
         boolean ret = handle0(aStack, aPlayer, aWorld, aX, aY, aZ, aSide);
         StructureLibAPI.endHinting(aWorld);
         return ret;
     }
 
-    private static boolean handle0(ItemStack aStack, EntityPlayer aPlayer, World aWorld, int aX, int aY, int aZ, int aSide) {
+    private static boolean handle0(ItemStack aStack, EntityPlayer aPlayer, World aWorld, int aX, int aY, int aZ,
+            int aSide) {
         TileEntity tTileEntity = aWorld.getTileEntity(aX, aY, aZ);
         if (tTileEntity == null || aPlayer instanceof FakePlayer) {
             return aPlayer instanceof EntityPlayerMP;
         }
         if (aPlayer instanceof EntityPlayerMP) {
-            //struct gen
-            if (aPlayer.isSneaking() && aPlayer.capabilities.isCreativeMode) {
-                if (tTileEntity instanceof IConstructableProvider) {
-                    IConstructable constructable = ((IConstructableProvider) tTileEntity).getConstructable();
-                    if (constructable != null) {
-                        constructable.construct(aStack, false);
-                    }
-                } else if (tTileEntity instanceof IConstructable) {
-                    ((IConstructable) tTileEntity).construct(aStack, false);
-                } else if (IMultiblockInfoContainer.contains(tTileEntity.getClass())) {
-                    IMultiblockInfoContainer<TileEntity> iMultiblockInfoContainer = IMultiblockInfoContainer.get(tTileEntity.getClass());
-                    if (tTileEntity instanceof IAlignment) {
-                        iMultiblockInfoContainer.construct(aStack, false, tTileEntity,
-                                ((IAlignment) tTileEntity).getExtendedFacing());
-                    } else {
-                        iMultiblockInfoContainer.construct(aStack, false, tTileEntity,
-                                ExtendedFacing.of(ForgeDirection.getOrientation(aSide)));
-                    }
+            // not sneaking - client side will generate hologram. nothing to do on server side
+            if (!aPlayer.isSneaking()) return true;
+
+            long timePast = System.currentTimeMillis() - getLastUseMilis(aPlayer);
+            if (timePast < ConfigurationHandler.INSTANCE.getAutoPlaceInterval()) {
+                aPlayer.addChatComponentMessage(
+                        new ChatComponentTranslation(
+                                "item.structurelib.constructableTrigger.too_fast",
+                                ConfigurationHandler.INSTANCE.getAutoPlaceInterval() - timePast));
+                return true;
+            }
+        } else if (!StructureLib.isCurrentPlayer(aPlayer)) {
+            return false;
+        }
+
+        IConstructable constructable = null;
+        if (tTileEntity instanceof IConstructableProvider)
+            constructable = ((IConstructableProvider) tTileEntity).getConstructable();
+        else if (tTileEntity instanceof IConstructable) {
+            constructable = (IConstructable) tTileEntity;
+        } else if (IMultiblockInfoContainer.contains(tTileEntity.getClass())) {
+            ExtendedFacing facing = tTileEntity instanceof IAlignment ? ((IAlignment) tTileEntity).getExtendedFacing()
+                    : ExtendedFacing.of(ForgeDirection.getOrientation(aSide));
+            constructable = IMultiblockInfoContainer.<TileEntity>get(tTileEntity.getClass())
+                    .toConstructable(tTileEntity, facing);
+        }
+
+        if (constructable == null) return false;
+
+        if (aPlayer instanceof EntityPlayerMP playerMP) {
+            // server side and sneaking (already checked above)
+            // do construct
+            if (aPlayer.capabilities.isCreativeMode) {
+                constructable.construct(aStack, false);
+            } else if (constructable instanceof ISurvivalConstructable) {
+                int built = ((ISurvivalConstructable) constructable).survivalConstruct(
+                        aStack,
+                        ConfigurationHandler.INSTANCE.getAutoPlaceBudget(),
+                        ISurvivalBuildEnvironment.create(
+                                IItemSource.fromPlayer(playerMP),
+                                // What the player can offer: every registered fluid source provider, e.g. the ME
+                                // network
+                                // behind a wireless terminal they have on them, and then the fluid they are carrying.
+                                FluidSourceProviders.getSourceFor(playerMP),
+                                playerMP));
+                if (built > 0) {
+                    playerMP.addChatMessage(new ChatComponentTranslation("structurelib.autoplace.built_stat", built));
+                } else if (built == -1) {
+                    playerMP.addChatMessage(new ChatComponentTranslation("structurelib.autoplace.complete"));
                 }
+                setLastUseMilis(aPlayer);
+            } else {
+                playerMP.addChatMessage(new ChatComponentTranslation("structurelib.autoplace.error.not_enabled"));
             }
             return true;
-        } else if (StructureLib.isCurrentPlayer(aPlayer)) {//particles and text client side
-            //if ((!aPlayer.isSneaking() || !aPlayer.capabilities.isCreativeMode)) {
-            if (tTileEntity instanceof IConstructableProvider) {
-                IConstructable constructable = ((IConstructableProvider) tTileEntity).getConstructable();
-                if (constructable != null) {
-                    constructable.construct(aStack, true);
-                    StructureLib.addClientSideChatMessages(constructable.getStructureDescription(aStack));
-                }
-            } else if (tTileEntity instanceof IConstructable) {
-                IConstructable constructable = (IConstructable) tTileEntity;
-                constructable.construct(aStack, true);
-                StructureLib.addClientSideChatMessages(constructable.getStructureDescription(aStack));
-                return false;
-            } else if (IMultiblockInfoContainer.contains(tTileEntity.getClass())) {
-                IMultiblockInfoContainer<TileEntity> iMultiblockInfoContainer = IMultiblockInfoContainer.get(tTileEntity.getClass());
-                if (tTileEntity instanceof IAlignment) {
-                    iMultiblockInfoContainer.construct(aStack, true, tTileEntity,
-                            ((IAlignment) tTileEntity).getExtendedFacing());
-                } else {
-                    iMultiblockInfoContainer.construct(aStack, true, tTileEntity,
-                            ExtendedFacing.of(ForgeDirection.getOrientation(aSide)));
-                }
-                StructureLib.addClientSideChatMessages(IMultiblockInfoContainer.get(tTileEntity.getClass()).getDescription(aStack));
-                return false;
-            }
         }
+        // client side
+        // particles and text
+        constructable.construct(aStack, true);
+        if (System.currentTimeMillis() - getLastUseMilis(aPlayer) >= 300)
+            StructureLib.addClientSideChatMessages(constructable.getStructureDescription(aStack));
+        setLastUseMilis(aPlayer);
         return false;
     }
+
+    private static void setLastUseMilis(EntityPlayer aPlayer) {
+        if (!(aPlayer instanceof EntityPlayerMP))
+            // assume client side
+            clientSideLastUse = System.currentTimeMillis();
+        else lastUse.put((EntityPlayerMP) aPlayer, System.currentTimeMillis());
+    }
+
+    private static long getLastUseMilis(EntityPlayer aPlayer) {
+        if (!(aPlayer instanceof EntityPlayerMP))
+            // assume client side
+            return clientSideLastUse;
+        return lastUse.getOrDefault(aPlayer, 0L);
+    }
 }

src/main/java/com/gtnewhorizon/structurelib/alignment/constructable/IConstructable.java

@@ -1,16 +1,26 @@
 package com.gtnewhorizon.structurelib.alignment.constructable;
 
+import net.minecraft.item.ItemStack;
+
+import com.gtnewhorizon.structurelib.structure.IStructureDefinition;
+
 import cpw.mods.fml.relauncher.Side;
 import cpw.mods.fml.relauncher.SideOnly;
-import net.minecraft.item.ItemStack;
 
 /**
  * Created by Tec on 24.03.2017.
  */
 public interface IConstructable {
+
     void construct(ItemStack stackSize, boolean hintsOnly);
 
+    /**
+     * Get the structure definition used for this constructable. Can be null if this constructable is not backed by one.
+     */
+    default IStructureDefinition<?> getStructureDefinition() {
+        return null;
+    }
+
     @SideOnly(Side.CLIENT)
     String[] getStructureDescription(ItemStack stackSize);
 }
-

src/main/java/com/gtnewhorizon/structurelib/alignment/constructable/IConstructableProvider.java

@@ -6,9 +6,10 @@ import javax.annotation.Nullable;
  * Implement this interface if this tile entity MIGHT be constructable
  */
 public interface IConstructableProvider {
-	/**
-	 * @return null if not constructable, an instance otherwise.
-	 */
-	@Nullable
-	IConstructable getConstructable();
+
+    /**
+     * @return null if not constructable, an instance otherwise.
+     */
+    @Nullable
+    IConstructable getConstructable();
 }

src/main/java/com/gtnewhorizon/structurelib/alignment/constructable/IMultiblockInfoContainer.java

@@ -1,17 +1,25 @@
 package com.gtnewhorizon.structurelib.alignment.constructable;
 
-import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
-import cpw.mods.fml.relauncher.Side;
-import cpw.mods.fml.relauncher.SideOnly;
+import java.util.HashMap;
+
+import net.minecraft.entity.player.EntityPlayerMP;
 import net.minecraft.item.ItemStack;
 import net.minecraft.tileentity.TileEntity;
+import net.minecraft.world.World;
 
-import java.util.HashMap;
+import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
+import com.gtnewhorizon.structurelib.structure.AutoPlaceEnvironment;
+import com.gtnewhorizon.structurelib.structure.IItemSource;
+import com.gtnewhorizon.structurelib.structure.ISurvivalBuildEnvironment;
+
+import cpw.mods.fml.relauncher.Side;
+import cpw.mods.fml.relauncher.SideOnly;
 
 /**
  * To implement IConstructable on not own TileEntities
  */
 public interface IMultiblockInfoContainer<T> {
+
     HashMap<String, IMultiblockInfoContainer<?>> MULTIBLOCK_MAP = new HashMap<>();
 
     /**
@@ -33,6 +41,47 @@ public interface IMultiblockInfoContainer<T> {
 
     void construct(ItemStack stackSize, boolean hintsOnly, T tileEntity, ExtendedFacing aSide);
 
+    /**
+     * Construct the structure using
+     * {@link com.gtnewhorizon.structurelib.structure.IStructureElement#survivalPlaceBlock(Object, World, int, int, int, ItemStack, AutoPlaceEnvironment)}
+     *
+     * @return -1 if done, a helping pointer
+     */
+    int survivalConstruct(ItemStack stackSize, int elementBudge, ISurvivalBuildEnvironment env, T tileEntity,
+            ExtendedFacing aSide);
+
     @SideOnly(Side.CLIENT)
     String[] getDescription(ItemStack stackSize);
+
+    default ISurvivalConstructable toConstructable(T tileEntity, ExtendedFacing aSide) {
+        return new ISurvivalConstructable() {
+
+            @Override
+            public int survivalConstruct(ItemStack stackSize, int elementBudget, ISurvivalBuildEnvironment env) {
+                return IMultiblockInfoContainer.this
+                        .survivalConstruct(stackSize, elementBudget, env, tileEntity, aSide);
+            }
+
+            @Override
+            public int survivalConstruct(ItemStack stackSize, int elementBudget, IItemSource source,
+                    EntityPlayerMP actor) {
+                return IMultiblockInfoContainer.this.survivalConstruct(
+                        stackSize,
+                        elementBudget,
+                        ISurvivalBuildEnvironment.create(source, actor),
+                        tileEntity,
+                        aSide);
+            }
+
+            @Override
+            public void construct(ItemStack stackSize, boolean hintsOnly) {
+                IMultiblockInfoContainer.this.construct(stackSize, hintsOnly, tileEntity, aSide);
+            }
+
+            @Override
+            public String[] getStructureDescription(ItemStack stackSize) {
+                return IMultiblockInfoContainer.this.getDescription(stackSize);
+            }
+        };
+    }
 }

src/main/java/com/gtnewhorizon/structurelib/alignment/constructable/ISurvivalConstructable.java

@@ -0,0 +1,85 @@
+package com.gtnewhorizon.structurelib.alignment.constructable;
+
+import net.minecraft.entity.player.EntityPlayer;
+import net.minecraft.entity.player.EntityPlayerMP;
+import net.minecraft.item.ItemStack;
+import net.minecraft.world.World;
+
+import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
+import com.gtnewhorizon.structurelib.structure.AutoPlaceEnvironment;
+import com.gtnewhorizon.structurelib.structure.IItemSource;
+import com.gtnewhorizon.structurelib.structure.ISurvivalBuildEnvironment;
+
+/**
+ * An extension to {@link IConstructable}. Tile Entities (or delegates returned by
+ * {@link IConstructableProvider#getConstructable()} should implement this interface to allow third party tools and
+ * StructureLib builtin constructable tools to trigger autoplace in survival mode.
+ * <p>
+ * While not originally planned, a creative player can also use this interface to trigger autoplace by using an
+ * {@link IItemSource} with every possible items in the game.
+ */
+public interface ISurvivalConstructable extends IConstructable {
+
+    /**
+     * End player might want to disable this hack if it turns out to be too crashy
+     */
+    boolean DISABLE_HACKY_MIGRATION_CODE = Boolean.getBoolean("structurelib.disable_isc_migration_hack");
+
+    /**
+     * Construct the structure using
+     * {@link com.gtnewhorizon.structurelib.structure.IStructureElement#survivalPlaceBlock(Object, World, int, int, int, ItemStack, IItemSource, EntityPlayerMP, java.util.function.Consumer)}
+     * or
+     * {@link com.gtnewhorizon.structurelib.structure.IStructureDefinition#survivalBuild(Object, ItemStack, String, World, ExtendedFacing, int, int, int, int, int, int, int, IItemSource, EntityPlayerMP, boolean)}
+     *
+     * @param elementBudget The server configured element budget. The implementor can choose to tune this up a bit if
+     *                      the structure is too big, but generally should not be a 4 digits number to not overwhelm the
+     *                      server
+     * @return -1 if done, otherwise number of elements placed this round
+     */
+    @Deprecated
+    default int survivalConstruct(ItemStack stackSize, int elementBudget, IItemSource source, EntityPlayerMP actor) {
+        return survivalConstruct(stackSize, elementBudget, ISurvivalBuildEnvironment.create(source, actor));
+    }
+
+    /**
+     * Construct the structure using
+     * {@link com.gtnewhorizon.structurelib.structure.IStructureElement#survivalPlaceBlock(Object, World, int, int, int, ItemStack, AutoPlaceEnvironment)}
+     * or
+     * {@link com.gtnewhorizon.structurelib.structure.IStructureDefinition#survivalBuild(Object, ItemStack, String, World, ExtendedFacing, int, int, int, int, int, int, int, ISurvivalBuildEnvironment, boolean)}
+     *
+     * @param elementBudget The server configured element budget. The implementor can choose to tune this up a bit if
+     *                      the structure is too big, but generally should not be a 4 digits number to not overwhelm the
+     *                      server
+     * @return -1 if done, -2 if not supported (e.g. due to an incompatible change in the API of env, otherwise number
+     *         of elements placed this round
+     */
+    default int survivalConstruct(ItemStack stackSize, int elementBudget, ISurvivalBuildEnvironment env) {
+        EntityPlayer actor = env.getActor();
+        if (actor instanceof EntityPlayerMP)
+            return survivalConstruct(stackSize, elementBudget, env.getSource(), (EntityPlayerMP) actor);
+        else if (!DISABLE_HACKY_MIGRATION_CODE && __get_player() == null) {
+            // as far as I know, no implementor would actually do anything to actor beyond passing it down to
+            // IStructureDefinition, so it's probably fine to proceed like this
+            GlobalStates.entityPlayer.set(env.getActor());
+            try {
+                return survivalConstruct(stackSize, elementBudget, env.getSource(), null);
+            } finally {
+                GlobalStates.entityPlayer.remove();
+            }
+        }
+        return -2;
+    }
+
+    /**
+     * Internal hack. Do not use.
+     */
+    @Deprecated
+    static EntityPlayer __get_player() {
+        return GlobalStates.entityPlayer.get();
+    }
+}
+
+class GlobalStates {
+
+    public static final ThreadLocal<EntityPlayer> entityPlayer = new ThreadLocal<>();
+}

src/main/java/com/gtnewhorizon/structurelib/alignment/constructable/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * This package contains interfaces and utility methods for autobuilding a structure.
+ */
+package com.gtnewhorizon.structurelib.alignment.constructable;

src/main/java/com/gtnewhorizon/structurelib/alignment/enumerable/Direction.java

@@ -1,9 +1,16 @@
 package com.gtnewhorizon.structurelib.alignment.enumerable;
 
-import com.gtnewhorizon.structurelib.util.Vec3Impl;
+import java.util.Arrays;
+import java.util.Map;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+
 import net.minecraftforge.common.util.ForgeDirection;
 
+import com.gtnewhorizon.structurelib.util.Vec3Impl;
+
 public enum Direction {
+
     DOWN(ForgeDirection.DOWN),
     UP(ForgeDirection.UP),
     NORTH(ForgeDirection.NORTH),
@@ -13,11 +20,13 @@ public enum Direction {
 
     private final ForgeDirection forgeDirection;
     private final Vec3Impl axisVector;
-    public static final Direction[] VALUES=values();
+    public static final Direction[] VALUES = values();
+    private static final Map<Vec3Impl, Direction> reverseMap = Arrays.stream(VALUES)
+            .collect(Collectors.toMap(d -> d.axisVector, Function.identity()));
 
     Direction(ForgeDirection forgeDirection) {
         this.forgeDirection = forgeDirection;
-        axisVector=new Vec3Impl(forgeDirection.offsetX,forgeDirection.offsetY,forgeDirection.offsetZ);
+        axisVector = Vec3Impl.getFromPool(forgeDirection.offsetX, forgeDirection.offsetY, forgeDirection.offsetZ);
     }
 
     public ForgeDirection getForgeDirection() {
@@ -28,7 +37,11 @@ public enum Direction {
         return axisVector;
     }
 
-    public static Vec3Impl getAxisVector(ForgeDirection forgeDirection){
+    public static Vec3Impl getAxisVector(ForgeDirection forgeDirection) {
         return VALUES[forgeDirection.ordinal()].axisVector;
     }
+
+    public static Direction getByAxisVector(Vec3Impl vec3) {
+        return reverseMap.get(vec3);
+    }
 }

src/main/java/com/gtnewhorizon/structurelib/alignment/enumerable/ExtendedFacing.java

@@ -1,21 +1,33 @@
 package com.gtnewhorizon.structurelib.alignment.enumerable;
 
-import com.google.common.collect.ImmutableSet;
-import com.gtnewhorizon.structurelib.alignment.IAlignment;
-import com.gtnewhorizon.structurelib.alignment.IntegerAxisSwap;
-import com.gtnewhorizon.structurelib.util.Vec3Impl;
-import net.minecraft.util.Vec3;
-import net.minecraftforge.common.util.ForgeDirection;
-
-import java.util.*;
-
 import static com.gtnewhorizon.structurelib.alignment.IAlignment.FLIPS_COUNT;
 import static com.gtnewhorizon.structurelib.alignment.IAlignment.ROTATIONS_COUNT;
 import static java.lang.Math.abs;
 import static java.util.Arrays.stream;
-import static java.util.stream.Collectors.*;
+import static java.util.stream.Collectors.collectingAndThen;
+import static java.util.stream.Collectors.groupingBy;
+import static java.util.stream.Collectors.toMap;
+import static java.util.stream.Collectors.toSet;
+
+import java.util.ArrayList;
+import java.util.EnumMap;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Random;
+
+import net.minecraft.util.StatCollector;
+import net.minecraft.util.Vec3;
+import net.minecraftforge.common.util.ForgeDirection;
+
+import com.google.common.collect.ImmutableSet;
+import com.gtnewhorizon.structurelib.alignment.IAlignment;
+import com.gtnewhorizon.structurelib.alignment.IntegerAxisSwap;
+import com.gtnewhorizon.structurelib.util.Vec3Impl;
 
 public enum ExtendedFacing {
+
     DOWN_NORMAL_NONE("down normal none"),
     DOWN_NORMAL_HORIZONTAL("down normal horizontal"),
     DOWN_NORMAL_VERTICAL("down normal vertical"),
@@ -113,13 +125,14 @@ public enum ExtendedFacing {
     EAST_COUNTER_CLOCKWISE_VERTICAL("east counter clockwise vertical"),
     EAST_COUNTER_CLOCKWISE_BOTH("east counter clockwise both");
 
-    public static final ExtendedFacing DEFAULT=NORTH_NORMAL_NONE;
+    public static final ExtendedFacing DEFAULT = NORTH_NORMAL_NONE;
     public static final ExtendedFacing[] VALUES = values();
-    public static final Map<ForgeDirection, List<ExtendedFacing>> FOR_FACING=new HashMap<>();
+    public static final Map<ForgeDirection, List<ExtendedFacing>> FOR_FACING = new HashMap<>();
     public static final int STATES_COUNT = VALUES.length;
+
     static {
-        stream(values()).forEach(extendedFacing ->
-                FOR_FACING.compute(extendedFacing.direction, ((forgeDirection, extendedFacings) -> {
+        stream(values()).forEach(
+                extendedFacing -> FOR_FACING.compute(extendedFacing.direction, ((forgeDirection, extendedFacings) -> {
                     if (extendedFacings == null) {
                         extendedFacings = new ArrayList<>();
                     }
@@ -128,10 +141,24 @@ public enum ExtendedFacing {
                 })));
     }
 
-    private static final Map<String, ExtendedFacing> NAME_LOOKUP = stream(VALUES).collect(toMap(ExtendedFacing::getName2, (extendedFacing) -> extendedFacing));
-    private static final EnumMap<ForgeDirection, ImmutableSet<ExtendedFacing>> LOOKUP_BY_DIRECTION = stream(VALUES).collect(groupingBy(ExtendedFacing::getDirection, () -> new EnumMap<>(ForgeDirection.class), collectingAndThen(toSet(), ImmutableSet::copyOf)));
-    private static final EnumMap<Rotation, ImmutableSet<ExtendedFacing>> LOOKUP_BY_ROTATION = stream(VALUES).collect(groupingBy(ExtendedFacing::getRotation, () -> new EnumMap<>(Rotation.class), collectingAndThen(toSet(), ImmutableSet::copyOf)));
-    private static final EnumMap<Flip, ImmutableSet<ExtendedFacing>> LOOKUP_BY_FLIP = stream(VALUES).collect(groupingBy(ExtendedFacing::getFlip, () -> new EnumMap<>(Flip.class), collectingAndThen(toSet(), ImmutableSet::copyOf)));
+    private static final Map<String, ExtendedFacing> NAME_LOOKUP = stream(VALUES)
+            .collect(toMap(ExtendedFacing::getName2, (extendedFacing) -> extendedFacing));
+    private static final EnumMap<ForgeDirection, ImmutableSet<ExtendedFacing>> LOOKUP_BY_DIRECTION = stream(VALUES)
+            .collect(
+                    groupingBy(
+                            ExtendedFacing::getDirection,
+                            () -> new EnumMap<>(ForgeDirection.class),
+                            collectingAndThen(toSet(), ImmutableSet::copyOf)));
+    private static final EnumMap<Rotation, ImmutableSet<ExtendedFacing>> LOOKUP_BY_ROTATION = stream(VALUES).collect(
+            groupingBy(
+                    ExtendedFacing::getRotation,
+                    () -> new EnumMap<>(Rotation.class),
+                    collectingAndThen(toSet(), ImmutableSet::copyOf)));
+    private static final EnumMap<Flip, ImmutableSet<ExtendedFacing>> LOOKUP_BY_FLIP = stream(VALUES).collect(
+            groupingBy(
+                    ExtendedFacing::getFlip,
+                    () -> new EnumMap<>(Flip.class),
+                    collectingAndThen(toSet(), ImmutableSet::copyOf)));
     private final ForgeDirection direction;
     private final ForgeDirection a, b, c;
     private final Rotation rotation;
@@ -142,133 +169,146 @@ public enum ExtendedFacing {
 
     ExtendedFacing(String name) {
         this.name = name;
-        direction= Direction.VALUES[ordinal()/(ROTATIONS_COUNT*FLIPS_COUNT)].getForgeDirection();
-        rotation=Rotation.VALUES[ordinal()/FLIPS_COUNT-direction.ordinal()*ROTATIONS_COUNT];
-        flip=Flip.VALUES[ordinal()%FLIPS_COUNT];
-        ForgeDirection a,b,c;
-        switch (direction){
+        direction = Direction.VALUES[ordinal() / (ROTATIONS_COUNT * FLIPS_COUNT)].getForgeDirection();
+        rotation = Rotation.VALUES[ordinal() / FLIPS_COUNT - direction.ordinal() * ROTATIONS_COUNT];
+        flip = Flip.VALUES[ordinal() % FLIPS_COUNT];
+        ForgeDirection a, b, c;
+        switch (direction) {
             case DOWN:
-                a= ForgeDirection.WEST;
-                b= ForgeDirection.SOUTH;
-                c= ForgeDirection.UP;
+                a = ForgeDirection.WEST;
+                b = ForgeDirection.SOUTH;
+                c = ForgeDirection.UP;
                 break;
             case UP:
-                a= ForgeDirection.EAST;
-                b= ForgeDirection.SOUTH;
-                c= ForgeDirection.DOWN;
+                a = ForgeDirection.EAST;
+                b = ForgeDirection.SOUTH;
+                c = ForgeDirection.DOWN;
                 break;
             case NORTH:
-                a= ForgeDirection.WEST;
-                b= ForgeDirection.DOWN;
-                c= ForgeDirection.SOUTH;
+                a = ForgeDirection.WEST;
+                b = ForgeDirection.DOWN;
+                c = ForgeDirection.SOUTH;
                 break;
             case SOUTH:
-                a= ForgeDirection.EAST;
-                b= ForgeDirection.DOWN;
-                c= ForgeDirection.NORTH;
+                a = ForgeDirection.EAST;
+                b = ForgeDirection.DOWN;
+                c = ForgeDirection.NORTH;
                 break;
             case WEST:
-                a= ForgeDirection.SOUTH;
-                b= ForgeDirection.DOWN;
-                c= ForgeDirection.EAST;
+                a = ForgeDirection.SOUTH;
+                b = ForgeDirection.DOWN;
+                c = ForgeDirection.EAST;
                 break;
             case EAST:
-                a= ForgeDirection.NORTH;
-                b= ForgeDirection.DOWN;
-                c= ForgeDirection.WEST;
+                a = ForgeDirection.NORTH;
+                b = ForgeDirection.DOWN;
+                c = ForgeDirection.WEST;
                 break;
-            default:throw new RuntimeException("Is impossible...");
+            default:
+                throw new RuntimeException("Is impossible...");
         }
-        switch (flip){//This duplicates some axis swaps since flip boolean would do, but seems more convenient to use
+        switch (flip) { // This duplicates some axis swaps since flip boolean would do, but seems more convenient to use
             case HORIZONTAL:
-                a=a.getOpposite();
+                a = a.getOpposite();
                 break;
             case BOTH:
-                a=a.getOpposite();
+                a = a.getOpposite();
             case VERTICAL:
-                b=b.getOpposite();
+                b = b.getOpposite();
                 break;
-            case NONE: break;
-            default:throw new RuntimeException("Even more impossible...");
+            case NONE:
+                break;
+            default:
+                throw new RuntimeException("Even more impossible...");
         }
         switch (rotation) {
             case CLOCKWISE: {
-                ForgeDirection _a=a;
-                a =b;
-                b =_a.getOpposite();
+                ForgeDirection _a = a;
+                a = b;
+                b = _a.getOpposite();
                 break;
             }
             case UPSIDE_DOWN:
-                a=a.getOpposite();
-                b=b.getOpposite();
+                a = a.getOpposite();
+                b = b.getOpposite();
                 break;
             case COUNTER_CLOCKWISE: {
-                ForgeDirection _a=a;
-                a =b.getOpposite();
-                b =_a;
+                ForgeDirection _a = a;
+                a = b.getOpposite();
+                b = _a;
                 break;
             }
-            case NORMAL: break;
+            case NORMAL:
+                break;
             default:
                 throw new RuntimeException("More impossible...");
         }
-        this.a=a;
-        this.b=b;
-        this.c=c;
-        integerAxisSwap =new IntegerAxisSwap(a,b,c);
+        this.a = a;
+        this.b = b;
+        this.c = c;
+        integerAxisSwap = new IntegerAxisSwap(a, b, c);
     }
 
-    public static ExtendedFacing of(ForgeDirection direction, Rotation rotation, Flip flip){
-        if(direction==ForgeDirection.UNKNOWN){
+    public static ExtendedFacing of(ForgeDirection direction, Rotation rotation, Flip flip) {
+        if (direction == ForgeDirection.UNKNOWN) {
             return VALUES[IAlignment.getAlignmentIndex(ForgeDirection.NORTH, rotation, flip)];
         }
         return VALUES[IAlignment.getAlignmentIndex(direction, rotation, flip)];
     }
 
-    public static ExtendedFacing of(ForgeDirection direction){
-        if(direction==ForgeDirection.UNKNOWN){
+    public static ExtendedFacing of(ForgeDirection direction) {
+        if (direction == ForgeDirection.UNKNOWN) {
             return DEFAULT;
         }
         return VALUES[IAlignment.getAlignmentIndex(direction, Rotation.NORMAL, Flip.NONE)];
     }
 
-    public static ImmutableSet<ExtendedFacing> getAllWith(ForgeDirection direction) { return LOOKUP_BY_DIRECTION.get(direction);}
-    public static ImmutableSet<ExtendedFacing> getAllWith(Rotation rotation) { return LOOKUP_BY_ROTATION.get(rotation);}
-    public static ImmutableSet<ExtendedFacing> getAllWith(Flip flip) { return LOOKUP_BY_FLIP.get(flip);}
-
-    public ExtendedFacing with(ForgeDirection direction){
-        return of(direction,rotation,flip);
+    public static ImmutableSet<ExtendedFacing> getAllWith(ForgeDirection direction) {
+        return LOOKUP_BY_DIRECTION.get(direction);
     }
 
-    public ExtendedFacing with(Rotation rotation){
-        return of(direction,rotation,flip);
+    public static ImmutableSet<ExtendedFacing> getAllWith(Rotation rotation) {
+        return LOOKUP_BY_ROTATION.get(rotation);
     }
 
-    public ExtendedFacing with(Flip flip){
-        return of(direction,rotation,flip);
+    public static ImmutableSet<ExtendedFacing> getAllWith(Flip flip) {
+        return LOOKUP_BY_FLIP.get(flip);
+    }
+
+    public ExtendedFacing with(ForgeDirection direction) {
+        return of(direction, rotation, flip);
+    }
+
+    public ExtendedFacing with(Rotation rotation) {
+        return of(direction, rotation, flip);
+    }
+
+    public ExtendedFacing with(Flip flip) {
+        return of(direction, rotation, flip);
     }
 
     public ExtendedFacing getOppositeDirection() {
-        return of(direction.getOpposite(),rotation,flip);
+        return of(direction.getOpposite(), rotation, flip);
     }
 
     public ExtendedFacing getOppositeRotation() {
-        return of(direction,rotation.getOpposite(),flip);
+        return of(direction, rotation.getOpposite(), flip);
     }
 
     public ExtendedFacing getOppositeFlip() {
-        return of(direction,rotation,flip.getOpposite());
+        return of(direction, rotation, flip.getOpposite());
     }
 
     /**
      * Gets the same effective facing achieved by different rot/flip combo
+     *
      * @return same effective facing, but different enum value
      */
-    public ExtendedFacing getDuplicate(){
-        return of(direction,rotation.getOpposite(),flip.getOpposite());
+    public ExtendedFacing getDuplicate() {
+        return of(direction, rotation.getOpposite(), flip.getOpposite());
     }
 
-    public int getIndex(){
+    public int getIndex() {
         return ordinal();
     }
 
@@ -276,6 +316,10 @@ public enum ExtendedFacing {
         return this.name;
     }
 
+    public String getLocalizedName() {
+        return StatCollector.translateToLocal("structurelib.facing." + getIndex());
+    }
+
     public static ExtendedFacing byName(String name) {
         return name == null ? null : NAME_LOOKUP.get(name.toLowerCase(Locale.ROOT));
     }
@@ -301,40 +345,69 @@ public enum ExtendedFacing {
     }
 
     /**
-     * Translates relative to front facing offset  to  world offset
-     * @param abcOffset A,B,C offset (facing relative  L-->R,U-->D,F-->B)
-     * @return X,Y,Z offset in world
+     * Translates relative to front facing offset to world offset
+     *
+     * @param abcOffset A,B,C offset (facing relative {@code L-->R,U-->D,F-->B})
+     * @return X, Y, Z offset in world
      */
     public Vec3 getWorldOffset(Vec3 abcOffset) {
         return integerAxisSwap.inverseTranslate(abcOffset);
     }
+
     public Vec3Impl getWorldOffset(Vec3Impl abcOffset) {
         return integerAxisSwap.inverseTranslate(abcOffset);
     }
-    public void getWorldOffset(int[] point,int[] out){
-        integerAxisSwap.inverseTranslate(point,out);
-    }
-    public void getWorldOffset(double[] point,double[] out){
-        integerAxisSwap.inverseTranslate(point,out);
+
+    public void getWorldOffset(int[] point, int[] out) {
+        integerAxisSwap.inverseTranslate(point, out);
     }
 
+    public void getWorldOffset(double[] point, double[] out) {
+        integerAxisSwap.inverseTranslate(point, out);
+    }
 
     /**
-     * Translates world offset  to  relative front facing offset
-     * @param xyzOffset X,Y,Z offset in world
-     * @return A,B,C offset (facing relative  L-->R,U-->D,F-->B)
+     * do note the ABC coordinate system is (X, -Y, Z).
      */
-    public Vec3 getOffsetABC(Vec3 xyzOffset){
+    public ForgeDirection getWorldDirection(ForgeDirection abcDirection) {
+        switch (abcDirection) {
+            case NORTH:
+                return getRelativeForwardInWorld();
+            case SOUTH:
+                return getRelativeBackInWorld();
+            case UP:
+                return getRelativeDownInWorld();
+            case DOWN:
+                return getRelativeUpInWorld();
+            case EAST:
+                return getRelativeLeftInWorld();
+            case WEST:
+                return getRelativeRightInWorld();
+            default:
+                return ForgeDirection.UNKNOWN;
+        }
+    }
+
+    /**
+     * Translates world offset to relative front facing offset
+     *
+     * @param xyzOffset X,Y,Z offset in world
+     * @return A, B, C offset (facing relative {@code L-->R,U-->D,F-->B})
+     */
+    public Vec3 getOffsetABC(Vec3 xyzOffset) {
         return integerAxisSwap.translate(xyzOffset);
     }
-    public Vec3Impl getOffsetABC(Vec3Impl xyzOffset){
+
+    public Vec3Impl getOffsetABC(Vec3Impl xyzOffset) {
         return integerAxisSwap.translate(xyzOffset);
     }
-    public void getOffsetABC(int[] point,int[] out){
-        integerAxisSwap.translate(point,out);
+
+    public void getOffsetABC(int[] point, int[] out) {
+        integerAxisSwap.translate(point, out);
     }
-    public void getOffsetABC(double[] point,double[] out){
-        integerAxisSwap.translate(point,out);
+
+    public void getOffsetABC(double[] point, double[] out) {
+        integerAxisSwap.translate(point, out);
     }
 
     public IntegerAxisSwap getIntegerAxisSwap() {

src/main/java/com/gtnewhorizon/structurelib/alignment/enumerable/Flip.java

@@ -1,15 +1,17 @@
 package com.gtnewhorizon.structurelib.alignment.enumerable;
 
-import javax.annotation.Nonnull;
-import java.util.Locale;
-import java.util.Map;
-import java.util.Random;
-
 import static java.lang.Math.abs;
 import static java.util.Arrays.stream;
 import static java.util.stream.Collectors.toMap;
 
+import java.util.Locale;
+import java.util.Map;
+import java.util.Random;
+
+import javax.annotation.Nonnull;
+
 public enum Flip {
+
     NONE(3, "none"),
     HORIZONTAL(2, "horizontal"),
     VERTICAL(1, "vertical"),
@@ -26,7 +28,7 @@ public enum Flip {
         this.name = nameIn;
     }
 
-    public int getIndex(){
+    public int getIndex() {
         return ordinal();
     }
 
@@ -58,19 +60,19 @@ public enum Flip {
         return this.name;
     }
 
-    public boolean isNotFlipped(){
-        return this==NONE;
+    public boolean isNotFlipped() {
+        return this == NONE;
     }
 
-    public boolean isBothFlipped(){
-        return this==BOTH;
+    public boolean isBothFlipped() {
+        return this == BOTH;
     }
 
     public boolean isHorizontallyFlipped() {
-        return this==HORIZONTAL || isBothFlipped();
+        return this == HORIZONTAL || isBothFlipped();
     }
 
     public boolean isVerticallyFliped() {
-        return this==VERTICAL || isBothFlipped();
+        return this == VERTICAL || isBothFlipped();
     }
 }

src/main/java/com/gtnewhorizon/structurelib/alignment/enumerable/Rotation.java

@@ -1,15 +1,17 @@
 package com.gtnewhorizon.structurelib.alignment.enumerable;
 
-import javax.annotation.Nonnull;
-import java.util.Locale;
-import java.util.Map;
-import java.util.Random;
-
 import static java.lang.Math.abs;
 import static java.util.Arrays.stream;
 import static java.util.stream.Collectors.toMap;
 
+import java.util.Locale;
+import java.util.Map;
+import java.util.Random;
+
+import javax.annotation.Nonnull;
+
 public enum Rotation {
+
     NORMAL(2, "normal"),
     CLOCKWISE(3, "clockwise"),
     UPSIDE_DOWN(0, "upside down"),
@@ -19,14 +21,15 @@ public enum Rotation {
     private final String name;
 
     public static final Rotation[] VALUES = values();
-    private static final Map<String, Rotation> NAME_LOOKUP = stream(VALUES).collect(toMap(Rotation::getName2, (rotation) -> rotation));
+    private static final Map<String, Rotation> NAME_LOOKUP = stream(VALUES)
+            .collect(toMap(Rotation::getName2, (rotation) -> rotation));
 
     Rotation(int oppositeIn, String nameIn) {
         this.opposite = oppositeIn;
         this.name = nameIn;
     }
 
-    public int getIndex(){
+    public int getIndex() {
         return ordinal();
     }
 
@@ -58,19 +61,19 @@ public enum Rotation {
         return this.name;
     }
 
-    public boolean isNotRotated(){
-        return this==NORMAL;
+    public boolean isNotRotated() {
+        return this == NORMAL;
     }
 
-    public boolean isClockwise(){
-        return this==CLOCKWISE;
+    public boolean isClockwise() {
+        return this == CLOCKWISE;
     }
 
-    public boolean isCounterClockwise(){
-        return this==COUNTER_CLOCKWISE;
+    public boolean isCounterClockwise() {
+        return this == COUNTER_CLOCKWISE;
     }
 
-    public boolean isUpsideDown(){
-        return this==UPSIDE_DOWN;
+    public boolean isUpsideDown() {
+        return this == UPSIDE_DOWN;
     }
 }

src/main/java/com/gtnewhorizon/structurelib/alignment/package-info.java

@@ -1,5 +1,7 @@
 /**
- * All public stuff in this package and its subpackages are considered part of the public API.
- * Backwards compatibility is maintained to the maximum extend possible.
+ * This package provide a framework for rotating a given block, or a multiblock structure.
+ * <p>
+ * All public stuff in this package and its subpackages are considered part of the public API. Backwards compatibility
+ * is maintained to the maximum extend possible.
  */
-package com.gtnewhorizon.structurelib.alignment;
+package com.gtnewhorizon.structurelib.alignment;

src/main/java/com/gtnewhorizon/structurelib/block/BlockHint.java

@@ -1,9 +1,7 @@
 package com.gtnewhorizon.structurelib.block;
 
-import com.gtnewhorizon.structurelib.StructureLib;
-import com.gtnewhorizon.structurelib.StructureLibAPI;
-import cpw.mods.fml.relauncher.Side;
-import cpw.mods.fml.relauncher.SideOnly;
+import java.util.List;
+
 import net.minecraft.block.Block;
 import net.minecraft.block.material.Material;
 import net.minecraft.client.renderer.texture.IIconRegister;
@@ -13,55 +11,63 @@ import net.minecraft.item.ItemStack;
 import net.minecraft.util.IIcon;
 import net.minecraft.world.IBlockAccess;
 
-import java.util.List;
+import com.gtnewhorizon.structurelib.StructureLib;
+import com.gtnewhorizon.structurelib.StructureLibAPI;
+
+import cpw.mods.fml.relauncher.Side;
+import cpw.mods.fml.relauncher.SideOnly;
 
 public class BlockHint extends Block {
-	private static final IIcon[] hint = new IIcon[16];
 
-	public BlockHint() {
-		super(Material.iron);
-		setBlockName("structurelib.blockhint");
-		setCreativeTab(StructureLib.creativeTab);
-	}
+    private static final IIcon[] hint = new IIcon[16];
 
-	@Override
-	public void registerBlockIcons(IIconRegister aIconRegister) {
-		//super.registerBlockIcons(aIconRegister);
-		hint[0] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_0");
-		hint[1] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_1");
-		hint[2] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_2");
-		hint[3] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_3");
-		hint[4] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_4");
-		hint[5] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_5");
-		hint[6] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_6");
-		hint[7] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_7");
-		hint[8] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_8");
-		hint[9] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_9");
-		hint[10] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_10");
-		hint[11] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_11");
-		hint[12] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_DEFAULT");
-		hint[13] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_AIR");
-		hint[14] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_NOAIR");
-		hint[15] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_ERROR");
-	}
+    public BlockHint() {
+        super(Material.iron);
+        setBlockName("structurelib.blockhint");
+        setCreativeTab(StructureLib.creativeTab);
+    }
 
-	@Override
-	public IIcon getIcon(int aSide, int aMeta) {
-		return hint[aMeta];
-	}
+    @Override
+    public void registerBlockIcons(IIconRegister aIconRegister) {
+        // super.registerBlockIcons(aIconRegister);
+        hint[0] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_0");
+        hint[1] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_1");
+        hint[2] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_2");
+        hint[3] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_3");
+        hint[4] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_4");
+        hint[5] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_5");
+        hint[6] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_6");
+        hint[7] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_7");
+        hint[8] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_8");
+        hint[9] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_9");
+        hint[10] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_10");
+        hint[11] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_11");
+        hint[12] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_DEFAULT");
+        hint[13] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_AIR");
+        hint[14] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_NOAIR");
+        hint[15] = aIconRegister.registerIcon(StructureLibAPI.MOD_ID + ":iconsets/HINT_ERROR");
+    }
 
-	@Override
-	@SideOnly(Side.CLIENT)
-	public IIcon getIcon(IBlockAccess aWorld, int xCoord, int yCoord, int zCoord, int aSide) {
-		int tMeta = aWorld.getBlockMetadata(xCoord, yCoord, zCoord);
-		return getIcon(aSide, tMeta);
-	}
+    @Override
+    public IIcon getIcon(int aSide, int aMeta) {
+        // For numbered hints, top and bottom are blank
+        if (aSide <= 1 && aMeta <= 11) {
+            return hint[13];
+        }
+        return hint[aMeta];
+    }
 
-	@Override
-	@SuppressWarnings("unchecked")
-	public void getSubBlocks(Item aItem, CreativeTabs par2CreativeTabs, List aList) {
-		for (int i = 0; i <= 15; i++) {
-			aList.add(new ItemStack(aItem, 1, i));
-		}
-	}
+    @Override
+    @SideOnly(Side.CLIENT)
+    public IIcon getIcon(IBlockAccess aWorld, int xCoord, int yCoord, int zCoord, int aSide) {
+        int tMeta = aWorld.getBlockMetadata(xCoord, yCoord, zCoord);
+        return getIcon(aSide, tMeta);
+    }
+
+    @Override
+    public void getSubBlocks(Item item, CreativeTabs tab, List<ItemStack> list) {
+        for (int i = 0; i <= 15; i++) {
+            list.add(new ItemStack(item, 1, i));
+        }
+    }
 }

src/main/java/com/gtnewhorizon/structurelib/command/CommandConfigureChannels.java

@@ -0,0 +1,119 @@
+package com.gtnewhorizon.structurelib.command;
+
+import java.util.Arrays;
+import java.util.List;
+import java.util.stream.Collectors;
+
+import net.minecraft.command.CommandBase;
+import net.minecraft.command.ICommandSender;
+import net.minecraft.command.WrongUsageException;
+import net.minecraft.entity.player.EntityPlayerMP;
+import net.minecraft.item.ItemStack;
+import net.minecraft.util.ChatComponentText;
+import net.minecraft.util.ChatComponentTranslation;
+
+import com.gtnewhorizon.structurelib.alignment.constructable.ChannelDataAccessor;
+import com.gtnewhorizon.structurelib.item.ItemConstructableTrigger;
+
+public class CommandConfigureChannels extends CommandBase {
+
+    @Override
+    public String getCommandName() {
+        return "sl_channel";
+    }
+
+    @Override
+    public String getCommandUsage(ICommandSender p_71518_1_) {
+        return "/sl_channel <wipe/getall>\n" + "/sl_channel <get/unset> <channel name>\n"
+                + "/sl_channel <set> <channel name> <value>\n"
+                + "<channel name> can have space in it. <value> must be positive integer";
+    }
+
+    @Override
+    public int getRequiredPermissionLevel() {
+        return 0;
+    }
+
+    @Override
+    public List<String> addTabCompletionOptions(ICommandSender p_71516_1_, String[] p_71516_2_) {
+        if (p_71516_2_.length == 1)
+            return getListOfStringsMatchingLastWord(p_71516_2_, "get", "set", "unset", "wipe", "getall");
+        return null;
+    }
+
+    @Override
+    public void processCommand(ICommandSender sender, String[] args) {
+        if (args.length == 0) throw new WrongUsageException(getCommandUsage(sender));
+
+        if (!(sender instanceof EntityPlayerMP player)) throw new WrongUsageException("must be a player");
+
+        ItemStack heldItem = player.getHeldItem();
+        if (heldItem == null || !(heldItem.getItem() instanceof ItemConstructableTrigger)) {
+            throw new WrongUsageException("must hold a hologram");
+        }
+
+        String channel;
+
+        switch (args[0]) {
+            case "getall":
+                if (!ChannelDataAccessor.hasSubChannel(heldItem)) {
+                    sender.addChatMessage(new ChatComponentText("No subchannel"));
+                } else {
+                    sender.addChatMessage(
+                            new ChatComponentTranslation(
+                                    "item.structurelib.constructableTrigger.desc.lshift.0",
+                                    ChannelDataAccessor.countChannelData(heldItem)));
+                    ChannelDataAccessor.iterateChannelData(heldItem).map(e -> e.getKey() + ": " + e.getValue())
+                            .map(ChatComponentText::new).forEach(player::addChatMessage);
+                }
+                return;
+            case "wipe":
+                ChannelDataAccessor.wipeChannelData(heldItem);
+                return;
+            case "get":
+            case "unset":
+                if (args.length < 2) throw new WrongUsageException(getCommandUsage(sender));
+                channel = args.length == 2 ? args[1] : Arrays.stream(args).skip(1).collect(Collectors.joining());
+                break;
+            case "set":
+                if (args.length < 3) throw new WrongUsageException(getCommandUsage(sender));
+                channel = args.length == 3 ? args[1]
+                        : Arrays.stream(args).skip(1).limit(args.length - 2).collect(Collectors.joining());
+                break;
+            default:
+                throw new WrongUsageException(getCommandUsage(sender));
+        }
+
+        switch (args[0]) {
+            case "get":
+                if (ChannelDataAccessor.hasSubChannel(heldItem, channel)) sender.addChatMessage(
+                        new ChatComponentText(
+                                channel + " value: " + ChannelDataAccessor.getChannelData(heldItem, channel)));
+                else sender.addChatMessage(new ChatComponentText(channel + " value: N/A"));
+                break;
+            case "clear":
+                if (ChannelDataAccessor.hasSubChannel(heldItem, channel))
+                    sender.addChatMessage(new ChatComponentText(channel + " no value"));
+                else {
+                    ChannelDataAccessor.unsetChannelData(heldItem, channel);
+                    sender.addChatMessage(new ChatComponentText(channel + " cleared"));
+                    player.inventoryContainer.detectAndSendChanges();
+                }
+                break;
+            case "set":
+                int value;
+                try {
+                    value = Integer.parseInt(args[args.length - 1]);
+                } catch (NumberFormatException e) {
+                    throw new WrongUsageException("%s not a valid value", args[args.length - 1]);
+                }
+
+                if (value <= 0) throw new WrongUsageException("%s not a valid value", args[args.length - 1]);
+
+                ChannelDataAccessor.setChannelData(heldItem, channel, value);
+                player.inventoryContainer.detectAndSendChanges();
+                sender.addChatMessage(new ChatComponentText(channel + " value: " + value));
+                break;
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/command/CommandRegistryDebug.java

@@ -0,0 +1,50 @@
+package com.gtnewhorizon.structurelib.command;
+
+import java.util.List;
+
+import net.minecraft.command.CommandBase;
+import net.minecraft.command.ICommandSender;
+import net.minecraft.command.WrongUsageException;
+import net.minecraft.entity.player.EntityPlayerMP;
+import net.minecraft.util.ChatComponentText;
+
+import com.gtnewhorizon.structurelib.SortedRegistry;
+
+public class CommandRegistryDebug extends CommandBase {
+
+    @Override
+    public String getCommandName() {
+        return "sl_registry_debug";
+    }
+
+    @Override
+    public String getCommandUsage(ICommandSender p_71518_1_) {
+        return "/sl_registry_debug <registry name>";
+    }
+
+    @Override
+    public int getRequiredPermissionLevel() {
+        return 0;
+    }
+
+    @Override
+    public List<String> addTabCompletionOptions(ICommandSender p_71516_1_, String[] p_71516_2_) {
+        if (p_71516_2_.length == 1) return getListOfStringsMatchingLastWord(
+                p_71516_2_,
+                SortedRegistry.getRegistryNames().toArray(new String[0]));
+        return null;
+    }
+
+    @Override
+    public void processCommand(ICommandSender sender, String[] args) {
+        if (args.length != 1) throw new WrongUsageException(getCommandUsage(sender));
+
+        if (!(sender instanceof EntityPlayerMP player)) throw new WrongUsageException("must be a player");
+
+        SortedRegistry<?> registry = SortedRegistry.getRegistry(args[0]);
+        if (registry == null) throw new WrongUsageException("registry not found");
+
+        player.addChatMessage(new ChatComponentText("Current order:"));
+        registry.getPlayerOrderingKeys(player).map(ChatComponentText::new).forEach(player::addChatMessage);
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/core/StructureLibCore.java

@@ -0,0 +1,49 @@
+package com.gtnewhorizon.structurelib.core;
+
+import java.util.Arrays;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import com.gtnewhorizon.gtnhmixins.IEarlyMixinLoader;
+
+import cpw.mods.fml.relauncher.IFMLLoadingPlugin;
+
+@IFMLLoadingPlugin.MCVersion("1.7.10")
+public class StructureLibCore implements IFMLLoadingPlugin, IEarlyMixinLoader {
+
+    @Override
+    public String[] getASMTransformerClass() {
+        return null;
+    }
+
+    @Override
+    public String getModContainerClass() {
+        return null;
+    }
+
+    @Override
+    public String getSetupClass() {
+        return null;
+    }
+
+    @Override
+    public void injectData(Map<String, Object> data) {
+
+    }
+
+    @Override
+    public String getAccessTransformerClass() {
+        return null;
+    }
+
+    @Override
+    public String getMixinConfig() {
+        return "mixins.structurelib.early.json";
+    }
+
+    @Override
+    public List<String> getMixins(Set<String> loadedCoreMods) {
+        return Arrays.asList("blockChangeNotifier.MixinForgeHooks", "blockChangeNotifier.MixinWorld");
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/entity/fx/EntityFXBlockHint.java

@@ -1,140 +0,0 @@
-package com.gtnewhorizon.structurelib.entity.fx;
-
-import com.gtnewhorizon.structurelib.StructureLib;
-import com.gtnewhorizon.structurelib.proxy.ClientProxy;
-import cpw.mods.fml.relauncher.Side;
-import cpw.mods.fml.relauncher.SideOnly;
-import net.minecraft.block.Block;
-import net.minecraft.client.particle.EntityFX;
-import net.minecraft.client.renderer.Tessellator;
-import net.minecraft.init.Blocks;
-import net.minecraft.util.IIcon;
-import net.minecraft.world.World;
-import org.lwjgl.opengl.GL11;
-
-@SideOnly(Side.CLIENT)
-public class EntityFXBlockHint extends EntityFX {
-    private IIcon[] icons;
-    private short[] mRGBa = {255,255,255,0};
-
-    public EntityFXBlockHint(World world){
-        this(world,0,0,0, Blocks.stone,0);
-    }
-
-    /**
-     *
-     * @param world
-     * @param x
-     * @param y
-     * @param z
-     * @param icons DOWN, UP, NORTH, SOUTH, WEST, EAST
-     */
-    public EntityFXBlockHint(World world, int x, int y, int z, IIcon[] icons) {
-        super(world, x + .25, y + .5, z + .25);
-        particleGravity = 0;
-        prevPosX = posX;
-        prevPosY = posY;
-        prevPosZ = posZ;
-        noClip = true;
-        particleMaxAge = 2000 + StructureLib.RANDOM.nextInt(200);
-        this.icons=icons;
-    }
-
-    public EntityFXBlockHint(World world, int x, int y, int z, Block block, int meta) {
-        super(world, x+.25, y+.5, z+.25);
-        particleGravity = 0;
-        prevPosX = posX;
-        prevPosY = posY;
-        prevPosZ = posZ;
-        noClip = true;
-        particleMaxAge = 2000 + StructureLib.RANDOM.nextInt(200);
-        icons = new IIcon[6];
-        for (int i = 0; i < 6; i++) {
-            icons[i] = block.getIcon(i, meta);
-        }
-    }
-
-    public EntityFXBlockHint withColorTint(short[] coloure){
-        this.mRGBa =coloure;
-        return this;
-    }
-
-    @Override
-    public void renderParticle(Tessellator tes, float subTickTime, float p_70539_3_, float p_70539_4_, float p_70539_5_, float p_70539_6_, float p_70539_7_) {
-        float size = .5f;
-        float X = (float) (prevPosX + (posX - prevPosX) * (double) subTickTime - EntityFX.interpPosX);
-        float Y = (float) (prevPosY + (posY - prevPosY) * (double) subTickTime - EntityFX.interpPosY) - size / 2;
-        float Z = (float) (prevPosZ + (posZ - prevPosZ) * (double) subTickTime - EntityFX.interpPosZ);
-        GL11.glDisable(GL11.GL_CULL_FACE);
-        GL11.glDepthMask(false);
-        tes.setColorRGBA((int) (mRGBa[0] * .9F), (int) (mRGBa[1] * .95F), (int) (mRGBa[2] * 1F), 192);
-
-        //var8, var9 - X U
-        //var 10, var 11 - Y V
-        for(int i=0;i<6;i++){
-            if(icons[i]==null) {
-                continue;
-            }
-            double u=icons[i].getMinU();
-            double U=icons[i].getMaxU();
-            double v=icons[i].getMinV();
-            double V=icons[i].getMaxV();
-            switch (i){//{DOWN, UP, NORTH, SOUTH, WEST, EAST}
-                case 0:
-                    tes.addVertexWithUV(X, Y, Z + size, u, V);
-                    tes.addVertexWithUV(X, Y, Z, u, v);
-                    tes.addVertexWithUV(X + size, Y, Z, U, v);
-                    tes.addVertexWithUV(X + size, Y, Z + size, U, V);
-                    break;
-                case 1:
-                    tes.addVertexWithUV(X, Y + size, Z, u, v);
-                    tes.addVertexWithUV(X, Y + size, Z + size, u, V);
-                    tes.addVertexWithUV(X + size, Y + size, Z + size, U, V);
-                    tes.addVertexWithUV(X + size, Y + size, Z, U, v);
-                    break;
-                case 2:
-                    tes.addVertexWithUV(X, Y, Z, U, V);
-                    tes.addVertexWithUV(X, Y + size, Z, U, v);
-                    tes.addVertexWithUV(X + size, Y + size, Z, u, v);
-                    tes.addVertexWithUV(X + size, Y, Z, u, V);
-                    break;
-                case 3:
-                    tes.addVertexWithUV(X + size, Y, Z + size, U, V);
-                    tes.addVertexWithUV(X + size, Y + size, Z + size, U, v);
-                    tes.addVertexWithUV(X, Y + size, Z + size, u, v);
-                    tes.addVertexWithUV(X, Y, Z + size, u, V);
-                    break;
-                case 4:
-                    tes.addVertexWithUV(X, Y, Z + size, U, V);
-                    tes.addVertexWithUV(X, Y + size, Z + size, U, v);
-                    tes.addVertexWithUV(X, Y + size, Z, u, v);
-                    tes.addVertexWithUV(X, Y, Z, u, V);
-                    break;
-                case 5:
-                    tes.addVertexWithUV(X + size, Y, Z, U, V);
-                    tes.addVertexWithUV(X + size, Y + size, Z, U, v);
-                    tes.addVertexWithUV(X + size, Y + size, Z + size, u, v);
-                    tes.addVertexWithUV(X + size, Y, Z + size, u, V);
-                    break;
-            }
-        }
-        GL11.glEnable(GL11.GL_CULL_FACE);
-        GL11.glDepthMask(true);
-    }
-
-    @Override
-    public int getFXLayer() {
-        return 1;
-    }
-
-    @Override
-    public boolean shouldRenderInPass(int pass) {
-        return pass==2;
-    }
-
-    @Override
-    public void setDead() {
-        super.setDead();
-        ClientProxy.onHintDead(this);
-    }
-}

src/main/java/com/gtnewhorizon/structurelib/entity/fx/WeightlessParticleFX.java

@@ -1,41 +1,40 @@
 package com.gtnewhorizon.structurelib.entity.fx;
 
-import cpw.mods.fml.relauncher.Side;
-import cpw.mods.fml.relauncher.SideOnly;
 import net.minecraft.client.particle.EntityFX;
 import net.minecraft.world.World;
 
+import cpw.mods.fml.relauncher.Side;
+import cpw.mods.fml.relauncher.SideOnly;
+
 @SideOnly(Side.CLIENT)
-public class WeightlessParticleFX extends EntityFX
-{
-    public WeightlessParticleFX(World p_i1205_1_, double p_i1205_2_, double p_i1205_4_, double p_i1205_6_, double p_i1205_8_, double p_i1205_10_, double p_i1205_12_)
-    {
+public class WeightlessParticleFX extends EntityFX {
+
+    public WeightlessParticleFX(World p_i1205_1_, double p_i1205_2_, double p_i1205_4_, double p_i1205_6_,
+            double p_i1205_8_, double p_i1205_10_, double p_i1205_12_) {
         super(p_i1205_1_, p_i1205_2_, p_i1205_4_, p_i1205_6_, p_i1205_8_, p_i1205_10_, p_i1205_12_);
-        this.motionX = p_i1205_8_ + (double)((float)(Math.random() * 2.0D - 1.0D) * 0.05F);
-        this.motionY = p_i1205_10_ + (double)((float)(Math.random() * 2.0D - 1.0D) * 0.05F);
-        this.motionZ = p_i1205_12_ + (double)((float)(Math.random() * 2.0D - 1.0D) * 0.05F);
+        this.motionX = p_i1205_8_ + (double) ((float) (Math.random() * 2.0D - 1.0D) * 0.05F);
+        this.motionY = p_i1205_10_ + (double) ((float) (Math.random() * 2.0D - 1.0D) * 0.05F);
+        this.motionZ = p_i1205_12_ + (double) ((float) (Math.random() * 2.0D - 1.0D) * 0.05F);
         this.particleRed = this.particleGreen = this.particleBlue = this.rand.nextFloat() * 0.3F + 0.7F;
         this.particleScale = this.rand.nextFloat() * this.rand.nextFloat() * 6.0F + 1.0F;
-        this.particleMaxAge = (int)(16.0D / ((double)this.rand.nextFloat() * 0.8D + 0.2D)) + 2;
-        this.noClip=true;
+        this.particleMaxAge = (int) (16.0D / ((double) this.rand.nextFloat() * 0.8D + 0.2D)) + 2;
+        this.noClip = true;
     }
 
     /**
      * Called to update the entity's position/logic.
      */
-    public void onUpdate()
-    {
+    public void onUpdate() {
         this.prevPosX = this.posX;
         this.prevPosY = this.posY;
         this.prevPosZ = this.posZ;
 
-        if (this.particleAge++ >= this.particleMaxAge)
-        {
+        if (this.particleAge++ >= this.particleMaxAge) {
             this.setDead();
         }
 
         this.setParticleTextureIndex(7 - this.particleAge * 8 / this.particleMaxAge);
-        //this.motionY += 0.004D;
+        // this.motionY += 0.004D;
         this.moveEntity(this.motionX, this.motionY, this.motionZ);
         this.motionX *= 0.8999999761581421D;
         this.motionY *= 0.8999999761581421D;

src/main/java/com/gtnewhorizon/structurelib/event/BlockChangeListener.java

@@ -0,0 +1,11 @@
+package com.gtnewhorizon.structurelib.event;
+
+import net.minecraft.block.Block;
+import net.minecraft.world.World;
+import net.minecraft.world.chunk.Chunk;
+
+public interface BlockChangeListener {
+
+    void onBlockChange(World world, Chunk chunk, int x, int y, int z, Block oldBlock, Block newBlock, int oldMeta,
+            int newMeta);
+}

src/main/java/com/gtnewhorizon/structurelib/event/BlockChangeNotifier.java

@@ -0,0 +1,33 @@
+package com.gtnewhorizon.structurelib.event;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import net.minecraft.block.Block;
+import net.minecraft.world.World;
+import net.minecraft.world.chunk.Chunk;
+
+@SuppressWarnings("ForLoopReplaceableByForEach")
+public class BlockChangeNotifier {
+
+    private static final List<BlockChangeListener> listeners = new ArrayList<>();
+
+    public static synchronized void addListener(BlockChangeListener listener) {
+        listeners.add(listener);
+    }
+
+    public static void onBlockChange(World world, Chunk chunk, int x, int y, int z, Block oldBlock, Block newBlock,
+            int oldMeta, int newMeta) {
+        if (oldBlock == newBlock && oldMeta == newMeta) return;
+
+        if (chunk == null) {
+            chunk = world.getChunkFromBlockCoords(x, z);
+        }
+
+        final int numListeners = listeners.size();
+        for (int i = 0; i < numListeners; i++) {
+            final BlockChangeListener listener = listeners.get(i);
+            listener.onBlockChange(world, chunk, x, y, z, oldBlock, newBlock, oldMeta, newMeta);
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/fluid/FluidAmounts.java

@@ -0,0 +1,66 @@
+package com.gtnewhorizon.structurelib.fluid;
+
+import net.minecraft.block.Block;
+import net.minecraft.world.World;
+import net.minecraftforge.fluids.BlockFluidFinite;
+import net.minecraftforge.fluids.IFluidBlock;
+
+/**
+ * Measure how much fluid a block in the world holds.
+ * <p>
+ * Fluid blocks disagree on what their meta means. A vanilla style liquid counts down as it thins out, some modded
+ * fluids count up instead, and a Forge fluid block can report its own fill. These helpers hide that difference, which
+ * is what allows autoplace to charge only for the fluid that is actually missing from a position.
+ */
+public class FluidAmounts {
+
+    private FluidAmounts() {}
+
+    /**
+     * How much fluid a block of given meta holds, assuming it is a fluid block whose meta encodes a level.
+     * <p>
+     * Blocks implementing Forge's {@code IFluidBlock} answer this themselves once they are in the world, so this is
+     * only used to derive a cost for a state that is not in the world yet.
+     *
+     * @param block      the fluid block. Must not be null.
+     * @param meta       the meta to interpret
+     * @param fullAmount how much fluid a full block of this fluid holds
+     * @return amount of fluid, between 0 and {@code fullAmount} inclusive
+     */
+    public static int getAmountForMeta(Block block, int meta, int fullAmount) {
+        if (block == null) throw new IllegalArgumentException();
+        int level = meta & 7;
+        // A finite fluid counts up: meta 0 is the thinnest state, meta 7 is a full block.
+        if (block instanceof BlockFluidFinite) return fullAmount * (level + 1) / 8;
+        // Everything else counts down: meta 0 is a source block, meta 7 is the thinnest state.
+        return fullAmount * (8 - level) / 8;
+    }
+
+    /**
+     * How full the block at given position is, as a fraction of a full block.
+     *
+     * @return a fraction between 0 and 1 inclusive. 0 when the position does not hold a fluid block.
+     */
+    public static float getStoredFraction(World world, int x, int y, int z) {
+        Block block = world.getBlock(x, y, z);
+        if (block == null) return 0;
+        if (block instanceof IFluidBlock fluidBlock) {
+            // A negative percentage means the block fills from the top down. Only its magnitude is interesting here.
+            return Math.min(1f, Math.abs(fluidBlock.getFilledPercentage(world, x, y, z)));
+        }
+        if (block.getMaterial() != null && block.getMaterial().isLiquid()) {
+            return getAmountForMeta(block, world.getBlockMetadata(x, y, z), 8) / 8f;
+        }
+        return 0;
+    }
+
+    /**
+     * How much fluid the block at given position holds.
+     *
+     * @param capacity how much fluid a full block of this kind holds, i.e. the amount to scale the fill fraction by
+     * @return amount of fluid, between 0 and {@code capacity} inclusive
+     */
+    public static int getStoredAmount(World world, int x, int y, int z, int capacity) {
+        return Math.round(getStoredFraction(world, x, y, z) * capacity);
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/fluid/FluidBlockPlacement.java

@@ -0,0 +1,104 @@
+package com.gtnewhorizon.structurelib.fluid;
+
+import javax.annotation.Nullable;
+
+import net.minecraftforge.fluids.Fluid;
+import net.minecraftforge.fluids.FluidStack;
+
+import com.github.bsideup.jabel.Desugar;
+
+/**
+ * How a specific block state is placed by autoplace: what fluid it costs, and how to write it into the world.
+ * <p>
+ * Register one of these through {@link FluidPlacementRegistry} to teach StructureLib about a fluid block that it cannot
+ * figure out on its own, e.g. a fluid block that stores its fluid somewhere else, or one whose fluid cost is not the
+ * default bucket.
+ *
+ * @param cost       the fluid that has to be paid for one block of this state. Must hold a fluid and a positive amount.
+ * @param forceFluid whether to always pay with fluid, even when this block also has an item form. When false, the item
+ *                   form is preferred, which keeps the behaviour of existing multiblocks unchanged.
+ * @param placer     how to actually place the block, or null to place it with a plain block set
+ */
+@Desugar
+public record FluidBlockPlacement(FluidStack cost, boolean forceFluid, @Nullable FluidBlockPlacer placer) {
+
+    public FluidBlockPlacement {
+        if (cost == null || cost.getFluid() == null) throw new IllegalArgumentException("cost must hold a fluid");
+        if (cost.amount <= 0) throw new IllegalArgumentException("cost must have a positive amount");
+    }
+
+    /**
+     * A placement that pays with given fluid, prefers the item form when there is one, and places the block directly.
+     */
+    public static FluidBlockPlacement of(FluidStack cost) {
+        return new FluidBlockPlacement(cost, false, null);
+    }
+
+    /**
+     * A placement that pays with given fluid, and always pays with fluid even when the block has an item form.
+     */
+    public static FluidBlockPlacement forced(FluidStack cost) {
+        return new FluidBlockPlacement(cost, true, null);
+    }
+
+    /**
+     * A placement that pays {@link FluidPlacementRegistry#DEFAULT_FLUID_AMOUNT} of given fluid, prefers the item form
+     * when there is one, and places the block directly.
+     */
+    public static FluidBlockPlacement of(Fluid fluid) {
+        return of(defaultCost(fluid));
+    }
+
+    /**
+     * A placement that pays {@link FluidPlacementRegistry#DEFAULT_FLUID_AMOUNT} of given fluid, and always pays with
+     * fluid even when the block has an item form.
+     */
+    public static FluidBlockPlacement forced(Fluid fluid) {
+        return forced(defaultCost(fluid));
+    }
+
+    /**
+     * A placement that pays with given fluid, and writes the block into the world the way the given placer says.
+     * <p>
+     * Use this for a fluid block that cannot be placed with a plain block set, e.g. one that has to be filled through
+     * its own API.
+     */
+    public static FluidBlockPlacement of(FluidStack cost, @Nullable FluidBlockPlacer placer) {
+        return new FluidBlockPlacement(cost, false, placer);
+    }
+
+    /**
+     * A placement that pays with given fluid, always pays with fluid, and writes the block into the world the way the
+     * given placer says.
+     */
+    public static FluidBlockPlacement forced(FluidStack cost, @Nullable FluidBlockPlacer placer) {
+        return new FluidBlockPlacement(cost, true, placer);
+    }
+
+    /**
+     * A placement that pays {@link FluidPlacementRegistry#DEFAULT_FLUID_AMOUNT} of given fluid, and writes the block
+     * into the world the way the given placer says.
+     */
+    public static FluidBlockPlacement of(Fluid fluid, @Nullable FluidBlockPlacer placer) {
+        return of(defaultCost(fluid), placer);
+    }
+
+    /**
+     * A placement that pays {@link FluidPlacementRegistry#DEFAULT_FLUID_AMOUNT} of given fluid, always pays with fluid,
+     * and writes the block into the world the way the given placer says.
+     */
+    public static FluidBlockPlacement forced(Fluid fluid, @Nullable FluidBlockPlacer placer) {
+        return forced(defaultCost(fluid), placer);
+    }
+
+    /**
+     * What one block of given fluid costs unless something else was registered for it, which is one bucket.
+     *
+     * @param fluid the fluid to pay with
+     * @throws IllegalArgumentException if the fluid is null
+     */
+    public static FluidStack defaultCost(Fluid fluid) {
+        if (fluid == null) throw new IllegalArgumentException("fluid must not be null");
+        return new FluidStack(fluid, FluidPlacementRegistry.DEFAULT_FLUID_AMOUNT);
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/fluid/FluidBlockPlacer.java

@@ -0,0 +1,30 @@
+package com.gtnewhorizon.structurelib.fluid;
+
+import net.minecraft.block.Block;
+import net.minecraft.world.World;
+import net.minecraftforge.fluids.FluidStack;
+
+/**
+ * Put a fluid block into the world.
+ * <p>
+ * The default implementation used by StructureLib is a plain {@code world.setBlock(x, y, z, block, meta, 2)}, which is
+ * what every vanilla and Forge fluid block expects. Register a custom placer for a fluid block that needs more than
+ * that, e.g. one that keeps its fluid inside a tile entity.
+ */
+public interface FluidBlockPlacer {
+
+    /**
+     * Place the fluid block.
+     *
+     * @param world world to place in. Never a client side world.
+     * @param x     x coord
+     * @param y     y coord
+     * @param z     z coord
+     * @param block block to place
+     * @param meta  block meta to place
+     * @param fluid the fluid that has been paid for, and how much of it. Never null.
+     * @return true if the block has been placed, false otherwise. Autoplace rolls back and refunds nothing when this
+     *         returns false before anything was consumed.
+     */
+    boolean place(World world, int x, int y, int z, Block block, int meta, FluidStack fluid);
+}

src/main/java/com/gtnewhorizon/structurelib/fluid/FluidBlockRequirement.java

@@ -0,0 +1,55 @@
+package com.gtnewhorizon.structurelib.fluid;
+
+import javax.annotation.Nullable;
+
+import net.minecraft.block.Block;
+import net.minecraftforge.fluids.FluidStack;
+
+import com.github.bsideup.jabel.Desugar;
+
+/**
+ * A concrete request to put one fluid block at one position: which block and meta the structure wants there, what that
+ * costs, and how strict the check for an already partially filled position is.
+ * <p>
+ * Structure elements create one of these, either from the {@link FluidPlacementRegistry} or from their own parameters,
+ * and hand it to the autoplace helper.
+ *
+ * @param block  the block the structure wants at that position
+ * @param meta   the block meta the structure wants at that position
+ * @param cost   the fluid that has to be paid for a position that holds nothing yet. Must hold a fluid and a positive
+ *               amount.
+ * @param policy how much fluid an existing position has to hold to be accepted as is
+ * @param placer how to actually place the block, or null to place it with a plain block set
+ */
+@Desugar
+public record FluidBlockRequirement(Block block, int meta, FluidStack cost, FluidFillPolicy policy,
+        @Nullable FluidBlockPlacer placer) {
+
+    public FluidBlockRequirement {
+        if (block == null) throw new IllegalArgumentException("block must not be null");
+        if (cost == null || cost.getFluid() == null) throw new IllegalArgumentException("cost must hold a fluid");
+        if (cost.amount <= 0) throw new IllegalArgumentException("cost must have a positive amount");
+        if (policy == null) throw new IllegalArgumentException("policy must not be null");
+    }
+
+    /**
+     * Build a requirement from a registered placement.
+     *
+     * @param placement what the registry knows about this block state
+     * @param block     the block the structure wants
+     * @param meta      the block meta the structure wants
+     * @param policy    how strict the check for an already partially filled position is
+     */
+    public static FluidBlockRequirement of(FluidBlockPlacement placement, Block block, int meta,
+            FluidFillPolicy policy) {
+        if (placement == null) throw new IllegalArgumentException("placement must not be null");
+        return new FluidBlockRequirement(block, meta, placement.cost(), policy, placement.placer());
+    }
+
+    /**
+     * Build a requirement that pays with given fluid, and that places the block directly.
+     */
+    public static FluidBlockRequirement of(Block block, int meta, FluidStack cost, FluidFillPolicy policy) {
+        return new FluidBlockRequirement(block, meta, cost, policy, null);
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/fluid/FluidFillPolicy.java

@@ -0,0 +1,43 @@
+package com.gtnewhorizon.structurelib.fluid;
+
+/**
+ * How much fluid a position has to hold before a fluid structure element considers it satisfied.
+ * <p>
+ * Structure definitions pick a policy, which allows a structure to accept an already partially filled position, e.g.
+ * one that got filled by fluid that spread from somewhere else, instead of insisting on a full source block.
+ */
+public enum FluidFillPolicy {
+
+    /**
+     * The position has to hold exactly the amount of fluid the structure element asks for. This is the default, and it
+     * accepts a full source block while rejecting anything that holds less.
+     */
+    EXACT_STATE,
+    /**
+     * The position has to hold at least the amount of fluid the structure element asks for. A position holding more
+     * fluid than asked for is accepted as is, and is never drained down by autoplace.
+     */
+    AT_LEAST,
+    /**
+     * The position has to hold any amount of the same fluid at all. Only a position that holds no fluid of that kind is
+     * topped up.
+     */
+    ANY_FILLED;
+
+    /**
+     * Test whether the given amount is acceptable.
+     *
+     * @param existingAmount how much fluid the position holds right now
+     * @param targetAmount   how much fluid the structure element asks for
+     */
+    public boolean isSatisfied(int existingAmount, int targetAmount) {
+        switch (this) {
+            case EXACT_STATE:
+                return existingAmount == targetAmount;
+            case AT_LEAST:
+                return existingAmount >= targetAmount;
+            default:
+                return existingAmount > 0;
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/fluid/FluidPlacementRegistry.java

@@ -0,0 +1,263 @@
+package com.gtnewhorizon.structurelib.fluid;
+
+import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
+
+import javax.annotation.Nullable;
+
+import net.minecraft.block.Block;
+import net.minecraft.block.material.Material;
+import net.minecraft.init.Blocks;
+import net.minecraft.item.Item;
+import net.minecraftforge.fluids.Fluid;
+import net.minecraftforge.fluids.FluidRegistry;
+import net.minecraftforge.fluids.FluidStack;
+import net.minecraftforge.fluids.IFluidBlock;
+import net.minecraftforge.oredict.OreDictionary;
+
+/**
+ * Tells StructureLib what it costs to place a fluid block, and how to place it.
+ * <p>
+ * A structure element that wants a fluid block, e.g. one created by {@code StructureUtility.ofBlock(Block, int)}, asks
+ * this registry what the block state costs. Water and lava are registered by default, every other Forge fluid block is
+ * recognised automatically with {@link #DEFAULT_FLUID_AMOUNT} per block, and a mod can register its own fluids, its own
+ * costs, and its own placement logic here.
+ * <p>
+ * Registrations are keyed by block and block meta. Registering the wildcard meta {@link OreDictionary#WILDCARD_VALUE}
+ * covers every meta of that block that does not have its own registration.
+ */
+public class FluidPlacementRegistry {
+
+    /**
+     * How much fluid one block of an automatically recognised fluid costs, which is one bucket by default.
+     */
+    public static final int DEFAULT_FLUID_AMOUNT = 1000;
+
+    private static final Map<Block, Map<Integer, FluidBlockPlacement>> REGISTRY = new ConcurrentHashMap<>();
+    /**
+     * Block to fluid index, so that looking up a block that turns out not to be a fluid doesn't have to walk every
+     * registered fluid. Rebuilt whenever the fluid registry grows, e.g. when a mod registers its fluids later than the
+     * first lookup.
+     */
+    private static final Map<Block, Fluid> FLUID_BLOCKS = new ConcurrentHashMap<>();
+    private static volatile int indexedFluidCount = -1;
+
+    static {
+        register(Blocks.water, 0);
+        register(Blocks.flowing_water, 0);
+        register(Blocks.lava, 0);
+        register(Blocks.flowing_lava, 0);
+    }
+
+    private FluidPlacementRegistry() {}
+
+    /**
+     * Dummy method to force the class to initialize, and with it the default water and lava registrations.
+     */
+    public static void init() {}
+
+    /**
+     * Register what it costs to place the given block state, preferring the item form when the block has one.
+     *
+     * @param block the fluid block
+     * @param meta  the block meta. {@link OreDictionary#WILDCARD_VALUE} covers every meta of this block.
+     * @param cost  how much fluid one block of this state costs
+     * @throws IllegalArgumentException if the block is null, the cost is invalid, or this state is already registered
+     */
+    public static void register(Block block, int meta, FluidStack cost) {
+        register(block, meta, FluidBlockPlacement.of(cost));
+    }
+
+    /**
+     * Register what it costs to place the given block state, with {@link #DEFAULT_FLUID_AMOUNT} of the fluid the block
+     * holds, preferring the item form when the block has one.
+     * <p>
+     * The amount is the whole cost of that state. A block whose meta says how full it is therefore wants one
+     * registration per meta it can be in, or no registration at all, in which case {@link #resolve(Block, int)} scales
+     * the default amount down for a partially filled block.
+     *
+     * @param block the fluid block
+     * @param meta  the block meta. {@link OreDictionary#WILDCARD_VALUE} covers every meta of this block.
+     * @throws IllegalArgumentException if the block holds no fluid, or this state is already registered
+     */
+    public static void register(Block block, int meta) {
+        register(block, meta, false);
+    }
+
+    /**
+     * Register what it costs to place the given block state, with {@link #DEFAULT_FLUID_AMOUNT} of the fluid the block
+     * holds.
+     *
+     * @param block      the fluid block
+     * @param meta       the block meta. {@link OreDictionary#WILDCARD_VALUE} covers every meta of this block.
+     * @param forceFluid whether to always pay with fluid, even when this block also has an item form
+     * @throws IllegalArgumentException if the block holds no fluid, or this state is already registered
+     */
+    public static void register(Block block, int meta, boolean forceFluid) {
+        FluidStack cost = FluidBlockPlacement.defaultCost(fluidOf(block));
+        register(block, meta, forceFluid ? FluidBlockPlacement.forced(cost) : FluidBlockPlacement.of(cost));
+    }
+
+    /**
+     * Register the whole block, i.e. every meta of it that has no registration of its own, with
+     * {@link #DEFAULT_FLUID_AMOUNT} of the fluid it holds.
+     *
+     * @param block the fluid block
+     * @throws IllegalArgumentException if the block holds no fluid, or the wildcard meta is already registered
+     */
+    public static void register(Block block) {
+        register(block, OreDictionary.WILDCARD_VALUE);
+    }
+
+    /**
+     * Register what it costs to place the given block state, with {@link #DEFAULT_FLUID_AMOUNT} of the fluid the block
+     * holds, and placed the way the given placer says.
+     * <p>
+     * Use this for a fluid block that cannot be placed with a plain block set, e.g. one that has to be filled through
+     * its own API.
+     *
+     * @param block  the fluid block
+     * @param meta   the block meta. {@link OreDictionary#WILDCARD_VALUE} covers every meta of this block.
+     * @param placer how to write the block into the world
+     * @throws IllegalArgumentException if the block holds no fluid, or this state is already registered
+     */
+    public static void register(Block block, int meta, FluidBlockPlacer placer) {
+        register(block, meta, FluidBlockPlacement.of(FluidBlockPlacement.defaultCost(fluidOf(block)), placer));
+    }
+
+    /**
+     * Register what it costs to place the given block state.
+     *
+     * @param block      the fluid block
+     * @param meta       the block meta. {@link OreDictionary#WILDCARD_VALUE} covers every meta of this block.
+     * @param forceFluid whether to always pay with fluid, even when this block also has an item form
+     * @param cost       how much fluid one block of this state costs
+     * @throws IllegalArgumentException if the block is null, the cost is invalid, or this state is already registered
+     */
+    public static void register(Block block, int meta, FluidStack cost, boolean forceFluid) {
+        register(block, meta, new FluidBlockPlacement(cost, forceFluid, null));
+    }
+
+    /**
+     * Register what it costs to place the given block state, and how to place it.
+     *
+     * @param block     the fluid block
+     * @param meta      the block meta. {@link OreDictionary#WILDCARD_VALUE} covers every meta of this block.
+     * @param placement the cost and the placement logic
+     * @throws IllegalArgumentException if the block or the placement is null, or this state is already registered
+     */
+    public static void register(Block block, int meta, FluidBlockPlacement placement) {
+        if (block == null) throw new IllegalArgumentException("block must not be null");
+        if (placement == null) throw new IllegalArgumentException("placement must not be null");
+        Map<Integer, FluidBlockPlacement> byMeta = REGISTRY.computeIfAbsent(block, b -> new ConcurrentHashMap<>());
+        if (byMeta.putIfAbsent(meta, placement) != null) {
+            throw new IllegalArgumentException(
+                    "Duplicate fluid placement for " + block.getUnlocalizedName() + ":" + meta);
+        }
+    }
+
+    /**
+     * What has been registered for exactly this block state.
+     *
+     * @return the registration, or null when there is none
+     */
+    @Nullable
+    public static FluidBlockPlacement get(Block block, int meta) {
+        if (block == null) return null;
+        Map<Integer, FluidBlockPlacement> byMeta = REGISTRY.get(block);
+        if (byMeta == null) return null;
+        FluidBlockPlacement placement = byMeta.get(meta);
+        return placement != null ? placement : byMeta.get(OreDictionary.WILDCARD_VALUE);
+    }
+
+    /**
+     * What it costs to place this block state, whether it has been registered or not.
+     * <p>
+     * This is what autoplace asks. A registered state answers with its registration. Otherwise a block implementing
+     * Forge's {@code IFluidBlock}, and any block whose material is a liquid, answer with {@link #DEFAULT_FLUID_AMOUNT}
+     * of the fluid they hold, scaled down for a meta that asks for a partial block.
+     *
+     * @return the placement, or null when this block state is not a fluid block
+     */
+    @Nullable
+    public static FluidBlockPlacement resolve(Block block, int meta) {
+        FluidBlockPlacement placement = get(block, meta);
+        if (placement != null) return placement;
+        Fluid fluid = getFluidOf(block);
+        if (fluid == null) return null;
+        int amount = FluidAmounts.getAmountForMeta(block, meta, DEFAULT_FLUID_AMOUNT);
+        if (amount <= 0) return null;
+        return FluidBlockPlacement.of(new FluidStack(fluid, amount));
+    }
+
+    /**
+     * Whether this block state is a fluid block that autoplace can place.
+     */
+    public static boolean isFluidBlock(Block block, int meta) {
+        return resolve(block, meta) != null;
+    }
+
+    /**
+     * Whether this block state can be placed as an item, i.e. whether the block has an item form.
+     * <p>
+     * Autoplace prefers the item form when there is one, so that blocks that are both a fluid block and an item keep
+     * behaving the way they did before fluid autoplace existed.
+     */
+    public static boolean hasItemForm(Block block) {
+        if (block == null) return false;
+        return Item.getItemFromBlock(block) != null;
+    }
+
+    /**
+     * The fluid held by given block, if any.
+     * <p>
+     * A block implementing Forge's {@code IFluidBlock} answers directly. Everything else is looked up in an index of
+     * every registered fluid, and finally by material, which covers the vanilla water and lava blocks that no fluid
+     * claims.
+     *
+     * @return the fluid, or null when this block does not hold one
+     */
+    @Nullable
+    public static Fluid getFluidOf(Block block) {
+        if (block == null) return null;
+        if (block instanceof IFluidBlock fluidBlock) {
+            Fluid fluid = fluidBlock.getFluid();
+            if (fluid != null) return fluid;
+        }
+        Fluid byBlock = indexFluidBlocks().get(block);
+        if (byBlock != null) return byBlock;
+        Material material = block.getMaterial();
+        if (material == Material.water) return FluidRegistry.WATER;
+        if (material == Material.lava) return FluidRegistry.LAVA;
+        return null;
+    }
+
+    /**
+     * The fluid held by given block, for the registrations that default to {@link #DEFAULT_FLUID_AMOUNT} of it.
+     *
+     * @throws IllegalArgumentException if the block is null or holds no fluid
+     */
+    private static Fluid fluidOf(Block block) {
+        Fluid fluid = getFluidOf(block);
+        if (fluid == null) {
+            throw new IllegalArgumentException(
+                    "Block " + (block == null ? "null" : block.getUnlocalizedName())
+                            + " holds no fluid,"
+                            + " register it with an explicit cost instead");
+        }
+        return fluid;
+    }
+
+    private static synchronized Map<Block, Fluid> indexFluidBlocks() {
+        Map<String, Fluid> fluids = FluidRegistry.getRegisteredFluids();
+        if (fluids.size() == indexedFluidCount) return FLUID_BLOCKS;
+        FLUID_BLOCKS.clear();
+        for (Fluid fluid : fluids.values()) {
+            if (fluid == null) continue;
+            Block block = fluid.getBlock();
+            if (block != null) FLUID_BLOCKS.put(block, fluid);
+        }
+        indexedFluidCount = fluids.size();
+        return FLUID_BLOCKS;
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/fluid/FluidSourceProviders.java

@@ -0,0 +1,56 @@
+package com.gtnewhorizon.structurelib.fluid;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import net.minecraft.entity.player.EntityPlayerMP;
+
+import com.gtnewhorizon.structurelib.SortedRegistry;
+
+/**
+ * The registry of everything that can hand out fluid on a player's behalf, plus the composition that autoplace uses.
+ * <p>
+ * This mirrors {@link FluidStackExtractors}: it is a {@link SortedRegistry}, so the player can reorder or disable every
+ * provider in StructureLib's config, and the ordering can be synced to the server. Providers are asked in order, and
+ * whatever the player is carrying comes last, so a provider that holds a lot of fluid, e.g. an ME network, is drained
+ * before the player's buckets are emptied.
+ */
+public class FluidSourceProviders {
+
+    private static final SortedRegistry<IFluidSourceProvider> PROVIDERS = new SortedRegistry<>("fluidsourceproviders");
+
+    private FluidSourceProviders() {}
+
+    /**
+     * Dummy method to force the class to initialize, and with it the registry and its config entry.
+     */
+    public static void init() {}
+
+    /**
+     * Register a provider. Lower keys are asked first.
+     *
+     * @param key      unique key. Matches the key shown in the config gui.
+     * @param provider the provider
+     */
+    public static void register(String key, IFluidSourceProvider provider) {
+        PROVIDERS.register(key, provider);
+    }
+
+    /**
+     * The fluid source to use for a player: every provider that has something to offer, in their configured order,
+     * followed by the fluid containers the player is carrying.
+     *
+     * @param player the player the structure is being built for
+     * @return a source that never returns more than it was asked for. never null.
+     */
+    public static IFluidSource getSourceFor(EntityPlayerMP player) {
+        if (player == null) throw new IllegalArgumentException();
+        List<IFluidSource> sources = new ArrayList<>();
+        for (IFluidSourceProvider provider : PROVIDERS.getPlayerOrdering(player)) {
+            IFluidSource source = provider.getFluidSource(player);
+            if (source != null) sources.add(source);
+        }
+        sources.add(IFluidSource.fromPlayer(player));
+        return IFluidSource.composite(sources.toArray(new IFluidSource[0]));
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/fluid/FluidStackExtractor.java

@@ -0,0 +1,78 @@
+package com.gtnewhorizon.structurelib.fluid;
+
+import javax.annotation.Nullable;
+
+import net.minecraft.item.ItemStack;
+import net.minecraftforge.fluids.FluidStack;
+
+/**
+ * Extract fluid from a single item stack, e.g. a bucket or a cell.
+ * <p>
+ * Implementations are registered in {@link FluidStackExtractors}. StructureLib ships implementations for Forge's
+ * {@code IFluidContainerItem} and for {@code FluidContainerRegistry}, which together cover the vast majority of fluid
+ * containers. Register your own implementation when your containers expose their fluid by other means, e.g. fluid
+ * stored inside a backpack or inside a custom NBT layout.
+ * <p>
+ * All methods must be side effect free when a simulation is requested, and must never depend on a world.
+ */
+public interface FluidStackExtractor {
+
+    /**
+     * Whether this extractor can work with given item stack. This must be a cheap, side effect free check.
+     *
+     * @param stack the stack to test. never null.
+     */
+    boolean isValidSource(ItemStack stack);
+
+    /**
+     * Extract up to {@code resource.amount} of fluid from this container.
+     * <p>
+     * The container item itself is never swapped by this method. A container whose fluid is stored in its NBT may
+     * mutate that NBT in place when {@code simulate} is false. A container that has to turn into another item, or to
+     * disappear, declares so through {@link #convertsContainer(ItemStack, FluidStack)} and
+     * {@link #getReplacement(ItemStack)} instead.
+     * <p>
+     * A container that is consumed as a whole, i.e. one that answers true from
+     * {@link #convertsContainer(ItemStack, FluidStack)}, cannot be split, so it may report the whole content of the
+     * container even when that is more than was asked for. Such a surplus is spent, as a half emptied bucket does not
+     * exist.
+     *
+     * @param container what to drain from. never null, and always accepted by {@link #isValidSource(ItemStack)}.
+     * @param resource  the fluid to drain, and how much of it at most. never null, and never mutated.
+     * @param simulate  whether to actually commit the modification. true for dry run, false otherwise.
+     * @return amount of fluid drained. never negative, and never more than {@code resource.amount} unless this
+     *         container is consumed as a whole
+     */
+    int drain(ItemStack container, FluidStack resource, boolean simulate);
+
+    /**
+     * Whether draining this container would turn it into another item, or make it disappear.
+     * <p>
+     * Called before draining, with the container still holding its fluid. When this returns true, the caller replaces
+     * the whole slot with {@link #getReplacement(ItemStack)} after a successful drain, so the implementation is
+     * responsible for the whole stack: either it has to be a container that is drained as a unit, e.g. a bucket, or
+     * {@link #drain(ItemStack, FluidStack, boolean)} has to reduce {@code stackSize} itself, as a stack of fluid drops
+     * does.
+     *
+     * @param container the container stack, in its state before being drained
+     * @param resource  the fluid that is about to be drained, and how much of it at most
+     */
+    default boolean convertsContainer(ItemStack container, FluidStack resource) {
+        return false;
+    }
+
+    /**
+     * The item stack that should replace given container once it got drained, or null when the container slot should
+     * become empty instead.
+     * <p>
+     * The caller refuses to drain a container that has to be replaced by another item while its slot holds more than
+     * one item, as it cannot hand the replacement back to the player safely. A null replacement is always allowed, as
+     * it only empties the slot.
+     *
+     * @param container the container stack, in its state before being drained
+     */
+    @Nullable
+    default ItemStack getReplacement(ItemStack container) {
+        return null;
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/fluid/FluidStackExtractors.java

@@ -0,0 +1,285 @@
+package com.gtnewhorizon.structurelib.fluid;
+
+import java.util.Iterator;
+
+import javax.annotation.Nullable;
+
+import net.minecraft.entity.player.EntityPlayerMP;
+import net.minecraft.inventory.IInventory;
+import net.minecraft.item.Item;
+import net.minecraft.item.ItemStack;
+import net.minecraftforge.fluids.FluidContainerRegistry;
+import net.minecraftforge.fluids.FluidStack;
+import net.minecraftforge.fluids.IFluidContainerItem;
+
+import com.gtnewhorizon.structurelib.SortedRegistry;
+import com.gtnewhorizon.structurelib.util.InventoryIterable;
+import com.gtnewhorizon.structurelib.util.InventoryUtility;
+import com.gtnewhorizon.structurelib.util.InventoryUtility.InventoryProvider;
+import com.gtnewhorizon.structurelib.util.InventoryUtility.ItemStackExtractor;
+
+/**
+ * The registry of every way StructureLib knows how to pull fluid out of an item, plus the inventory walk that uses
+ * these extractors.
+ * <p>
+ * This is the fluid counterpart of the item extraction facilities that survival autoplace already relies on, including
+ * the fact that the registry is a {@link SortedRegistry}: entries can be reordered or disabled by the player in
+ * StructureLib's config, and the ordering can be synced to the server.
+ */
+public class FluidStackExtractors {
+
+    private static final SortedRegistry<FluidStackExtractor> EXTRACTORS = new SortedRegistry<>("fluidstackextractors");
+
+    static {
+        register("3000-forge-fluid-container-item", new ForgeFluidContainerItemExtractor());
+        register("5000-forge-fluid-container-registry", new ForgeFluidContainerRegistryExtractor());
+    }
+
+    private FluidStackExtractors() {}
+
+    /**
+     * Dummy method to force the class to initialize, and with it the builtin extractors.
+     */
+    public static void init() {}
+
+    /**
+     * Register an extractor. Lower keys are tried first, so a mod that wants its extractor to take priority over
+     * StructureLib builtin ones should use a key sorting before {@code "3000-forge-fluid-container-item"}.
+     *
+     * @param key unique key. Matches the key shown in the config gui.
+     * @param val the extractor
+     */
+    public static void register(String key, FluidStackExtractor val) {
+        EXTRACTORS.register(key, val);
+    }
+
+    /**
+     * Extract fluid from every inventory associated with the given player.
+     * <p>
+     * This walks exactly the same inventories as item autoplace does, see
+     * {@link com.gtnewhorizon.structurelib.util.InventoryUtility}: the main inventory first, then whatever else is
+     * registered, which currently means the ender chest when a mod asked for it and every inventory a mod registered
+     * for a backpack. Inside every item that holds an inventory the walk goes one level deep, so a bucket a player left
+     * in a backpack is found, and a mod that already lets autoplace take items out of its backpacks does not have to do
+     * anything for the fluid containers inside them.
+     * <p>
+     * Armor slots are excluded, as there is no fluid container that goes into one.
+     *
+     * @param player   where to take fluid from
+     * @param resource what fluid to take, and how much of it at most
+     * @param simulate whether to actually take the fluid
+     * @return what has actually been taken. Never null, and never holding more than requested.
+     */
+    public static FluidStack takeFromPlayer(EntityPlayerMP player, FluidStack resource, boolean simulate) {
+        if (player == null) throw new IllegalArgumentException();
+        if (resource == null || resource.getFluid() == null) throw new IllegalArgumentException();
+        int remaining = resource.amount;
+        for (InventoryProvider<?> provider : InventoryUtility.getInventoryProviders(player)) {
+            if (remaining <= 0) break;
+            remaining -= takeFromProvider(player, provider, new FluidStack(resource, remaining), simulate);
+        }
+        return new FluidStack(resource, resource.amount - remaining);
+    }
+
+    /**
+     * Extract fluid from one registered inventory of a player, and let its provider know it changed.
+     * <p>
+     * The wildcard of {@link InventoryProvider} is captured by this method's type parameter, which is what allows the
+     * inventory to be handed back to {@code markDirty}.
+     */
+    private static <R extends Iterable<ItemStack>> int takeFromProvider(EntityPlayerMP player,
+            InventoryProvider<R> provider, FluidStack resource, boolean simulate) {
+        R inventory = provider.getInventory(player);
+        if (inventory == null) return 0;
+        // Only an inventory that is backed by an IInventory can have a slot written back, which a container such as a
+        // bucket needs when it is emptied into the world. A provider that hands out its stacks some other way is
+        // skipped rather than drained in place, as draining without replacing would leave the player a filled
+        // container that is already spent.
+        if (!(inventory instanceof InventoryIterable<?>iterable)) return 0;
+        int taken = takeFromInventory(iterable.getInventory(), resource, simulate, player, iterable.getMaxSlot(), true);
+        if (taken > 0 && !simulate && hasConnection(player)) provider.markDirty(inventory);
+        return taken;
+    }
+
+    /**
+     * Whether the inventory of given player has a client to be kept in sync with. A fake player, e.g. the one a
+     * structure preview tool uses, has no connection, and an inventory it changed never has to be sent anywhere.
+     */
+    private static boolean hasConnection(EntityPlayerMP player) {
+        return player.playerNetServerHandler != null;
+    }
+
+    /**
+     * Extract fluid from given inventory.
+     * <p>
+     * Containers held inside an item of this inventory, e.g. in a backpack, are not looked into here. Take from a
+     * player through {@link #takeFromPlayer(EntityPlayerMP, FluidStack, boolean)} to look into those as well.
+     *
+     * @param inv      where to take fluid from
+     * @param resource what fluid to take, and how much of it at most
+     * @param simulate whether to actually take the fluid
+     * @return what has actually been taken. Never null, and never holding more than requested.
+     */
+    public static FluidStack takeFromInventory(IInventory inv, FluidStack resource, boolean simulate) {
+        if (inv == null) throw new IllegalArgumentException();
+        if (resource == null || resource.getFluid() == null) throw new IllegalArgumentException();
+        return new FluidStack(resource, takeFromInventory(inv, resource, simulate, null, -1, false));
+    }
+
+    /**
+     * Walk the slots of one inventory and take as much of the requested fluid as they hold.
+     *
+     * @param maxSlot   slot to stop at, exclusive. -1 for every slot
+     * @param recursive whether to look inside the items of this inventory, e.g. into a backpack
+     * @return how much has been taken, never more than requested
+     */
+    private static int takeFromInventory(IInventory inv, FluidStack resource, boolean simulate,
+            @Nullable EntityPlayerMP player, int maxSlot, boolean recursive) {
+        int slots = maxSlot < 0 ? inv.getSizeInventory() : Math.min(maxSlot, inv.getSizeInventory());
+        int remaining = resource.amount;
+        for (int slot = 0; slot < slots && remaining > 0; slot++) {
+            ItemStack stack = inv.getStackInSlot(slot);
+            if (stack == null || stack.getItem() == null || stack.stackSize <= 0) continue;
+            int taken = takeFromStack(stack, inv, slot, resource, remaining, simulate, player);
+            if (taken > 0) {
+                remaining -= taken;
+                continue;
+            }
+            if (recursive && player != null) {
+                remaining -= takeFromNested(player, stack, new FluidStack(resource, remaining), simulate);
+            }
+        }
+        return resource.amount - remaining;
+    }
+
+    /**
+     * Take fluid out of a single slot, using the first extractor that recognises what is in it.
+     *
+     * @return how much has been taken out of this slot, never more than requested
+     */
+    private static int takeFromStack(ItemStack stack, IInventory owner, int slot, FluidStack resource, int maxAmount,
+            boolean simulate, @Nullable EntityPlayerMP player) {
+        for (FluidStackExtractor extractor : EXTRACTORS.getPlayerOrdering(player)) {
+            if (!extractor.isValidSource(stack)) continue;
+            FluidStack request = new FluidStack(resource, maxAmount);
+            boolean converts = extractor.convertsContainer(stack, request);
+            ItemStack replacement = converts ? extractor.getReplacement(stack) : null;
+            // A container that turns into another item can only be replaced when it is the only item in its slot.
+            if (replacement != null && stack.stackSize != 1) continue;
+            int drained = extractor.drain(stack, request, simulate);
+            if (drained <= 0) continue;
+            if (!simulate && converts) {
+                // A null replacement means the whole slot is spent, e.g. the drops of a fluid that was paid in full.
+                owner.setInventorySlotContents(slot, replacement);
+                owner.markDirty();
+            }
+            return Math.min(drained, maxAmount);
+        }
+        return 0;
+    }
+
+    /**
+     * Look inside the given stack for an inventory, e.g. a backpack, and take fluid out of the containers it holds.
+     * <p>
+     * Which stacks hold an inventory is decided by {@link InventoryUtility}, which is the same registry item autoplace
+     * uses, so a mod that already lets autoplace take items out of its backpacks gets the fluid containers inside them
+     * for free and never has to register anything for fluid. Only one level is looked into, exactly like the item walk
+     * does.
+     *
+     * @return how much has been taken, never more than requested
+     */
+    private static int takeFromNested(EntityPlayerMP player, ItemStack stack, FluidStack resource, boolean simulate) {
+        int taken = 0;
+        for (Iterator<? extends ItemStackExtractor> iter = InventoryUtility.getStackExtractors(player); iter
+                .hasNext();) {
+            ItemStackExtractor extractor = iter.next();
+            if (!extractor.isValidSource(stack, player)) continue;
+            IInventory nested = extractor.getInventory(stack, player);
+            if (nested == null) continue;
+            int fromNested = takeFromInventory(
+                    nested,
+                    new FluidStack(resource, resource.amount - taken),
+                    simulate,
+                    player,
+                    -1,
+                    false);
+            if (fromNested <= 0) continue;
+            if (!simulate) nested.markDirty();
+            taken += fromNested;
+            break;
+        }
+        return taken;
+    }
+
+    /**
+     * Builtin extractor for containers implementing Forge's {@code IFluidContainerItem}, e.g. cells. Such containers
+     * keep their own fluid inside their NBT, so they are drained in place, and only turn into another item when their
+     * item declares a container item.
+     */
+    public static class ForgeFluidContainerItemExtractor implements FluidStackExtractor {
+
+        @Override
+        public boolean isValidSource(ItemStack stack) {
+            return stack != null && stack.getItem() instanceof IFluidContainerItem;
+        }
+
+        @Override
+        public int drain(ItemStack container, FluidStack resource, boolean simulate) {
+            IFluidContainerItem item = (IFluidContainerItem) container.getItem();
+            FluidStack contained = item.getFluid(container);
+            if (contained == null || !contained.isFluidEqual(resource)) return 0;
+            FluidStack drained = item.drain(container, Math.min(contained.amount, resource.amount), !simulate);
+            return drained == null ? 0 : Math.min(drained.amount, resource.amount);
+        }
+
+        @Override
+        public boolean convertsContainer(ItemStack container, FluidStack resource) {
+            Item item = container.getItem();
+            if (item == null || !item.hasContainerItem(container)) return false;
+            FluidStack contained = ((IFluidContainerItem) item).getFluid(container);
+            // The container only turns into another item when this drain empties it for good.
+            return contained != null && contained.amount <= resource.amount;
+        }
+
+        @Nullable
+        @Override
+        public ItemStack getReplacement(ItemStack container) {
+            Item item = container.getItem();
+            return item == null ? null : item.getContainerItem(container);
+        }
+    }
+
+    /**
+     * Builtin extractor for containers registered with Forge's {@code FluidContainerRegistry}, e.g. buckets. Such
+     * containers are consumed as a whole, and are replaced by their container item.
+     */
+    public static class ForgeFluidContainerRegistryExtractor implements FluidStackExtractor {
+
+        @Override
+        public boolean isValidSource(ItemStack stack) {
+            return stack != null && stack.getItem() != null && FluidContainerRegistry.isFilledContainer(stack);
+        }
+
+        @Override
+        public int drain(ItemStack container, FluidStack resource, boolean simulate) {
+            if (container.stackSize != 1) return 0;
+            FluidStack contained = FluidContainerRegistry.getFluidForFilledItem(container);
+            if (contained == null || !contained.isFluidEqual(resource)) return 0;
+            // A bucket cannot be half emptied. Report the whole bucket, even when only part of it is needed.
+            return contained.amount;
+        }
+
+        @Override
+        public boolean convertsContainer(ItemStack container, FluidStack resource) {
+            return container.stackSize == 1;
+        }
+
+        @Nullable
+        @Override
+        public ItemStack getReplacement(ItemStack container) {
+            Item item = container.getItem();
+            if (item != null && item.hasContainerItem(container)) return item.getContainerItem(container);
+            return null;
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/fluid/IFluidSource.java

@@ -0,0 +1,149 @@
+package com.gtnewhorizon.structurelib.fluid;
+
+import javax.annotation.Nonnull;
+
+import net.minecraft.entity.player.EntityPlayerMP;
+import net.minecraft.inventory.IInventory;
+import net.minecraftforge.common.util.ForgeDirection;
+import net.minecraftforge.fluids.FluidStack;
+import net.minecraftforge.fluids.IFluidHandler;
+
+/**
+ * Represent a source of fluid. Take only, cannot be put back. This is the fluid counterpart of the item source that
+ * survival autoplace already uses for blocks with an item form.
+ * <p>
+ * A structure element that has to place a fluid block asks the autoplace environment for a fluid source. When the
+ * environment doesn't carry one, StructureLib falls back to {@link #fromPlayer(EntityPlayerMP)} as long as the actor is
+ * a server side player, so multiblocks and third party tools that were written before this API existed keep working
+ * without any change.
+ * <p>
+ * Implementations are expected to be side effect free when {@code simulate} is true. A failed simulation followed by a
+ * successful one is not guaranteed to succeed, but it is not expected to happen either as autoplace runs on the server
+ * thread with no concurrent inventory modification.
+ */
+public interface IFluidSource {
+
+    /**
+     * Retrieve up to {@code resource.amount} of the given fluid from this source.
+     * <p>
+     * The given resource is never mutated.
+     *
+     * @param resource what fluid to extract, and how much of it at most. must have a positive amount.
+     * @param simulate whether to actually commit the modification. true for dry run, false otherwise.
+     * @return a new fluid stack describing what has actually been extracted. Never null. A zero amount means nothing
+     *         could be extracted. The returned stack keeps the NBT tag of the requested fluid.
+     * @throws IllegalArgumentException if the given resource is null or has no fluid
+     */
+    @Nonnull
+    FluidStack take(FluidStack resource, boolean simulate);
+
+    /**
+     * Take exactly {@code resource.amount} amount of fluid. Nothing is taken if the full amount isn't available.
+     *
+     * @param resource what fluid to extract, and how much of it. must have a positive amount.
+     * @param simulate whether to actually commit the modification. true for dry run, false otherwise.
+     * @return true if at least this much fluid can be/is taken.
+     * @throws IllegalArgumentException if the given resource is null or has no fluid
+     */
+    default boolean takeAll(FluidStack resource, boolean simulate) {
+        if (resource == null || resource.getFluid() == null) throw new IllegalArgumentException();
+        if (resource.amount <= 0) return true;
+        if (getAvailable(resource) < resource.amount) return false;
+        if (simulate) return true;
+        FluidStack taken = take(resource, false);
+        return taken != null && taken.amount >= resource.amount;
+    }
+
+    /**
+     * Query how much of the given fluid this source could provide right now.
+     *
+     * @param resource what fluid to query. must have a positive amount, which acts as the upper bound of the result.
+     * @return amount available, between 0 and {@code resource.amount} inclusive
+     * @throws IllegalArgumentException if the given resource is null or has no fluid
+     */
+    default int getAvailable(FluidStack resource) {
+        if (resource == null || resource.getFluid() == null) throw new IllegalArgumentException();
+        FluidStack taken = take(resource, true);
+        return taken == null ? 0 : Math.max(0, Math.min(taken.amount, resource.amount));
+    }
+
+    /**
+     * A source that never provides anything. Useful as a placeholder for a fluid source that is not available.
+     */
+    static IFluidSource empty() {
+        return (resource, simulate) -> {
+            if (resource == null || resource.getFluid() == null) throw new IllegalArgumentException();
+            return new FluidStack(resource, 0);
+        };
+    }
+
+    /**
+     * Combine several sources into one, asking them in order until the requested amount is met.
+     * <p>
+     * This is how a multiblock that wants its fluid to come from somewhere else than the player keeps the player's own
+     * containers as a fallback: {@code composite(custom, env.getEffectiveFluidSource())}.
+     *
+     * @param sources the sources to ask, in order. Null entries are skipped.
+     */
+    static IFluidSource composite(IFluidSource... sources) {
+        if (sources == null || sources.length == 0) return empty();
+        return (resource, simulate) -> {
+            if (resource == null || resource.getFluid() == null) throw new IllegalArgumentException();
+            int remaining = resource.amount;
+            for (IFluidSource source : sources) {
+                if (source == null || remaining <= 0) continue;
+                FluidStack taken = source.take(new FluidStack(resource, remaining), simulate);
+                if (taken == null || taken.amount <= 0) continue;
+                remaining -= Math.min(remaining, taken.amount);
+            }
+            return new FluidStack(resource, resource.amount - remaining);
+        };
+    }
+
+    /**
+     * Construct a fluid source from the fluid containers held by given player.
+     * <p>
+     * This will be backed by {@link FluidStackExtractors}, which covers every fluid container registered with Forge,
+     * and every container type registered by another mod through
+     * {@link FluidStackExtractors#register(String, FluidStackExtractor)}.
+     */
+    static IFluidSource fromPlayer(EntityPlayerMP player) {
+        return (resource, simulate) -> FluidStackExtractors.takeFromPlayer(player, resource, simulate);
+    }
+
+    /**
+     * Construct a fluid source from given inventory. Useful for multiblocks that want to drain fluid from a nearby
+     * machine instead of from the player.
+     * <p>
+     * This will be backed by {@link FluidStackExtractors}.
+     */
+    static IFluidSource fromInventory(IInventory inv) {
+        return (resource, simulate) -> FluidStackExtractors.takeFromInventory(inv, resource, simulate);
+    }
+
+    /**
+     * Construct a fluid source from a Forge fluid handler, e.g. a tank or a machine.
+     * <p>
+     * This is the intended way for a multiblock to pull fluid from a world container instead of from the player. A
+     * multiblock that wants to do so hands the source to autoplace through its own autoplace environment.
+     *
+     * @param handler the handler to drain from. must not be null.
+     * @param sides   sides to try, in order. An empty or null array means every side.
+     */
+    static IFluidSource fromHandler(IFluidHandler handler, ForgeDirection... sides) {
+        if (handler == null) throw new IllegalArgumentException();
+        ForgeDirection[] directions = sides == null || sides.length == 0 ? ForgeDirection.VALID_DIRECTIONS
+                : sides.clone();
+        return (resource, simulate) -> {
+            if (resource == null || resource.getFluid() == null) throw new IllegalArgumentException();
+            int remaining = resource.amount;
+            for (ForgeDirection direction : directions) {
+                if (remaining <= 0) break;
+                FluidStack drained = handler.drain(direction, new FluidStack(resource, remaining), !simulate);
+                if (drained == null || drained.getFluid() != resource.getFluid()) continue;
+                remaining -= Math.min(remaining, drained.amount);
+            }
+            return new FluidStack(resource, resource.amount - remaining);
+        };
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/fluid/IFluidSourceProvider.java

@@ -0,0 +1,28 @@
+package com.gtnewhorizon.structurelib.fluid;
+
+import javax.annotation.Nullable;
+
+import net.minecraft.entity.player.EntityPlayerMP;
+
+/**
+ * Offers a fluid source to ask before the fluid containers a player is carrying.
+ * <p>
+ * This is how a mod that can hand out fluid without an item in the player's inventory plugs into autoplace, e.g. the ME
+ * network behind a wireless fluid terminal the player has on them, or the tanks of a network the player has access to.
+ * Providers are registered in {@link FluidSourceProviders}, so the player can reorder or disable them in StructureLib's
+ * config like every other registered feature.
+ * <p>
+ * A provider is only ever asked for a server side player, and only while autoplace is placing a fluid block, so it does
+ * not have to be cheap, but it should still avoid work it can do lazily: the returned source is asked for fluid more
+ * than once, and should look up whatever it drains from at that point rather than when it is created.
+ */
+public interface IFluidSourceProvider {
+
+    /**
+     * A fluid source for the given player, or null when this provider has nothing to contribute right now.
+     *
+     * @param player the player the structure is being built for. never null, and never a client side player.
+     */
+    @Nullable
+    IFluidSource getFluidSource(EntityPlayerMP player);
+}

src/main/java/com/gtnewhorizon/structurelib/gui/EmptyContainer.java

@@ -0,0 +1,18 @@
+package com.gtnewhorizon.structurelib.gui;
+
+import net.minecraft.entity.player.EntityPlayer;
+import net.minecraft.inventory.Container;
+
+public class EmptyContainer extends Container {
+
+    private final EntityPlayer player;
+
+    public EmptyContainer(EntityPlayer player) {
+        this.player = player;
+    }
+
+    @Override
+    public boolean canInteractWith(EntityPlayer player) {
+        return player == this.player;
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/gui/GuiScreenConfigureChannels.java

@@ -0,0 +1,686 @@
+package com.gtnewhorizon.structurelib.gui;
+
+import java.util.AbstractMap;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Map.Entry;
+import java.util.Set;
+import java.util.stream.Collectors;
+import java.util.stream.StreamSupport;
+
+import net.minecraft.client.gui.GuiButton;
+import net.minecraft.client.gui.GuiTextField;
+import net.minecraft.client.gui.inventory.GuiContainer;
+import net.minecraft.client.renderer.Tessellator;
+import net.minecraft.client.resources.I18n;
+import net.minecraft.inventory.Container;
+import net.minecraft.item.ItemStack;
+import net.minecraft.util.EnumChatFormatting;
+import net.minecraft.util.ResourceLocation;
+import net.minecraft.util.StatCollector;
+
+import org.apache.commons.lang3.StringUtils;
+import org.lwjgl.input.Keyboard;
+import org.lwjgl.input.Mouse;
+import org.lwjgl.opengl.GL11;
+
+import com.google.common.base.Splitter;
+import com.gtnewhorizon.structurelib.ChannelDescription;
+import com.gtnewhorizon.structurelib.StructureLib;
+import com.gtnewhorizon.structurelib.alignment.constructable.ChannelDataAccessor;
+import com.gtnewhorizon.structurelib.gui.GuiScrollableList.IGuiScreen;
+
+import codechicken.nei.VisiblityData;
+import codechicken.nei.api.INEIGuiHandler;
+import codechicken.nei.api.TaggedInventoryArea;
+import cpw.mods.fml.common.Loader;
+import cpw.mods.fml.common.Optional;
+import gnu.trove.map.TIntObjectMap;
+import gnu.trove.map.hash.TIntObjectHashMap;
+
+@Optional.Interface(iface = "codechicken.nei.api.INEIGuiHandler", modid = "NotEnoughItems")
+public class GuiScreenConfigureChannels extends GuiContainer implements IGuiScreen, INEIGuiHandler {
+
+    private static final String I18N_PREFIX = "item.structurelib.constructableTrigger.gui.";
+
+    private static final int ADD_BTN = 0;
+    private static final int UNSET_BTN = 1;
+    private static final int WIPE_BTN = 2;
+
+    private static final int KEY_MAX_WIDTH = 50;
+    private static final int INFO_BOX_SIZE = 11;
+    private final ItemStack trigger;
+    private final GuiChannelsList list;
+    private final GuiAutoCompleteList autoCompleteList;
+    private final Map<String, List<String>> tooltipSplitCache = new HashMap<>();
+    private final TIntObjectMap<Map<String, String>> trimCache = new TIntObjectHashMap<>();
+    private GuiTextField key, value;
+    protected int guiTop, guiLeft;
+    private List<String> info;
+    private boolean wipePending = false;
+    private long wipePendingTime = 0;
+    private static final long WIPE_CONFIRM_TIMEOUT_MS = 3000;
+
+    public GuiScreenConfigureChannels(Container container, ItemStack trigger) {
+        super(container);
+
+        this.trigger = trigger;
+        list = new GuiChannelsList(152, 91, 12, 21, 14);
+        list.addSelectionListener((list, selectedIndex) -> {
+            Entry<String, Integer> e = list.getElementAt(selectedIndex);
+            key.setText(e.getKey());
+            value.setText(e.getValue().toString());
+            updateButtons();
+        });
+        autoCompleteList = new GuiAutoCompleteList(151 + 12 - 45 - 2, 50, 45, 119 + 12, 14);
+    }
+
+    @Override
+    public void initGui() {
+        super.initGui();
+        // so you can keep holding backspace to delete a long sequence of chars
+        Keyboard.enableRepeatEvents(true);
+
+        guiLeft = (this.width - this.getXSize()) / 2;
+        guiTop = (this.height - this.getYSize()) / 2;
+
+        key = new GuiTextField(fontRendererObj, guiLeft + 45, guiTop + 119, 151 + 12 - 45, 12) {
+
+            @Override
+            public void writeText(String text) {
+                // force lower case
+                super.writeText(text.toLowerCase(Locale.ROOT));
+                updateButtons();
+            }
+
+            @Override
+            public void mouseClicked(int p_146192_1_, int p_146192_2_, int p_146192_3_) {
+                super.mouseClicked(p_146192_1_, p_146192_2_, p_146192_3_);
+                boolean flag = p_146192_1_ >= this.xPosition && p_146192_1_ < this.xPosition + this.width
+                        && p_146192_2_ >= this.yPosition
+                        && p_146192_2_ < this.yPosition + this.height;
+                if (flag && p_146192_3_ == 1) {
+                    key.setText("");
+                    value.setText("");
+                }
+            }
+
+            @Override
+            public void setText(String p_146180_1_) {
+                super.setText(p_146180_1_);
+                updateButtons();
+            }
+        };
+        value = new GuiTextField(fontRendererObj, guiLeft + 45, guiTop + 139, 151 + 12 - 45, 12) {
+
+            @Override
+            public void writeText(String text) {
+                // ignore write requests containing non digit characters.
+                // we don't accept decimals or negative numbers, so we can safely use isDigit instead of something more
+                // advanced
+                // use codePoints() in case someone pasted an emoji by mistake
+                if (text != null && text.codePoints().allMatch(Character::isDigit)) {
+                    super.writeText(text);
+                    updateButtons();
+                }
+            }
+
+            @Override
+            public void setFocused(boolean p_146195_1_) {
+                if (!p_146195_1_ && isFocused() && !StringUtils.isBlank(getText())) {
+                    int result;
+                    try {
+                        result = Math.max(Integer.parseInt(getText()), 1);
+                    } catch (NumberFormatException e) {
+                        result = 1;
+                    }
+                    setText(String.valueOf(result));
+                }
+                super.setFocused(p_146195_1_);
+            }
+
+            @Override
+            public void mouseClicked(int p_146192_1_, int p_146192_2_, int p_146192_3_) {
+                super.mouseClicked(p_146192_1_, p_146192_2_, p_146192_3_);
+                boolean flag = p_146192_1_ >= this.xPosition && p_146192_1_ < this.xPosition + this.width
+                        && p_146192_2_ >= this.yPosition
+                        && p_146192_2_ < this.yPosition + this.height;
+                if (flag && p_146192_3_ == 1) {
+                    setText("");
+                }
+            }
+
+            @Override
+            public void setText(String p_146180_1_) {
+                super.setText(p_146180_1_);
+                updateButtons();
+            }
+        };
+
+        list.onGuiInit(this);
+        autoCompleteList.onGuiInit(this);
+
+        addButton(new GuiButton(ADD_BTN, guiLeft + 12, guiTop + 157, 47, 20, I18n.format(I18N_PREFIX + "add")));
+        addButton(new GuiButton(UNSET_BTN, guiLeft + 65, guiTop + 157, 47, 20, I18n.format(I18N_PREFIX + "unset")));
+        addButton(new GuiButton(WIPE_BTN, guiLeft + 118, guiTop + 157, 47, 20, I18n.format(I18N_PREFIX + "wipe")));
+
+        updateButtons();
+        tooltipSplitCache.clear();
+        info = StreamSupport
+                .stream(
+                        Splitter.on("\\n").split(StatCollector.translateToLocal(I18N_PREFIX + "info")).spliterator(),
+                        false)
+                .flatMap(line -> fontRendererObj.listFormattedStringToWidth(line, width * 1 / 3).stream())
+                .collect(Collectors.toList());
+    }
+
+    @Override
+    public int getGuiLeft() {
+        return guiLeft;
+    }
+
+    @Override
+    public int getGuiTop() {
+        return guiTop;
+    }
+
+    @Override
+    public int getXSize() {
+        return 176;
+    }
+
+    @Override
+    public int getYSize() {
+        return 188;
+    }
+
+    @Override
+    public void addButton(GuiButton button) {
+        getButtonList().add(button);
+    }
+
+    @Override
+    public void removeButton(GuiButton button) {
+        getButtonList().remove(button);
+    }
+
+    @Override
+    public int getOverlayOffsetX() {
+        return 0;
+    }
+
+    @Override
+    public void doActionPerformed(GuiButton but) {
+        actionPerformed(but);
+    }
+
+    public List<GuiButton> getButtonList() {
+        return buttonList;
+    }
+
+    private boolean isMouseOverValue() {
+        int mx = Mouse.getEventX() * this.width / this.mc.displayWidth;
+        int my = this.height - Mouse.getEventY() * this.height / this.mc.displayHeight - 1;
+        return mx >= value.xPosition && mx < value.xPosition + value.width
+                && my >= value.yPosition
+                && my < value.yPosition + value.height;
+
+    }
+
+    @Override
+    public void handleMouseInput() {
+        int delta = Mouse.getEventDWheel();
+        if (delta != 0) {
+            if (isMouseOverValue()) {
+                if (delta > 0) {
+                    value.setText(String.valueOf(getValue() + 1));
+                } else {
+                    value.setText(String.valueOf(Math.max(getValue() - 1, 1)));
+                }
+            } else {
+                list.handleDWheel(delta);
+            }
+        }
+        super.handleMouseInput();
+    }
+
+    @Override
+    protected void mouseClicked(int mX, int mY, int button) {
+        super.mouseClicked(mX, mY, button);
+        key.mouseClicked(mX, mY, button);
+        value.mouseClicked(mX, mY, button);
+    }
+
+    @Override
+    protected void keyTyped(char aChar, int aKey) {
+        GuiScrollableList<?> l = key.isFocused() ? autoCompleteList : list;
+        switch (aKey) {
+            case Keyboard.KEY_TAB:
+                if (key.isFocused()) {
+                    if (autoCompleteList.getSelectedElement() != null) {
+                        key.setText(autoCompleteList.getSelectedElement());
+                        return;
+                    }
+
+                    key.setFocused(false);
+                    value.setFocused(true);
+                } else {
+                    key.setFocused(true);
+                    value.setFocused(false);
+                }
+                return;
+            case Keyboard.KEY_RETURN:
+            case Keyboard.KEY_NUMPADENTER:
+                if (key.isFocused() && autoCompleteList.getSelectedElement() != null) {
+                    key.setText(autoCompleteList.getSelectedElement());
+                    key.setFocused(false);
+                    value.setFocused(true);
+                    value.setText("1");
+                    value.setSelectionPos(0);
+                    return;
+                }
+                GuiButton add = getButtonList().get(ADD_BTN);
+                if (add.enabled) doActionPerformed(add);
+                return;
+            case Keyboard.KEY_UP:
+                if (l.selectedIndex > 0) l.setSelection(l.selectedIndex - 1);
+                return;
+            case Keyboard.KEY_DOWN:
+                if (l.selectedIndex < l.getNumElements() - 1) l.setSelection(l.selectedIndex + 1);
+                return;
+            case Keyboard.KEY_ESCAPE:
+                if (key.isFocused()) {
+                    if (autoCompleteList.getSelectedElement() != null) {
+                        autoCompleteList.reset();
+                    } else {
+                        key.setFocused(false);
+                    }
+                    return;
+                }
+                break;
+        }
+        if (key.textboxKeyTyped(aChar, aKey) || value.textboxKeyTyped(aChar, aKey)) {
+            updateButtons();
+            return;
+        }
+        super.keyTyped(aChar, aKey);
+    }
+
+    private void updateButtons() {
+        // this will be called from setText of key and value. NEVER UPDATE THE VALUE OF THESE HERE OR GET A
+        // STACKOVERFLOW!
+        String keyText = key.getText();
+        boolean existing = !StringUtils.isEmpty(keyText) && ChannelDataAccessor.hasSubChannel(trigger, keyText);
+        getButtonList().get(ADD_BTN).displayString = existing ? I18n.format(I18N_PREFIX + "set")
+                : I18n.format(I18N_PREFIX + "add");
+        getButtonList().get(ADD_BTN).enabled = !StringUtils.isBlank(key.getText())
+                && !StringUtils.isBlank(value.getText())
+                && Integer.parseInt(value.getText()) > 0;
+        getButtonList().get(UNSET_BTN).enabled = existing && !StringUtils.isBlank(value.getText());
+
+        autoCompleteList.reset();
+    }
+
+    private int getValue() {
+        try {
+            return Integer.parseInt(value.getText());
+        } catch (NumberFormatException e) {
+            return -1;
+        }
+    }
+
+    @Override
+    protected void actionPerformed(GuiButton btn) {
+        if (btn == null) return;
+        switch (btn.id) {
+            case ADD_BTN:
+                int value = getValue();
+                if (value <= 0) return;
+                ChannelDataAccessor.setChannelData(trigger, key.getText(), value);
+                break;
+            case UNSET_BTN:
+                ChannelDataAccessor.unsetChannelData(trigger, key.getText());
+                break;
+            case WIPE_BTN:
+                if (!wipePending) {
+                    wipePending = true;
+                    wipePendingTime = System.currentTimeMillis();
+                    btn.displayString = I18n.format(I18N_PREFIX + "wipe.confirm");
+                } else {
+                    wipePending = false;
+                    btn.displayString = I18n.format(I18N_PREFIX + "wipe");
+                    ChannelDataAccessor.wipeChannelData(trigger);
+                    key.setText("");
+                    this.value.setText("");
+                }
+                break;
+        }
+
+        updateButtons();
+
+        super.actionPerformed(btn);
+    }
+
+    @Override
+    public void onGuiClosed() {
+        super.onGuiClosed();
+        Keyboard.enableRepeatEvents(false);
+        StructureLib.instance().proxy().uploadChannels(trigger);
+    }
+
+    @Override
+    public void updateScreen() {
+        super.updateScreen();
+        key.updateCursorCounter();
+        value.updateCursorCounter();
+        if (wipePending && System.currentTimeMillis() - wipePendingTime > WIPE_CONFIRM_TIMEOUT_MS) {
+            wipePending = false;
+            getButtonList().get(WIPE_BTN).displayString = I18n.format(I18N_PREFIX + "wipe");
+        }
+    }
+
+    @Override
+    public void drawGuiContainerBackgroundLayer(float partialTick, int mX, int mY) {
+        mc.renderEngine.bindTexture(new ResourceLocation("structurelib", "textures/gui/channels.png"));
+        int topLeftX = (this.width - this.getXSize()) / 2;
+        int topLeftY = (this.height - this.getYSize()) / 2;
+        drawTexturedModalRect(topLeftX, topLeftY, 0, 0, getXSize(), getYSize());
+        list.drawScreen(mX, mY, partialTick);
+        fontRendererObj.drawString(I18n.format(I18N_PREFIX + "title"), guiLeft + 12, guiTop + 9, 0);
+        fontRendererObj.drawString(I18n.format(I18N_PREFIX + "key"), guiLeft + 12, guiTop + 122, 0);
+        key.drawTextBox();
+        fontRendererObj.drawString(I18n.format(I18N_PREFIX + "value"), guiLeft + 12, guiTop + 142, 0);
+        value.drawTextBox();
+    }
+
+    @Override
+    protected void drawGuiContainerForegroundLayer(int mouseX, int mouseY) {
+        if (key.isFocused() && autoCompleteList.getNumElements() > 0) {
+            autoCompleteList.drawScreen(mouseX, mouseY, 0);
+        }
+    }
+
+    @Override
+    public void drawScreen(int mouseX, int mouseY, float partialTicks) {
+        super.drawScreen(mouseX, mouseY, partialTicks);
+        String highlight = null;
+        if (key.isFocused() && autoCompleteList.getNumElements() > 0) {
+            highlight = autoCompleteList.getSelectedElement();
+        }
+        if (highlight == null && ChannelDescription.has(key.getText())) {
+            highlight = key.getText();
+        }
+        if (highlight != null) {
+            drawChannelDescriptionTooltip(highlight);
+        }
+        if (mouseX > xSize + guiLeft - INFO_BOX_SIZE - 12 && mouseX < xSize + guiLeft - 12
+                && mouseY > guiTop + 7
+                && mouseY < guiTop + INFO_BOX_SIZE + 7) {
+            drawHoveringText(info, mouseX, mouseY, fontRendererObj);
+        }
+    }
+
+    private void drawChannelDescriptionTooltip(String candidate) {
+        List<String> tooltip = tooltipSplitCache.computeIfAbsent(candidate, this::getChannelDescriptionTooltip);
+        drawHoveringText(tooltip, guiLeft + 151 + 12, guiTop + 122, fontRendererObj);
+    }
+
+    private List<String> getChannelDescriptionTooltip(String candidate) {
+        List<String> tooltip = new ArrayList<>();
+        int maxLine = width - (guiLeft + 151 + 12) - 12;
+        for (Entry<String, String> e : ChannelDescription.get(candidate).getDescriptions().entrySet()) {
+            tooltip.addAll(
+                    fontRendererObj.listFormattedStringToWidth(
+                            StatCollector.translateToLocalFormatted(
+                                    I18N_PREFIX + "channels.from",
+                                    Loader.instance().getIndexedModList().get(e.getKey()).getName()),
+                            maxLine));
+            tooltip.addAll(
+                    fontRendererObj.listFormattedStringToWidth(StatCollector.translateToLocal(e.getValue()), maxLine));
+        }
+        return tooltip;
+    }
+
+    public String trim(String str, int keyMaxWidth) {
+        Map<String, String> cache = trimCache.get(keyMaxWidth);
+        if (cache == null) {
+            trimCache.put(keyMaxWidth, cache = new HashMap<>());
+        }
+        return cache.computeIfAbsent(str, e -> {
+            String s = fontRendererObj.trimStringToWidth(e, keyMaxWidth);
+            if (s.length() != e.length()) {
+                StringBuilder buffer = new StringBuilder(s).deleteCharAt(s.length() - 1).append("...");
+                while ((s = fontRendererObj.trimStringToWidth(buffer.toString(), keyMaxWidth)).length()
+                        != buffer.length())
+                    // drop last original char
+                    buffer.deleteCharAt(s.length() - 4);
+                do {
+                    buffer.append('.');
+                } while (fontRendererObj.getStringWidth(buffer.toString()) <= keyMaxWidth);
+                s = buffer.deleteCharAt(s.length() - 1).insert(s.length() - 3, EnumChatFormatting.GRAY).toString();
+            }
+            return s;
+        });
+    }
+
+    @Override
+    @Optional.Method(modid = "NotEnoughItems")
+    public VisiblityData modifyVisiblity(GuiContainer gui, VisiblityData currentVisibility) {
+        return null;
+    }
+
+    @Override
+    public Iterable<Integer> getItemSpawnSlots(GuiContainer gui, ItemStack item) {
+        return Collections.emptyList();
+    }
+
+    @Override
+    public List<TaggedInventoryArea> getInventoryAreas(GuiContainer gui) {
+        return Collections.emptyList();
+    }
+
+    @Override
+    public boolean handleDragNDrop(GuiContainer gui, int mousex, int mousey, ItemStack draggedStack, int button) {
+        if (button != 0 || mousex <= guiLeft
+                || mousey <= guiTop
+                || mousex >= guiLeft + getXSize()
+                || mousey >= guiTop + getYSize()) {
+            return false;
+        }
+        Collection<Entry<String, Integer>> channels = ChannelDescription.iterate(draggedStack);
+        switch (channels.size()) {
+            case 0:
+                return false;
+            case 1:
+            default: // TODO implement a GUI to select which pair to use, instead of blindly using the first
+                Entry<String, Integer> e = channels.iterator().next();
+                ChannelDataAccessor.setChannelData(trigger, e.getKey(), e.getValue());
+                key.setText(e.getKey());
+                value.setText(e.getValue().toString());
+                draggedStack.stackSize = 0;
+                return true;
+        }
+    }
+
+    @Override
+    public boolean hideItemPanelSlot(GuiContainer gui, int x, int y, int w, int h) {
+        return false;
+    }
+
+    private class GuiAutoCompleteList extends GuiScrollableList<String> {
+
+        private List<Entry<String, String>> cache; // <key, display string>
+
+        public GuiAutoCompleteList(int width, int height, int originX, int originY, int slotHeight) {
+            super(width, height, originX, originY, slotHeight);
+            margin = 2;
+        }
+
+        private List<Entry<String, String>> getOptions() {
+            if (cache == null) {
+                cache = search();
+            }
+            return cache;
+        }
+
+        private List<Entry<String, String>> search() {
+            List<Entry<String, String>> cache = new ArrayList<>();
+            Set<String> added = new HashSet<>();
+            String term = key.getText();
+            String[] subjects = ChannelDescription.getAll().keySet().toArray(new String[0]);
+            Arrays.sort(subjects);
+            if (StringUtils.isBlank(term)) {
+                // nothing. just gives out everything
+                for (String subject : subjects) {
+                    cache.add(new AbstractMap.SimpleImmutableEntry<>(subject, EnumChatFormatting.GRAY + subject));
+                }
+                return cache;
+            }
+            // prefix match
+            for (String s : subjects) {
+                if (s.startsWith(term)) {
+                    cache.add(
+                            new AbstractMap.SimpleImmutableEntry<>(
+                                    s,
+                                    term + EnumChatFormatting.GRAY + s.substring(term.length())));
+                    added.add(s);
+                }
+            }
+            // subsequence match
+            for (String subject : subjects) {
+                if (!added.contains(subject) && subject.length() > term.length()) {
+                    int i = 0, j = 0;
+                    StringBuilder sb = new StringBuilder();
+                    boolean mode = true;
+                    sb.append(EnumChatFormatting.WHITE);
+                    while (i < term.length() && j < subject.length()) {
+                        if (term.codePointAt(i) == subject.codePointAt(j)) {
+                            if (!mode) {
+                                sb.append(EnumChatFormatting.WHITE);
+                                mode = true;
+                            }
+                            sb.appendCodePoint(term.codePointAt(i));
+                            i++;
+                            j++;
+                        } else {
+                            if (mode) {
+                                sb.append(EnumChatFormatting.GRAY);
+                                mode = false;
+                            }
+                            sb.appendCodePoint(subject.codePointAt(j));
+                            j++;
+                        }
+                    }
+                    if (i == term.length()) {
+                        if (j < subject.length()) {
+                            sb.append(EnumChatFormatting.GRAY);
+                            sb.append(subject, j, subject.length());
+                        }
+                        cache.add(new AbstractMap.SimpleImmutableEntry<>(subject, sb.toString()));
+                        added.add(subject);
+                    }
+                }
+            }
+            return cache;
+        }
+
+        public void reset() {
+            cache = search();
+            selectedIndex = cache.isEmpty() ? -1 : 0;
+            resetScroll();
+        }
+
+        @Override
+        public String getElementAt(int index) {
+            return index >= 0 && index < cache.size() ? getOptions().get(index).getKey() : null;
+        }
+
+        @Override
+        public int getNumElements() {
+            return getOptions().size();
+        }
+
+        @Override
+        protected void drawElement(int elementIndex, int x, int y, int height, Tessellator tessellator,
+                boolean isHovering) {
+            int color = elementIndex == selectedIndex ? 0xffffff : 0xcccccc;
+            fontRendererObj.drawString(getOptions().get(elementIndex).getValue(), x + margin, y + margin / 2, color);
+        }
+    }
+
+    private class GuiChannelsList extends GuiScrollableList<Entry<String, Integer>> {
+
+        private List<Entry<String, Integer>> cache;
+
+        public GuiChannelsList(int width, int height, int originX, int originY, int slotHeight) {
+            super(width, height, originX, originY, slotHeight);
+        }
+
+        @Override
+        public Entry<String, Integer> getElementAt(int index) {
+            return ChannelDataAccessor.iterateChannelData(trigger).sorted().skip(index).findFirst().orElse(null);
+        }
+
+        @Override
+        public int getNumElements() {
+            return ChannelDataAccessor.countChannelData(trigger);
+        }
+
+        @Override
+        protected boolean elementClicked(int elementIndex, boolean doubleClick, int mXRelative, int mYRelative) {
+            if (mXRelative >= margin + 1 && mXRelative <= margin + 5
+                    && mYRelative >= margin / 2 + 1
+                    && mYRelative <= margin / 2 + 5) {
+                Entry<String, Integer> e = getElementAt(elementIndex);
+                if (e != null) {
+                    ChannelDataAccessor.unsetChannelData(trigger, e.getKey());
+                    updateButtons();
+                    return false;
+                }
+            }
+            return super.elementClicked(elementIndex, doubleClick, mXRelative, mYRelative);
+        }
+
+        @Override
+        protected void prepareDrawElements() {
+            cache = ChannelDataAccessor.iterateChannelData(trigger).sorted().collect(Collectors.toList());
+        }
+
+        @Override
+        protected void drawElement(int elementIndex, int x, int y, int height, Tessellator tessellator,
+                boolean isHovering) {
+            if (elementIndex < 0 || elementIndex >= cache.size()) {
+                return;
+            }
+            Entry<String, Integer> e = cache.get(elementIndex);
+            if (e == null) return;
+            if (elementIndex > 0) {
+                // args x1, x2, y1, color
+                drawHorizontalLine(minX + 1, maxX - 1, y - 2, 0xffaaaaaa);
+            }
+            int keyMaxWidth = KEY_MAX_WIDTH * 2;
+            if (isHovering) {
+                mc.renderEngine.bindTexture(new ResourceLocation("structurelib", "textures/gui/channels.png"));
+                GL11.glColor4f(1, 1, 1, 1);
+                drawTexturedModalRect(x + margin + 1, y + margin / 2 + 1, 251, 251, 5, 5);
+            }
+            fontRendererObj.drawString(trim(e.getKey(), keyMaxWidth - 9), x + margin + 8, y + margin / 2, 0xffffff);
+            int valueX = x + margin + keyMaxWidth + margin;
+            fontRendererObj.drawString(trim(e.getValue().toString(), maxX - valueX), valueX, y + margin / 2, 0xffffff);
+        }
+
+        @Override
+        public void drawScreen(int mX, int mY, float partialTick) {
+            super.drawScreen(mX, mY, partialTick);
+            // args x1, y1, y2, color
+            drawVerticalLine(minX + margin + margin / 2 + KEY_MAX_WIDTH * 2, minY + 1, maxY - 1, 0xffaaaaaa);
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/gui/GuiScrollableList.java

@@ -0,0 +1,468 @@
+package com.gtnewhorizon.structurelib.gui;
+
+import java.util.List;
+import java.util.concurrent.CopyOnWriteArrayList;
+
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.gui.GuiButton;
+import net.minecraft.client.gui.ScaledResolution;
+import net.minecraft.client.renderer.Tessellator;
+
+import org.lwjgl.input.Mouse;
+import org.lwjgl.opengl.GL11;
+
+/**
+ * Shamelessly stolen from EnderCore, with some amount of edit to fit in one file. Original code from CrazyPants.
+ * <p>
+ * As the code has been released into public domain, it is now LGPL as part of this library as a whole. You can go to
+ * EnderCore's repository to obtain a public domain copy though
+ * <p>
+ * Major edits
+ * <ul>
+ * <li>Separate dwheel handling to handleDWheel. The next event calls often cause the mouse click event to not fire on
+ * other widgets</li>
+ * <li>scrollbar are now rendered within width</li>
+ * <li>added prepareDrawElements</li>
+ * </ul>
+ *
+ * @author CrazyPants
+ * @author glee8e
+ */
+public abstract class GuiScrollableList<T> {
+
+    protected final int slotHeight;
+    private final Minecraft mc = Minecraft.getMinecraft();
+    protected final int originX;
+    protected final int originY;
+    protected final int width;
+    protected final int height;
+    protected int minY;
+    protected int maxY;
+    protected int minX;
+    protected int maxX;
+    protected int mouseX;
+    protected int mouseY;
+    protected int selectedIndex = -1;
+    protected int margin = 4;
+    protected final List<ListSelectionListener<T>> listeners = new CopyOnWriteArrayList<>();
+    private int scrollUpButtonID;
+    private int scrollDownButtonID;
+    private float initialClickY = -2.0F;
+    private float scrollMultiplier;
+    private float amountScrolled;
+    private long lastClickedTime;
+
+    private boolean showSelectionBox = true;
+
+    public GuiScrollableList(int width, int height, int originX, int originY, int slotHeight) {
+        this.width = width;
+        this.height = height;
+        this.originX = originX;
+        this.originY = originY;
+        this.slotHeight = slotHeight;
+
+        minY = originY;
+        maxY = minY + height;
+        minX = originX;
+        maxX = minX + width;
+    }
+
+    public void onGuiInit(IGuiScreen gui) {
+        minY = originY + gui.getGuiTop();
+        maxY = minY + height;
+        minX = originX + gui.getGuiLeft();
+        maxX = minX + width;
+    }
+
+    public void addSelectionListener(ListSelectionListener<T> listener) {
+        listeners.add(listener);
+    }
+
+    public void removeSelectionListener(ListSelectionListener<T> listener) {
+        listeners.remove(listener);
+    }
+
+    public T getSelectedElement() {
+        return getElementAt(selectedIndex);
+    }
+
+    public void setSelection(T selection) {
+        setSelection(getIndexOf(selection));
+    }
+
+    public void setSelection(int index) {
+        if (index == selectedIndex) {
+            return;
+        }
+        selectedIndex = index;
+        for (ListSelectionListener<T> listener : listeners) {
+            listener.selectionChanged(this, selectedIndex);
+        }
+    }
+
+    public int getIndexOf(T element) {
+        if (element == null) {
+            return -1;
+        }
+        for (int i = 0; i < getNumElements(); i++) {
+            if (element.equals(getElementAt(i))) {
+                return i;
+            }
+        }
+        return -1;
+    }
+
+    public abstract T getElementAt(int index);
+
+    public abstract int getNumElements();
+
+    protected abstract void drawElement(int elementIndex, int x, int y, int height, Tessellator tessellator,
+            boolean isHovering);
+
+    protected boolean elementClicked(int elementIndex, boolean doubleClick, int mXRelative, int mYRelative) {
+        return true;
+    }
+
+    public void setShowSelectionBox(boolean val) {
+        showSelectionBox = val;
+    }
+
+    protected int getContentHeight() {
+        return getNumElements() * slotHeight;
+    }
+
+    public void setScrollButtonIds(int scrollUpButtonID, int scrollDownButtonID) {
+        this.scrollUpButtonID = scrollUpButtonID;
+        this.scrollDownButtonID = scrollDownButtonID;
+    }
+
+    private void clampScrollToBounds() {
+        int i = getContentOverhang();
+        if (i < 0) {
+            i *= -1;
+        }
+        if (amountScrolled < 0.0F) {
+            amountScrolled = 0.0F;
+        }
+        if (amountScrolled > i) {
+            amountScrolled = i;
+        }
+    }
+
+    public int getContentOverhang() {
+        return getContentHeight() - (height - margin);
+    }
+
+    public void actionPerformed(GuiButton b) {
+        if (b.enabled) {
+            if (b.id == scrollUpButtonID) {
+                amountScrolled -= slotHeight * 2f / 3;
+                initialClickY = -2.0F;
+                clampScrollToBounds();
+            } else if (b.id == scrollDownButtonID) {
+                amountScrolled += slotHeight * 2f / 3;
+                initialClickY = -2.0F;
+                clampScrollToBounds();
+            }
+        }
+    }
+
+    protected void resetScroll() {
+        amountScrolled = 0;
+    }
+
+    /**
+     * draws the slot to the screen, pass in mouse's current x and y and partial ticks
+     */
+    public void drawScreen(int mX, int mY, float partialTick) {
+        GL11.glPushMatrix();
+        GL11.glLoadIdentity();
+        GL11.glTranslatef(0.0F, 0.0F, -2000.0F);
+        this.mouseX = mX;
+        this.mouseY = mY;
+
+        processMouseEvents();
+
+        if (getContentOverhang() > 0) maxX = minX + width - 6;
+        else maxX = minX + width;
+
+        clampScrollToBounds();
+
+        GL11.glDisable(GL11.GL_LIGHTING);
+        GL11.glDisable(GL11.GL_FOG);
+
+        ScaledResolution sr = new ScaledResolution(mc, mc.displayWidth, mc.displayHeight);
+        int sx = minX * sr.getScaleFactor();
+        int sw = width * sr.getScaleFactor();
+        int sy = mc.displayHeight - (maxY * sr.getScaleFactor());
+        int sh = height * sr.getScaleFactor();
+        GL11.glEnable(GL11.GL_SCISSOR_TEST);
+        GL11.glScissor(sx, sy, sw, sh);
+
+        Tessellator tessellator = Tessellator.instance;
+        drawContainerBackground(tessellator);
+
+        int amountScrolled = (int) this.amountScrolled;
+        int contentYOffset = this.minY + margin - amountScrolled;
+
+        boolean hoveringPrecondition = mX >= minX && mX <= maxX && mY >= minY && mY <= maxY;
+        int slotHeight = this.slotHeight - margin;
+
+        if (selectedIndex != -1) {
+            int elementY = contentYOffset + selectedIndex * this.slotHeight;
+            if (elementY + slotHeight > maxY) {
+                this.amountScrolled = (selectedIndex + 1) * this.slotHeight - this.height + margin;
+                amountScrolled = (int) this.amountScrolled;
+                contentYOffset = this.minY + margin - amountScrolled;
+            } else if (elementY < minY) {
+                this.amountScrolled = selectedIndex * this.slotHeight;
+                amountScrolled = (int) this.amountScrolled;
+                contentYOffset = this.minY + margin - amountScrolled;
+            }
+        }
+
+        prepareDrawElements();
+
+        for (int i = 0; i < getNumElements(); ++i) {
+
+            int elementY = contentYOffset + i * this.slotHeight;
+
+            if (elementY <= maxY && elementY + slotHeight >= minY) {
+
+                if (showSelectionBox && i == selectedIndex) {
+                    GL11.glColor4f(1.0F, 1.0F, 1.0F, 1.0F);
+                    GL11.glDisable(GL11.GL_TEXTURE_2D);
+                    tessellator.startDrawingQuads();
+                    tessellator.setColorOpaque_I(8421504);
+                    tessellator.addVertexWithUV(minX, elementY + slotHeight + 2, 0.0D, 0.0D, 1.0D);
+                    tessellator.addVertexWithUV(maxX, elementY + slotHeight + 2, 0.0D, 1.0D, 1.0D);
+                    tessellator.addVertexWithUV(maxX, elementY - 2, 0.0D, 1.0D, 0.0D);
+                    tessellator.addVertexWithUV(minX, elementY - 2, 0.0D, 0.0D, 0.0D);
+                    tessellator.setColorOpaque_I(0);
+                    tessellator.addVertexWithUV(minX + 1, elementY + slotHeight + 1, 0.0D, 0.0D, 1.0D);
+                    tessellator.addVertexWithUV(maxX - 1, elementY + slotHeight + 1, 0.0D, 1.0D, 1.0D);
+                    tessellator.addVertexWithUV(maxX - 1, elementY - 1, 0.0D, 1.0D, 0.0D);
+                    tessellator.addVertexWithUV(minX + 1, elementY - 1, 0.0D, 0.0D, 0.0D);
+                    tessellator.draw();
+                    GL11.glEnable(GL11.GL_TEXTURE_2D);
+                }
+
+                boolean isHovering = hoveringPrecondition && elementY - 2 <= mY && mY < elementY + slotHeight + 2;
+                drawElement(i, minX, elementY, slotHeight, tessellator, isHovering);
+            }
+        }
+
+        GL11.glDisable(GL11.GL_SCISSOR_TEST);
+
+        GL11.glDisable(GL11.GL_DEPTH_TEST);
+        GL11.glEnable(GL11.GL_BLEND);
+        GL11.glBlendFunc(GL11.GL_SRC_ALPHA, GL11.GL_ONE_MINUS_SRC_ALPHA);
+        GL11.glDisable(GL11.GL_ALPHA_TEST);
+        GL11.glShadeModel(GL11.GL_SMOOTH);
+        GL11.glDisable(GL11.GL_TEXTURE_2D);
+
+        tessellator.startDrawingQuads();
+        tessellator.setColorRGBA_I(0, 0);
+        tessellator.addVertexWithUV(this.minX, this.minY + margin, 0.0D, 0.0D, 1.0D);
+        tessellator.addVertexWithUV(this.maxX, this.minY + margin, 0.0D, 1.0D, 1.0D);
+        tessellator.setColorRGBA_I(0, 255);
+        tessellator.addVertexWithUV(this.maxX, this.minY, 0.0D, 1.0D, 0.0D);
+        tessellator.addVertexWithUV(this.minX, this.minY, 0.0D, 0.0D, 0.0D);
+        tessellator.draw();
+        tessellator.startDrawingQuads();
+        tessellator.setColorRGBA_I(0, 255);
+        tessellator.addVertexWithUV(this.minX, this.maxY, 0.0D, 0.0D, 1.0D);
+        tessellator.addVertexWithUV(this.maxX, this.maxY, 0.0D, 1.0D, 1.0D);
+        tessellator.setColorRGBA_I(0, 0);
+        tessellator.addVertexWithUV(this.maxX, this.maxY - margin, 0.0D, 1.0D, 0.0D);
+        tessellator.addVertexWithUV(this.minX, this.maxY - margin, 0.0D, 0.0D, 0.0D);
+        tessellator.draw();
+
+        renderScrollBar(tessellator);
+
+        GL11.glEnable(GL11.GL_TEXTURE_2D);
+        GL11.glShadeModel(GL11.GL_FLAT);
+        GL11.glEnable(GL11.GL_ALPHA_TEST);
+        GL11.glDisable(GL11.GL_BLEND);
+        GL11.glPopMatrix();
+    }
+
+    protected void prepareDrawElements() {}
+
+    protected void renderScrollBar(Tessellator tessellator) {
+
+        int contentHeightOverBounds = getContentOverhang();
+        if (contentHeightOverBounds > 0) {
+
+            int clear = (maxY - minY) * (maxY - minY) / getContentHeight();
+
+            if (clear < 32) {
+                clear = 32;
+            }
+
+            if (clear > maxY - minY - 8) {
+                clear = maxY - minY - 8;
+            }
+
+            int y = (int) this.amountScrolled * (maxY - minY - clear) / contentHeightOverBounds + minY;
+            if (y < minY) {
+                y = minY;
+            }
+
+            GL11.glDisable(GL11.GL_TEXTURE_2D);
+            int scrollBarMinX = getScrollBarX();
+            int scrollBarMaxX = scrollBarMinX + 6;
+            tessellator.startDrawingQuads();
+
+            tessellator.setColorRGBA_I(0, 255);
+            tessellator.addVertexWithUV(scrollBarMinX, maxY, 0.0D, 0.0D, 1.0D);
+            tessellator.addVertexWithUV(scrollBarMaxX, maxY, 0.0D, 1.0D, 1.0D);
+            tessellator.addVertexWithUV(scrollBarMaxX, minY, 0.0D, 1.0D, 0.0D);
+            tessellator.addVertexWithUV(scrollBarMinX, minY, 0.0D, 0.0D, 0.0D);
+
+            tessellator.setColorRGBA_F(0.3f, 0.3f, 0.3f, 1);
+            tessellator.addVertexWithUV(scrollBarMinX, (y + clear), 0.0D, 0.0D, 1.0D);
+            tessellator.addVertexWithUV(scrollBarMaxX, (y + clear), 0.0D, 1.0D, 1.0D);
+            tessellator.addVertexWithUV(scrollBarMaxX, y, 0.0D, 1.0D, 0.0D);
+            tessellator.addVertexWithUV(scrollBarMinX, y, 0.0D, 0.0D, 0.0D);
+
+            tessellator.setColorRGBA_F(0.7f, 0.7f, 0.7f, 1);
+            tessellator.addVertexWithUV(scrollBarMinX, (y + clear - 1), 0.0D, 0.0D, 1.0D);
+            tessellator.addVertexWithUV((scrollBarMaxX - 1), (y + clear - 1), 0.0D, 1.0D, 1.0D);
+            tessellator.addVertexWithUV((scrollBarMaxX - 1), y, 0.0D, 1.0D, 0.0D);
+            tessellator.addVertexWithUV(scrollBarMinX, y, 0.0D, 0.0D, 0.0D);
+
+            tessellator.draw();
+            GL11.glEnable(GL11.GL_TEXTURE_2D);
+        }
+    }
+
+    private void processMouseEvents() {
+        if (Mouse.isButtonDown(0)) {
+            processMouseBown();
+        } else {
+            initialClickY = -1.0F;
+        }
+    }
+
+    public void handleDWheel(int mouseWheelDelta) {
+        if (!Mouse.isButtonDown(0)) {
+            if (mouseWheelDelta > 0) {
+                amountScrolled -= slotHeight / 2f;
+            } else /* if (mouseWheelDelta < 0) */ {
+                amountScrolled += slotHeight / 2f;
+            }
+        }
+    }
+
+    private void processMouseBown() {
+        int contentHeightOverBounds;
+        if (initialClickY == -1.0F) {
+
+            if (mouseY >= minY && mouseY <= maxY && mouseX >= minX && mouseX <= maxX + 6) {
+
+                boolean clickInBounds = true;
+
+                int y = mouseY - minY + (int) amountScrolled - margin;
+                int mouseOverElement = y / slotHeight;
+
+                if (mouseX >= minX && mouseX <= maxX
+                        && mouseOverElement >= 0
+                        && y >= 0
+                        && mouseOverElement < getNumElements()) {
+                    boolean doubleClick = mouseOverElement == selectedIndex
+                            && Minecraft.getSystemTime() - lastClickedTime < 250L;
+                    if (elementClicked(
+                            mouseOverElement,
+                            doubleClick,
+                            mouseX - minX,
+                            y - slotHeight * mouseOverElement)) {
+                        setSelection(mouseOverElement);
+                        lastClickedTime = Minecraft.getSystemTime();
+                    }
+                } else if (mouseX >= minX && mouseX <= maxX && y < 0) {
+                    clickInBounds = false;
+                }
+
+                int scrollBarMinX = getScrollBarX();
+                int scrollBarMaxX = scrollBarMinX + 6;
+                if (mouseX >= scrollBarMinX && mouseX <= scrollBarMaxX) {
+
+                    scrollMultiplier = -1.0F;
+                    contentHeightOverBounds = getContentOverhang();
+
+                    if (contentHeightOverBounds < 1) {
+                        contentHeightOverBounds = 1;
+                    }
+
+                    int empty = (int) ((float) ((maxY - minY) * (maxY - minY)) / (float) getContentHeight());
+                    if (empty < 32) {
+                        empty = 32;
+                    }
+                    if (empty > maxY - minY - 8) {
+                        empty = maxY - minY - 8;
+                    }
+                    scrollMultiplier /= (float) (maxY - minY - empty) / (float) contentHeightOverBounds;
+
+                } else {
+                    scrollMultiplier = 1.0F;
+                }
+
+                if (clickInBounds) {
+                    initialClickY = mouseY;
+                } else {
+                    initialClickY = -2.0F;
+                }
+
+            } else {
+                initialClickY = -2.0F;
+            }
+
+        } else if (initialClickY >= 0.0F) {
+            // Scrolling
+            amountScrolled -= (mouseY - initialClickY) * scrollMultiplier;
+            initialClickY = mouseY;
+        }
+    }
+
+    protected int getScrollBarX() {
+        return maxX;
+    }
+
+    protected void drawContainerBackground(Tessellator tess) {
+        GL11.glColor4f(1.0F, 1.0F, 1.0F, 1.0F);
+        GL11.glDisable(GL11.GL_TEXTURE_2D);
+        tess.startDrawingQuads();
+        tess.setColorOpaque_I(0x202020);
+        tess.addVertex(minX, maxY, 0.0D);
+        tess.addVertex(maxX, maxY, 0.0D);
+        tess.addVertex(maxX, minY, 0.0D);
+        tess.addVertex(minX, minY, 0.0D);
+        tess.draw();
+        GL11.glEnable(GL11.GL_TEXTURE_2D);
+    }
+
+    public interface IGuiScreen {
+
+        int getGuiLeft();
+
+        int getGuiTop();
+
+        int getXSize();
+
+        int getYSize();
+
+        void addButton(GuiButton button);
+
+        void removeButton(GuiButton button);
+
+        int getOverlayOffsetX();
+
+        void doActionPerformed(GuiButton but);
+    }
+
+    public interface ListSelectionListener<T> {
+
+        void selectionChanged(GuiScrollableList<T> list, int selectedIndex);
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/item/ItemBlockHint.java

@@ -1,5 +1,9 @@
 package com.gtnewhorizon.structurelib.item;
 
+import static net.minecraft.util.StatCollector.translateToLocal;
+
+import java.util.List;
+
 import net.minecraft.block.Block;
 import net.minecraft.creativetab.CreativeTabs;
 import net.minecraft.entity.player.EntityPlayer;
@@ -7,60 +11,69 @@ import net.minecraft.item.ItemBlock;
 import net.minecraft.item.ItemStack;
 import net.minecraft.util.EnumChatFormatting;
 
-import java.util.List;
-
-import static net.minecraft.util.StatCollector.translateToLocal;
-
 public class ItemBlockHint extends ItemBlock {
-	public ItemBlockHint(Block p_i45328_1_) {
-		super(p_i45328_1_);
-		setMaxDamage(0);
-		setHasSubtypes(true);
-		setCreativeTab(CreativeTabs.tabBlock);
-	}
 
-	@Override
-	@SuppressWarnings("unchecked")
-	public void addInformation(ItemStack aStack, EntityPlayer aPlayer, List aList, boolean aF3_H) {
-		aList.add(translateToLocal("structurelib.blockhint.desc.0"));//Helps while building
-		switch (aStack.getItemDamage()) {
-			case 0:
-			case 1:
-			case 2:
-			case 3:
-			case 4:
-			case 5:
-			case 6:
-			case 7:
-			case 8:
-			case 9:
-			case 10:
-			case 11:
-				aList.add(EnumChatFormatting.AQUA.toString() + EnumChatFormatting.BOLD + translateToLocal("structurelib.blockhint.desc.1"));//Placeholder for a certain group.
-				break;
-			case 12:
-				aList.add(EnumChatFormatting.AQUA.toString() + EnumChatFormatting.BOLD + translateToLocal("structurelib.blockhint.desc.2"));//General placeholder.
-				break;
-			case 13:
-				aList.add(EnumChatFormatting.AQUA.toString() + EnumChatFormatting.BOLD + translateToLocal("structurelib.blockhint.desc.3"));//Make sure it contains Air material.
-				break;
-			case 14:
-				aList.add(EnumChatFormatting.AQUA.toString() + EnumChatFormatting.BOLD + translateToLocal("structurelib.blockhint.desc.4"));//Make sure it does not contain Air material.
-				break;
-			case 15:
-				aList.add(EnumChatFormatting.BLUE.toString() + translateToLocal("structurelib.blockhint.desc.5"));//ERROR, what did u expect?
-				break;
-			default://WTF?
-				aList.add("Damn son where did you get that!?");
-				aList.add(EnumChatFormatting.BLUE.toString() + "From outer space... I guess...");
-		}
-	}
+    public ItemBlockHint(Block p_i45328_1_) {
+        super(p_i45328_1_);
+        setMaxDamage(0);
+        setHasSubtypes(true);
+        setCreativeTab(CreativeTabs.tabBlock);
+    }
 
-	public int getMetadata(int aMeta) {
-		return aMeta;
-	}
+    @Override
+    public void addInformation(ItemStack stack, EntityPlayer player, List<String> tooltip, boolean adv) {
+        tooltip.add(translateToLocal("structurelib.blockhint.desc.0")); // Helps while building
+        switch (stack.getItemDamage()) {
+            case 0:
+            case 1:
+            case 2:
+            case 3:
+            case 4:
+            case 5:
+            case 6:
+            case 7:
+            case 8:
+            case 9:
+            case 10:
+            case 11:
+                // Placeholder for a certain group.
+                tooltip.add(
+                        EnumChatFormatting.AQUA.toString() + EnumChatFormatting.BOLD
+                                + translateToLocal("structurelib.blockhint.desc.1"));
+                break;
+            case 12:
+                // General placeholder.
+                tooltip.add(
+                        EnumChatFormatting.AQUA.toString() + EnumChatFormatting.BOLD
+                                + translateToLocal("structurelib.blockhint.desc.2"));
+                break;
+            case 13:
+                // Make sure it contains Air material.
+                tooltip.add(
+                        EnumChatFormatting.AQUA.toString() + EnumChatFormatting.BOLD
+                                + translateToLocal("structurelib.blockhint.desc.3"));
+                break;
+            case 14:
+                // Make sure it does not contain Air material.
+                tooltip.add(
+                        EnumChatFormatting.AQUA.toString() + EnumChatFormatting.BOLD
+                                + translateToLocal("structurelib.blockhint.desc.4"));
+                break;
+            case 15:
+                // ERROR, what did u expect?
+                tooltip.add(EnumChatFormatting.BLUE + translateToLocal("structurelib.blockhint.desc.5"));
+                break;
+            default: // WTF?
+                tooltip.add("Damn son where did you get that!?");
+                tooltip.add(EnumChatFormatting.BLUE + "From outer space... I guess...");
+        }
+    }
 
-	public String getUnlocalizedName(ItemStack aStack) {
-		return this.field_150939_a.getUnlocalizedName() + "." + getDamage(aStack);
-	}
+    public int getMetadata(int aMeta) {
+        return aMeta;
+    }
+
+    public String getUnlocalizedName(ItemStack aStack) {
+        return this.field_150939_a.getUnlocalizedName() + "." + getDamage(aStack);
+    }
 }

src/main/java/com/gtnewhorizon/structurelib/item/ItemConstructableTrigger.java

@@ -1,19 +1,25 @@
 package com.gtnewhorizon.structurelib.item;
 
-import com.gtnewhorizon.structurelib.StructureLib;
-import com.gtnewhorizon.structurelib.alignment.constructable.ConstructableUtility;
+import static com.gtnewhorizon.structurelib.StructureLibAPI.MOD_ID;
+import static net.minecraft.util.EnumChatFormatting.BLUE;
+import static net.minecraft.util.StatCollector.translateToLocal;
+import static net.minecraft.util.StatCollector.translateToLocalFormatted;
+
+import java.util.List;
+
 import net.minecraft.entity.player.EntityPlayer;
 import net.minecraft.item.Item;
 import net.minecraft.item.ItemStack;
 import net.minecraft.world.World;
 
-import java.util.List;
+import org.lwjgl.input.Keyboard;
 
-import static com.gtnewhorizon.structurelib.StructureLibAPI.MOD_ID;
-import static net.minecraft.util.EnumChatFormatting.BLUE;
-import static net.minecraft.util.StatCollector.translateToLocal;
+import com.gtnewhorizon.structurelib.StructureLib;
+import com.gtnewhorizon.structurelib.alignment.constructable.ChannelDataAccessor;
+import com.gtnewhorizon.structurelib.alignment.constructable.ConstructableUtility;
 
 public class ItemConstructableTrigger extends Item {
+
     public ItemConstructableTrigger() {
         setUnlocalizedName("structurelib.constructableTrigger");
         setTextureName(MOD_ID + ":itemConstructableTrigger");
@@ -21,17 +27,48 @@ public class ItemConstructableTrigger extends Item {
     }
 
     @Override
-    public boolean onItemUseFirst(ItemStack stack, EntityPlayer player, World world, int x, int y, int z, int side, float hitX, float hitY, float hitZ) {
+    public ItemStack onItemRightClick(ItemStack stack, World world, EntityPlayer player) {
+        if (getMovingObjectPositionFromPlayer(world, player, true) == null) {
+            // channel gui is opened from server and config gui from client
+            if (!world.isRemote && !player.isSneaking()) {
+                player.openGui(StructureLib.instance(), 0, world, player.inventory.currentItem, 0, 0);
+            } else if (world.isRemote && player.isSneaking()) {
+                StructureLib.instance().proxy().displayConfigGUI("registries");
+            }
+        }
+        return super.onItemRightClick(stack, world, player);
+    }
+
+    @Override
+    public boolean onItemUseFirst(ItemStack stack, EntityPlayer player, World world, int x, int y, int z, int side,
+            float hitX, float hitY, float hitZ) {
         return ConstructableUtility.handle(stack, player, world, x, y, z, side);
     }
 
-    @SuppressWarnings("unchecked")
     @Override
-    public void addInformation(ItemStack aStack, EntityPlayer ep, List aList, boolean boo) {
-        aList.add(translateToLocal("item.structurelib.constructableTrigger.desc.0"));//Triggers Constructable Interface
-        aList.add(BLUE + translateToLocal("item.structurelib.constructableTrigger.desc.1"));//Shows multiblock construction details,
-        aList.add(BLUE + translateToLocal("item.structurelib.constructableTrigger.desc.2"));//just Use on a multiblock controller.
-        aList.add(BLUE + translateToLocal("item.structurelib.constructableTrigger.desc.3"));//(Sneak Use in creative to build)
-        aList.add(BLUE + translateToLocal("item.structurelib.constructableTrigger.desc.4"));//Quantity affects tier/mode/type
+    public void addInformation(ItemStack stack, EntityPlayer player, List<String> tooltip, boolean adv) {
+        if (Keyboard.isKeyDown(Keyboard.KEY_LSHIFT)) {
+            tooltip.add(
+                    translateToLocalFormatted(
+                            "item.structurelib.constructableTrigger.desc.lshift.0",
+                            ChannelDataAccessor.countChannelData(stack)));
+            ChannelDataAccessor.iterateChannelData(stack).map(e -> e.getKey() + ": " + e.getValue())
+                    .forEach(tooltip::add);
+        } else {
+            // Tooltip text:
+            // Triggers Constructable Interface
+            // Shows multiblock construction details,
+            // just Use on a multiblock controller.
+            // (Sneak Use in creative to build)
+            // Quantity affects tier/mode/type
+
+            tooltip.add(translateToLocal("item.structurelib.constructableTrigger.desc.0"));
+            tooltip.add(BLUE + translateToLocal("item.structurelib.constructableTrigger.desc.1"));
+            tooltip.add(BLUE + translateToLocal("item.structurelib.constructableTrigger.desc.2"));
+            tooltip.add(BLUE + translateToLocal("item.structurelib.constructableTrigger.desc.3"));
+            tooltip.add(BLUE + translateToLocal("item.structurelib.constructableTrigger.desc.4"));
+            if (ChannelDataAccessor.hasSubChannel(stack))
+                tooltip.add(translateToLocal("item.structurelib.constructableTrigger.desc.5"));
+        }
     }
 }

src/main/java/com/gtnewhorizon/structurelib/item/ItemFrontRotationTool.java

@@ -1,38 +1,47 @@
 package com.gtnewhorizon.structurelib.item;
 
-import com.gtnewhorizon.structurelib.StructureLib;
-import com.gtnewhorizon.structurelib.alignment.AlignmentUtility;
-import cpw.mods.fml.relauncher.Side;
-import cpw.mods.fml.relauncher.SideOnly;
+import static com.gtnewhorizon.structurelib.StructureLibAPI.MOD_ID;
+import static net.minecraft.util.StatCollector.translateToLocal;
+
+import java.util.List;
+
 import net.minecraft.entity.player.EntityPlayer;
 import net.minecraft.item.Item;
 import net.minecraft.item.ItemStack;
 import net.minecraft.util.EnumChatFormatting;
 import net.minecraft.world.World;
 
-import java.util.List;
+import com.gtnewhorizon.structurelib.StructureLib;
+import com.gtnewhorizon.structurelib.alignment.AlignmentUtility;
 
-import static com.gtnewhorizon.structurelib.StructureLibAPI.MOD_ID;
-import static net.minecraft.util.StatCollector.translateToLocal;
+import cpw.mods.fml.relauncher.Side;
+import cpw.mods.fml.relauncher.SideOnly;
 
 public class ItemFrontRotationTool extends Item {
-	public ItemFrontRotationTool() {
-		setMaxStackSize(1);
-		setUnlocalizedName("structurelib.frontRotationTool");
-		setTextureName(MOD_ID + ":itemFrontRotationTool");
-		setCreativeTab(StructureLib.creativeTab);
-	}
 
-	@Override
-	public boolean onItemUseFirst(ItemStack stack, EntityPlayer player, World world, int x, int y, int z, int side, float hitX, float hitY, float hitZ) {
-		return AlignmentUtility.handle(player, world, x, y, z);
-	}
+    public ItemFrontRotationTool() {
+        setMaxStackSize(1);
+        setUnlocalizedName("structurelib.frontRotationTool");
+        setTextureName(MOD_ID + ":itemFrontRotationTool");
+        setCreativeTab(StructureLib.creativeTab);
+    }
 
-	@Override
-	@SideOnly(Side.CLIENT)
-	public void addInformation(ItemStack p_77624_1_, EntityPlayer p_77624_2_, List aList, boolean p_77624_4_) {
-		aList.add(translateToLocal("item.structurelib.frontRotationTool.desc.0"));//Triggers Front Rotation Interface
-		aList.add(EnumChatFormatting.BLUE + translateToLocal("item.structurelib.frontRotationTool.desc.1"));//Rotates only the front panel,
-		aList.add(EnumChatFormatting.BLUE + translateToLocal("item.structurelib.frontRotationTool.desc.2"));//which allows structure rotation.
-	}
+    @Override
+    public boolean onItemUseFirst(ItemStack stack, EntityPlayer player, World world, int x, int y, int z, int side,
+            float hitX, float hitY, float hitZ) {
+        return AlignmentUtility.handle(player, world, x, y, z);
+    }
+
+    @Override
+    @SideOnly(Side.CLIENT)
+    public void addInformation(ItemStack stack, EntityPlayer player, List<String> tooltip, boolean adv) {
+        // Tooltip Text:
+        // Triggers Front Rotation Interface
+        // Rotates only the front panel,
+        // which allows structure rotation.
+
+        tooltip.add(translateToLocal("item.structurelib.frontRotationTool.desc.0"));
+        tooltip.add(EnumChatFormatting.BLUE + translateToLocal("item.structurelib.frontRotationTool.desc.1"));
+        tooltip.add(EnumChatFormatting.BLUE + translateToLocal("item.structurelib.frontRotationTool.desc.2"));
+    }
 }

src/main/java/com/gtnewhorizon/structurelib/mixins/TargetedMod.java

@@ -0,0 +1,30 @@
+package com.gtnewhorizon.structurelib.mixins;
+
+import cpw.mods.fml.common.Mod;
+
+public enum TargetedMod {
+
+    VANILLA("Minecraft", null);
+
+    /** The "name" in the {@link Mod @Mod} annotation */
+    public final String modName;
+    /** Class that implements the IFMLLoadingPlugin interface */
+    public final String coreModClass;
+    /** The "modid" in the {@link Mod @Mod} annotation */
+    public final String modId;
+
+    TargetedMod(String modName, String coreModClass) {
+        this(modName, coreModClass, null);
+    }
+
+    TargetedMod(String modName, String coreModClass, String modId) {
+        this.modName = modName;
+        this.coreModClass = coreModClass;
+        this.modId = modId;
+    }
+
+    @Override
+    public String toString() {
+        return "TargetedMod{modName='" + modName + "', coreModClass='" + coreModClass + "', modId='" + modId + "'}";
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/mixins/early/blockChangeNotifier/MixinForgeHooks.java

@@ -0,0 +1,44 @@
+package com.gtnewhorizon.structurelib.mixins.early.blockChangeNotifier;
+
+import net.minecraft.block.Block;
+import net.minecraft.entity.player.EntityPlayer;
+import net.minecraft.item.ItemStack;
+import net.minecraft.world.World;
+import net.minecraftforge.common.ForgeHooks;
+import net.minecraftforge.common.util.BlockSnapshot;
+
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.injection.At;
+import org.spongepowered.asm.mixin.injection.Inject;
+import org.spongepowered.asm.mixin.injection.callback.CallbackInfoReturnable;
+
+import com.gtnewhorizon.structurelib.event.BlockChangeNotifier;
+import com.llamalad7.mixinextras.sugar.Local;
+
+@Mixin(ForgeHooks.class)
+public class MixinForgeHooks {
+
+    @Inject(
+            method = "onPlaceItemIntoWorld",
+            at = @At(
+                    value = "INVOKE",
+                    target = "Lnet/minecraft/world/World;markAndNotifyBlock(IIILnet/minecraft/world/chunk/Chunk;Lnet/minecraft/block/Block;Lnet/minecraft/block/Block;I)V",
+                    shift = At.Shift.AFTER),
+            remap = false)
+    private static void onBlockChange(ItemStack itemstack, EntityPlayer player, World world, int x, int y, int z,
+            int side, float hitX, float hitY, float hitZ, CallbackInfoReturnable<Boolean> cir,
+            @Local(name = "blocksnapshot") BlockSnapshot blocksnapshot, @Local(name = "newBlock") Block newBlock,
+            @Local(name = "metadata") int newMetadata) {
+        BlockChangeNotifier.onBlockChange(
+                world,
+                null,
+                blocksnapshot.x,
+                blocksnapshot.y,
+                blocksnapshot.z,
+                blocksnapshot.replacedBlock,
+                newBlock,
+                blocksnapshot.meta,
+                newMetadata);
+    }
+
+}

src/main/java/com/gtnewhorizon/structurelib/mixins/early/blockChangeNotifier/MixinWorld.java

@@ -0,0 +1,55 @@
+package com.gtnewhorizon.structurelib.mixins.early.blockChangeNotifier;
+
+import net.minecraft.block.Block;
+import net.minecraft.world.World;
+import net.minecraft.world.chunk.Chunk;
+
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.injection.At;
+import org.spongepowered.asm.mixin.injection.Inject;
+import org.spongepowered.asm.mixin.injection.callback.CallbackInfoReturnable;
+
+import com.gtnewhorizon.structurelib.event.BlockChangeNotifier;
+import com.llamalad7.mixinextras.sugar.Local;
+import com.llamalad7.mixinextras.sugar.Share;
+import com.llamalad7.mixinextras.sugar.ref.LocalIntRef;
+import com.llamalad7.mixinextras.sugar.ref.LocalRef;
+
+@Mixin(World.class)
+public class MixinWorld {
+
+    @Inject(
+            method = "Lnet/minecraft/world/World;setBlock(IIILnet/minecraft/block/Block;II)Z",
+            at = @At(
+                    value = "INVOKE",
+                    target = "Lnet/minecraft/world/World;markAndNotifyBlock(IIILnet/minecraft/world/chunk/Chunk;Lnet/minecraft/block/Block;Lnet/minecraft/block/Block;I)V",
+                    shift = At.Shift.AFTER,
+                    remap = false))
+    public void setBlockObserve(int x, int y, int z, Block newBlock, int newMeta, int flags,
+            CallbackInfoReturnable<Boolean> cir, @Local(name = "block1") Block originalBlock,
+            @Share("originalMeta") LocalIntRef originalMeta, @Share("chunk") LocalRef<Chunk> chunkLocalRef) {
+        BlockChangeNotifier.onBlockChange(
+                (World) ((Object) (this)),
+                chunkLocalRef.get(),
+                x,
+                y,
+                z,
+                originalBlock,
+                newBlock,
+                originalMeta.get(),
+                newMeta);
+    }
+
+    @Inject(
+            method = "Lnet/minecraft/world/World;setBlock(IIILnet/minecraft/block/Block;II)Z",
+            at = @At(
+                    value = "INVOKE",
+                    target = "Lnet/minecraft/world/chunk/Chunk;func_150807_a(IIILnet/minecraft/block/Block;I)Z",
+                    shift = At.Shift.BEFORE))
+    public void captureChunkAndOriginalMetadata(int x, int y, int z, Block blockIn, int metadataIn, int flags,
+            CallbackInfoReturnable<Boolean> cir, @Local(name = "chunk") Chunk chunk,
+            @Share("originalMeta") LocalIntRef originalMeta, @Share("chunk") LocalRef<Chunk> chunkLocalRef) {
+        chunkLocalRef.set(chunk);
+        originalMeta.set(chunk.getBlockMetadata(x & 15, y, z & 15));
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/net/AlignmentMessage.java

@@ -1,28 +1,30 @@
 package com.gtnewhorizon.structurelib.net;
 
-import com.gtnewhorizon.structurelib.StructureLib;
-import com.gtnewhorizon.structurelib.alignment.IAlignment;
-import com.gtnewhorizon.structurelib.alignment.IAlignmentProvider;
-import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
-import cpw.mods.fml.common.network.ByteBufUtils;
-import cpw.mods.fml.common.network.simpleimpl.IMessage;
-import cpw.mods.fml.common.network.simpleimpl.IMessageHandler;
-import cpw.mods.fml.common.network.simpleimpl.MessageContext;
-import io.netty.buffer.ByteBuf;
 import net.minecraft.nbt.NBTTagCompound;
 import net.minecraft.tileentity.TileEntity;
 import net.minecraft.world.World;
 import net.minecraftforge.common.DimensionManager;
 
+import com.gtnewhorizon.structurelib.StructureLib;
+import com.gtnewhorizon.structurelib.alignment.IAlignment;
+import com.gtnewhorizon.structurelib.alignment.IAlignmentProvider;
+import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
+
+import cpw.mods.fml.common.network.ByteBufUtils;
+import cpw.mods.fml.common.network.simpleimpl.IMessage;
+import cpw.mods.fml.common.network.simpleimpl.IMessageHandler;
+import cpw.mods.fml.common.network.simpleimpl.MessageContext;
+import io.netty.buffer.ByteBuf;
+
 public abstract class AlignmentMessage implements IMessage {
+
     int mPosX;
     int mPosY;
     int mPosZ;
     int mPosD;
     int mAlign;
 
-    public AlignmentMessage() {
-    }
+    public AlignmentMessage() {}
 
     @Override
     public void fromBytes(ByteBuf pBuffer) {
@@ -47,11 +49,9 @@ public abstract class AlignmentMessage implements IMessage {
     }
 
     private AlignmentMessage(IAlignmentProvider provider) {
-        if (!(provider instanceof TileEntity))
-            throw new IllegalArgumentException("Provider must be a TileEntity");
+        if (!(provider instanceof TileEntity)) throw new IllegalArgumentException("Provider must be a TileEntity");
         IAlignment alignment = provider.getAlignment();
-        if (alignment == null)
-            throw new IllegalArgumentException("Passed in provider does not provide an alignment!");
+        if (alignment == null) throw new IllegalArgumentException("Passed in provider does not provide an alignment!");
         TileEntity base = (TileEntity) provider;
         mPosX = base.xCoord;
         mPosY = base.yCoord;
@@ -69,8 +69,8 @@ public abstract class AlignmentMessage implements IMessage {
     }
 
     public static class AlignmentQuery extends AlignmentMessage {
-        public AlignmentQuery() {
-        }
+
+        public AlignmentQuery() {}
 
         public AlignmentQuery(IAlignmentProvider provider) {
             super(provider);
@@ -82,8 +82,8 @@ public abstract class AlignmentMessage implements IMessage {
     }
 
     public static class AlignmentData extends AlignmentMessage {
-        public AlignmentData() {
-        }
+
+        public AlignmentData() {}
 
         private AlignmentData(AlignmentQuery query) {
             mPosX = query.mPosX;
@@ -103,10 +103,12 @@ public abstract class AlignmentMessage implements IMessage {
     }
 
     public static class ClientHandler implements IMessageHandler<AlignmentData, IMessage> {
+
         @Override
         public IMessage onMessage(AlignmentData pMessage, MessageContext pCtx) {
             if (StructureLib.getCurrentPlayer().worldObj.provider.dimensionId == pMessage.mPosD) {
-                TileEntity te = StructureLib.getCurrentPlayer().worldObj.getTileEntity(pMessage.mPosX, pMessage.mPosY, pMessage.mPosZ);
+                TileEntity te = StructureLib.getCurrentPlayer().worldObj
+                        .getTileEntity(pMessage.mPosX, pMessage.mPosY, pMessage.mPosZ);
                 if (te instanceof IAlignmentProvider) {
                     IAlignment alignment = ((IAlignmentProvider) te).getAlignment();
                     if (alignment != null) {
@@ -119,6 +121,7 @@ public abstract class AlignmentMessage implements IMessage {
     }
 
     public static class ServerHandler implements IMessageHandler<AlignmentQuery, AlignmentData> {
+
         @Override
         public AlignmentData onMessage(AlignmentQuery pMessage, MessageContext pCtx) {
             World world = DimensionManager.getWorld(pMessage.mPosD);
@@ -126,8 +129,7 @@ public abstract class AlignmentMessage implements IMessage {
                 TileEntity te = world.getTileEntity(pMessage.mPosX, pMessage.mPosY, pMessage.mPosZ);
                 if (te instanceof IAlignmentProvider) {
                     IAlignment alignment = ((IAlignmentProvider) te).getAlignment();
-                    if (alignment == null)
-                        return null;
+                    if (alignment == null) return null;
                     pMessage.mAlign = alignment.getExtendedFacing().getIndex();
                     return new AlignmentData(pMessage);
                 }
@@ -135,4 +137,4 @@ public abstract class AlignmentMessage implements IMessage {
             return null;
         }
     }
-}
+}

src/main/java/com/gtnewhorizon/structurelib/net/ErrorHintParticleMessage.java

@@ -0,0 +1,60 @@
+package com.gtnewhorizon.structurelib.net;
+
+import static com.gtnewhorizon.structurelib.StructureLib.LOGGER;
+
+import com.gtnewhorizon.structurelib.StructureLib;
+import com.gtnewhorizon.structurelib.StructureLibAPI;
+
+import cpw.mods.fml.common.network.simpleimpl.IMessage;
+import cpw.mods.fml.common.network.simpleimpl.IMessageHandler;
+import cpw.mods.fml.common.network.simpleimpl.MessageContext;
+import io.netty.buffer.ByteBuf;
+
+public class ErrorHintParticleMessage implements IMessage {
+
+    private int x;
+    private short y;
+    private int z;
+
+    public ErrorHintParticleMessage() {}
+
+    public ErrorHintParticleMessage(int x, short y, int z) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+    }
+
+    @Override
+    public void fromBytes(ByteBuf buf) {
+        x = buf.readInt();
+        y = buf.readShort();
+        z = buf.readInt();
+    }
+
+    @Override
+    public void toBytes(ByteBuf buf) {
+        buf.writeInt(x);
+        buf.writeShort(y);
+        buf.writeInt(z);
+    }
+
+    public static class Handler implements IMessageHandler<ErrorHintParticleMessage, IMessage> {
+
+        @Override
+        public IMessage onMessage(ErrorHintParticleMessage msg, MessageContext ctx) {
+            boolean updateResult = StructureLibAPI.markHintParticleError(
+                    StructureLib.getCurrentPlayer(),
+                    StructureLib.getCurrentPlayer().worldObj,
+                    msg.x,
+                    msg.y,
+                    msg.z);
+            if (StructureLibAPI.isDebugEnabled()) LOGGER.debug(
+                    "Server instructed to mark hint particle at ({}, {}, {}) error, result {}!",
+                    msg.x,
+                    msg.y,
+                    msg.z,
+                    updateResult);
+            return null;
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/net/RegistryOrderSyncMessage.java

@@ -0,0 +1,77 @@
+package com.gtnewhorizon.structurelib.net;
+
+import java.lang.ref.WeakReference;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.concurrent.ConcurrentHashMap;
+
+import com.gtnewhorizon.structurelib.SortedRegistry;
+
+import cpw.mods.fml.common.network.ByteBufUtils;
+import cpw.mods.fml.common.network.simpleimpl.IMessage;
+import cpw.mods.fml.common.network.simpleimpl.IMessageHandler;
+import cpw.mods.fml.common.network.simpleimpl.MessageContext;
+import io.netty.buffer.ByteBuf;
+
+public class RegistryOrderSyncMessage implements IMessage {
+
+    private String name;
+    private List<String> order;
+    private List<String> disabled;
+
+    public RegistryOrderSyncMessage() {}
+
+    public RegistryOrderSyncMessage(String name, List<String> order, List<String> disabled) {
+        this.name = name;
+        this.order = order;
+        this.disabled = disabled;
+    }
+
+    @Override
+    public void fromBytes(ByteBuf buf) {
+        name = ByteBufUtils.readUTF8String(buf);
+        int size = ByteBufUtils.readVarInt(buf, 2);
+        order = new ArrayList<>(size);
+        for (int i = 0; i < size; i++) {
+            order.add(ByteBufUtils.readUTF8String(buf));
+        }
+        size = ByteBufUtils.readVarInt(buf, 2);
+        disabled = new ArrayList<>(size);
+        for (int i = 0; i < size; i++) {
+            disabled.add(ByteBufUtils.readUTF8String(buf));
+        }
+    }
+
+    @Override
+    public void toBytes(ByteBuf buf) {
+        ByteBufUtils.writeUTF8String(buf, name);
+        ByteBufUtils.writeVarInt(buf, order.size(), 2);
+        for (String s : order) {
+            ByteBufUtils.writeUTF8String(buf, s);
+        }
+        ByteBufUtils.writeVarInt(buf, disabled.size(), 2);
+        for (String s : disabled) {
+            ByteBufUtils.writeUTF8String(buf, s);
+        }
+    }
+
+    public static class Handler implements IMessageHandler<RegistryOrderSyncMessage, IMessage> {
+
+        private static ConcurrentHashMap<String, WeakReference<SortedRegistry<?>>> ALL_REGISTRIES;
+
+        public static void setAllRegistries(ConcurrentHashMap<String, WeakReference<SortedRegistry<?>>> r) {
+            if (ALL_REGISTRIES == null) ALL_REGISTRIES = r;
+        }
+
+        @Override
+        public IMessage onMessage(RegistryOrderSyncMessage message, MessageContext ctx) {
+            if (ALL_REGISTRIES == null) return null;
+            WeakReference<SortedRegistry<?>> ref = ALL_REGISTRIES.get(message.name);
+            if (ref == null) return null;
+            SortedRegistry<?> r = ref.get();
+            if (r == null) return null;
+            r.registerOrdering(ctx.getServerHandler().playerEntity, message.order, message.disabled);
+            return null;
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/net/SetChannelDataMessage.java

@@ -0,0 +1,73 @@
+package com.gtnewhorizon.structurelib.net;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.Map.Entry;
+
+import net.minecraft.entity.player.EntityPlayerMP;
+import net.minecraft.item.ItemStack;
+
+import org.apache.commons.lang3.tuple.Pair;
+
+import com.gtnewhorizon.structurelib.StructureLib;
+import com.gtnewhorizon.structurelib.alignment.constructable.ChannelDataAccessor;
+import com.gtnewhorizon.structurelib.item.ItemConstructableTrigger;
+
+import cpw.mods.fml.common.network.ByteBufUtils;
+import cpw.mods.fml.common.network.simpleimpl.IMessage;
+import cpw.mods.fml.common.network.simpleimpl.IMessageHandler;
+import cpw.mods.fml.common.network.simpleimpl.MessageContext;
+import io.netty.buffer.ByteBuf;
+
+public class SetChannelDataMessage implements IMessage {
+
+    private final List<Map.Entry<String, Integer>> data = new ArrayList<>();
+
+    public SetChannelDataMessage() {}
+
+    public SetChannelDataMessage(ItemStack trigger) {
+        ChannelDataAccessor.iterateChannelData(trigger).forEach(data::add);
+    }
+
+    @Override
+    public void fromBytes(ByteBuf buf) {
+        data.clear();
+        int size = ByteBufUtils.readVarShort(buf);
+        for (int i = 0; i < size; i++) {
+            data.add(Pair.of(ByteBufUtils.readUTF8String(buf), ByteBufUtils.readVarInt(buf, 4)));
+        }
+    }
+
+    @Override
+    public void toBytes(ByteBuf buf) {
+        ByteBufUtils.writeVarShort(buf, data.size());
+        for (Entry<String, Integer> e : data) {
+            ByteBufUtils.writeUTF8String(buf, e.getKey());
+            ByteBufUtils.writeVarInt(buf, e.getValue(), 4);
+        }
+    }
+
+    public static class Handler implements IMessageHandler<SetChannelDataMessage, IMessage> {
+
+        @Override
+        public IMessage onMessage(SetChannelDataMessage message, MessageContext ctx) {
+            EntityPlayerMP player = ctx.getServerHandler().playerEntity;
+            ItemStack heldItem = player.getHeldItem();
+            if (heldItem != null && heldItem.getItem() instanceof ItemConstructableTrigger) {
+                ChannelDataAccessor.wipeChannelData(heldItem);
+                for (Entry<String, Integer> e : message.data) {
+                    ChannelDataAccessor.setChannelData(heldItem, e.getKey(), e.getValue());
+                }
+                // since this is a set all channel request from the client, we would assume client already know
+                // what this would look like on the client, so no sync
+            } else {
+                StructureLib.LOGGER.warn(
+                        "{} trying to set channel data on {}, which is not a hologram projector!",
+                        player.getUniqueID(),
+                        heldItem);
+            }
+            return null;
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/net/UpdateHintParticleMessage.java

@@ -0,0 +1,77 @@
+package com.gtnewhorizon.structurelib.net;
+
+import static com.gtnewhorizon.structurelib.StructureLib.LOGGER;
+
+import com.gtnewhorizon.structurelib.StructureLib;
+import com.gtnewhorizon.structurelib.StructureLibAPI;
+
+import cpw.mods.fml.common.network.simpleimpl.IMessage;
+import cpw.mods.fml.common.network.simpleimpl.IMessageHandler;
+import cpw.mods.fml.common.network.simpleimpl.MessageContext;
+import io.netty.buffer.ByteBuf;
+
+public class UpdateHintParticleMessage implements IMessage {
+
+    private int x;
+    private short y;
+    private int z;
+    private short r;
+    private short g;
+    private short b;
+    private short a;
+
+    public UpdateHintParticleMessage() {}
+
+    public UpdateHintParticleMessage(int x, short y, int z, short r, short g, short b, short a) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+        this.r = r;
+        this.g = g;
+        this.b = b;
+        this.a = a;
+    }
+
+    @Override
+    public void fromBytes(ByteBuf buf) {
+        x = buf.readInt();
+        y = buf.readShort();
+        z = buf.readInt();
+        r = buf.readUnsignedByte();
+        g = buf.readUnsignedByte();
+        b = buf.readUnsignedByte();
+        a = buf.readUnsignedByte();
+    }
+
+    @Override
+    public void toBytes(ByteBuf buf) {
+        buf.writeInt(x);
+        buf.writeShort(y);
+        buf.writeInt(z);
+        buf.writeByte(r);
+        buf.writeByte(g);
+        buf.writeByte(b);
+        buf.writeByte(a);
+    }
+
+    public static class Handler implements IMessageHandler<UpdateHintParticleMessage, IMessage> {
+
+        @Override
+        public IMessage onMessage(UpdateHintParticleMessage msg, MessageContext ctx) {
+            boolean updateResult = StructureLibAPI.updateHintParticleTint(
+                    StructureLib.getCurrentPlayer(),
+                    StructureLib.getCurrentPlayer().worldObj,
+                    msg.x,
+                    msg.y,
+                    msg.z,
+                    new short[] { msg.r, msg.g, msg.b, msg.a, });
+            if (StructureLibAPI.isDebugEnabled()) LOGGER.debug(
+                    "Server instructed to update hint particle at ({}, {}, {}), result {}!",
+                    msg.x,
+                    msg.y,
+                    msg.z,
+                    updateResult);
+            return null;
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/proxy/ClientProxy.java

@@ -1,187 +0,0 @@
-package com.gtnewhorizon.structurelib.proxy;
-
-import com.google.common.collect.BiMap;
-import com.google.common.collect.HashBiMap;
-import com.gtnewhorizon.structurelib.ConfigurationHandler;
-import com.gtnewhorizon.structurelib.entity.fx.EntityFXBlockHint;
-import com.gtnewhorizon.structurelib.entity.fx.WeightlessParticleFX;
-import cpw.mods.fml.common.event.FMLPreInitializationEvent;
-import cpw.mods.fml.common.eventhandler.SubscribeEvent;
-import net.minecraft.block.Block;
-import net.minecraft.client.Minecraft;
-import net.minecraft.client.gui.GuiNewChat;
-import net.minecraft.client.particle.EntityFX;
-import net.minecraft.entity.player.EntityPlayer;
-import net.minecraft.util.ChatComponentText;
-import net.minecraft.util.IIcon;
-import net.minecraft.world.World;
-import net.minecraftforge.common.MinecraftForge;
-import net.minecraftforge.event.world.WorldEvent;
-
-import java.util.ArrayList;
-import java.util.Iterator;
-import java.util.LinkedList;
-import java.util.List;
-
-import static com.gtnewhorizon.structurelib.StructureLib.RANDOM;
-
-public class ClientProxy extends CommonProxy {
-    @Override
-    public void hintParticleTinted(World w, int x, int y, int z, IIcon[] icons, short[] RGBa) {
-        EntityFXBlockHint hint = new EntityFXBlockHint(w, x, y, z, icons).withColorTint(RGBa);
-        Minecraft.getMinecraft().effectRenderer.addEffect(hint);
-        ensureHinting();
-        if (ConfigurationHandler.INSTANCE.isRemoveCollidingHologram()) {
-            HintParticleInfo info = new HintParticleInfo(x, y, z, currentHints);
-            EntityFXBlockHint dupe = allHints.inverse().get(info);
-            if (dupe != null) {
-                List<EntityFXBlockHint> owner = allHints.get(dupe).owner;
-                // in case someone forget to call endHinting
-                if (owner != currentHints) {
-                    hintOwners.remove(owner);
-                    owner.forEach(EntityFXBlockHint::setDead);
-                    owner.clear();
-                }
-            }
-            allHints.forcePut(hint, info);
-        }
-        currentHints.add(hint);
-
-        EntityFX particle = new WeightlessParticleFX(w, x + RANDOM.nextFloat() * 0.5F, y + RANDOM.nextFloat() * 0.5F, z + RANDOM.nextFloat() * 0.5F, 0, 0, 0);
-        particle.setRBGColorF(0, 0.6F * RANDOM.nextFloat(), 0.8f);
-        Minecraft.getMinecraft().effectRenderer.addEffect(particle);
-    }
-
-    @Override
-    public void hintParticleTinted(World w, int x, int y, int z, Block block, int meta, short[] RGBa) {
-        hintParticleTinted(w, x, y, z, createIIconFromBlock(block, meta), RGBa);
-    }
-
-    @Override
-    public void hintParticle(World w, int x, int y, int z, IIcon[] icons) {
-        hintParticleTinted(w, x, y, z, icons, new short[]{255, 255, 255, 0});
-    }
-
-    @Override
-    public void hintParticle(World w, int x, int y, int z, Block block, int meta) {
-        hintParticleTinted(w, x, y, z, createIIconFromBlock(block, meta), new short[]{255, 255, 255, 0});
-    }
-
-    private static IIcon[] createIIconFromBlock(Block block, int meta) {
-        IIcon[] ret = new IIcon[6];
-        for (int i = 0; i < 6; i++) {
-            ret[i] = block.getIcon(i, meta);
-        }
-        return ret;
-    }
-
-    @Override
-    public void addClientSideChatMessages(String... messages) {
-        GuiNewChat chat = Minecraft.getMinecraft().ingameGUI.getChatGUI();
-        for (String s : messages) {
-            chat.printChatMessage(new ChatComponentText(s));
-        }
-    }
-
-    @Override
-    public EntityPlayer getCurrentPlayer() {
-        return Minecraft.getMinecraft().thePlayer;
-    }
-
-    @Override
-    public boolean isCurrentPlayer(EntityPlayer player) {
-        return player == Minecraft.getMinecraft().thePlayer;
-    }
-
-    private static final BiMap<EntityFXBlockHint, HintParticleInfo> allHints = HashBiMap.create();
-    private static final List<List<EntityFXBlockHint>> hintOwners = new ArrayList<>();
-    private static List<EntityFXBlockHint> currentHints;
-
-    public static void onHintDead(EntityFXBlockHint fx) {
-        if (ConfigurationHandler.INSTANCE.isRemoveCollidingHologram())
-            allHints.remove(fx);
-        for (Iterator<List<EntityFXBlockHint>> iterator = hintOwners.iterator(); iterator.hasNext(); ) {
-            List<EntityFXBlockHint> list = iterator.next();
-            if (list.remove(fx)) {
-                if (list.isEmpty())
-                    iterator.remove();
-                break;
-            }
-        }
-    }
-
-    @Override
-    public void startHinting(World w) {
-        if (!w.isRemote)
-            return;
-        if (currentHints != null)
-            hintOwners.add(currentHints);
-        currentHints = new LinkedList<>();
-    }
-
-    private void ensureHinting() {
-        if (currentHints == null)
-            currentHints = new LinkedList<>();
-    }
-
-    @Override
-    public void endHinting(World w) {
-        if (!w.isRemote)
-            return;
-        while (!hintOwners.isEmpty() && hintOwners.size() >= ConfigurationHandler.INSTANCE.getMaxCoexistingHologram()) {
-            List<EntityFXBlockHint> list = hintOwners.remove(0);
-            list.forEach(EntityFXBlockHint::setDead);
-            list.clear();
-        }
-        if (!currentHints.isEmpty())
-            hintOwners.add(currentHints);
-        currentHints = null;
-    }
-
-    @Override
-    public void preInit(FMLPreInitializationEvent e) {
-        MinecraftForge.EVENT_BUS.register(new ForgeEventHandler());
-    }
-
-    private static class HintParticleInfo {
-        private final int x, y, z;
-        private final List<EntityFXBlockHint> owner;
-
-        public HintParticleInfo(int x, int y, int z, List<EntityFXBlockHint> owner) {
-            this.x = x;
-            this.y = y;
-            this.z = z;
-            this.owner = owner;
-        }
-
-        @Override
-        public boolean equals(Object o) {
-            if (this == o) return true;
-            if (o == null || getClass() != o.getClass()) return false;
-
-            HintParticleInfo that = (HintParticleInfo) o;
-
-            if (x != that.x) return false;
-            if (y != that.y) return false;
-            return z == that.z;
-        }
-
-        @Override
-        public int hashCode() {
-            int result = x;
-            result = 31 * result + y;
-            result = 31 * result + z;
-            return result;
-        }
-    }
-
-    public static class ForgeEventHandler {
-        @SubscribeEvent
-        public void onWorldLoad(WorldEvent.Load e) {
-            if (e.world.isRemote) {
-                allHints.clear();
-                hintOwners.clear();
-            }
-        }
-    }
-}

src/main/java/com/gtnewhorizon/structurelib/proxy/CommonProxy.java

@@ -1,26 +0,0 @@
-package com.gtnewhorizon.structurelib.proxy;
-
-import cpw.mods.fml.common.event.FMLPreInitializationEvent;
-import net.minecraft.block.Block;
-import net.minecraft.entity.player.EntityPlayer;
-import net.minecraft.util.IIcon;
-import net.minecraft.world.World;
-
-public class CommonProxy {
-	public void hintParticleTinted(World w, int x, int y, int z, IIcon[] icons, short[] RGBa){}
-	public void hintParticleTinted(World w, int x, int y, int z, Block block, int meta, short[] RGBa){}
-	public void hintParticle(World w, int x, int y, int z, IIcon[] icons){}
-	public void hintParticle(World w, int x, int y, int z, Block block, int meta){}
-	public EntityPlayer getCurrentPlayer() {
-		return null;
-	}
-	public boolean isCurrentPlayer(EntityPlayer player) {
-		return false;
-	}
-	public void addClientSideChatMessages(String... messages){
-	}
-	public void startHinting(World w) {}
-	public void endHinting(World w) {}
-
-	public void preInit(FMLPreInitializationEvent e) {}
-}

src/main/java/com/gtnewhorizon/structurelib/structure/AutoPlaceEnvironment.java

@@ -0,0 +1,455 @@
+package com.gtnewhorizon.structurelib.structure;
+
+import java.util.Map;
+import java.util.function.Consumer;
+import java.util.function.Predicate;
+
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
+
+import net.minecraft.entity.player.EntityPlayer;
+import net.minecraft.entity.player.EntityPlayerMP;
+import net.minecraft.item.ItemStack;
+import net.minecraft.util.IChatComponent;
+
+import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
+import com.gtnewhorizon.structurelib.fluid.FluidSourceProviders;
+import com.gtnewhorizon.structurelib.fluid.IFluidSource;
+
+/**
+ * Represent the environment in which autoplace of a single element took place.
+ */
+public class AutoPlaceEnvironment {
+
+    private IItemSource source;
+    private IFluidSource fluidSource;
+    private final EntityPlayer actor;
+    private final Consumer<IChatComponent> chatter;
+    private final IStructureDefinition<?> definition;
+    private final String piece;
+    private final ExtendedFacing facing;
+    final int[] offsetABC;
+    private final int[] baseOffsetABC;
+    private final int[] basePositionXYZ;
+    private final Object contextObject;
+    private final FluidRoundState fluidRoundState;
+
+    public static AutoPlaceEnvironment fromLegacy(IItemSource source, EntityPlayer actor,
+            Consumer<IChatComponent> chatter) {
+        if (source instanceof WrappedIItemSource) {
+            AutoPlaceEnvironment original = ((WrappedIItemSource) source).container;
+            // feels like this is extremely likely to cause issues, but this does allow us to recover lost info.
+            // TODO probably should remove this once all addons migrate over
+            if (actor != original.actor || chatter != original.chatter) {
+                AutoPlaceEnvironment newEnv = original;
+                if (actor != original.actor) newEnv = newEnv.withActor(actor);
+                if (chatter != original.chatter) newEnv = newEnv.withChatter(chatter);
+                return newEnv;
+            }
+            return original;
+        }
+        return new AutoPlaceEnvironment(source, null, actor, chatter, null, null, null, null, null, null, null);
+    }
+
+    AutoPlaceEnvironment(EntityPlayer actor, Consumer<IChatComponent> chatter, IStructureDefinition<?> definition,
+            String piece, ExtendedFacing facing, int[] baseOffsetABC, int[] basePositionXYZ, Object contextObject,
+            IFluidSource fluidSource, FluidRoundState fluidRoundState) {
+        this.source = null;
+        this.fluidSource = fluidSource;
+        this.actor = actor;
+        this.chatter = chatter;
+        this.definition = definition;
+        this.piece = piece;
+        this.facing = facing;
+        this.offsetABC = new int[3];
+        this.baseOffsetABC = baseOffsetABC;
+        this.basePositionXYZ = basePositionXYZ;
+        this.contextObject = contextObject;
+        this.fluidRoundState = fluidRoundState;
+    }
+
+    AutoPlaceEnvironment(IItemSource source, IFluidSource fluidSource, EntityPlayer actor,
+            Consumer<IChatComponent> chatter, IStructureDefinition<?> definition, String piece, ExtendedFacing facing,
+            int[] offsetABC, int[] baseOffsetABC, int[] basePositionXYZ, Object contextObject) {
+        this(
+                source,
+                fluidSource,
+                actor,
+                chatter,
+                definition,
+                piece,
+                facing,
+                offsetABC,
+                baseOffsetABC,
+                basePositionXYZ,
+                contextObject,
+                null);
+    }
+
+    private AutoPlaceEnvironment(IItemSource source, IFluidSource fluidSource, EntityPlayer actor,
+            Consumer<IChatComponent> chatter, IStructureDefinition<?> definition, String piece, ExtendedFacing facing,
+            int[] offsetABC, int[] baseOffsetABC, int[] basePositionXYZ, Object contextObject,
+            FluidRoundState fluidRoundState) {
+        this.source = definition != null && !(source instanceof WrappedIItemSource)
+                ? new WrappedIItemSource(this, source)
+                : source;
+        this.fluidSource = fluidSource;
+        this.actor = actor;
+        this.chatter = chatter;
+        this.definition = definition;
+        this.piece = piece;
+        this.facing = facing;
+        this.offsetABC = offsetABC;
+        this.baseOffsetABC = baseOffsetABC;
+        this.basePositionXYZ = basePositionXYZ;
+        this.contextObject = contextObject;
+        this.fluidRoundState = fluidRoundState;
+    }
+
+    protected AutoPlaceEnvironment(AutoPlaceEnvironment parent) {
+        this(
+                parent.getSource(),
+                parent.fluidSource,
+                parent.getActor(),
+                parent.getChatter(),
+                parent.definition,
+                parent.piece,
+                parent.facing,
+                parent.offsetABC,
+                parent.baseOffsetABC,
+                parent.basePositionXYZ,
+                parent.contextObject,
+                parent.fluidRoundState);
+    }
+
+    void setSource(IItemSource source) {
+        this.source = definition != null && !(source instanceof WrappedIItemSource)
+                ? new WrappedIItemSource(this, source)
+                : source;
+    }
+
+    public APILevel getAPILevel() {
+        return definition == null ? actor instanceof EntityPlayerMP ? APILevel.Legacy : APILevel.LegacyRelaxed
+                : APILevel.V2;
+    }
+
+    /**
+     * From where survival autoplace will drain resources.
+     */
+    public IItemSource getSource() {
+        return source;
+    }
+
+    /**
+     * The fluid source this environment has been given, or null when it has none.
+     * <p>
+     * A structure element that has to place fluid blocks should ask {@link #getEffectiveFluidSource()} instead, which
+     * falls back to whatever the actor can offer when there is no explicit fluid source.
+     */
+    @Nullable
+    public IFluidSource getFluidSource() {
+        return fluidSource;
+    }
+
+    /**
+     * From where survival autoplace will drain fluid.
+     * <p>
+     * This is the fluid source this environment has been given, or what the actor can offer when the actor is a server
+     * side player: the {@linkplain com.gtnewhorizon.structurelib.fluid.FluidSourceProviders registered fluid source
+     * providers}, e.g. the ME network behind a wireless terminal the player has on them, and then the fluid containers
+     * the player is carrying. It is null when the actor isn't a server side player and no fluid source has been given,
+     * in which case fluid blocks cannot be placed at all.
+     */
+    @Nullable
+    public IFluidSource getEffectiveFluidSource() {
+        if (fluidSource != null) return fluidSource;
+        if (actor instanceof EntityPlayerMP) return FluidSourceProviders.getSourceFor((EntityPlayerMP) actor);
+        return null;
+    }
+
+    /**
+     * The initiator of actions. for very critical errors you can also just send the error messages here, bypassing any
+     * filter that {@link #getChatter()} might have. You might want to use
+     * {@link com.gtnewhorizon.structurelib.StructureLibAPI#addThrottledChat(Object, EntityPlayer, IChatComponent, short)}
+     * to help reduce spam.
+     */
+    public EntityPlayer getActor() {
+        return actor;
+    }
+
+    /**
+     * send error messages here. Caller will choose an appropriate way to forward it to player if the other fallbacks
+     * also fails.
+     */
+    public Consumer<IChatComponent> getChatter() {
+        return chatter;
+    }
+
+    /**
+     * Test if given location is contained within the current piece.
+     *
+     * @param offsetA offset in A direction <b>relative to current element</b>
+     * @param offsetB offset in B direction <b>relative to current element</b>
+     * @param offsetC offset in C direction <b>relative to current element</b>
+     * @return true if contained, false otherwise.
+     */
+    public boolean isContainedInPiece(int offsetA, int offsetB, int offsetC) {
+        if (definition == null) return false;
+        return definition.isContainedInStructure(
+                piece,
+                offsetABC[0] + offsetA + baseOffsetABC[0],
+                offsetABC[1] + offsetB + baseOffsetABC[1],
+                offsetABC[2] + offsetC + baseOffsetABC[2]);
+    }
+
+    public ExtendedFacing getFacing() {
+        return facing;
+    }
+
+    /**
+     * Return a new instance with source modified to given value.
+     * <p>
+     * The returned instance shares the fluid source, and every bookkeeping about the current autoplace round, with this
+     * one.
+     *
+     * @param source new source
+     * @return new instance
+     */
+    public AutoPlaceEnvironment withSource(IItemSource source) {
+        return new AutoPlaceEnvironment(
+                source,
+                fluidSource,
+                actor,
+                chatter,
+                definition,
+                piece,
+                facing,
+                offsetABC,
+                baseOffsetABC,
+                basePositionXYZ,
+                contextObject,
+                fluidRoundState);
+    }
+
+    /**
+     * Return a new instance with actor modified to given value.
+     * <p>
+     * The returned instance shares the fluid source, and every bookkeeping about the current autoplace round, with this
+     * one.
+     *
+     * @param actor new actor
+     * @return new instance
+     */
+    public AutoPlaceEnvironment withActor(EntityPlayer actor) {
+        return new AutoPlaceEnvironment(
+                source,
+                fluidSource,
+                actor,
+                chatter,
+                definition,
+                piece,
+                facing,
+                offsetABC,
+                baseOffsetABC,
+                basePositionXYZ,
+                contextObject,
+                fluidRoundState);
+    }
+
+    /**
+     * Return a new instance with chatter modified to given value.
+     * <p>
+     * The returned instance shares the fluid source, and every bookkeeping about the current autoplace round, with this
+     * one.
+     *
+     * @param chatter new chatter
+     * @return new instance
+     */
+    public AutoPlaceEnvironment withChatter(Consumer<IChatComponent> chatter) {
+        return new AutoPlaceEnvironment(
+                source,
+                fluidSource,
+                actor,
+                chatter,
+                definition,
+                piece,
+                facing,
+                offsetABC,
+                baseOffsetABC,
+                basePositionXYZ,
+                contextObject,
+                fluidRoundState);
+    }
+
+    /**
+     * Return a new instance with an explicit fluid source.
+     * <p>
+     * This is how a multiblock that wants its fluid to come from somewhere else than the player inventory, e.g. from a
+     * tank, hands its fluid source to autoplace.
+     *
+     * @param fluidSource new fluid source
+     * @return new instance
+     */
+    public AutoPlaceEnvironment withFluidSource(@Nullable IFluidSource fluidSource) {
+        return new AutoPlaceEnvironment(
+                source,
+                fluidSource,
+                actor,
+                chatter,
+                definition,
+                piece,
+                facing,
+                offsetABC,
+                baseOffsetABC,
+                basePositionXYZ,
+                contextObject,
+                fluidRoundState);
+    }
+
+    IStructureDefinition<?> getDefinition() {
+        return definition;
+    }
+
+    String getPiece() {
+        return piece;
+    }
+
+    int[] getBaseOffsetABC() {
+        return baseOffsetABC;
+    }
+
+    @Nullable
+    int[] getBasePositionXYZ() {
+        return basePositionXYZ;
+    }
+
+    @Nullable
+    Object getContextObject() {
+        return contextObject;
+    }
+
+    /**
+     * The answer to the fluid placement gate of the current autoplace round, or null when it has not been asked yet.
+     */
+    @Nullable
+    Boolean getFluidGateResult() {
+        return fluidRoundState == null ? null : fluidRoundState.getGateResult();
+    }
+
+    void setFluidGateResult(boolean ready) {
+        if (fluidRoundState != null) fluidRoundState.setGateResult(ready);
+    }
+
+    void clearFluidGateResult() {
+        if (fluidRoundState != null) fluidRoundState.clearGateResult();
+    }
+
+    /**
+     * Flag that at least one fluid element wanted to place its fluid, but had to wait for the structure to be built
+     * first. An autoplace round that did nothing but wait reports zero placed elements instead of reporting that the
+     * structure is done.
+     */
+    void markFluidPlacementDeferred() {
+        if (fluidRoundState != null) fluidRoundState.markDeferred();
+    }
+
+    boolean isFluidPlacementDeferred() {
+        return fluidRoundState != null && fluidRoundState.isDeferred();
+    }
+
+    private static class WrappedIItemSource implements IItemSource {
+
+        final AutoPlaceEnvironment container;
+        final IItemSource delegate;
+
+        public WrappedIItemSource(AutoPlaceEnvironment container, IItemSource delegate) {
+            this.container = container;
+            this.delegate = delegate;
+        }
+
+        @Override
+        @Nonnull
+        public Map<ItemStack, Integer> take(Predicate<ItemStack> predicate, boolean simulate, int count) {
+            return delegate.take(predicate, simulate, count);
+        }
+
+        @Override
+        public ItemStack takeOne(Predicate<ItemStack> predicate, boolean simulate) {
+            return delegate.takeOne(predicate, simulate);
+        }
+
+        @Override
+        public boolean takeAll(Predicate<ItemStack> predicate, boolean simulate, int count) {
+            return delegate.takeAll(predicate, simulate, count);
+        }
+
+        @Override
+        public boolean takeOne(ItemStack stack, boolean simulate) {
+            return delegate.takeOne(stack, simulate);
+        }
+
+        @Override
+        public boolean takeAll(ItemStack stack, boolean simulate) {
+            return delegate.takeAll(stack, simulate);
+        }
+    }
+
+    /**
+     * Bookkeeping about the current autoplace round, shared by every instance {@link AutoPlaceEnvironment} hands out
+     * for itself. Implemented by the autoplace walker. Third parties should neither implement nor call this.
+     */
+    public interface FluidRoundState {
+
+        /**
+         * The answer the fluid placement gate gave earlier in this round, or null when it has not been asked yet.
+         */
+        @Nullable
+        Boolean getGateResult();
+
+        /**
+         * Remember the answer of the fluid placement gate for the rest of this round.
+         */
+        void setGateResult(boolean ready);
+
+        /**
+         * Forget the answer of the fluid placement gate, so that it is asked again.
+         * <p>
+         * The answer describes the world as it was before this round built anything, so it has to be dropped once the
+         * round has placed something and the fluids that had to wait are retried. An implementation that keeps no
+         * answer at all can leave this alone.
+         */
+        default void clearGateResult() {}
+
+        /**
+         * Remember that a fluid element had to wait for the structure to be built first.
+         */
+        void markDeferred();
+
+        /**
+         * Whether any fluid element had to wait for the structure to be built in this round.
+         */
+        boolean isDeferred();
+    }
+
+    /**
+     * Defines the various API level an {@link AutoPlaceEnvironment} has implemented.
+     * <p>
+     * Enum constants are defined in chronological order.
+     */
+    public enum APILevel {
+        /**
+         * Implements {@link #getChatter()}, {@link #getActor()} and {@link #getSource()}. {@link #getActor()} is
+         * guaranteed to be an {@link net.minecraft.entity.player.EntityPlayerMP}
+         */
+        Legacy,
+        /**
+         * Implements {@link #getChatter()}, {@link #getActor()} and {@link #getSource()}. {@link #getActor()} is
+         * <b>NOT</b> guaranteed to be an {@link net.minecraft.entity.player.EntityPlayerMP}
+         */
+        LegacyRelaxed,
+        /**
+         * Implements everything so far we have defined.
+         */
+        V2,
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/structure/ChatThrottleKey.java

@@ -0,0 +1,29 @@
+package com.gtnewhorizon.structurelib.structure;
+
+class ChatThrottleKey {
+
+    static class NoExplicitChannel {
+
+        private static final int hashOffset = NoExplicitChannel.class.hashCode();
+        private final String subchannel;
+
+        public NoExplicitChannel(String subchannel) {
+            this.subchannel = subchannel;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (!(o instanceof NoExplicitChannel that)) return false;
+
+            return subchannel.equals(that.subchannel);
+        }
+
+        @Override
+        public int hashCode() {
+            // as this one will be placed within a map along with instances of different classes, it'd be best to add
+            // an offset based off class type to avoid collision
+            return subchannel.hashCode() + hashOffset;
+        }
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/structure/DefaultSurvivalBuildEnvironment.java

@@ -0,0 +1,39 @@
+package com.gtnewhorizon.structurelib.structure;
+
+import javax.annotation.Nullable;
+
+import net.minecraft.entity.player.EntityPlayer;
+
+import com.gtnewhorizon.structurelib.fluid.IFluidSource;
+
+class DefaultSurvivalBuildEnvironment implements ISurvivalBuildEnvironment {
+
+    private final IItemSource source;
+    private final IFluidSource fluidSource;
+    private final EntityPlayer actor;
+
+    public DefaultSurvivalBuildEnvironment(IItemSource source, EntityPlayer actor) {
+        this(source, null, actor);
+    }
+
+    public DefaultSurvivalBuildEnvironment(IItemSource source, @Nullable IFluidSource fluidSource, EntityPlayer actor) {
+        this.source = source;
+        this.fluidSource = fluidSource;
+        this.actor = actor;
+    }
+
+    @Override
+    public IItemSource getSource() {
+        return source;
+    }
+
+    @Override
+    public IFluidSource getFluidSource() {
+        return fluidSource;
+    }
+
+    @Override
+    public EntityPlayer getActor() {
+        return actor;
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/structure/FluidAutoplace.java

@@ -0,0 +1,335 @@
+package com.gtnewhorizon.structurelib.structure;
+
+import java.util.function.Consumer;
+
+import javax.annotation.Nullable;
+
+import net.minecraft.block.Block;
+import net.minecraft.entity.player.EntityPlayer;
+import net.minecraft.util.ChatComponentTranslation;
+import net.minecraft.util.IChatComponent;
+import net.minecraft.util.StatCollector;
+import net.minecraft.world.World;
+import net.minecraftforge.common.util.ForgeDirection;
+import net.minecraftforge.fluids.FluidStack;
+import net.minecraftforge.fluids.IFluidBlock;
+
+import com.gtnewhorizon.gtnhlib.chat.customcomponents.ChatComponentFluid;
+import com.gtnewhorizon.gtnhlib.chat.customcomponents.ChatComponentFluidName;
+import com.gtnewhorizon.gtnhlib.util.numberformatting.NumberFormatUtil;
+import com.gtnewhorizon.structurelib.ConfigurationHandler;
+import com.gtnewhorizon.structurelib.StructureLib;
+import com.gtnewhorizon.structurelib.StructureLibAPI;
+import com.gtnewhorizon.structurelib.alignment.enumerable.ExtendedFacing;
+import com.gtnewhorizon.structurelib.fluid.FluidAmounts;
+import com.gtnewhorizon.structurelib.fluid.FluidBlockRequirement;
+import com.gtnewhorizon.structurelib.fluid.FluidFillPolicy;
+import com.gtnewhorizon.structurelib.fluid.IFluidSource;
+import com.gtnewhorizon.structurelib.structure.IStructureElement.PlaceResult;
+
+/**
+ * Autoplace of fluid blocks.
+ * <p>
+ * Placing a fluid is not the same as placing a block. A block stays where it was put, while a fluid flows out of an
+ * unfinished structure, floods the surroundings, and turns a partially filled position into something that no longer
+ * counts as a source block. This class handles that:
+ * <ul>
+ * <li>It only places a fluid once the rest of the structure is in place, so that the fluid has something to hold it.
+ * See {@link GateMode} for how strict that gate is.</li>
+ * <li>It charges only for the fluid that is actually missing from a position, so topping a position up after a leak
+ * costs the difference instead of a whole bucket.</li>
+ * <li>It only consumes fluid after the block has been placed successfully, and puts the previous block back if the
+ * fluid turns out to be gone by then.</li>
+ * </ul>
+ * Structure elements reach this class through
+ * {@link StructureUtility#survivalPlaceBlock(Block, int, World, int, int, int, IItemSource, EntityPlayer, Consumer)} or
+ * {@link StructureUtility#ofFluidBlock(Block, int)}, and custom elements may call
+ * {@link #tryPlace(World, int, int, int, AutoPlaceEnvironment, FluidBlockRequirement)} directly.
+ */
+public class FluidAutoplace {
+
+    /**
+     * How careful autoplace is about placing a fluid into a structure that is not finished yet.
+     */
+    public enum GateMode {
+        /**
+         * Place the fluid right away. The fluid can flow out of the unfinished structure.
+         */
+        NONE,
+        /**
+         * Only place the fluid when none of its six neighbours is a position that the fluid can flow into and that
+         * doesn't belong to the structure. The fluid can still flow into the part of the structure that is not built
+         * yet, but it cannot leave the structure.
+         */
+        LENIENT,
+        /**
+         * Only place the fluid once every non fluid element of the structure is satisfied. This is the default.
+         * <p>
+         * The fluid is placed as soon as the structure can hold it, which is normally the round that finishes the
+         * structure: the fluids that round could not place yet are tried once more when it is done building, so they do
+         * not have to wait for another round.
+         */
+        STRICT
+    }
+
+    private FluidAutoplace() {}
+
+    /**
+     * Try to place a fluid block, draining the fluid from the autoplace environment's fluid source.
+     * <p>
+     * Nothing is consumed when this returns anything other than {@link PlaceResult#ACCEPT}, and the block that was
+     * there before is put back when the fluid cannot be taken after the block has been placed.
+     *
+     * @param world       world to place in
+     * @param x           x coord
+     * @param y           y coord
+     * @param z           z coord
+     * @param env         autoplace environment, providing the fluid source, the actor and the chatter
+     * @param requirement which block the structure wants there, what it costs, and how strict the check is
+     * @return {@link PlaceResult#SKIP} when the position is already good enough, {@link PlaceResult#ACCEPT} when the
+     *         fluid block has been placed, {@link PlaceResult#REJECT_CONTINUE} when the structure is not ready for its
+     *         fluid yet or fluid autoplace is off, and {@link PlaceResult#REJECT} when the fluid is missing
+     */
+    public static PlaceResult tryPlace(World world, int x, int y, int z, AutoPlaceEnvironment env,
+            FluidBlockRequirement requirement) {
+        if (world.isRemote || !ConfigurationHandler.INSTANCE.isFluidAutoplaceEnabled()) {
+            return PlaceResult.REJECT_CONTINUE;
+        }
+        if (isSatisfied(world, x, y, z, requirement)) return PlaceResult.SKIP;
+        if (!canReplace(world, x, y, z, env.getActor())) return PlaceResult.REJECT;
+        if (!isGateOpen(world, x, y, z, env)) {
+            env.markFluidPlacementDeferred();
+            return PlaceResult.REJECT_CONTINUE;
+        }
+        IFluidSource source = env.getEffectiveFluidSource();
+        if (source == null) {
+            reportMissingFluid(env, requirement, requirement.cost().amount);
+            return PlaceResult.REJECT;
+        }
+        Block existingBlock = world.getBlock(x, y, z);
+        int existingMeta = world.getBlockMetadata(x, y, z);
+        int target = requirement.cost().amount;
+        int existing = existingBlock == requirement.block() ? FluidAmounts.getStoredAmount(world, x, y, z, target) : 0;
+        int missing = Math.max(0, target - existing);
+        if (missing > 0 && !source.takeAll(new FluidStack(requirement.cost(), missing), true)) {
+            reportMissingFluid(
+                    env,
+                    requirement,
+                    missing - source.getAvailable(new FluidStack(requirement.cost(), missing)));
+            return PlaceResult.REJECT;
+        }
+        if (!placeFluidBlock(world, x, y, z, requirement)) return PlaceResult.REJECT;
+        if (missing > 0 && !source.takeAll(new FluidStack(requirement.cost(), missing), false)) {
+            restore(world, x, y, z, existingBlock, existingMeta);
+            return PlaceResult.REJECT;
+        }
+        return PlaceResult.ACCEPT;
+    }
+
+    /**
+     * Try to place one of several fluid blocks, in order, and stop at the first one that is already there or that could
+     * be placed.
+     *
+     * @return the result of the first attempt that was more than a {@link PlaceResult#REJECT_CONTINUE}, or
+     *         {@link PlaceResult#REJECT} when the fluid of an alternative was missing, or
+     *         {@link PlaceResult#REJECT_CONTINUE} when every alternative had to wait
+     * @see #tryPlace(World, int, int, int, AutoPlaceEnvironment, FluidBlockRequirement)
+     */
+    public static PlaceResult tryPlace(World world, int x, int y, int z, AutoPlaceEnvironment env,
+            Iterable<FluidBlockRequirement> requirements) {
+        PlaceResult result = PlaceResult.REJECT_CONTINUE;
+        for (FluidBlockRequirement requirement : requirements) {
+            PlaceResult attempt = tryPlace(world, x, y, z, env, requirement);
+            if (attempt == PlaceResult.REJECT_CONTINUE) continue;
+            if (attempt == PlaceResult.REJECT) {
+                result = PlaceResult.REJECT;
+                continue;
+            }
+            return attempt;
+        }
+        return result;
+    }
+
+    /**
+     * Whether the position already holds as much fluid as the structure asks for.
+     * <p>
+     * This is what a fluid structure element uses for its check, so that a check and an autoplace always agree.
+     *
+     * @param world       world to look at
+     * @param x           x coord
+     * @param y           y coord
+     * @param z           z coord
+     * @param requirement which block the structure wants there, and how strict the check is
+     */
+    public static boolean isSatisfied(World world, int x, int y, int z, FluidBlockRequirement requirement) {
+        Block worldBlock = world.getBlock(x, y, z);
+        if (worldBlock != requirement.block()) return false;
+        if (world.getBlockMetadata(x, y, z) == requirement.meta()) return true;
+        if (requirement.policy() == FluidFillPolicy.EXACT_STATE) return false;
+        int target = requirement.cost().amount;
+        return requirement.policy().isSatisfied(FluidAmounts.getStoredAmount(world, x, y, z, target), target);
+    }
+
+    /**
+     * Put the fluid block into the world without paying for it, which is what a creative mode build does.
+     * <p>
+     * Unlike {@link #tryPlace(World, int, int, int, AutoPlaceEnvironment, FluidBlockRequirement)} this does not check
+     * whether the structure is ready to hold the fluid. A creative mode build places everything that isn't a fluid
+     * first for that reason.
+     *
+     * @return true if the block has been placed
+     */
+    public static boolean place(World world, int x, int y, int z, FluidBlockRequirement requirement) {
+        return placeFluidBlock(world, x, y, z, requirement);
+    }
+
+    /**
+     * Returns a human-readable description of the structure element requirement.
+     */
+    public static String describe(FluidBlockRequirement requirement) {
+        FluidStack stack = requirement.cost();
+        return StatCollector.translateToLocalFormatted(
+                "structurelib.autoplace.requirement_fluid",
+                stack.getLocalizedName(),
+                NumberFormatUtil.formatFluid(stack.amount));
+    }
+
+    /**
+     * Whether a fluid may be placed at this position right now.
+     * <p>
+     * With {@link GateMode#STRICT} the answer is computed by a walk over the whole structure and cached for the rest of
+     * the round, as that walk is expensive. The cache is dropped as soon as the round has built something, so that the
+     * fluids which waited for it are not held back by an answer that predates those placements.
+     *
+     * @param world world to place in
+     * @param x     x coord
+     * @param y     y coord
+     * @param z     z coord
+     * @param env   autoplace environment
+     */
+    public static boolean isGateOpen(World world, int x, int y, int z, AutoPlaceEnvironment env) {
+        GateMode mode = ConfigurationHandler.INSTANCE.getFluidGateMode();
+        if (mode == GateMode.NONE) return true;
+        if (mode == GateMode.LENIENT) return isLocallyContained(world, x, y, z, env);
+        Boolean cached = env.getFluidGateResult();
+        if (cached != null) return cached;
+        boolean ready = isStructureReady(world, env);
+        env.setFluidGateResult(ready);
+        return ready;
+    }
+
+    /**
+     * Whether every non fluid element of the structure is satisfied, i.e. whether the structure is built far enough to
+     * hold the fluid.
+     * <p>
+     * An autoplace environment that doesn't know its structure, e.g. one handed to a legacy caller, always answers
+     * true, as there is nothing to be checked against.
+     */
+    private static boolean isStructureReady(World world, AutoPlaceEnvironment env) {
+        IStructureDefinition<?> definition = env.getDefinition();
+        int[] base = env.getBasePositionXYZ();
+        if (definition == null || base == null) return true;
+        Object context = env.getContextObject();
+        int[] baseOffset = env.getBaseOffsetABC();
+        ExtendedFacing facing = env.getFacing();
+        IStructureElement<Object>[] elements = getElements(definition, env.getPiece());
+        if (elements == null) return true;
+        return StructureUtility.iterateV2(
+                elements,
+                world,
+                facing,
+                base[0],
+                base[1],
+                base[2],
+                baseOffset[0],
+                baseOffset[1],
+                baseOffset[2],
+                (element, w, ex, ey, ez, a, b, c) -> element.isFluidElement(context)
+                        || element.check(context, w, ex, ey, ez),
+                "fluid gate");
+    }
+
+    @SuppressWarnings("unchecked")
+    @Nullable
+    private static IStructureElement<Object>[] getElements(IStructureDefinition<?> definition, String piece) {
+        try {
+            return (IStructureElement<Object>[]) definition.getStructureFor(piece);
+        } catch (RuntimeException e) {
+            StructureLib.LOGGER
+                    .warn("Could not look up structure piece {} to check whether it can hold fluid", piece, e);
+            return null;
+        }
+    }
+
+    /**
+     * Whether the fluid cannot flow out of the structure from this position, i.e. whether every neighbour is either
+     * blocked, or part of the structure and therefore eventually filled by it.
+     */
+    private static boolean isLocallyContained(World world, int x, int y, int z, AutoPlaceEnvironment env) {
+        ExtendedFacing facing = env.getFacing();
+        // An environment that doesn't know the structure cannot tell which neighbours belong to it. Don't block then.
+        if (facing == null) return true;
+        int[] abcOffset = new int[3];
+        int[] xyzOffset = new int[3];
+        for (ForgeDirection direction : ForgeDirection.VALID_DIRECTIONS) {
+            int nx = x + direction.offsetX;
+            int ny = y + direction.offsetY;
+            int nz = z + direction.offsetZ;
+            if (isBlocking(world, nx, ny, nz)) continue;
+            xyzOffset[0] = direction.offsetX;
+            xyzOffset[1] = direction.offsetY;
+            xyzOffset[2] = direction.offsetZ;
+            facing.getOffsetABC(xyzOffset, abcOffset);
+            if (env.isContainedInPiece(abcOffset[0], abcOffset[1], abcOffset[2])) continue;
+            return false;
+        }
+        return true;
+    }
+
+    private static boolean isBlocking(World world, int x, int y, int z) {
+        Block block = world.getBlock(x, y, z);
+        if (block == null) return true;
+        if (block.isAir(world, x, y, z)) return false;
+        if (block.getMaterial() != null && block.getMaterial().isLiquid()) return false;
+        return !block.isReplaceable(world, x, y, z);
+    }
+
+    private static boolean canReplace(World world, int x, int y, int z, EntityPlayer actor) {
+        Block block = world.getBlock(x, y, z);
+        if (block == null || block.isAir(world, x, y, z)) return true;
+        if (block.getMaterial() != null && block.getMaterial().isLiquid()) return true;
+        if (block instanceof IFluidBlock) return true;
+        return StructureLibAPI.isBlockTriviallyReplaceable(world, x, y, z, actor);
+    }
+
+    private static boolean placeFluidBlock(World world, int x, int y, int z, FluidBlockRequirement requirement) {
+        FluidStack fluid = requirement.cost();
+        Block block = requirement.block();
+        if (requirement.placer() != null) {
+            if (!requirement.placer().place(world, x, y, z, block, requirement.meta(), fluid)) return false;
+        } else {
+            // The notification flags matter here. A fluid that is put into the world silently neither flows nor tells
+            // its neighbours about itself, so it would sit where it was placed until something else happens to touch
+            // it, which for water inside a multiblock can be never.
+            if (!world.setBlock(x, y, z, block, requirement.meta(), 3)) return false;
+        }
+        // A fluid that is never ticked does not spread, and a fluid placed as a flowing one would never settle.
+        world.scheduleBlockUpdate(x, y, z, block, block.tickRate(world));
+        return true;
+    }
+
+    private static void restore(World world, int x, int y, int z, Block block, int meta) {
+        StructureLibAPI.restoreBlock(world, x, y, z, block, meta);
+    }
+
+    private static void reportMissingFluid(AutoPlaceEnvironment env, FluidBlockRequirement requirement, int missing) {
+        Consumer<IChatComponent> chatter = env.getChatter();
+        if (chatter == null) return;
+        FluidStack stack = new FluidStack(requirement.cost(), Math.max(1, missing));
+        chatter.accept(
+                new ChatComponentTranslation(
+                        "structurelib.autoplace.missing_fluid",
+                        new ChatComponentFluidName(stack),
+                        new ChatComponentFluid(stack)));
+    }
+}

src/main/java/com/gtnewhorizon/structurelib/structure/IBlockPosConsumer.java

@@ -3,5 +3,6 @@ package com.gtnewhorizon.structurelib.structure;
 import net.minecraft.world.World;
 
 public interface IBlockPosConsumer {
-	void consume(World world, int x, int y, int z);
+
+    void consume(World world, int x, int y, int z);
 }