Fix Central release artifacts

Author: youngledo

.github/workflows/release.yml

@@ -182,33 +182,44 @@ jobs:
                   text = re.sub(r"(<project\b[^>]*>\s*)", r"\1    <modelVersion>4.0.0</modelVersion>\n", text, count=1, flags=re.S)
               return text
 
+          def maven_property(name):
+              return "${" + name + "}"
+
           junit_version = property_value("junit.version")
           log4j2_version = property_value("log4j2.version")
+          exec_maven_plugin_version = property_value("exec-maven-plugin.version")
+          spotbugs_maven_plugin_version = property_value("spotbugs-maven-plugin.version")
+          maven_jar_plugin_version = property_value("maven-jar-plugin.version")
+          maven_source_plugin_version = property_value("maven-source-plugin.version")
+          maven_javadoc_plugin_version = property_value("maven-javadoc-plugin.version")
+          maven_surefire_plugin_version = property_value("maven-surefire-plugin.version")
+          maven_gpg_plugin_version = property_value("maven-gpg-plugin.version")
+          maven_assembly_plugin_version = "3.7.1"
 
           root_text = central_compatible_pom(root_text)
           root_text = root_text.replace("<version>${revision}</version>", f"<version>{revision}</version>", 1)
           root_text = re.sub(r"<revision>[^<]+</revision>", f"<revision>{revision}</revision>", root_text, count=1)
-          root_modules = """    <modules>\n        <module>godot-java-code-generator</module>\n        <module>godot-java-core</module>\n        <module>godot-java-examples</module>\n        <module>godot-java-native</module>\n    </modules>\n\n"""
+          root_modules = """    <modules>\n        <module>godot-java-code-generator</module>\n        <module>godot-java-core</module>\n        <module>godot-java-native</module>\n    </modules>\n\n"""
           if "<modules>" not in root_text:
               root_text = root_text.replace("    <licenses>", root_modules + "    <licenses>", 1)
           root.write_text(root_text)
 
           parent_with_coordinates = f"""    <parent>\n        <groupId>io.github.youngledo</groupId>\n        <artifactId>godot-java</artifactId>\n        <version>{revision}</version>\n    </parent>"""
           for path in [
               Path("godot-java-code-generator/pom.xml"),
-              Path("godot-java-core/pom.xml"),
-              Path("godot-java-examples/pom.xml"),
-              Path("godot-java-native/pom.xml"),
           ]:
               text = central_compatible_pom(path.read_text())
               if "<parent/>" not in text:
                   raise RuntimeError(f"Unexpected parent block in {path}")
               path.write_text(re.sub(r"\s*<parent/>\s*", "\n" + parent_with_coordinates + "\n\n", text, count=1))
 
           core = Path("godot-java-core/pom.xml")
-          core_text = core.read_text()
+          core_text = central_compatible_pom(core.read_text())
+          if "<parent/>" not in core_text:
+              raise RuntimeError("Unexpected parent block in godot-java-core/pom.xml")
+          core_text = re.sub(r"\s*<parent/>\s*", "\n", core_text, count=1)
           core_coordinates = f"""    <groupId>io.github.youngledo</groupId>\n    <version>{revision}</version>\n"""
