jp.keijiro.klutter-tools 2.4.4 → 2.5.1

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [2.5.1] - 2026-01-21
+
+### Fixed
+
+- Adjusted Downloader launch delay to be applied when constructing the launcher.
+- Avoided setting the Downloader visible flag when the window is not shown.
+
+## [2.5.0] - 2026-01-17
+
+### Added
+
+- Added the Downloader tool for fetching large external assets.
+
 ## [2.4.4] - 2025-11-25
 
 ### Added

package/Editor/Downloader/DownloaderWindow.cs

@@ -0,0 +1,65 @@
+using System;
+using UnityEditor;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace KlutterTools.Downloader {
+
+sealed class DownloaderWindow : EditorWindow
+{
+    static readonly string UxmlPath =
+      "Packages/jp.keijiro.klutter-tools/Editor/Downloader/DownloaderWindow.uxml";
+
+    public static void ShowWindow()
+    {
+        var window = GetWindow<DownloaderWindow>(true, "Downloader");
+        window.minSize = new Vector2(400, 200);
+        window.Show();
+    }
+
+    public void CreateGUI()
+    {
+        // New UI document from UXML
+        var uxml = AssetDatabase.LoadAssetAtPath<VisualTreeAsset>(UxmlPath);
+        var doc = uxml.CloneTree();
+
+        // Caption text
+        var caption = doc.Q<Label>("caption-label");
+        caption.text = GlobalManifest.Instance.Caption;
+
+        // List view setup
+        var list = doc.Q<ListView>("entry-list");
+        list.bindItem = BindItem;
+        list.itemsSource = GlobalManifest.Instance.FileEntries;
+
+        rootVisualElement.Add(doc);
+    }
+
+    // List view item binding
+    void BindItem(VisualElement element, int index)
+    {
+        var button = element.Q<Button>("download-button");
+        var entry = GlobalManifest.Instance.FileEntries[index];
+
+        // Enable button only for missing files.
+        button.enabledSelf = (entry.CurrentState == FileState.Missing);
+
+        // Remove previous handler if exists.
+        if (button.userData is Action prev) button.clicked -= prev;
+
+        // Register new handler.
+        Action action = async () =>
+        {
+            button.enabledSelf = false;
+            if (await entry.DownloadAsync())
+                AssetDatabase.Refresh();
+            else
+                button.enabledSelf = true;
+            Repaint();
+        };
+        button.clicked += action;
+        button.userData = action;
+    }
+}
+
+} // namespace KlutterTools.Downloader

package/Editor/Downloader/DownloaderWindow.cs.meta

@@ -0,0 +1,13 @@
+fileFormatVersion: 2
+guid: 125c9a9d918e49768edc34c7ffa1dbcd
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences:
+  - m_ViewDataDictionary: {instanceID: 0}
+  - _uxml: {fileID: 9197481963319205126, guid: 6c823161c766e470388d0ce278f2a86f, type: 3}
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Editor/Downloader/DownloaderWindow.uxml

@@ -0,0 +1,6 @@
+<ui:UXML xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ui="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements" noNamespaceSchemaLocation="../../../UIElementsSchema/UIElements.xsd" editor-extension-mode="True">
+    <ui:VisualElement name="root-container" style="margin-top: 8px; margin-right: 8px; margin-bottom: 8px; margin-left: 8px;">
+        <ui:Label text="Some files are missing:" name="caption-label" style="margin-bottom: 8px; white-space: normal;"/>
+        <ui:ListView item-template="project://database/Packages/jp.keijiro.klutter-tools/Editor/Downloader/FileEntry.uxml?fileID=9197481963319205126&amp;guid=e5fb5605902c247d8b81f9a365e2b6e4&amp;type=3#FileEntry" binding-source-selection-mode="AutoAssign" name="entry-list"/>
+    </ui:VisualElement>
+</ui:UXML>

package/Editor/Downloader/DownloaderWindow.uxml.meta

@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: 6c823161c766e470388d0ce278f2a86f
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 13804, guid: 0000000000000000e000000000000000, type: 0}

package/Editor/Downloader/FileEntry.cs

