@uepm/dependency-plugin 1.0.1

package/DependencyPlugin.uplugin

@@ -0,0 +1,30 @@
+{
+  "FileVersion": 3,
+  "Version": 1,
+  "VersionName": "1.0.0",
+  "FriendlyName": "Dependency Plugin",
+  "Description": "A plugin demonstrating dependencies on other NPM-distributed plugins",
+  "Category": "Other",
+  "CreatedBy": "UEPM",
+  "CreatedByURL": "https://github.com/uepm/uepm",
+  "DocsURL": "",
+  "MarketplaceURL": "",
+  "SupportURL": "",
+  "CanContainContent": false,
+  "IsBetaVersion": false,
+  "IsExperimentalVersion": false,
+  "Installed": false,
+  "Modules": [
+    {
+      "Name": "DependencyPlugin",
+      "Type": "Runtime",
+      "LoadingPhase": "Default"
+    }
+  ],
+  "Plugins": [
+    {
+      "Name": "ExamplePlugin",
+      "Enabled": true
+    }
+  ]
+}

package/README.md

@@ -0,0 +1,123 @@
+# @uepm/dependency-plugin
+
+Unreal Engine plugin demonstrating dependencies on other NPM-distributed plugins.
+
+## Installation
+
+```bash
+npm install @uepm/dependency-plugin
+```
+
+This will automatically install the required dependency:
+- `@uepm/example-plugin` - The plugin this one depends on
+
+## Prerequisites
+
+Your Unreal Engine project must be initialized for UEPM:
+
+```bash
+npx @uepm/init
+```
+
+## What's Included
+
+This plugin demonstrates:
+
+- **Plugin dependencies** - How to depend on other NPM plugins
+- **Dependency resolution** - Automatic installation of required plugins
+- **Cross-plugin communication** - Using functionality from other plugins
+- **Proper dependency declaration** - Both in package.json and .uplugin
+
+## Plugin Dependencies
+
+### NPM Dependencies (package.json)
+```json
+{
+  "dependencies": {
+    "@uepm/example-plugin": "^1.0.0"
+  }
+}
+```
+
+### Unreal Engine Dependencies (.uplugin)
+```json
+{
+  "Plugins": [
+    {
+      "Name": "ExamplePlugin",
+      "Enabled": true
+    }
+  ]
+}
+```
+
+## Plugin Structure
+
+```
+@uepm/dependency-plugin/
+├── DependencyPlugin.uplugin  # Plugin descriptor with dependencies
+├── package.json              # NPM package with dependencies
+├── Source/                   # C++ source code
+│   └── DependencyPlugin/
+│       ├── Private/
+│       │   ├── DependencyPlugin.cpp
+│       │   └── DependencyPluginModule.cpp
+│       ├── Public/
+│       │   ├── DependencyPlugin.h
+│       │   └── DependencyPluginModule.h
+│       └── DependencyPlugin.Build.cs
+└── README.md
+```
+
+## Engine Compatibility
+
+- **Unreal Engine**: 5.0.0 or later (< 6.0.0)
+- **Platforms**: All platforms supported by Unreal Engine
+- **Dependencies**: Requires ExamplePlugin to be available
+
+## Usage in Unreal Engine
+
+1. Install the plugin via NPM (dependencies install automatically)
+2. Open your project in Unreal Engine
+3. Go to **Edit > Plugins**
+4. Find "Dependency Plugin" in the list
+5. Enable the plugin (ExamplePlugin will be enabled automatically)
+6. Restart the editor when prompted
+
+The plugin will log messages showing the dependency relationship:
+
+```
+LogExamplePlugin: Example Plugin has been loaded!
+LogDependencyPlugin: Dependency Plugin has been loaded!
+LogDependencyPlugin: Successfully found and using ExamplePlugin functionality
+```
+
+## Dependency Management
+
+This plugin shows how UEPM handles plugin dependencies:
+
+1. **NPM-level dependencies** - Ensures required plugins are downloaded
+2. **Unreal Engine dependencies** - Declares plugin dependencies in .uplugin
+3. **Build system integration** - Links against dependency modules
+4. **Runtime dependency checking** - Verifies dependencies are available
+
+## Creating Dependent Plugins
+
+To create your own plugin with dependencies:
+
+1. **Add NPM dependency** in package.json
+2. **Declare Unreal dependency** in .uplugin file
+3. **Add module dependency** in Build.cs file
+4. **Include headers** from dependency plugin
+5. **Test dependency resolution** during development
+
+## Best Practices
+
+- Always specify compatible version ranges for dependencies
+- Test with and without dependencies to ensure proper error handling
+- Document dependency requirements clearly
+- Use semantic versioning for your plugin releases
+
+## License
+
+MIT

