Beta release

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,48 @@
+name: Bug Report
+description: Report a bug
+labels: ["needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please fill out the sections below to help identify the issue.
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe your issue
+      placeholder: When I do this action, this result occurs.
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      placeholder: |
+        1. Go to page X.
+        2. Click here.
+        3. Click there.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What was the expected result?
+      placeholder: I expected this to happen...
+  - type: upload
+    id: logfile
+    attributes:
+      label: Provide your log file (if applicable)
+    validations:
+      required: false
+      accept: ".txt,.log"
+  - type: upload
+    id: screenshots
+    attributes:
+      label: Put here any screenshots or videos (optional)
+    validations:
+      required: false
+      accept: ".png,.jpg,.jpeg,.gif,.svg,.webp,.mp4,.mov,.webm"
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting this issue! We will get back to you as soon as possible.

.github/ISSUE_TEMPLATE/documentation.yml

@@ -0,0 +1,36 @@
+name: Documentation Issue.
+description: Report an issue with documentation.
+labels: ["needs-triage", "documentation"]
+body:
+  - type: "textarea"
+    attributes:
+      label: "What is the problem?"
+      description: "A clear and concise description of what the problem is."
+      placeholder: "For the Spawnable system, it says to [...] when you should do [...]."
+    validations:
+      required: true
+  - type: "textarea"
+    attributes:
+      label: "Where is the problem located?"
+      description: "Provide a direct link to either the documentation, or the problem function(s)."
+      placeholder: "Link to spawnables.gd line #54."
+    validations:
+      required: true
+  - type: "dropdown"
+    attributes:
+      label: "What is the category of the problem?"
+      description: "A quick tag to categorize the issue."
+      options:
+        - Wrong
+        - Outdated
+        - Missing
+    validations:
+      required: true
+  - type: "textarea"
+    attributes:
+      label: "Additional context"
+      description: "Add any other context about this issue."
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting this issue! We will get back to you as soon as possible.

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,35 @@
+name: Feature Request
+description: Suggest a new feature
+labels: ["needs-triage"]
+body:
+  - type: "textarea"
+    attributes:
+      label: "Is your feature request related to a problem?"
+      description: "A clear and concise description of what the problem is."
+      placeholder: "I'm always frustrated when [...]"
+    validations:
+      required: true
+  - type: "textarea"
+    attributes:
+      label: "Describe the solution you'd like"
+      description: "A clear and concise description of what you want to happen."
+      placeholder: "I want to [...]"
+    validations:
+      required: true
+  - type: "textarea"
+    attributes:
+      label: "Describe alternatives you've considered"
+      description: "A clear and concise description of any alternative solutions or features you've considered. This helps developers formulate an appropriate solution and helps paint a clear picture about your desired outcome."
+      placeholder: "I thought I could do [...] to solve my issue, but I ran into issues with [...]."
+    validations:
+      required: false
+  - type: "textarea"
+    attributes:
+      label: "Additional context"
+      description: "Add any other context about the feature request here."
+    validations:
+      required: false
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting this issue! We will get back to you as soon as possible.

.github/ISSUE_TEMPLATE/question.yml

@@ -0,0 +1,15 @@
+name: Question
+description: Ask a question about the core application.
+labels: ["needs-triage", "question"]
+body:
+  - type: "textarea"
+    attributes:
+      label: "What is your question?"
+      description: "A clear and concise question."
+      placeholder: "How do I [...]. Is there a way to [...]? "
+    validations:
+      required: true
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for asking a question! We will get back to you as soon as possible.

.github/workflows/godot-ci.yml

@@ -0,0 +1,155 @@
+name: "godot-ci export"
+on:
+ push:
+  branches:
+   - alpha
+   - beta
+   - master
+
+env:
+  GODOT_VERSION: 4.7
+  EXPORT_NAME: OpenMinerva
+  PROJECT_PATH: src
+
+jobs:
+  timestamp:
+    name: Timestamp
+    runs-on: ubuntu-24.04
+    outputs:
+      stamp: ${{ steps.stamp.outputs.stamp }}
+      safe_ref: ${{ steps.stamp.outputs.safe_ref }}
+    steps:
+      - name: Generate timestamp
+        id: stamp
+        run: |
+         echo "stamp=$(date -u +'%H%M%S.%d.%m.%Y')" >> "$GITHUB_OUTPUT"
+         echo "safe_ref=${GITHUB_REF_NAME//\//-}" >> "$GITHUB_OUTPUT"
+
+  test:
+    name: GdUnit4 Test
+    needs: timestamp
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up environment
+        run: ./setup_environment.sh
+        working-directory: src
+      - uses: godot-gdunit-labs/gdUnit4-action@v1
+        with:
+          godot-version: '4.7'
+          project_dir: './src/'
+          paths: 'res://test'
+          warnings-as-errors: false
+          publish-report: false
+          upload-report: false
+
+  export-windows:
+    name: Windows Export
+    needs: [timestamp, test]
+    runs-on: ubuntu-24.04
+    container:
+      image: barichello/godot-ci:4.7
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          lfs: true
+      - name: Setup
+        run: |
+          mkdir -v -p ~/.local/share/godot/export_templates/
+          mkdir -v -p ~/.config/
+          mv /root/.config/godot ~/.config/godot
+          mv /root/.local/share/godot/export_templates/${GODOT_VERSION}.stable ~/.local/share/godot/export_templates/${GODOT_VERSION}.stable
+      - name: Windows Build
+        run: |
+          mkdir -v -p build/windows
+          OUT="$GITHUB_WORKSPACE/build/windows/${EXPORT_NAME}-${{ needs.timestamp.outputs.safe_ref }}-${{ needs.timestamp.outputs.stamp }}.exe"
+          cd $PROJECT_PATH
+          godot --headless --verbose --export-release "Windows Desktop" "$OUT"
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: windows-${{ needs.timestamp.outputs.safe_ref }}-${{ needs.timestamp.outputs.stamp }}
+          path: build/windows
+
+  export-linux:
+    name: Linux Export
+    needs: [timestamp, test]
+    runs-on: ubuntu-24.04
+    container:
+      image: barichello/godot-ci:4.7
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          lfs: true
+      - name: Setup
+        run: |
+          mkdir -v -p ~/.local/share/godot/export_templates/
+          mv /root/.local/share/godot/export_templates/${GODOT_VERSION}.stable ~/.local/share/godot/export_templates/${GODOT_VERSION}.stable
+      - name: Linux Build
+        run: |
+          mkdir -v -p build/linux
+          cd $PROJECT_PATH
+          OUT="$GITHUB_WORKSPACE/build/linux/${EXPORT_NAME}-${{ needs.timestamp.outputs.safe_ref }}-${{ needs.timestamp.outputs.stamp }}.x86_64"
+          godot --headless --verbose --export-release "Linux" "$OUT"
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: linux-${{ needs.timestamp.outputs.safe_ref }}-${{ needs.timestamp.outputs.stamp }}
+          path: build/linux
+
+  # Mac exports are not currently supported as they can not be properly tested at all.
+  # This exporter code has not been touched since this file was created, so please double check for any previous changes to the other exporters before blindly re-enabling this!
+  #
+  # export-mac:
+  #   name: Mac Export
+  #   needs: timestamp
+  #   runs-on: ubuntu-24.04
+  #   container:
+  #     image: barichello/godot-ci:4.7
+  #   steps:
+  #     - name: Checkout
+  #       uses: actions/checkout@v4
+  #       with:
+  #         lfs: true
+  #     - name: Setup
+  #       run: |
+  #         mkdir -v -p ~/.local/share/godot/export_templates/
+  #         mv /root/.local/share/godot/export_templates/${GODOT_VERSION}.stable ~/.local/share/godot/export_templates/${GODOT_VERSION}.stable
+  #     - name: Mac Build
+  #       run: |
+  #         mkdir -v -p build/mac
+  #         EXPORT_DIR="$(readlink -f build)"
+  #         cd $PROJECT_PATH
+  #         godot --headless --verbose --export-release "macOS" "$EXPORT_DIR/mac/${EXPORT_NAME}-${{ needs.timestamp.outputs.stamp }}.zip"
+  #     - name: Upload Artifact
+  #       uses: actions/upload-artifact@v4
+  #       with:
+  #         name: mac-${{ needs.timestamp.outputs.stamp }}
+  #         path: build/mac
+  release:
+    name: Create Release
+    needs: [timestamp, test, export-windows, export-linux ] # Add this back when mac support is added: 'export-mac'
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: write
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: build
+      - name: Package each platform
+        run: |
+          cd build
+          for dir in */; do
+            platform="${dir%/}"
+            (cd "$platform" && zip -r "../${platform}.zip" .)
+          done
+      - name: Create release
+        uses: softprops/action-gh-release@v3
+        with:
+          tag_name: ${{ needs.timestamp.outputs.safe_ref }}-${{ needs.timestamp.outputs.stamp }}
+          name: ${{ needs.timestamp.outputs.safe_ref }}-${{ needs.timestamp.outputs.stamp }}
+          prerelease: ${{ github.ref_name != 'master' }}
+          files: build/*.zip

.gitignore

@@ -0,0 +1,8 @@
+/src/.godot
+/src/android/
+/src/addons/godot-sqlite
+/src/addons/gdUnit4
+/src/setup_downloads/
+
+# gdUnit
+/src/reports

.gitmodules

@@ -0,0 +1,6 @@
+[submodule "src/addons/godot-oauth2client"]
+	path = src/addons/godot-oauth2client
+	url = https://github.com/OpenMinerva/godot-oauth2client.git
+[submodule "src/addons/godot-urlparser"]
+	path = src/addons/godot-urlparser
+	url = https://github.com/OpenMinerva/godot-urlparser.git

.vscode/settings.json

@@ -0,0 +1,53 @@
+{
+    "psi-header.config": {
+        "forceToTop": true,
+        "blankLinesAfter": 1,
+        "spacesBetweenYears": false,
+        "license": "MIT",
+        "company": "OpenMinerva",
+        "creationDateZero": "asIs",
+    },
+    "psi-header.lang-config": [
+        {
+            "language": "gdscript",
+            "begin": "# --- License",
+            "prefix": "# ",
+            "lineLength": 80,
+            "end": "# --- License",
+            "forceToTop": true,
+            "blankLinesAfter": 1,
+            "beforeHeader": [],
+            "afterHeader": [],
+            "rootDirFileName": "client",
+            "modAuthor": "Modified By:",
+            "modDate": "Last Modified:",
+            "modDateFormat": "dd/MM/yyyy hh:nn:ss",
+            "replace": [
+                "Filename:",
+                "Project"
+            ],
+            "ignoreLines": []
+        }
+    ],
+    "psi-header.templates": [
+        {
+            "language": "gdscript",
+            "template": [
+                "File: <<filerelativepath>>",
+                "Project: <<projectname>>",
+                "Created Date: <<filecreated('DD MMMM YYYY')>>",
+                "Copyright (c) <<yeartoyear(fc, now)>> <<company>>",
+                "License: <<licensename>>",
+                "Authors: <<author>>",
+            ],
+            "changeLogCaption": "HISTORY",
+            "changeLogHeaderLineCount": 2,
+            "changeLogEntryTemplate": [
+                "",
+                "<<dateformat(DD-MM-YYYY)>>\t<<initials>>\t"
+            ],
+            "changeLogNaturalOrder": false,
+            "changeLogFooterLineCount": 0
+        }
+    ],
+}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenMinerva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.