Add Gymnasium client

.github/workflows/linux.yml

@@ -125,6 +125,42 @@ jobs:
         run: |
           ./util/test_multiplayer.sh
 
+  pytest:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v3
+      - name: Install deps
+        run: |
+          source ./util/ci/common.sh
+          install_linux_deps clang-14 gdb
+
+      - name: Build
+        run: |
+          ./util/ci/build.sh
+        env:
+          CC: clang-14
+          CXX: clang++-14
+
+      - uses: conda-incubator/setup-miniconda@v3
+        with:
+          python-version: '3.11'
+          mamba-version: "*"
+          channels: conda-forge,nodefaults
+          activate-environment: minetest
+          environment-file: environment.yml
+
+      - name: Setup Minetest env
+        shell: bash -x -l {0}
+        run: |
+          pushd python && pip install -e . && popd
+
+      - name: Run pytest
+        shell: bash -l {0}
+        run: |
+          set -euo pipefail
+          timeout 5m pytest -v || find artifacts/log -type f -name '*.log' -exec cat {} \;
+
+
   # Build with prometheus-cpp (server-only)
   clang_9_prometheus:
     name: "clang_9 (PROMETHEUS=1)"
@@ -151,13 +187,3 @@ jobs:
       - name: Test
         run: |
           ./bin/minetestserver --run-unittests
-
-  docker:
-    name: "Docker image"
-    runs-on: ubuntu-20.04
-    steps:
-      - uses: actions/checkout@v3
-      - name: Build docker image
-        run: |
-          docker build . -t minetest:latest
-          docker run --rm minetest:latest /usr/local/bin/minetestserver --version

.github/workflows/macos.yml

@@ -33,17 +33,18 @@ jobs:
 
       - name: Build
         run: |
-          git clone https://github.com/minetest/irrlicht lib/irrlichtmt --depth 1 -b $(cat misc/irrlichtmt_tag.txt)
-          mkdir build
-          cd build
-          cmake .. \
-            -DCMAKE_OSX_DEPLOYMENT_TARGET=10.14 \
+          cmake -B build -S . \
             -DCMAKE_FIND_FRAMEWORK=LAST \
-            -DCMAKE_INSTALL_PREFIX=../build/macos/ \
-            -DRUN_IN_PLACE=FALSE -DENABLE_GETTEXT=TRUE \
-            -DINSTALL_DEVTEST=TRUE
-          cmake --build . -j$(sysctl -n hw.logicalcpu)
-          make install
+            -DCMAKE_INSTALL_PREFIX=build/macos/ \
+            -DRUN_IN_PLACE=FALSE \
+            -DENABLE_GETTEXT=TRUE \
+            -DCMAKE_BUILD_TYPE=Debug \
+            -DBUILD_HEADLESS=FALSE \
+            -GNinja \
+            -DSDL2_DIR= \
+            -DCMAKE_EXPORT_COMPILE_COMMANDS=1
+          cmake --build build
+          cmake --install build
 
       - name: Test
         run: |

.gitignore

@@ -25,8 +25,6 @@ gtags.files
 .idea
 # Codelite
 *.project
-# Visual Studio Code & plugins
-.vscode/
 build/.cmake/
 # Fleet
 .fleet
@@ -66,6 +64,7 @@ AppDir
 /client/mod_storage/
 
 ## Configuration/log files
+artifacts/
 minetest.conf
 debug.txt
 debug.txt.1
@@ -126,3 +125,7 @@ lib/irrlichtmt
 
 # Generated mod storage database
 client/mod_storage.sqlite
+
+# Python
+*.egg-info
+*.pyc

.gitmodules

@@ -0,0 +1,13 @@
+[submodule "lib/zmqpp"]
+	path = lib/zmqpp
+	url = https://github.com/zeromq/zmqpp.git
+[submodule "games/minetest_game"]
+	path = games/minetest_game
+	url = https://github.com/minetest/minetest_game.git
+[submodule "lib/SDL"]
+	path = lib/SDL
+	url = https://github.com/libsdl-org/SDL.git
+[submodule "lib/irrlichtmt"]
+	path = lib/irrlichtmt
+	url = https://github.com/Astera-org/irrlicht
+	branch = headless

.pre-commit-config.yaml

@@ -0,0 +1,11 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.1.2
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+        types: [python]
+        exclude: '^util/'
+      - id: ruff-format
+        types: [python]
+        exclude: '^util/'

.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+    "recommendations": [
+        "greenxenith.minetest-tools"
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "editor.formatOnSave": false
+}

CMakeLists.txt

@@ -39,6 +39,7 @@ endif()
 
 # Configuration options
 set(BUILD_CLIENT TRUE CACHE BOOL "Build client")
+set(BUILD_HEADLESS TRUE CACHE BOOL "Build in headless mode")
 set(BUILD_SERVER FALSE CACHE BOOL "Build server")
 set(BUILD_UNITTESTS TRUE CACHE BOOL "Build unittests")
 set(BUILD_BENCHMARKS FALSE CACHE BOOL "Build benchmarks")
@@ -303,6 +304,8 @@ endif()
 find_package(GMP REQUIRED)
 find_package(Json REQUIRED)
 find_package(Lua REQUIRED)
+find_package(Zmq REQUIRED)
+find_package(Zmqpp REQUIRED)
 if(NOT USE_LUAJIT)
 	add_subdirectory(lib/bitop)
 endif()

builtin/settingtypes.txt

@@ -1728,6 +1728,9 @@ deprecated_lua_api_handling (Deprecated Lua API handling) enum log none,log,erro
 #    Enable random user input (only used for testing).
 random_input (Random input) bool false
 
+#    Enable input via remote message queue (for AI agent training).
+remote_input (Remote input) string
+
 #    Enable mod channels support.
 enable_mod_channels (Mod channels) bool false
 

cmake/Modules/FindZmq.cmake

@@ -0,0 +1,10 @@
+mark_as_advanced(ZMQ_LIBRARY ZMQ_INCLUDE_DIR)
+
+find_path(ZMQ_INCLUDE_DIR NAMES zmq.h)
+message(STATUS ${ZMQ_INCLUDE_DIR})
+
+find_library(ZMQ_LIBRARY NAMES zmq)
+message(STATUS ${ZMQ_LIBRARY})
+
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(Zmq DEFAULT_MSG ZMQ_LIBRARY ZMQ_INCLUDE_DIR)