package/Source/DependencyPlugin/DependencyPlugin.Build.cs

@@ -0,0 +1,43 @@
+using UnrealBuildTool;
+
+public class DependencyPlugin : ModuleRules
+{
+    public DependencyPlugin(ReadOnlyTargetRules Target) : base(Target)
+    {
+        PCHUsage = ModuleRules.PCHUsageMode.UseExplicitOrSharedPCHs;
+
+        PublicIncludePaths.AddRange(
+            new string[] {
+            }
+        );
+
+        PrivateIncludePaths.AddRange(
+            new string[] {
+            }
+        );
+
+        PublicDependencyModuleNames.AddRange(
+            new string[]
+            {
+                "Core",
+                "ExamplePlugin",
+            }
+        );
+
+        PrivateDependencyModuleNames.AddRange(
+            new string[]
+            {
+                "CoreUObject",
+                "Engine",
+                "Slate",
+                "SlateCore",
+            }
+        );
+
+        DynamicallyLoadedModuleNames.AddRange(
+            new string[]
+            {
+            }
+        );
+    }
+}

package/Source/DependencyPlugin/Private/DependencyPlugin.cpp

@@ -0,0 +1,41 @@
+#include "DependencyPlugin.h"
+#include "ExamplePlugin.h"
+
+#define LOCTEXT_NAMESPACE "FDependencyPluginModule"
+
+void FDependencyPluginModule::StartupModule()
+{
+    // This code will execute after your module is loaded into memory; the exact timing is specified in the .uplugin file per-module
+    UE_LOG(LogTemp, Warning, TEXT("DependencyPlugin module has been loaded"));
+    
+    // Demonstrate using functionality from ExamplePlugin
+    UseExamplePluginFunctionality();
+}
+
+void FDependencyPluginModule::ShutdownModule()
+{
+    // This function may be called during shutdown to clean up your module.  For modules that support dynamic reloading,
+    // we call this function before unloading the module.
+    UE_LOG(LogTemp, Warning, TEXT("DependencyPlugin module has been unloaded"));
+}
+
+void FDependencyPluginModule::UseExamplePluginFunctionality()
+{
+    // Check if ExamplePlugin module is loaded
+    if (FModuleManager::Get().IsModuleLoaded("ExamplePlugin"))
+    {
+        UE_LOG(LogTemp, Warning, TEXT("DependencyPlugin: ExamplePlugin is loaded and available"));
+        
+        // In a real implementation, you would call specific functions from ExamplePlugin
+        // For this example, we just log that the dependency is available
+        UE_LOG(LogTemp, Warning, TEXT("DependencyPlugin: Successfully using ExamplePlugin functionality"));
+    }
+    else
+    {
+        UE_LOG(LogTemp, Error, TEXT("DependencyPlugin: ExamplePlugin is not loaded - dependency not satisfied"));
+    }
+}
+
+#undef LOCTEXT_NAMESPACE
+
+IMPLEMENT_MODULE(FDependencyPluginModule, DependencyPlugin)

package/Source/DependencyPlugin/Public/DependencyPlugin.h

@@ -0,0 +1,17 @@
+#pragma once
+
+#include "CoreMinimal.h"
+#include "Modules/ModuleManager.h"
+
+class FDependencyPluginModule : public IModuleInterface
+{
+public:
+
+    /** IModuleInterface implementation */
+    virtual void StartupModule() override;
+    virtual void ShutdownModule() override;
+
+private:
+    /** Demonstrates using functionality from ExamplePlugin */
+    void UseExamplePluginFunctionality();
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@uepm/dependency-plugin",
+  "version": "1.0.1",
+  "description": "Plugin demonstrating dependencies on other NPM plugins",
+  "main": "DependencyPlugin.uplugin",
+  "scripts": {
+    "test": "vitest --run",
+    "test:watch": "vitest"
+  },
+  "unreal": {
+    "engineVersion": ">=5.0.0 <6.0.0",
+    "pluginName": "DependencyPlugin"
+  },
+  "dependencies": {
+    "@uepm/example-plugin": "^1.0.1"
+  },
+  "files": [
+    "DependencyPlugin.uplugin",
+    "Source/**/*"
+  ],
+  "keywords": [
+    "unreal",
+    "unreal-engine",
+    "plugin",
+    "uepm",
+    "dependency"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}