@@ -0,0 +1,80 @@
+using System;
+using System.IO;
+using System.Threading.Tasks;
+using Unity.Properties;
+using UnityEngine;
+using UnityEngine.Networking;
+
+namespace KlutterTools.Downloader {
+
+[Serializable]
+public sealed class FileEntry
+{
+    //// Editable attributes
+
+    [field:SerializeField]
+    public string SourceUrl { get; private set; }
+
+    [field:SerializeField]
+    public string Destination { get; private set; } = "Assets/StreamingAssets";
+
+    //// Exposed UI properties
+
+    [CreateProperty]
+    public string Filename { get; private set; }
+
+    [CreateProperty]
+    public FileState CurrentState { get; private set; }
+
+    //// Dynamic properties
+
+    public string DestinationPath
+      => Path.Combine(Destination, Filename);
+
+    public string TemporaryPath
+      => Path.Combine(Application.temporaryCachePath, Filename);
+
+    //// Public methods
+
+    // Validation method
+    public void OnValidate()
+    {
+        if (Uri.TryCreate(SourceUrl, UriKind.Absolute, out var uri))
+        {
+            Filename = Path.GetFileName(uri.LocalPath);
+            CurrentState = File.Exists(DestinationPath)
+              ? FileState.Downloaded : FileState.Missing;
+        }
+        else
+        {
+            Filename = null;
+            CurrentState = FileState.Missing;
+        }
+    }
+
+    // Asynchronous file download method
+    public async Task<bool> DownloadAsync()
+    {
+        var destPath = DestinationPath;
+        var tempPath = TemporaryPath;
+        var success = false;
+
+        using (var request = UnityWebRequest.Get(SourceUrl))
+        {
+            CurrentState = FileState.Downloading;
+            request.downloadHandler = new DownloadHandlerFile(tempPath);
+            await Awaitable.FromAsyncOperation(request.SendWebRequest());
+            success = (request.result == UnityWebRequest.Result.Success);
+            CurrentState = success ? FileState.Downloaded : FileState.Missing;
+        }
+
+        if (success)
+            File.Move(tempPath, destPath);
+        else
+            Debug.LogError($"Failed to download test data file: {Filename}");
+
+        return success;
+    }
+}
+
+} // namespace KlutterTools.Downloader

package/Editor/Downloader/FileEntry.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: 270945ec9f9a749a1bd38f4a91503d59

package/Editor/Downloader/FileEntry.uxml

@@ -0,0 +1,15 @@
+<ui:UXML xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ui="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements" noNamespaceSchemaLocation="../../../UIElementsSchema/UIElements.xsd" editor-extension-mode="True">
+    <ui:VisualElement name="file-entry" data-source-type="KlutterTools.Downloader.FileEntry, KlutterTools.Editor" style="flex-direction: row; align-items: center;">
+        <ui:Label text="TestFile.dat" name="filename-label" style="flex-grow: 1;">
+            <Bindings>
+                <ui:DataBinding property="text" data-source-path="Filename" binding-mode="ToTarget"/>
+            </Bindings>
+        </ui:Label>
+        <ui:Label name="state-label" text="Missing" style="color: rgb(147, 147, 147); -unity-font-style: italic;">
+            <Bindings>
+                <ui:DataBinding property="text" data-source-path="CurrentState" binding-mode="ToTarget"/>
+            </Bindings>
+        </ui:Label>
+        <ui:Button text="Download" name="download-button"/>
+    </ui:VisualElement>
+</ui:UXML>

package/Editor/Downloader/FileEntry.uxml.meta

@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: e5fb5605902c247d8b81f9a365e2b6e4
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 13804, guid: 0000000000000000e000000000000000, type: 0}

package/Editor/Downloader/FileState.cs

@@ -0,0 +1,3 @@
+namespace KlutterTools.Downloader {
+    public enum FileState { Missing, Downloading, Downloaded }
+}

package/Editor/Downloader/FileState.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: 9243bbc63cbb149b7bec57f3e379c01d

package/Editor/Downloader/GlobalManifest.cs

