From ce2967ed400a0f3ff052676e79afed8818e5211c Mon Sep 17 00:00:00 2001
From: ToxicCrzay270 <185776014+ToxicCrzay270@users.noreply.github.com>
Date: Wed, 27 May 2026 13:48:25 +0200
Subject: [PATCH] Add Power Grid NeoForge port submodule

---
 .codex/project.md     | 15 ++++++++-
 .gitmodules           |  4 +++
 AGENTS.md             | 19 +++++++++--
 CHANGELOG.md          |  1 +
 README.md             | 73 +++++++++++++++++++++++++++++++++++++------
 docs/agent-handoff.md |  5 ++-
 power-grid            |  1 +
 7 files changed, 104 insertions(+), 14 deletions(-)
 create mode 100644 .gitmodules
 create mode 160000 power-grid

diff --git a/.codex/project.md b/.codex/project.md
index 50f7db8..9f5bc1b 100644
--- a/.codex/project.md
+++ b/.codex/project.md
@@ -4,7 +4,10 @@
 
 `minecraft-renew-mod` is a local workspace for Minecraft mod porting and prototyping.
 
-The active project is `create-limited-draining/`, a NeoForge port of Create: Limited Draining for Minecraft 1.21.1 and Create 6.0.10.
+The active projects are:
+
+- `create-limited-draining/`, a NeoForge port of Create: Limited Draining for Minecraft 1.21.1 and Create 6.0.10.
+- `power-grid/`, the official Create: Power Grid `architectury-1.21.1/dev` upstream branch tracked as a submodule for NeoForge 1.21.1 verification.
 
 Repository:
 
@@ -33,6 +36,13 @@ From `create-limited-draining/`:
 .\gradlew dependencies --configuration runtimeClasspath
 ```
 
+From `power-grid/`:
+
+```powershell
+.\gradlew :forge:compileJava -x :native:buildWindows -x :native:buildLinux --no-daemon
+.\gradlew :forge:remapJar -x :native:buildWindows -x :native:buildLinux --no-daemon
+```
+
 Command notes:
 
 - Build: `.\gradlew build`
@@ -40,6 +50,7 @@ Command notes:
 - Lint: no separate lint command is currently documented
 - Audit/dependency review: `.\gradlew dependencies --configuration runtimeClasspath`
 - README generation: README is maintained manually; no blueprint generator is configured
+- Power Grid NeoForge artifact build: `.\gradlew :forge:remapJar -x :native:buildWindows -x :native:buildLinux --no-daemon`
 
 ## Stack
 
@@ -59,12 +70,14 @@ Release artifacts are produced in:
 
 ```text
 create-limited-draining/build/libs/
+power-grid/forge/build/libs/
 ```
 
 Expected files:
 
 ```text
 createlimiteddraining-*.jar
+powergrid-*.jar
 ```
 
 ## Security Rules
diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..d433ead
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,4 @@
+[submodule "power-grid"]
+	path = power-grid
+	url = https://github.com/patryk3211/PowerGrid.git
+	branch = architectury-1.21.1/dev
diff --git a/AGENTS.md b/AGENTS.md
index 4f95d3c..e416f85 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -4,7 +4,10 @@
 
 Minecraft Renew Mod is a local workspace for Minecraft mod porting and prototyping.
 
-The active project is `create-limited-draining/`, a NeoForge port of Create: Limited Draining for Minecraft 1.21.1 and Create 6.0.10.
+The active projects are:
+
+- `create-limited-draining/`, a NeoForge port of Create: Limited Draining for Minecraft 1.21.1 and Create 6.0.10.
+- `power-grid/`, the official Create: Power Grid `architectury-1.21.1/dev` upstream branch tracked as a submodule for NeoForge 1.21.1 verification.
 
 ## Repository Rules
 
@@ -22,7 +25,7 @@ The active project is `create-limited-draining/`, a NeoForge port of Create: Lim
 
 ## Commands
 
-Run commands from `create-limited-draining/` unless noted otherwise.
+From `create-limited-draining/`:
 
 ```powershell
 .\gradlew build
