Fix assets conversion bug. Add running with docker docs

Using Cython < 3.0.10 leads to the runtime errors on
assets conversion. Cython >= 3.0.10 shall be used.

Update docker build file and add chapter in documentation
about running image with Docker.

Issue: #1766

Author: DanyCppVito

CMakeLists.txt

@@ -39,7 +39,7 @@ set(CMAKE_CXX_STANDARD_REQUIRED ON)
 
 # Python and Cython requirements
 set(PYTHON_MIN_VERSION 3.9)
-set(CYTHON_MIN_VERSION 0.29.31)
+set(CYTHON_MIN_VERSION 3.0.10)
 
 # CMake policies
 foreach(pol

README.md

@@ -145,6 +145,9 @@ To turn them off, use `./bin/run --dont-segfault --no-errors --dont-eat-dog`.
 If this still does not help, try our [troubleshooting guide](/doc/troubleshooting.md), the [contact section](#contact)
 or the [bug tracker](https://github.com/SFTtech/openage/issues).
 
+* **Running with Docker**
+You can build and run the project using Docker. See [Running with docker](/doc/building.md#running-with-docker)
+
 
 Contributing
 ============

doc/build_instructions/ubuntu.md

@@ -7,6 +7,10 @@ Run the following commands:
 
 You will also need [nyan](https://github.com/SFTtech/nyan/blob/master/doc/building.md) and its dependencies.
 
+Notes:
+- The project requires at least **Cython 3.0.10** for successful compilation.
+  Using an older version may result in runtime errors!
+
 # Additional steps for Ubuntu 22.04 LTS
 
 The available system version of Cython is too old in Ubuntu 22.04. You have to get the correct version

doc/building.md

@@ -29,7 +29,7 @@ Dependency list:
 
     C     gcc >=10 or clang >=10
     CRA   python >=3.9
-    C     cython >=0.29.31
+    C     cython >=3.0.10
     C     cmake >=3.16
       A   numpy
       A   lz4
@@ -162,6 +162,42 @@ The reference package is [created for Gentoo](https://github.com/SFTtech/gentoo-
   which will then be packed/installed by your package manager.
 
 
+### Running with Docker
+
+To simplify the setup process, you can use Docker to build and run the project.
+This is particularly useful if you want to avoid installing dependencies
+manually. Please note:
+- You will need docker installed on your machine. Follow [official documentation
+  from docker](https://docs.docker.com/) to start.
+- The following configuration was tested on Ubuntu 24.04 on WSL2 on Windows 11.
+
+##### Steps to Build and Run
+
+1. **Enable GUI Support**
+
+    allow the Docker container to access your X server:
+   ```bash
+   xhost +local:root
+   ```
+
+2. **Build the Docker Image**
+
+   ```bash
+   sudo docker build -t openage -f packaging/docker/devenv/Dockerfile.ubuntu.2404 .
+   ```
+
+3. **Run the Docker Container**
+
+   Run docker container and mount necessary X11 socket and .Xauthority file to
+   enable GUI for openage project.
+   ```bash
+   docker run -it -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix -v $HOME/.Xauthority:/root/.Xauthority --network host openage
+   ```
+
+After running container just follow regular setup described in
+[Development](#development) chapter (you can already skip dependencies
+installation) inside your docker image.
+
 ### Troubleshooting
 
 - I wanna see compiler invocations

packaging/docker/devenv/Dockerfile.ubuntu.2404

@@ -36,4 +36,7 @@ RUN apt-get update && DEBIAN_FRONTEND="noninteractive" apt-get install -y sudo \
     qt6-multimedia-dev \
     qml6-module-qtquick3d-spatialaudio \
     && sudo apt-get clean \
-    && truncate -s 0 ~/.bash_history
+    && truncate -s 0 ~/.bash_history
+
+# At least cython >= 3.0.10 is required to avoid runtime errors
+RUN pip install cython==3.0.10 --break-system-packages