@@ -0,0 +1,22 @@
+using UnityEditor;
+
+namespace KlutterTools.Downloader {
+
+public static class GlobalManifest
+{
+    public static Manifest Instance { get; private set; }
+
+    static GlobalManifest()
+    {
+        // Search
+        var guids = AssetDatabase.FindAssets("t:KlutterTools.Downloader.Manifest");
+        if (guids.Length == 0) return;
+
+        // Load
+        var path = AssetDatabase.GUIDToAssetPath(guids[0]);
+        Instance = AssetDatabase.LoadAssetAtPath<Manifest>(path);
+        Instance.Validate();
+    }
+}
+
+} // namespace KlutterTools.Downloader

package/Editor/Downloader/GlobalManifest.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: 2709c757046bf4a5ca615b877b57f204

package/Editor/Downloader/Launcher.cs

@@ -0,0 +1,29 @@
+using UnityEditor;
+
+namespace KlutterTools.Downloader {
+
+[InitializeOnLoad]
+static class Launcher
+{
+    static Launcher()
+      => EditorApplication.delayCall += CheckAndShow;
+
+    static void CheckAndShow()
+    {
+        // Session state check
+        const string sessionKey = "KlutterTools.Downloader.Shown";
+        if (SessionState.GetBool(sessionKey, false)) return;
+
+        // Manifest existence check
+        if (GlobalManifest.Instance == null) return;
+
+        // All files downloaded check
+        if (GlobalManifest.Instance.CheckAllDownloaded()) return;
+
+        // Downloader window open
+        DownloaderWindow.ShowWindow();
+        SessionState.SetBool(sessionKey, true);
+    }
+}
+
+} // namespace KlutterTools.Downloader

package/Editor/Downloader/Launcher.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 102ec9e67620463f9254f5fdd9b699c1
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData:
+  assetBundleName:
+  assetBundleVariant:

package/Editor/Downloader/Manifest.cs

@@ -0,0 +1,33 @@
+using System.Linq;
+using UnityEngine;
+
+namespace KlutterTools.Downloader {
+
+[CreateAssetMenu(fileName = "Manifest", menuName = "Klutter Tools/Downloader/Manifest")]
+public sealed class Manifest : ScriptableObject
+{
+    // Editable attributes
+
+    [field:SerializeField]
+    public string Caption { get; private set; } = "Some files are missing:";
+
+    [field:SerializeField]
+    public FileEntry[] FileEntries { get; private set; }
+
+    // Public methods
+
+    public bool CheckAllDownloaded()
+        => FileEntries.All(e => e.CurrentState == FileState.Downloaded);
+
+    public void Validate() => OnValidate();
+
+    // ScriptableObject implementation
+
+    void OnValidate()
+    {
+        if (FileEntries == null) return;
+        foreach (var entry in FileEntries) entry.OnValidate();
+    }
+}
+
+} // namespace KlutterTools.Downloader

package/Editor/Downloader/Manifest.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: 5acc6266be6eb4130afc5134ec35fcec

package/Editor/Downloader.meta

@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 5b3e6ae533eef420c830e5e3b00bbbbd
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/README.md

@@ -41,6 +41,12 @@ or notes directly to GameObjects in the Inspector. This can be useful for
 leaving reminders, instructions, or context for other developers -- or just
 jotting down your own thoughts.
 
+### Downloader
+
+**Downloader** is a tool for fetching additional data from the web. It's
+useful when a project needs large assets, such as uncompressed video files or
+large machine learning models.
+
 ## System Requirements
 
 - Unity 6 or later

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jp.keijiro.klutter-tools",
-  "version": "2.4.4",
+  "version": "2.5.1",
   "displayName": "Klutter Tools",
   "description": "Miscellaneous editor tools.",
   "unity": "6000.0",
@@ -11,11 +11,11 @@
   "licensesUrl": "https://github.com/keijiro/KlutterTools/blob/main/LICENSE",
   "license": "Unlicense",
   "_upm": {
-    "changelog": "<b>Added</b><br>- Added signing for Unity 6.3."
+    "changelog": "<b>Fixed</b><br>- Adjusted Downloader launch delay to be applied when constructing the launcher.<br>- Avoided setting the Downloader visible flag when the window is not shown."
   },
   "repository": {
     "url": "git@github.com:keijiro/KlutterTools.git",
     "type": "git",
-    "revision": "e681f462862b2948acac6125f0e640030e1434e4"
+    "revision": "9afabac843d781841341be05c6421c499ea29a5c"
   }
 }