Verwalte Dateien und Ordner in der Unreal Engine 5
Nutze Funktionen wie Ordnerexistenzprüfung, Dateifilterung, Berechtigungsprüfungen, rekursive Dateiauflistung, Datei- und Ordnererstellung sowie -löschung, asynchrone Dateilesung und -ausführung sowie das Öffnen von Ordnern im Dateiexplorer.
Beschreibung
Das FolderUtilityPlugin bietet umfassende Datei- und Ordnerverwaltungsfunktionen direkt in Unreal Engine. Es ermöglicht Entwicklern, Dateisystemoperationen nahtlos über Blueprint-Knoten durchzuführen, einschließlich Lesen, Schreiben, Löschen und Überprüfen von Dateien und Verzeichnissen.
- Existenzprüfung von Ordnern
- Spezifische Dateisuche
- Zugriffsrechte prüfen
- Erstellen & Löschen von Ordnern und Dateien
- Ordner im Explorer via Blueprint öffnen
- Ausführen von exe, sh und bat Dateien
Play Video about Folder Utility Plugin - Manage Folders, execute and read Files
Folder Utility Plugin: Showcase
Das FolderUtilityPlugin ist ein Unreal Engine Plugin, das eine Reihe von nützlichen Funktionen für die Arbeit mit Dateien und Verzeichnissen bereitstellt. Es ermöglicht Entwicklern, Dateisystemoperationen direkt aus Blueprints heraus durchzuführen, einschließlich Lesen, Schreiben, Löschen und Überprüfen von Dateien und Ordnern.
Dokumentation & News
Erste Schritte
- Lade das FolderUtility-Plugin herunter und platziere es im Plugins-Ordner deines Unreal Engine-Projekts.
- Navigiere zu Bearbeiten > Plugins und aktiviere Folder Utility.
- Starte den Editor einmal neu, um die Änderungen anzuwenden.
- Lade das FolderUtility-Plugin aus dem FAB Marketplace herunter und importiere es in dein Unreal Engine-Projekt.
- Navigiere zu Bearbeiten > Plugins und aktiviere Folder Utility.
- Starte den Editor einmal neu, um die Änderungen anzuwenden.
Verfügbare Funktionen
Check Folder Existence
- Category:
Folder Utility - Description: Überprüft, ob ein bestimmter Ordnerpfad existiert.
- Inputs:
Folder Path(String): Der zu überprüfende Ordnerpfad.
- Outputs (return):
Exists(Boolean): Gibt an, ob der Ordner existiert.Valid Path(String): Gibt den gültigen Pfad zurück, falls der Ordner existiert.
Get Filtered Files
- Category:
Folder Utility - Description: Listet alle Dateien in einem Ordner auf, die bestimmte Dateiendungen haben.
- Inputs:
Folder Path(String): Der Pfad zum Ordner.File Extensions(String Array): Eine Liste von Dateiendungen (z. B..txt,.jpg).
- Outputs (return):
Filtered Files(String Array): Eine Liste der gefundenen Dateien mit den angegebenen Endungen.
Check Folder Permissions
- Category:
Folder Utility - Description: Überprüft die Lese- und Schreibberechtigungen für einen Ordner.
- Inputs:
Folder Path(String): Der Pfad zum Ordner.
- Outputs (return):
Can Read(Boolean): Gibt an, ob der Ordner gelesen werden kann.Can Write(Boolean): Gibt an, ob in den Ordner geschrieben werden kann.Permission Message(String): Eine Nachricht über die Berechtigungen.
Get All Files Recursively
- Category:
Folder Utility - Description: Listet alle Dateien in einem Ordner und seinen Unterordnern auf.
- Inputs:
Folder Path(String): Der Pfad zum Ordner.
- Outputs (return):
All Files(String Array): Eine Liste aller gefundenen Dateien.
Create Folder
- Category:
Folder Utility - Description: Erstellt einen neuen Ordner.
- Inputs:
Folder Path(String): Der Pfad, an dem der Ordner erstellt werden soll.
- Outputs (return):
Success(Boolean): Gibt an, ob der Ordner erfolgreich erstellt wurde.Message(String): Eine Nachricht im Fehlerfall.
Delete Folder
- Category:
Folder Utility - Description: Löscht einen vorhandenen Ordner.
- Inputs:
Folder Path(String): Der Pfad zum zu löschenden Ordner.
- Outputs (return):
Success(Boolean): Gibt an, ob der Ordner erfolgreich gelöscht wurde.Message(String): Eine Nachricht im Fehlerfall.
Create File
- Category:
Folder Utility - Description: Erstellt eine neue Datei mit Inhalt.
- Inputs:
File Path(String): Der Pfad zur zu erstellenden Datei.Content(String): Der Inhalt, der in die Datei geschrieben werden soll.
- Outputs (return):
Success(Boolean): Gibt an, ob die Datei erfolgreich erstellt wurde.Message(String): Eine Nachricht im Fehlerfall.
Delete File
- Category:
Folder Utility - Description: Löscht eine vorhandene Datei.
- Inputs:
File Path(String): Der Pfad zur zu löschenden Datei.
- Outputs (return):
Success(Boolean): Gibt an, ob die Datei erfolgreich gelöscht wurde.Message(String): Eine Nachricht im Fehlerfall.
Open Folder in Explorer
- Category:
Folder Utility - Description: Öffnet einen Ordner im Dateiexplorer des Betriebssystems.
- Inputs:
Folder Path(String): Der Pfad zum zu öffnenden Ordner.
- Outputs (return):
Success(Boolean): Gibt an, ob der Ordner erfolgreich geöffnet wurde.Message(String): Eine Nachricht im Fehlerfall.
Read File Content Async
- Category:
Folder Utility - Description: Liest asynchron den Inhalt einer Textdatei.
- Inputs:
File Path(String): Der Pfad zur Datei.
- Outputs (return):
Success(Boolean): Gibt an, ob die Datei erfolgreich gelesen wurde.Content(String): Der gelesene Inhalt.Message(String): Eine Nachricht im Fehlerfall.
Execute File Async
- Category:
Folder Utility - Description: Führt asynchron eine ausführbare Datei aus. Bspw. exe, bat und sh.
- Inputs:
File Path(String): Der Pfad zur ausführbaren Datei.Parameters(String): Optionale Parameter für die Ausführung.Show Window(Boolean): Gibt an, ob das Fenster der Anwendung angezeigt werden soll.
- Outputs (return):
Success(Boolean): Gibt an, ob die Datei erfolgreich ausgeführt wurde.Message(String): Eine Nachricht im Fehlerfall.
Beispiele
Ordnerexistenz überprüfen
- Ziehe die Node „Check Folder Existence“ in dein Blueprint.
- Gebe den Pfad des zu überprüfenden Ordners ein.
- Verwende die Ausgaben
ExistsundValid Pathfür weitere Logik.
Dateiinhalt asynchron lesen
- Ziehe die Node „Read File Content Async“ in dein Blueprint.
- Verbinde die Eingaben und binde das
Completed-Event. - Im
Completed-Event kannst du den gelesenen Inhalt verarbeiten.
Hinweise
- Sicherheitsüberprüfungen: Das Plugin enthält Schutzmechanismen, um das Löschen von Systemdateien oder -ordnern zu verhindern. Jedoch obliegt es deiner Verantwortung, was du mit dem Plugin machst.
- Plattformunterstützung: Das Plugin unterstützt theoretisch neben Windows, MacOS, Linux, Android und iOS. Die Open File Explorer Funktion funktionert vermutlich aber nur unter Mac, Win und Linux.
- Asynchrone Funktionen: Verwende die asynchronen Funktionen für zeitintensive Operationen, um die Leistung deiner Anwendung zu verbessern.
Troubleshooting & Common Issues
Fehlerhafte Ordnerpfade: Sollte ein Ordnerpfad nicht funktionieren, überprüfe ob der Pfad korrekt ist und versuche die Schreibweise zu ändern; bspw. C:\ zu C:/ . Vermeide Umlaute oder Sonderzeichen.
Roadmap
Current - v1.0
Kundenwünsche
Current - v1.0
Initial Release.
- Folder Existence Check: Easily verify if a folder exists.
- File Filtering: Retrieve files with specific extensions.
- Folder Permissions Check: Check read/write access to folders.
- Recursive File Listing: Get all files within a folder and its subfolders.
- File and Folder Creation and Deletion: Create or delete files and folders.
- Open Folder in Explorer: Open folders in the system’s file explorer.
- Read File Content Async: Asynchronously read the content of text files.
- Execute File Async: Asynchronously execute files like .bat, .sh, or .exe.
Kundenwünsche
Keine Einträge.