Make plugin version single source of truth in CMakeLists.txt

Define VERSION in project() and pass it to C++ via configure_file
with version.h.in. The release workflow now updates CMakeLists.txt
and commits the version bump alongside the changelog update.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: wu-vincent

.github/workflows/release.yml

@@ -59,9 +59,19 @@ jobs:
           echo "Tag: v$VERSION"
           echo "Date: $DATE"
           echo ""
+          echo "=== CMakeLists.txt version (current) ==="
+          grep 'project(' CMakeLists.txt
+          echo "=== CMakeLists.txt version (after update) ==="
+          echo "project(cpp_example VERSION $VERSION LANGUAGES CXX)"
+          echo ""
           echo "=== Release Body ==="
           cat /tmp/release_body.md
 
+      - name: Update version in CMakeLists.txt
+        if: ${{ !inputs.dry_run }}
+        run: |
+          sed -i "s/\(project(cpp_example VERSION \)[0-9]\+\.[0-9]\+\.[0-9]\+/\1$VERSION/" CMakeLists.txt
+
       - name: Update CHANGELOG.md
         if: ${{ !inputs.dry_run }}
         run: |
@@ -73,7 +83,7 @@ jobs:
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git add CHANGELOG.md
+          git add CMakeLists.txt CHANGELOG.md
           git commit -m "Release $VERSION"
           git tag "v$VERSION"
 

AGENTS.md

@@ -15,7 +15,7 @@ Use CMake with FetchContent to pull in the Endstone SDK:
 
 ```cmake
 cmake_minimum_required(VERSION 3.15)
-project(my_plugin CXX)
+project(my_plugin VERSION 0.1.0 LANGUAGES CXX)
 
 set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
@@ -28,8 +28,11 @@ FetchContent_Declare(
 )
 FetchContent_MakeAvailable(endstone)
 
+string(TOUPPER ${PROJECT_NAME} PROJECT_NAME_UPPER)
+configure_file(include/version.h.in include/version.h)
+
 endstone_add_plugin(${PROJECT_NAME} src/plugin.cpp)
-target_include_directories(${PROJECT_NAME} PRIVATE include)
+target_include_directories(${PROJECT_NAME} PRIVATE include ${CMAKE_CURRENT_BINARY_DIR}/include)
 ```
 
 ## Plugin Class
@@ -68,7 +71,8 @@ Declared in a .cpp file:
 ```cpp
 #include "plugin.h"
 
-ENDSTONE_PLUGIN("my_plugin", "0.1.0", MyPlugin)
+// MY_PLUGIN_VERSION is defined in version.h, generated by CMake from project(... VERSION ...)
+ENDSTONE_PLUGIN("my_plugin", MY_PLUGIN_VERSION, MyPlugin)
 {
     prefix = "MyPlugin";
     description = "My Endstone plugin";

CMakeLists.txt

@@ -1,6 +1,6 @@
 cmake_minimum_required(VERSION 3.15)
 
-project(cpp_example CXX)
+project(cpp_example VERSION 0.5.0 LANGUAGES CXX)
 
 set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
@@ -16,5 +16,8 @@ FetchContent_Declare(
 )
 FetchContent_MakeAvailable(endstone)
 
+string(TOUPPER ${PROJECT_NAME} PROJECT_NAME_UPPER)
+configure_file(include/version.h.in include/version.h)
+
 endstone_add_plugin(${PROJECT_NAME} src/plugin.cpp)
-target_include_directories(${PROJECT_NAME} PRIVATE include)
+target_include_directories(${PROJECT_NAME} PRIVATE include ${CMAKE_CURRENT_BINARY_DIR}/include)

README.md

@@ -14,8 +14,9 @@ and permissions.
 
 | What | Where | Example |
 |------|-------|---------|
-| Project name | `CMakeLists.txt` `project(...)` | `project(my_plugin CXX)` |
-| Plugin metadata | `src/plugin.cpp` `ENDSTONE_PLUGIN(...)` | `"my_plugin", "0.1.0", MyPlugin` |
+| Project name | `CMakeLists.txt` `project(...)` | `project(my_plugin VERSION 0.1.0 LANGUAGES CXX)` |
+| Plugin version | `CMakeLists.txt` `project(... VERSION ...)` | `0.1.0` |
+| Plugin metadata | `src/plugin.cpp` `ENDSTONE_PLUGIN(...)` | `"my_plugin", MY_PLUGIN_VERSION, MyPlugin` |
 | Plugin class | `include/plugin.h` class name | `MyPlugin` |
 | Prefix | `src/plugin.cpp` `prefix = ...` | `"MyPlugin"` |
 | Permission prefix | `src/plugin.cpp` permission names | `my_plugin.command.*` |

include/version.h.in

@@ -0,0 +1,3 @@
+#pragma once
+
+#define @PROJECT_NAME_UPPER@_VERSION "@PROJECT_VERSION@"

src/plugin.cpp

@@ -1,9 +1,10 @@
 #include "plugin.h"
+#include "version.h"
 
 // The ENDSTONE_PLUGIN macro defines the metadata for the plugin.
 // This is where you set the plugin name, version, and main class,
 // and declare commands and permissions.
-ENDSTONE_PLUGIN(/*name=*/"cpp_example", /*version=*/"0.1.0", /*main_class=*/ExamplePlugin)
+ENDSTONE_PLUGIN(/*name=*/"cpp_example", /*version=*/CPP_EXAMPLE_VERSION, /*main_class=*/ExamplePlugin)
 {
     prefix = "ExamplePlugin";
     description = "C++ example plugin for Endstone servers";