@@ -31,7 +34,14 @@ Run commands from `create-limited-draining/` unless noted otherwise.
 .\gradlew dependencies --configuration runtimeClasspath
 ```
 
-There is no separate lint or test command currently documented. Use `.\gradlew build` as the cheapest reliable verification command.
+From `power-grid/`:
+
+```powershell
+.\gradlew :forge:compileJava -x :native:buildWindows -x :native:buildLinux --no-daemon
+.\gradlew :forge:remapJar -x :native:buildWindows -x :native:buildLinux --no-daemon
+```
+
+There is no separate lint command currently documented. Use the project-specific build or compile command as the cheapest reliable verification command.
 
 ## Artifacts
 
@@ -39,12 +49,14 @@ Expected build output:
 
 ```text
 create-limited-draining/build/libs/*.jar
+power-grid/forge/build/libs/*.jar
 ```
 
 Current documented artifact:
 
 ```text
 createlimiteddraining-1.21.1-0.3.0-port.1.jar
+powergrid-mc1.21.1-0.5.5.1.jar
 ```
 
 ## Security Notes
@@ -53,6 +65,7 @@ createlimiteddraining-1.21.1-0.3.0-port.1.jar
 - Treat generated Minecraft run data under `create-limited-draining/run/` as local-only.
 - Treat Gradle caches, logs, generated resources, and build outputs as generated files.
 - Keep external dependency sources documented in `create-limited-draining/build.gradle`.
+- Keep `power-grid/` aligned with the upstream submodule unless explicitly doing local patch work.
 - Keep publishing credentials in Gitea repository or organization secrets, not in tracked files.
 
 ## Finish Checklist
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2d535ef..de9932b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,7 @@ All notable changes to this workspace are documented here.
 
 ## Unreleased
 
+- Added Create: Power Grid as an upstream submodule for the official Minecraft 1.21.1 NeoForge port branch.
 - Updated the processed Codex repository kit guidance to derive repository owner/name from the target remote or CI metadata.
 - Added Codex repository baseline files from the repository kit.
 - Added root README documentation for the Minecraft Renew Mod workspace.
diff --git a/README.md b/README.md
index 7c0540d..2a8d8a1 100644
--- a/README.md
+++ b/README.md
@@ -1,17 +1,72 @@
 # Minecraft Renew Mod
 
-Local project area for Minecraft mod porting and prototyping.
+Local workspace for Minecraft mod porting and prototyping.
 
-## Current Port
+## Projects
 
-The first port target is `Create: Limited Draining`, located in `create-limited-draining/`.
+| Project | Path | Status |
+| --- | --- | --- |
+| Create: Limited Draining | `create-limited-draining/` | Local NeoForge 1.21.1 port |
+| Create: Power Grid | `power-grid/` | Official upstream NeoForge 1.21.1 branch tracked as a submodule |
+
+## Create: Limited Draining
 
 - Original project: https://github.com/JasdewStarfield/CreateLimitedDraining
-- Original license: MIT License, Copyright (c) 2024 Jasdew Starfield
-- Port target: Minecraft 1.21.1, NeoForge 21.1.x, Create 6.0.10
+- License: MIT License, Copyright (c) 2024 Jasdew Starfield
+- Target: Minecraft 1.21.1, NeoForge 21.1.x, Create 6.0.10
 
-## Rules
+Build:
 
-- Work on `feature/create-addon-port` for this port.
-- Do not push, merge, or publish without explicit approval.
-- Keep original license and attribution with any copied code or assets.
+```powershell
+cd create-limited-draining
+.\gradlew build
+```
+
+Artifact:
+
+```text
+create-limited-draining/build/libs/
+```
+
+## Create: Power Grid
+
+- Original project: https://github.com/patryk3211/PowerGrid
+- License: Apache License 2.0
+- Source branch: `architectury-1.21.1/dev`
+- Target: Minecraft 1.21.1, NeoForge, Create 6.0.10
+- Published reference: Modrinth version `0.5.5.1` for Minecraft 1.21.1 + NeoForge
+
+Clone submodules after checkout:
+
+```powershell
+git submodule update --init --recursive
+```
+
+Verify the NeoForge Java port without building native acceleration binaries:
+
+```powershell
+cd power-grid
+.\gradlew :forge:compileJava -x :native:buildWindows -x :native:buildLinux --no-daemon
+```
+
+Build a NeoForge JAR without native acceleration binaries:
+
+```powershell
+cd power-grid
+.\gradlew :forge:remapJar -x :native:buildWindows -x :native:buildLinux --no-daemon
+```
+
+Artifact:
+
+```text
+power-grid/forge/build/libs/powergrid-mc1.21.1-0.5.5.1.jar
+```
+
+The full upstream `:forge:build` also tries to build native acceleration binaries and may require CMake plus a working C/C++ toolchain.
+
+## Repository Rules
+
+- Work on `feature/create-addon-port` unless the user says otherwise.
+- Do not push, merge, publish, or create releases without explicit approval.
+- Keep original licenses and attribution with copied code, assets, and submodules.
+- Do not commit local run directories, generated worlds, Gradle caches, build outputs, logs, or secrets.
diff --git a/docs/agent-handoff.md b/docs/agent-handoff.md
index 62e7297..0600c98 100644
--- a/docs/agent-handoff.md
+++ b/docs/agent-handoff.md
@@ -15,14 +15,17 @@ Codex repository kit baseline has been applied to the workspace and updated to k
 - Added Gitea workflow templates adapted for the Gradle Minecraft mod workspace.
 - Added `.gitignore` entries for local kit checkout, build output, Minecraft run data, logs, and secrets.
 - Processed the kit update that requires repository owner/name to be derived from the target repository remote or CI metadata.
+- Added `power-grid/` as the official upstream Create: Power Grid `architectury-1.21.1/dev` submodule.
 
 ## Verification
 
 | Check | Result |
 | --- | --- |
-| `git diff --check` | Skipped: root workspace is not a Git repository in this environment |
+| `git diff --check` | Passed on 2026-05-27 |
 | `.\gradlew build` | Passed on 2026-05-15 |
 | `.\gradlew dependencies --configuration runtimeClasspath` | Passed on 2026-05-15 |
+| `power-grid .\gradlew :forge:compileJava -x :native:buildWindows -x :native:buildLinux --no-daemon` | Passed on 2026-05-27 |
+| `power-grid .\gradlew :forge:remapJar -x :native:buildWindows -x :native:buildLinux --no-daemon` | Passed on 2026-05-27 |
 
 ## Open Questions
 
diff --git a/power-grid b/power-grid
new file mode 160000
index 0000000..96daf40
--- /dev/null
+++ b/power-grid
@@ -0,0 +1 @@
+Subproject commit 96daf40407d608c12ebabb03b7249f63ee95b98f