-          core_text = core_text.replace("    <artifactId>godot-java-core</artifactId>", core_coordinates + "    <artifactId>godot-java-core</artifactId>", 1)
+          core_text = re.sub(r"(\s*)<artifactId>godot-java-core</artifactId>", "\n" + core_coordinates + r"\1<artifactId>godot-java-core</artifactId>", core_text, count=1)
           core_metadata = """
 
               <url>https://github.com/youngledo/godot-java</url>
@@ -237,19 +248,63 @@ jobs:
           core_text = core_text.replace("""            <artifactId>junit-jupiter</artifactId>""", f"""            <artifactId>junit-jupiter</artifactId>\n            <version>{junit_version}</version>\n            <scope>test</scope>""", 1)
           core_text = core_text.replace("""            <artifactId>log4j-api</artifactId>""", f"""            <artifactId>log4j-api</artifactId>\n            <version>{log4j2_version}</version>""", 1)
           core_text = core_text.replace("""            <artifactId>log4j-core</artifactId>""", f"""            <artifactId>log4j-core</artifactId>\n            <version>{log4j2_version}</version>\n            <scope>runtime</scope>""", 1)
+          core_text = core_text.replace("${exec-maven-plugin.version}", exec_maven_plugin_version)
+          core_text = core_text.replace("${spotbugs-maven-plugin.version}", spotbugs_maven_plugin_version)
+          for artifact_id, version in [
+              ("maven-jar-plugin", maven_jar_plugin_version),
+              ("maven-surefire-plugin", maven_surefire_plugin_version),
+              ("maven-source-plugin", maven_source_plugin_version),
+              ("maven-javadoc-plugin", maven_javadoc_plugin_version),
+          ]:
+              marker = f"            <artifactId>{artifact_id}</artifactId>"
+              replacement = marker + f"\n            <version>{version}</version>"
+              if marker in core_text and replacement not in core_text:
+                  core_text = core_text.replace(marker, replacement, 1)
+          core_text = core_text.replace("        </plugins>", f"""            <plugin>\n                <groupId>org.apache.maven.plugins</groupId>\n                <artifactId>maven-gpg-plugin</artifactId>\n                <version>{maven_gpg_plugin_version}</version>\n                <configuration>\n                    <skip>{maven_property("gpg.skip")}</skip>\n                    <passphrase>{maven_property("env.GPG_PASSPHRASE")}</passphrase>\n                    <gpgArguments>\n                        <arg>--pinentry-mode</arg>\n                        <arg>loopback</arg>\n                    </gpgArguments>\n                </configuration>\n                <executions>\n                    <execution>\n                        <id>sign-artifacts</id>\n                        <phase>verify</phase>\n                        <goals>\n                            <goal>sign</goal>\n                        </goals>\n                    </execution>\n                </executions>\n            </plugin>\n        </plugins>""", 1)
           core.write_text(core_text)
 
-          examples = Path("godot-java-examples/pom.xml")
-          examples_text = examples.read_text()
-          examples_text = examples_text.replace("""            <artifactId>godot-java-core</artifactId>""", f"""            <artifactId>godot-java-core</artifactId>\n            <version>{revision}</version>""", 1)
-          examples.write_text(examples_text)
+          native = Path("godot-java-native/pom.xml")
+          native_text = central_compatible_pom(native.read_text())
+          if "<parent/>" not in native_text:
+              raise RuntimeError("Unexpected parent block in godot-java-native/pom.xml")
+          native_text = re.sub(r"\s*<parent/>\s*", "\n", native_text, count=1)
+          native_coordinates = f"""    <groupId>io.github.youngledo</groupId>\n    <version>{revision}</version>\n"""
+          native_text = re.sub(r"(\s*)<artifactId>godot-java-native</artifactId>", "\n" + native_coordinates + r"\1<artifactId>godot-java-native</artifactId>", native_text, count=1)
+          native_metadata = """
+
+              <url>https://github.com/youngledo/godot-java</url>
+
+              <licenses>
+                  <license>
+                      <name>Apache-2.0</name>
+                      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+                      <distribution>repo</distribution>
+                  </license>
+              </licenses>
+
+              <developers>
+                  <developer>
+                      <id>youngledo</id>
+                  </developer>
+              </developers>
+
+              <scm>
+                  <connection>scm:git:git@github.com:youngledo/godot-java.git</connection>
+                  <developerConnection>scm:git:git@github.com:youngledo/godot-java.git</developerConnection>
+                  <url>https://github.com/youngledo/godot-java</url>
+              </scm>"""
+          native_text = native_text.replace("    <description>Platform native GDExtension library for godot-java</description>", "    <description>Platform native GDExtension library for godot-java</description>" + native_metadata, 1)
+          native_text = native_text.replace("""                <artifactId>maven-assembly-plugin</artifactId>""", f"""                <artifactId>maven-assembly-plugin</artifactId>\n                <version>{maven_assembly_plugin_version}</version>""", 1)
+          native_text = native_text.replace("        </plugins>", f"""            <plugin>\n                <groupId>org.apache.maven.plugins</groupId>\n                <artifactId>maven-gpg-plugin</artifactId>\n                <version>{maven_gpg_plugin_version}</version>\n                <configuration>\n                    <skip>{maven_property("gpg.skip")}</skip>\n                    <passphrase>{maven_property("env.GPG_PASSPHRASE")}</passphrase>\n                    <gpgArguments>\n                        <arg>--pinentry-mode</arg>\n                        <arg>loopback</arg>\n                    </gpgArguments>\n                </configuration>\n                <executions>\n                    <execution>\n                        <id>sign-artifacts</id>\n                        <phase>verify</phase>\n                        <goals>\n                            <goal>sign</goal>\n                        </goals>\n                    </execution>\n                </executions>\n            </plugin>\n        </plugins>""", 1)
+          native.write_text(native_text)
+
           PY
 
       - name: Build and publish
         env:
           CENTRAL_USERNAME: ${{ secrets.CENTRAL_USERNAME }}
           CENTRAL_TOKEN: ${{ secrets.CENTRAL_TOKEN }}
-        run: ./mvnw deploy -P release -Drevision="$REVISION" -Dgodot.java.native.attach.dir="$PWD/dist/native" -DskipTests -B
+        run: ./mvnw deploy -pl godot-java-core,godot-java-native -am -P release -Drevision="$REVISION" -Dgodot.java.native.attach.dir="$PWD/dist/native" -DskipTests -B
 
       - name: Attach native fallback artifacts to GitHub Release
         uses: softprops/action-gh-release@v2

README.md

@@ -9,9 +9,10 @@ ENGLISH | [中文](README_ZH.md)
 Java bindings for [Godot](https://godotengine.org/).  
 Built on top of GDExtension and Panama FFI to make Java a first-class citizen in the Godot ecosystem.
 
-> Status: 0.1.0 – production-ready with scoped memory management and full GDExtension feature coverage.
+> Status: 0.1.2 – production-ready with scoped memory management, full GDExtension feature coverage, and Maven Central desktop runtime artifacts.
 
 Project examples:
+- [godot-java-template](https://github.com/youngledo/godot-java-template) — recommended starting point for new desktop projects
 - [godot-java-examples](godot-java-examples/README.md) — 10 small examples in this repo
 - [godot-java-demo-projects](https://github.com/youngledo/godot-java-demo-projects) — 107 official Godot demos ported to Java (2D, 3D, audio, GUI, networking, XR, and more)
 - [godot-java-3d-demo](https://github.com/youngledo/godot-java-3d-demo) — a 3D character demo
@@ -313,20 +314,21 @@ Then verify:
 
 ## Where to start?
 
-To get a demo running:
+To start a new Godot Java project, use the standalone template:
 
-1. Make sure you have:
-   - JDK 25+
-   - Maven 4.0.x
-   - Godot
+```bash
+git clone https://github.com/youngledo/godot-java-template.git my-godot-game
+cd my-godot-game
+./mvnw package
+godot --path godot
+```
 
-2. Read:
-   - [docs/en/user/getting-started.md](docs/en/user/getting-started.md)
+The template consumes released Maven artifacts and syncs `app.jar` plus the
+matching native desktop library into the Godot project during `mvn package`.
 
-3. Then:
-   - Build `godot-java-core` and `godot-java-code-generator`
-   - Load the built GDExtension into a new Godot project
-   - Create a simple `@GodotClass`-annotated Java script and experiment
+Then read [docs/en/user/getting-started.md](docs/en/user/getting-started.md).
+Use this repository directly only when contributing to the framework or running
+the internal examples.
 
 ---
 

README_ZH.md

@@ -8,9 +8,10 @@
 
 [Godot](https://godotengine.org/zh-cn/) 的 Java 绑定，通过 GDExtension + Panama FFI 让 Java 在 Godot 生态中成为一等公民。
 
-> 状态：0.1.0——生产就绪，具备 scoped 内存管理和完整的 GDExtension 功能覆盖。
+> 状态：0.1.2——生产就绪，具备 scoped 内存管理、完整 GDExtension 功能覆盖，以及 Maven Central 桌面运行时发布物。
 
 项目示例：
+- [godot-java-template](https://github.com/youngledo/godot-java-template) — 新桌面项目推荐起点
 - [godot-java-examples](godot-java-examples/README_ZH.md) — 本仓库内的 10 个小示例
 - [godot-java-demo-projects](https://github.com/youngledo/godot-java-demo-projects) — 107 个 Godot 官方示例的 Java 移植版（2D、3D、音频、GUI、网络、XR 等）
 - [godot-java-3d-demo](https://github.com/youngledo/godot-java-3d-demo) — 3D 角色演示
@@ -300,20 +301,19 @@ godot-java/
 
 ## 我应该从哪开始？
 
-如果你想快速跑起来：
+新 Godot Java 项目建议从独立模板开始：
 
-1. 确保本地有：
-   - JDK 25+
-   - Maven 4.0.x
-   - Godot
+```bash
+git clone https://github.com/youngledo/godot-java-template.git my-godot-game
+cd my-godot-game
+./mvnw package
+godot --path godot
+```
 
-2. 阅读：
-   - [docs/zh/user/getting-started.md](docs/zh/user/getting-started.md)
+模板使用已发布的 Maven artifacts，并在 `mvn package` 时把 `app.jar` 和匹配平台的 native 库同步到 Godot 项目。
 
-3. 然后根据文档：
-   - 构建 `godot-java-core` 和 `godot-java-code-generator`
-   - 在一个新的 Godot 项目中加载生成的 GDExtension
-   - 创建一个简单的 `@GodotClass` Java 脚本进行试验
+然后阅读 [docs/zh/user/getting-started.md](docs/zh/user/getting-started.md)。
+只有在贡献框架或运行仓库内部示例时，才需要直接使用本仓库源码。
 
 ---
 

docs/README.md

@@ -8,7 +8,7 @@ ENGLISH | [中文](README_ZH.md)
 
 > Write Godot 4.6 game logic in Java 25+ using Panama FFI
 
-- [Getting Started](en/user/getting-started.md) -- Prerequisites, Maven setup, first class
+- [Getting Started](en/user/getting-started.md) -- Template project, Maven setup, first Java class
 - [API Reference](en/user/api.md) -- Annotations, types, core classes
 - [Development Guide](en/user/guide.md) -- Step-by-step game entity, virtual methods, signals
 - [Troubleshooting](en/user/troubleshooting.md) -- Common errors and solutions

docs/README_ZH.md

@@ -8,7 +8,7 @@
 
 > 使用 Java 25+ 和 Panama FFI 编写 Godot 4.6 游戏逻辑
 
-- [快速入门](zh/user/getting-started.md) -- 环境准备、Maven 配置、第一个类
+- [快速入门](zh/user/getting-started.md) -- 模板项目、Maven 配置、第一个 Java 类
 - [API 参考](zh/user/api.md) -- 注解、类型、核心类
 - [开发指南](zh/user/guide.md) -- 逐步构建游戏实体、虚方法、信号
 - [常见问题](zh/user/troubleshooting.md) -- 常见错误及解决方案