[email protected] (#1)

Author: StephenHodgson

.gitattributes

@@ -0,0 +1,2 @@
+text=auto
+*.sh text eol=lf

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @buildalon/buildalon

.github/workflows/update-release-tags.yml

@@ -0,0 +1,15 @@
+name: Update Action Release Tags
+on:
+  push:
+    tags: ['*']
+  workflow_dispatch:
+jobs:
+  update-release-tags:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: RageAgainstThePixel/update-action-release-tags@v1

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Buildalon
+Copyright (c) 2025 Virtual Maker Corporation
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,2 +1,47 @@
 # create-unity-project
+
 A GitHub Action to create a new Unity Project using a predefined template package.
+
+## How to use
+
+### Requirements
+
+> [!IMPORTANT]
+> This action requires that the Unity Editor is installed on the runner.
+>
+> You can use [`unity-setup`](https://github.com/buildalon/unity-setup) action to install Unity Editor before using this action.
+
+- `UNITY_EDITOR_PATH` environment variable must be set to the path of the Unity Editor executable.
+
+> [!IMPORTANT]
+> This action requires an active Unity license be available on the runner.
+>
+> You can use [`activate-unity-license`](https://github.com/buildalon/activate-unity-license) action to activate the Unity license before using this action.
+
+- A license activation for the Unity Editor must also be completed before using this action.
+
+### workflow
+
+```yaml
+steps:
+  - uses: buildalon/create-unity-project@v1
+    with:
+      project-name: Test Project
+      project-directory: ./Unity Project
+      template-name: com.unity.template.3d(-cross-platform)?
+```
+
+### inputs
+
+| name | description | required |
+| ---- | ----------- | -------- |
+| `project-name` | The name of the Unity project to create. | true |
+| `project-directory` | The directory where the Unity project will be created.  | Defaults to the root of the workspace. |
+| `template-name` | The name of the template package to use for creating the Unity project. | Default: `com.unity.template.3d(-cross-platform)?` |
+
+> [!NOTE]
+> `template-name` supports regex patterns, allowing you to match multiple template packages. For example, `com.unity.template.3d(-cross-platform)?` will match both `com.unity.template.3d` and `com.unity.template.3d-cross-platform`.
+
+### outputs
+
+- `project-path`: The path to the created Unity project. This is the absolute path to the project directory.

action.yml

@@ -0,0 +1,36 @@
+name: Buildalon create unity project from hub template
+branding:
+  icon: cloud-lightning
+  color: red
+description: A GitHub Action to create a new Unity Project using a predefined template package.
+inputs:
+  project-name:
+    description: The name of the Unity project to create.
+    required: true
+  project-directory:
+    description: The directory where the Unity project will be created. Defaults to the root of the workspace.
+    required: false
+    default: '${{ github.workspace }}'
+  template-name:
+    description: The name of the template package to use for creating the Unity project.
+    required: false
+    default: 'com.unity.template.3d(-cross-platform)?'
+outputs:
+  project-path:
+    description: The path to the created Unity project.
+    value: '${{ inputs.project-directory }}/${{ inputs.project-name }}'
+runs:
+  using: composite
+  steps:
+    - name: Get Unity Template
+      id: template
+      shell: bash
+      env:
+        ACTION_PATH: ${{ github.action_path }}
+        TEMPLATE_NAME: ${{ inputs.template-name }}
+      run: '"${ACTION_PATH}/get-unity-template.sh" "${TEMPLATE_NAME}"'
+    - uses: buildalon/unity-action@v2
+      name: Create Unity Project
+      with:
+        log-name: create-unity-project
+        args: '-quit -nographics -batchmode -createProject "${{ inputs.project-directory }}/${{ inputs.project-name }}" -cloneFromTemplate "${{ steps.template.outputs.template-path }}"'

get-unity-template.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+# This script is used to fetch the Unity template from the editor path in env variables.
+set -e
+
+if [ -z "$UNITY_EDITOR_PATH" ]; then
+  echo "UNITY_EDITOR_PATH is not set. Please set it to the path of your Unity editor."
+  exit 1
+fi
+
+PACKAGE="$1"
+
+if [ -z "$PACKAGE" ]; then
+    echo "Usage: $0 <package-name-or-regex>"
+    echo "Example: $0 'com.unity.template.3d'"
+    echo "         $0 'com.unity.template.3d-cross-platform'"
+    echo "         $0 'com.unity.template.3d*' (regex supported)"
+    echo "         $0 'com.unity.template.3d(-cross-platform)?' (regex supported)"
+    exit 1
+fi
+
+EDITOR_ROOT=$(dirname "${UNITY_EDITOR_PATH}")
+EDITOR_ROOT=${EDITOR_ROOT//\\/\/}
+TEMPLATE_DIR="${EDITOR_ROOT}/Data/Resources/PackageManager/ProjectTemplates"
+OS_NAME=$(uname -s | tr '[:upper:]' '[:lower:]')
+
+if [[ "${OS_NAME}" == "darwin" ]]; then
+    TEMPLATE_DIR=$(dirname "${EDITOR_ROOT}")/Resources/PackageManager/ProjectTemplates
+fi
+
+if [ ! -d "${TEMPLATE_DIR}" ]; then
+    echo "Template directory not found: ${TEMPLATE_DIR}"
+    exit 1
+fi
+
+PACKAGES=$(find "${TEMPLATE_DIR}" -name "*.tgz" 2>/dev/null)
+
+if [ -z "${PACKAGES}" ]; then
+    echo "No templates found in ${TEMPLATE_DIR}"
+else
+    echo "Available templates:"
+    echo "${PACKAGES}" | while IFS= read -r pkg; do
+        echo " - $(basename \""${pkg}"\")"
+    done
+fi
+
+MATCHES=$(find "${TEMPLATE_DIR}" -name "*.tgz" 2>/dev/null | grep -E "${PACKAGE}.*[0-9]+\.[0-9]+\.[0-9]+\.tgz")
+TEMPLATE_PATH=$(echo "${MATCHES}" | awk '{ print length, $0 }' | sort -nr | cut -d" " -f2- | head -n 1)
+
+if [ -z "${TEMPLATE_PATH}" ]; then
+    echo "${PACKAGE} path not found in ${TEMPLATE_DIR}!"
+    exit 1
+fi
+
+TEMPLATE_PATH=${TEMPLATE_PATH//\\/\/}
+
+echo "TEMPLATE_PATH=${TEMPLATE_PATH}"
+echo "template-path=${TEMPLATE_PATH}" >> "${GITHUB_OUTPUT}"