commit 8a96bcfd2bdfc66ea823ab78074a0659189013e9
Author: Arlind-dev <arlind@sulej.ch>
Date:   Wed Oct 1 14:20:17 2025 +0200

    add actions

diff --git a/.gitea/actions/create-tag/action.yml b/.gitea/actions/create-tag/action.yml
new file mode 100644
index 0000000..4fc45f3
--- /dev/null
+++ b/.gitea/actions/create-tag/action.yml
@@ -0,0 +1,27 @@
+name: "Create New Tag"
+description: "Compute the next semantic version tag based on existing tags"
+
+outputs:
+  new_tag:
+    description: "The new tag computed for this build"
+    value: ${{ steps.tag.outputs.new_tag }}
+
+runs:
+  using: "composite"
+  steps:
+    - name: Create New Tag
+      id: tag
+      shell: bash
+      run: |
+        echo "Computing new tag..."
+        latest_tag=$(git describe --tags $(git rev-list --tags --max-count=1) 2>/dev/null || echo "")
+        if [ -z "$latest_tag" ]; then
+          new_tag="v1.0.0"
+        else
+          IFS='.' read -r major minor patch <<< "${latest_tag#v}"
+          minor=$((minor + 1))
+          patch=0
+          new_tag="v${major}.${minor}.${patch}"
+        fi
+        echo "new_tag=$new_tag" >> $GITHUB_OUTPUT
+        echo "Computed new tag: $new_tag"
diff --git a/.gitea/actions/discover-skins/action.yml b/.gitea/actions/discover-skins/action.yml
new file mode 100644
index 0000000..a961880
--- /dev/null
+++ b/.gitea/actions/discover-skins/action.yml
@@ -0,0 +1,145 @@
+name: "Discover and Detect Skins"
+description: "Find all skins and detect which ones changed since last tag or based on inputs"
+
+inputs:
+  force_rebuild:
+    description: "Force rebuild all skins"
+    required: false
+    default: "false"
+  target_skins:
+    description: "Comma-separated list of skins to rebuild"
+    required: false
+    default: ""
+
+outputs:
+  changed_skins_file:
+    description: "Path to file containing changed skins"
+    value: ${{ steps.detect.outputs.changed_skins_file }}
+  all_skins:
+    description: "All discovered skins (JSON array)"
+    value: ${{ steps.discover_all.outputs.all_skins }}
+
+runs:
+  using: "composite"
+  steps:
+    - name: Discover all skins
+      id: discover_all
+      shell: bash
+      run: |
+        echo "Discovering all skins in $SKINS_DIR…"
+        mapfile -t skins < <(
+          find "$SKINS_DIR" -mindepth 1 -maxdepth 1 -type d \
+            | sed 's|'"$SKINS_DIR"'/||'
+        )
+
+        # Convert to compact JSON
+        json=$(printf '%s\n' "${skins[@]}" | jq -R . | jq -cs .)
+
+        {
+          echo "all_skins<<EOF"
+          echo "$json"
+          echo "EOF"
+        } >> "$GITHUB_OUTPUT"
+
+    - name: Detect Changed Skin Directories
+      id: detect
+      shell: bash
+      run: |
+        echo "[Detect Changed Skin Directories Started]"
+
+        # Parse JSON back into Bash array
+        readarray -t all_skins < <(echo '${{ steps.discover_all.outputs.all_skins }}' | jq -r '.[]')
+
+        force_rebuild="${{ inputs.force_rebuild }}"
+        target_skins="${{ inputs.target_skins }}"
+        skins=()
+        deleted_skins=()
+
+        echo "→ Force rebuild flag: $force_rebuild"
+        echo "→ Target skins input: $target_skins"
+
+        if [[ "$force_rebuild" == "true" ]]; then
+          echo "→ Force rebuild is enabled. Using ALL_SKINS_DIR for full list…"
+          skins=("${all_skins[@]}")
+          echo "    ✓ Found ${#skins[@]} skin directories (from ALL_SKINS_DIR)"
+
+        elif [[ -n "$target_skins" ]]; then
+          echo "→ Target skins specified. Using target_skins input…"
+          IFS=',' read -r -a input_skins <<< "$target_skins"
+          for s in "${input_skins[@]}"; do
+            s="${s#"${s%%[![:space:]]*}"}"
+            s="${s%"${s##*[![:space:]]}"}"
+            [[ -n "$s" ]] && skins+=("$s")
+          done
+          echo "    ✓ Found ${#skins[@]} skin(s) from target_skins input"
+
+        else
+          echo "→ No rebuild flags set. Finding latest git tag..."
+          latest_tag=$(git tag --sort=-creatordate | head -n 1 || true)
+
+          if [[ -n "$latest_tag" ]]; then
+            echo "→ Latest tag found: $latest_tag"
+            echo "→ Finding added/modified skins since $latest_tag…"
+
+            mapfile -t skins < <(
+              git diff --name-only -z --diff-filter=AM "$latest_tag" HEAD \
+              | while IFS= read -r -d '' file; do
+                  [[ $file == Skins/* ]] && echo "${file#Skins/}" | cut -d/ -f1
+                done | sort -u
+            )
+            echo "    ✓ Found ${#skins[@]} added/modified skins"
+
+            echo "→ Finding deleted skins since $latest_tag…"
+            mapfile -t deleted_skins < <(
+              git diff --name-only -z --diff-filter=D "$latest_tag" HEAD \
+              | while IFS= read -r -d '' file; do
+                  [[ $file == Skins/* ]] && echo "${file#Skins/}" | cut -d/ -f1
+                done | sort -u
+            )
+            if [ "${#deleted_skins[@]}" -gt 0 ]; then
+              for d in "${deleted_skins[@]}"; do
+                echo "→ Skin '$d' was deleted"
+              done
+            else
+              echo "    ✓ No skins deleted"
+            fi
+          else
+            echo "→ No tag found. Falling back to ALL_SKINS_DIR for full list…"
+            skins=("${all_skins[@]}")
+            echo "    ✓ Found ${#skins[@]} skin directories (from ALL_SKINS_DIR)"
+          fi
+        fi
+
+        echo ""
+        echo "[Cleaning Skin Names]"
+        uniq_skins=()
+        for skin in "${skins[@]}"; do
+          skin="${skin#"${skin%%[![:space:]]*}"}"
+          skin="${skin%"${skin##*[![:space:]]}"}"
+          [[ -n "$skin" ]] && uniq_skins+=("$skin")
+        done
+        echo "    ✓ ${#uniq_skins[@]} valid skin names after cleaning"
+
+        echo ""
+        if [ "${#uniq_skins[@]}" -eq 0 ]; then
+          echo "→ No added/modified skins detected."
+          {
+            echo "changed_skins_file<<EOF"
+            echo ""
+            echo "EOF"
+          } >> "$GITHUB_OUTPUT"
+        else
+          echo "[Writing Changed Skins to File]"
+          changed_skins_file=$(mktemp)
+          printf "%s\n" "${uniq_skins[@]}" > "$changed_skins_file"
+          echo "    ✓ Skins written to $changed_skins_file"
+
+          {
+            echo "changed_skins_file<<EOF"
+            echo "$changed_skins_file"
+            echo "EOF"
+          } >> "$GITHUB_OUTPUT"
+        fi
+
+        echo ""
+        echo "[Detect Changed Skin Directories Complete — ${#uniq_skins[@]} skins processed, ${#deleted_skins[@]} skins deleted]"
diff --git a/.gitea/actions/generate-docs/action.yml b/.gitea/actions/generate-docs/action.yml
new file mode 100644
index 0000000..e8c7aba
--- /dev/null
+++ b/.gitea/actions/generate-docs/action.yml
@@ -0,0 +1,271 @@
+name: "Generate Documentation"
+description: "Generate README index and per-skin markdown pages"
+
+inputs:
+  new_tag:
+    description: "The new tag for this build"
+    required: true
+  readme_path:
+    description: "Path to write README.md"
+    required: true
+  doc_dir:
+    description: "Directory to write per-skin markdown pages"
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    - name: Generate README
+      shell: bash
+      run: |
+        echo "Generating README index…"
+
+        sanitize_filename() {
+          echo "$1" | \
+            tr -d '\000-\037' | \
+            sed -e 's#[\\/:\*\?"<>|]#-#g' | \
+            sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//'
+        }
+
+        url_encode_path() {
+          local IFS='/'
+          local parts=($1)
+          local encoded=""
+          for part in "${parts[@]}"; do
+            [ -n "$encoded" ] && encoded+="/"
+            encoded+=$(printf '%s' "$part" | jq -sRr @uri)
+          done
+          echo "$encoded"
+        }
+
+        SKINS_JSON_FILE="${{ github.workspace }}/.gitea/workflows/skins.json"
+        DESC_FILE=$(mktemp)
+
+        echo "---" > "${{ inputs.readme_path }}"
+        echo "gitea: none" >> "${{ inputs.readme_path }}"
+        echo "include_toc: true" >> "${{ inputs.readme_path }}"
+        echo "---" >> "${{ inputs.readme_path }}"
+        echo "" >> "${{ inputs.readme_path }}"
+        echo "# Skins" >> "${{ inputs.readme_path }}"
+        echo "" >> "${{ inputs.readme_path }}"
+        echo "<!--" >> "${{ inputs.readme_path }}"
+        echo "osuid: $OSU_ID" >> "${{ inputs.readme_path }}"
+        echo "-->" >> "${{ inputs.readme_path }}"
+        echo "" >> "${{ inputs.readme_path }}"
+        echo "**Go back to [osc/skins]($REGISTRY_URL/osc/skins)**" >> "${{ inputs.readme_path }}"
+        echo "" >> "${{ inputs.readme_path }}"
+        echo "**Click on the Skin name to download it, or click on the thumbnail to see more about the skin, including a video preview, screenshots, and mod icons.**" >> "${{ inputs.readme_path }}"
+        echo "" >> "${{ inputs.readme_path }}"
+
+        jq -r '.descriptions | to_entries[] | "\(.key)=\(.value)"' "$SKINS_JSON_FILE" > "$DESC_FILE"
+        jq -r '.order[]?' "$SKINS_JSON_FILE" > order.txt
+
+        get_desc() {
+          grep -F -m1 -- "$1=" "$DESC_FILE" 2>/dev/null | cut -d '=' -f2- || true
+        }
+
+        declare -A ordered
+        while IFS= read -r skin; do
+          [ "$skin" = "default-skin" ] && continue
+          ordered["$skin"]=1
+          dir="$DANSER_SKINS_DIR/$skin"
+          [ ! -d "$dir" ] && continue
+
+          ini_file=$(find "$dir" -maxdepth 1 -iname "skin.ini" | head -n1 || true)
+          skin_header="$skin"
+
+          if [ -f "$ini_file" ]; then
+            name_line=$(grep -a -i -m1 'Name[[:space:]]*:' "$ini_file" || true)
+            if [ -n "$name_line" ]; then
+              val="${name_line#*:}"
+              val="$(echo "$val" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')"
+              [ -n "$val" ] && skin_header=$(sanitize_filename "$val")
+            fi
+          else
+            continue
+          fi
+
+          raw_path="$(printf "%s/%s" "$skin" "$skin_header" | sed 's/^ *//;s/ *$//')"
+          base_path=$(url_encode_path "$raw_path")
+
+          echo "## [$skin_header]($REGISTRY_URL/$USER_REPOSITORY/media/tag/${{ inputs.new_tag }}/export/${base_path}.osk)" >> "${{ inputs.readme_path }}"
+          echo "" >> "${{ inputs.readme_path }}"
+
+          desc=$(get_desc "$skin")
+          [ -n "$desc" ] && { echo "$desc" >> "${{ inputs.readme_path }}"; echo "" >> "${{ inputs.readme_path }}"; }
+
+          if [ -f "$ini_file" ]; then
+            author_line=$(grep -i '^[[:space:]]*Author:' "$ini_file" | head -n1 || true)
+            if [ -n "$author_line" ]; then
+              author=$(echo "$author_line" | cut -d ':' -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+              [ -n "$author" ] && { echo "**Author:** $author" >> "${{ inputs.readme_path }}"; echo "" >> "${{ inputs.readme_path }}"; }
+            fi
+          fi
+
+          echo "[![$skin_header Thumbnail](media/thumbnail/${base_path}.webp)](/docs/${base_path}.md)" >> "${{ inputs.readme_path }}"
+          echo "" >> "${{ inputs.readme_path }}"
+        done < order.txt
+
+        for dir in "$DANSER_SKINS_DIR"/*; do
+          [ -d "$dir" ] || continue
+          skin="$(basename "$dir")"
+          [ "$skin" = "default-skin" ] && continue
+          [[ -n "${ordered[$skin]}" ]] && continue
+
+          ini_file=$(find "$dir" -maxdepth 1 -iname "skin.ini" | head -n1 || true)
+          skin_header="$skin"
+
+          if [ -f "$ini_file" ]; then
+            name_line=$(grep -a -i -m1 'Name[[:space:]]*:' "$ini_file" || true)
+            if [ -n "$name_line" ]; then
+              val="${name_line#*:}"
+              val="$(echo "$val" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')"
+              [ -n "$val" ] && skin_header=$(sanitize_filename "$val")
+            fi
+          else
+            continue
+          fi
+
+          raw_path="$(printf "%s/%s" "$skin" "$skin_header" | sed 's/^ *//;s/ *$//')"
+          base_path=$(url_encode_path "$raw_path")
+
+          echo "## [$skin_header]($REGISTRY_URL/$USER_REPOSITORY/media/tag/${{ inputs.new_tag }}/export/${base_path}.osk)" >> "${{ inputs.readme_path }}"
+          echo "" >> "${{ inputs.readme_path }}"
+
+          if [ -f "$ini_file" ]; then
+            author_line=$(grep -i '^[[:space:]]*Author:' "$ini_file" | head -n1 || true)
+            if [ -n "$author_line" ]; then
+              author=$(echo "$author_line" | cut -d ':' -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+              [ -n "$author" ] && { echo "**Author:** $author" >> "${{ inputs.readme_path }}"; echo "" >> "${{ inputs.readme_path }}"; }
+            fi
+          fi
+
+          echo "[![$skin_header Thumbnail](media/thumbnail/${base_path}.webp)](/docs/${base_path}.md)" >> "${{ inputs.readme_path }}"
+          echo "" >> "${{ inputs.readme_path }}"
+        done
+
+        echo "# Build History" >> "${{ inputs.readme_path }}"
+        echo "" >> "${{ inputs.readme_path }}"
+        echo "| Version | Date |" >> "${{ inputs.readme_path }}"
+        echo "| ------- | ---- |" >> "${{ inputs.readme_path }}"
+
+        current_commit_date=$(TZ="Europe/Zurich" date -d "$(git log -1 --format=%cI)" "+%d.%m.%Y %H:%M:%S")
+        echo "| [\`${{ inputs.new_tag }} (Current)\`]($REGISTRY_URL/$USER_REPOSITORY/src/tag/${{ inputs.new_tag }}/README.md) | $current_commit_date |" >> "${{ inputs.readme_path }}"
+
+        old_tags=$(git tag --sort=-v:refname | grep -v "^${{ inputs.new_tag }}$" | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' || true)
+        if [ -n "$old_tags" ]; then
+          echo "$old_tags" | while read -r tag; do
+            tag_date=$(git log -1 --format=%ci "$tag")
+            formatted_date=$(TZ="Europe/Zurich" date -d "$tag_date" "+%d.%m.%Y %H:%M:%S")
+            echo "| [\`$tag\`]($REGISTRY_URL/$USER_REPOSITORY/src/tag/$tag/README.md) | $formatted_date |" >> "${{ inputs.readme_path }}"
+          done
+        fi
+
+        echo "README index generated successfully."
+
+    - name: Generate Per-Skin Pages
+      shell: bash
+      run: |
+        echo "Generating detailed per-skin markdown pages…"
+
+        sanitize_filename() {
+          echo "$1" | \
+            tr -d '\000-\037' | \
+            sed -e 's#[\\/:\*\?"<>|]#-#g' | \
+            sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//'
+        }
+
+        url_encode_path() {
+          local IFS='/'
+          local parts=($1)
+          local encoded=""
+          for part in "${parts[@]}"; do
+            [ -n "$encoded" ] && encoded+="/"
+            encoded+=$(printf '%s' "$part" | jq -sRr @uri)
+          done
+          echo "$encoded"
+        }
+
+        mkdir -p "${{ inputs.doc_dir }}"
+
+        for dir in "$DANSER_SKINS_DIR"/*; do
+          [ -d "$dir" ] || continue
+
+          skin=$(basename "$dir")
+          [ "$skin" = "default-skin" ] && continue
+          ini_file=$(find "$dir" -maxdepth 1 -iname "skin.ini" | head -n1 || true)
+          skin_header="$skin"
+
+          if [ -f "$ini_file" ]; then
+            line=$(grep -i '^[[:space:]]*Name:' "$ini_file" | head -n1 || true)
+            if [ -n "$line" ]; then
+              val="${line#*:}"
+              val="$(echo "$val" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')"
+              if [ -n "$val" ]; then
+                skin_header=$(sanitize_filename "$val")
+              fi
+            fi
+          fi
+
+          raw_path="${skin}/${skin_header}"
+          base_path=$(url_encode_path "$raw_path")
+          osk_url="$REGISTRY_URL/$USER_REPOSITORY/media/tag/${{ inputs.new_tag }}/export/${base_path}.osk"
+          md_file_path="${{ inputs.doc_dir }}/${raw_path}.md"
+
+          mkdir -p "$(dirname "$md_file_path")"
+
+          video_url="$REGISTRY_URL/$USER_REPOSITORY/media/tag/${{ inputs.new_tag }}/media/gameplay/${base_path}.mp4"
+
+          author=""
+          if [ -f "$ini_file" ]; then
+            author_line=$(grep -i '^[[:space:]]*Author:' "$ini_file" | head -n1 || true)
+            if [ -n "$author_line" ]; then
+              author=$(echo "$author_line" | cut -d ':' -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+            fi
+          fi
+
+          {
+            echo "# [$skin_header]($osk_url)"
+            echo ""
+            [ -n "$author" ] && echo "**Author:** $author"
+            [ -n "$author" ] && echo ""
+
+            echo "## Hitsounds"
+            echo "<video controls autoplay loop muted playsinline src=\"$video_url\" type=\"video/mp4\">"
+            echo "</video>"
+            echo ""
+
+            echo "## Ranking Panel"
+            echo "![](/media/panel/${base_path}.webp)"
+            echo ""
+
+            echo "## Mod Icons"
+            echo "![](/media/icons/${base_path}-mod-icons.webp)"
+
+            echo ""
+            echo "## Build History"
+            echo ""
+            echo "| Version | Date |"
+            echo "| ------- | ---- |"
+
+            current_commit_date=$(TZ="Europe/Zurich" date -d "$(git log -1 --format=%cI)" "+%d.%m.%Y %H:%M:%S")
+            echo "| [\`${{ inputs.new_tag }} (Current)\`]($REGISTRY_URL/$USER_REPOSITORY/src/tag/${{ inputs.new_tag }}/docs/${base_path}.md) | $current_commit_date |"
+
+            old_tags=$(git tag --sort=-v:refname | grep -v "^${{ inputs.new_tag }}$" | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' || true)
+            if [ -n "$old_tags" ]; then
+              echo "$old_tags" | while read -r tag; do
+                raw_osk_path="export/${skin}/${skin_header}.osk"
+                if git ls-tree -r --name-only "$tag" | grep -Fx -- "$raw_osk_path" >/dev/null; then
+                  tag_date=$(git log -1 --format=%ci "$tag")
+                  formatted_date=$(TZ="Europe/Zurich" date -d "$tag_date" "+%d.%m.%Y %H:%M:%S")
+                  echo "| [\`$tag\`]($REGISTRY_URL/$USER_REPOSITORY/src/tag/$tag/docs/${base_path}.md) | $formatted_date |"
+                fi
+              done
+            fi
+
+          } > "$md_file_path"
+
+          echo " → Wrote $md_file_path"
+        done
+
+        echo "Per-skin markdown pages complete."
diff --git a/.gitea/actions/generate-icons/action.yml b/.gitea/actions/generate-icons/action.yml
new file mode 100644
index 0000000..4695733
--- /dev/null
+++ b/.gitea/actions/generate-icons/action.yml
@@ -0,0 +1,146 @@
+name: "Generate Mod Icons and Convert Images"
+description: "Generate WEBP mod icons from skins and convert panel/thumbnail PNGs to WEBPs"
+
+inputs:
+  changed_skins_file:
+    description: "Path to file with changed skins"
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    - name: Generate Mod Icons (WEBP)
+      shell: bash
+      run: |
+        echo "[Mod Icon Generation Job Started]"
+
+        if [ -z "${{ inputs.changed_skins_file }}" ] || [ ! -s "${{ inputs.changed_skins_file }}" ]; then
+          echo "No skins changed. Skipping mod icon generation."
+          exit 0
+        fi
+
+        mapfile -t skin_dirs < "${{ inputs.changed_skins_file }}"
+        [ "${#skin_dirs[@]}" -eq 0 ] && { echo "No skins to process. Exiting."; exit 0; }
+
+        sanitize_filename() {
+          echo "$1" | \
+            tr -d '\000-\037' | \
+            sed -e 's#[\\/:\*\?"<>|]#-#g' | \
+            sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//'
+        }
+
+        ICONS_JSON_FILE="${{ github.workspace }}/.gitea/workflows/icons.json"
+        group1_icons=$(jq -r '.group1 | join(" ")' "$ICONS_JSON_FILE")
+        group2_icons=$(jq -r '.group2 | join(" ")' "$ICONS_JSON_FILE")
+        group3_icons=$(jq -r '.group3 | join(" ")' "$ICONS_JSON_FILE")
+
+        BLANK_IMAGE="blank.png"
+        magick -size "160x160" xc:none "$BLANK_IMAGE"
+
+        SKIN_COUNT=${#skin_dirs[@]}
+        INDEX=1
+
+        for skin_path in "${skin_dirs[@]}"; do
+          SKIN_DIR="$DANSER_SKINS_DIR/$skin_path"
+          [ ! -d "$SKIN_DIR" ] && { echo "Skipping missing skin directory: $SKIN_DIR"; ((INDEX++)); continue; }
+
+          skin_header="$skin_path"
+          ini_file=$(find "$SKIN_DIR" -maxdepth 1 -iname "skin.ini" | head -n1 || true)
+          if [ -f "$ini_file" ]; then
+            name_line=$(grep -i '^[[:space:]]*Name:' "$ini_file" | head -n1 || true)
+            if [ -n "$name_line" ]; then
+              val="${name_line#*:}"
+              val="$(echo "$val" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')"
+              if [ -n "$val" ]; then
+                sanitized="$(sanitize_filename "$val")"
+                [ -n "$sanitized" ] && skin_header="$sanitized"
+              fi
+            fi
+          fi
+
+          echo ""
+          echo "[$INDEX/$SKIN_COUNT] Skin: $skin_header"
+
+          ICON_FOLDER="$SKIN_DIR"
+          OUTPUT_DIR="$REPO_MOD_ICONS_DIR/$skin_path"
+          mkdir -p "$OUTPUT_DIR"
+          OUTPUT="$OUTPUT_DIR/${skin_header}-mod-icons.webp"
+
+          row_images=()
+          row_index=1
+
+          for group_list in "$group1_icons" "$group2_icons" "$group3_icons"; do
+            montage_files=()
+            for icon in $group_list; do
+              file=""
+              if [ -f "${ICON_FOLDER}/selection-mod-${icon}@2x.png" ]; then
+                file="${ICON_FOLDER}/selection-mod-${icon}@2x.png"
+              elif [ -f "${ICON_FOLDER}/selection-mod-${icon}.png" ]; then
+                file="${ICON_FOLDER}/selection-mod-${icon}.png"
+              elif [ -f "${DEFAULT_SKIN_DIR}/selection-mod-${icon}@2x.png" ]; then
+                file="${DEFAULT_SKIN_DIR}/selection-mod-${icon}@2x.png"
+              fi
+
+              [ -n "$file" ] && montage_files+=("$file")
+            done
+
+            while [ "${#montage_files[@]}" -lt 7 ]; do
+              montage_files+=("$BLANK_IMAGE")
+            done
+
+            magick montage "${montage_files[@]}" \
+              -tile "7x1" -geometry "160x160+10+10" -background none \
+              "row_${row_index}.png"
+            row_images+=("row_${row_index}.png")
+            row_index=$((row_index + 1))
+          done
+
+          magick montage "${row_images[@]}" \
+            -tile "1x${#row_images[@]}" -geometry "+10+10" -background none \
+            "temp_combined.png"
+
+          magick "temp_combined.png" -define webp:lossless=true "$OUTPUT"
+          rm temp_combined.png row_*.png
+
+          echo "    ✓ Mod Icons Generated at $OUTPUT"
+          INDEX=$((INDEX + 1))
+        done
+
+        rm "$BLANK_IMAGE"
+
+        echo ""
+        echo "[Mod Icon Generation Finished — processed $SKIN_COUNT skins]"
+
+    - name: Convert PNGs to WEBPs
+      shell: bash
+      run: |
+        echo "[Convert PNG → WEBP Started]"
+
+        if [ -z "${{ inputs.changed_skins_file }}" ] || [ ! -s "${{ inputs.changed_skins_file }}" ]; then
+          echo "No skins changed. Skipping conversion."
+          exit 0
+        fi
+
+        mapfile -t skins < "${{ inputs.changed_skins_file }}"
+        [ "${#skins[@]}" -eq 0 ] && { echo "No skins to process. Exiting."; exit 0; }
+
+        convert_pngs_to_webp() {
+          local base_dir="$1"
+          local skin_path="$2"
+          local dir="$base_dir/$skin_path"
+          echo " → Processing: $dir"
+          [ ! -d "$dir" ] && { echo "    ✖ Directory does not exist: $dir"; return; }
+          find "$dir" -type f -iname "*.png" | while read -r png; do
+            webp="${png%.png}.webp"
+            echo "    ↳ Converting: $png → $webp"
+            magick "$png" -define webp:lossless=false -quality 90 "$webp" && rm -f "$png"
+          done
+        }
+
+        for skin_path in "${skins[@]}"; do
+          [ -z "$skin_path" ] && continue
+          convert_pngs_to_webp "$REPO_RANKING_PANEL_DIR" "$skin_path"
+          convert_pngs_to_webp "$REPO_THUMBNAIL_DIR" "$skin_path"
+        done
+
+        echo "[Convert PNG → WEBP Finished]"
diff --git a/.gitea/actions/generate-previews/action.yml b/.gitea/actions/generate-previews/action.yml
new file mode 100644
index 0000000..d1370e5
--- /dev/null
+++ b/.gitea/actions/generate-previews/action.yml
@@ -0,0 +1,149 @@
+name: "Generate Previews"
+description: "Generate Danser videos, screenshots, thumbnails, and rename them based on skin.ini"
+
+inputs:
+  changed_skins_file:
+    description: "Path to file with changed skins"
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    - name: Generate Danser videos and screenshots
+      shell: bash
+      run: |
+        echo "[Danser Job Started]"
+
+        if [ -z "${{ inputs.changed_skins_file }}" ] || [ ! -s "${{ inputs.changed_skins_file }}" ]; then
+          echo "No skins changed. Skipping generation."
+          exit 0
+        fi
+
+        mapfile -t skins < "${{ inputs.changed_skins_file }}"
+        [ "${#skins[@]}" -eq 0 ] && { echo "No skins to process. Exiting."; exit 0; }
+
+        SKIN_COUNT=${#skins[@]}
+        INDEX=1
+
+        sanitize_filename() {
+          echo "$1" | \
+            tr -d '\000-\037' | \
+            sed -e 's#[\\/:\*\?"<>|]#-#g' | \
+            sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//'
+        }
+
+        for skin_path in "${skins[@]}"; do
+          [ -z "$skin_path" ] && continue
+          SKIN_DIR="$DANSER_SKINS_DIR/$skin_path"
+          [ ! -d "$SKIN_DIR" ] && { echo "Skipping missing skin: $skin_path"; continue; }
+
+          SKIN_NAME="$skin_path"
+          OUT_VIDEO_DIR="$REPO_SCREENSHOT_DIR/$SKIN_NAME"
+          OUT_PNG_DIR="$REPO_RANKING_PANEL_DIR/$SKIN_NAME"
+          OUT_THUMBNAIL_DIR="$REPO_THUMBNAIL_DIR/$SKIN_NAME"
+
+          echo ""
+          echo "[$INDEX/$SKIN_COUNT] Generating for skin: $SKIN_NAME"
+
+          LOGFILE="/tmp/danser_log_$INDEX.txt"
+
+          echo "    → Generating video..."
+          if ! xvfb-run -a "$DANSER_DIR/danser-cli" \
+            -replay "$GAMEPLAY_REPLAY_PATH" -record -skip -start=300 -end=307 -noupdatecheck \
+            -out="$SKIN_NAME" -skin="$SKIN_NAME" -settings="skinhub" >"$LOGFILE" 2>&1; then
+            echo "    ✖ Video failed for $SKIN_NAME"; cat "$LOGFILE"; INDEX=$((INDEX+1)); continue
+          fi
+
+          if [ -f "$DANSER_VIDEO_DIR/$SKIN_NAME.mp4" ]; then
+            echo "    → Trimming MP4 with ffmpeg..."
+            ffmpeg -hide_banner -loglevel error \
+              -ss 5 -t 6.5 \
+              -i "$DANSER_VIDEO_DIR/$SKIN_NAME.mp4" \
+              -c:v h264_nvenc -preset fast \
+              -c:a aac -b:a 128k \
+              "$DANSER_VIDEO_DIR/${SKIN_NAME}_trimmed.mp4"
+
+            if [ -f "$DANSER_VIDEO_DIR/${SKIN_NAME}_trimmed.mp4" ]; then
+              mv "$DANSER_VIDEO_DIR/${SKIN_NAME}_trimmed.mp4" "$DANSER_VIDEO_DIR/$SKIN_NAME.mp4"
+              mkdir -p "$OUT_VIDEO_DIR"
+              mv "$DANSER_VIDEO_DIR/$SKIN_NAME.mp4" "$OUT_VIDEO_DIR/$SKIN_NAME.mp4"
+              echo "    ✓ Trimmed MP4 moved to $OUT_VIDEO_DIR/"
+            else
+              echo "    ✖ ffmpeg trimming failed for $SKIN_NAME"
+            fi
+          else
+            echo "    ✖ No MP4 found for $SKIN_NAME"
+          fi
+
+          echo "    → Taking screenshot..."
+          if ! xvfb-run -a "$DANSER_DIR/danser-cli" \
+            -replay "$PANEL_REPLAY_PATH" -skip -settings="skinhub" -noupdatecheck -ss 28 \
+            -out="$SKIN_NAME" -skin="$SKIN_NAME" >>"$LOGFILE" 2>&1; then
+            echo "    ✖ Screenshot failed for $SKIN_NAME"; cat "$LOGFILE"; INDEX=$((INDEX+1)); continue
+          fi
+
+          if [ -f "$DANSER_SCREENSHOT_DIR/$SKIN_NAME.png" ]; then
+            mkdir -p "$OUT_PNG_DIR"
+            mv "$DANSER_SCREENSHOT_DIR/$SKIN_NAME.png" "$OUT_PNG_DIR/$SKIN_NAME.png"
+            echo "    ✓ PNG moved to $OUT_PNG_DIR/"
+          else
+            echo "    ✖ No PNG found for $SKIN_NAME"
+          fi
+
+          echo "    → Taking thumbnail screenshot..."
+          if ! xvfb-run -a "$DANSER_DIR/danser-cli" \
+            -replay "$THUMBNAIL_REPLAY_PATH" -skip -settings="skinhub" -noupdatecheck -ss 1.3 \
+            -out="${SKIN_NAME}_thumb" -skin="$SKIN_NAME" >>"$LOGFILE" 2>&1; then
+            echo "    ✖ Thumbnail screenshot failed for $SKIN_NAME"; cat "$LOGFILE"; INDEX=$((INDEX+1)); continue
+          fi
+
+          if [ -f "$DANSER_SCREENSHOT_DIR/${SKIN_NAME}_thumb.png" ]; then
+            mkdir -p "$OUT_THUMBNAIL_DIR"
+            mv "$DANSER_SCREENSHOT_DIR/${SKIN_NAME}_thumb.png" "$OUT_THUMBNAIL_DIR/$SKIN_NAME.png"
+            echo "    ✓ Thumbnail PNG moved to $OUT_THUMBNAIL_DIR/"
+          else
+            echo "    ✖ No thumbnail PNG found for $SKIN_NAME"
+          fi
+
+          # --- Renaming Section ---
+          skin_header="$SKIN_NAME"
+          ini_file=$(find "$SKIN_DIR" -maxdepth 1 -iname "skin.ini" | head -n1 || true)
+          if [ -f "$ini_file" ]; then
+            name_line=$(grep -i '^[[:space:]]*Name:' "$ini_file" | head -n1 || true)
+            if [ -n "$name_line" ]; then
+              val="${name_line#*:}"
+              val="$(echo "$val" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')"
+              if [ -n "$val" ]; then
+                sanitized="$(sanitize_filename "$val")"
+                [ -n "$sanitized" ] && skin_header="$sanitized"
+              fi
+            fi
+          fi
+
+          VIDEO_DIR="$REPO_SCREENSHOT_DIR/$SKIN_DIR_NAME"
+          PNG_DIR="$REPO_RANKING_PANEL_DIR/$SKIN_DIR_NAME"
+          THUMBNAIL_DIR="$REPO_THUMBNAIL_DIR/$SKIN_DIR_NAME"
+
+          if [ -f "$VIDEO_DIR/$SKIN_DIR_NAME.mp4" ] && [ "$SKIN_DIR_NAME" != "$skin_header" ]; then
+            mv -f "$VIDEO_DIR/$SKIN_DIR_NAME.mp4" \
+                  "$VIDEO_DIR/$skin_header.mp4" || true
+            echo "    ✓ Renamed MP4 to $VIDEO_DIR/$skin_header.mp4"
+          fi
+
+          if [ -f "$PNG_DIR/$SKIN_DIR_NAME.png" ] && [ "$SKIN_DIR_NAME" != "$skin_header" ]; then
+            mv -f "$PNG_DIR/$SKIN_DIR_NAME.png" \
+                  "$PNG_DIR/$skin_header.png" || true
+            echo "    ✓ Renamed PNG to $PNG_DIR/$skin_header.png"
+          fi
+
+          if [ -f "$THUMBNAIL_DIR/$SKIN_DIR_NAME.png" ] && [ "$SKIN_DIR_NAME" != "$skin_header" ]; then
+            mv -f "$THUMBNAIL_DIR/$SKIN_DIR_NAME.png" \
+                  "$THUMBNAIL_DIR/$skin_header.png" || true
+            echo "    ✓ Renamed thumbnail to $THUMBNAIL_DIR/$skin_header.png"
+          fi
+
+          INDEX=$((INDEX + 1))
+        done
+
+        echo ""
+        echo "[Danser Job Finished — processed $SKIN_COUNT skins]"
diff --git a/.gitea/actions/git-commit-push/action.yml b/.gitea/actions/git-commit-push/action.yml
new file mode 100644
index 0000000..f4247f6
--- /dev/null
+++ b/.gitea/actions/git-commit-push/action.yml
@@ -0,0 +1,40 @@
+name: "Commit and Push Changes"
+description: "Configure Git, commit changes, push to branch, and tag release"
+
+inputs:
+  new_tag:
+    description: "The tag to create and push"
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    - name: Configure Git
+      shell: bash
+      run: |
+        git config user.name "${{ github.actor }}"
+        git config user.email "${{ github.actor }}@users.noreply.${{ github.server_url }}"
+
+    - name: Add and Commit changes
+      shell: bash
+      run: |
+        git config advice.addIgnoredFile false
+
+        for p in docs/ media/gameplay media/thumbnail media/panel media/icons export README.md how-to-use.md src; do
+          if [ -e "$p" ]; then
+            git add -A "$p"
+          fi
+        done
+
+        git commit -m "[ci skip] push back from pipeline" -q || echo "No changes to commit"
+
+    - name: Push changes and create tag
+      shell: bash
+      run: |
+        if [ "${GITHUB_REF}" = "refs/heads/main" ]; then
+          git push origin HEAD:main || echo "No changes to push"
+          git tag "${{ inputs.new_tag }}"
+          git push origin "${{ inputs.new_tag }}"
+        else
+          git push origin HEAD:"${GITHUB_REF_NAME}" || echo "No changes to push"
+        fi
diff --git a/.gitea/actions/prepare-assets/action.yml b/.gitea/actions/prepare-assets/action.yml
new file mode 100644
index 0000000..cb3335e
--- /dev/null
+++ b/.gitea/actions/prepare-assets/action.yml
@@ -0,0 +1,62 @@
+name: "Prepare Assets"
+description: "Setup environment dirs and create directories for assets"
+
+inputs:
+  all_skins:
+    description: "JSON array of all skins"
+    required: true
+
+outputs:
+  user_repository:
+    description: "Path of the repository (relative inside container)"
+    value: ${{ steps.repo.outputs.user_repository }}
+
+runs:
+  using: "composite"
+  steps:
+    - name: Extract Repository path
+      id: repo
+      shell: bash
+      run: |
+        echo "Extracting repository path..."
+        USER_REPOSITORY="${{ github.workspace }}"
+        USER_REPOSITORY="${USER_REPOSITORY#/workspace/}"
+        USER_REPOSITORY="${USER_REPOSITORY%/}"
+        echo "Repository path extracted: $USER_REPOSITORY"
+        echo "user_repository=$USER_REPOSITORY" >> $GITHUB_OUTPUT
+
+    - name: Set XDG_RUNTIME_DIR
+      shell: bash
+      run: |
+        echo "Setting XDG_RUNTIME_DIR..."
+        mkdir -p /tmp/xdg_runtime_dir
+        chmod 0700 /tmp/xdg_runtime_dir
+        echo "XDG_RUNTIME_DIR=/tmp/xdg_runtime_dir" >> "$GITHUB_ENV"
+        echo "XDG_RUNTIME_DIR set."
+
+    - name: Create directories for assets
+      shell: bash
+      run: |
+        echo "Creating base directories for assets..."
+        mkdir -p "$REPO_SCREENSHOT_DIR" "$REPO_MOD_ICONS_DIR" "$REPO_RANKING_PANEL_DIR" "$OSK_PATH" "$REPO_THUMBNAIL_DIR"
+
+        echo '${{ inputs.all_skins }}' | jq -r '.[]' | while IFS= read -r skin; do
+          [ -z "$skin" ] && continue
+          echo " → Creating subdirs for '$skin'…"
+          mkdir -p \
+            "$REPO_SCREENSHOT_DIR/$skin" \
+            "$REPO_MOD_ICONS_DIR/$skin" \
+            "$REPO_RANKING_PANEL_DIR/$skin" \
+            "$OSK_PATH/$skin" \
+            "$REPO_THUMBNAIL_DIR/$skin"
+        done
+
+        echo "All asset directories created."
+
+    - name: Move Skin files to Danser Skins directory
+      shell: bash
+      run: |
+        echo "Moving Skin files to Danser Skins directory..."
+        mkdir -p "$DANSER_SKINS_DIR"
+        mv "$SKINS_DIR"/* "$DANSER_SKINS_DIR"
+        echo "Skin files moved."
diff --git a/.gitea/actions/pull-lfs/action.yml b/.gitea/actions/pull-lfs/action.yml
new file mode 100644
index 0000000..100512b
--- /dev/null
+++ b/.gitea/actions/pull-lfs/action.yml
@@ -0,0 +1,35 @@
+name: "Pull Git LFS Objects"
+description: "Pull only LFS objects for changed skins and core assets"
+
+inputs:
+  changed_skins_file:
+    description: "Path to file containing changed skins"
+    required: false
+    default: ""
+
+runs:
+  using: "composite"
+  steps:
+    - name: Pull Git LFS objects
+      shell: bash
+      run: |
+        if [ -z "${{ inputs.changed_skins_file }}" ] || [ ! -s "${{ inputs.changed_skins_file }}" ]; then
+          echo "No skins changed. Skipping git pull lfs."
+          exit 0
+        fi
+
+        includes="src/**,export/**,media/**"
+
+        skin_includes=$(
+          while IFS= read -r skin; do
+            esc=$(printf '%s' "$skin" \
+              | sed -e 's/\[/\\[/g' -e 's/\]/\\]/g')
+            printf 'Skins/%s/**\n' "$esc"
+          done < "${{ inputs.changed_skins_file }}" \
+          | paste -sd ','
+        )
+
+        includes="$includes,$skin_includes"
+
+        echo "→ Pulling LFS objects for patterns: $includes"
+        git lfs pull --include="$includes"
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f7532f5
--- /dev/null
+++ b/README.md
@@ -0,0 +1 @@
+# Reusable Actions