CryptikLemur.AssetBundleBuilder 1.0.2

AssetBundleBuilder

Command line tool for building Unity asset bundles for RimWorld mods. No repository cloning or Unity project setup required.

Prerequisites

Unity Editor Required: This tool requires Unity Hub and a Unity Editor installation (e.g., 2022.3.35f1) to build asset bundles. The tool will:

• Auto detect Unity installations in standard locations
• Create temporary Unity projects automatically
• Handle all Unity project configuration

Download Unity Hub from unity.com/download and install the required Unity version through it.

Installation

.NET Global Tool (Cross Platform)

# Install globally
dotnet tool install --global CryptikLemur.AssetBundleBuilder

# Use anywhere
assetbundlebuilder 2022.3.35f1 "/path/to/assets" "mybundle" "/path/to/output"

Manual Installation

Download the appropriate executable for your platform from the Releases Page:

• Windows: AssetBundleBuilder-win-x64-v1.0.0.zip
• macOS Intel: AssetBundleBuilder-osx-x64-v1.0.0.zip
• Linux x64: AssetBundleBuilder-linux-x64-v1.0.0.zip

Extract and run the executable directly. No installation required.

Quick Start

Basic Usage

# Auto find Unity and build asset bundles
assetbundlebuilder 2022.3.35f1 "/path/to/your/mod/assets" "mybundle" "/path/to/output/directory"

With Custom Bundle Name

# Specify a custom bundle name
assetbundlebuilder 2022.3.35f1 "/path/to/assets" "author.modname" "/path/to/output"

Specific Platform

# Build only for Windows
assetbundlebuilder 2022.3.35f1 "/path/to/assets" "mybundle" "/path/to/output" --target windows

How It Works

1. Creates a temporary Unity project
2. Finds Unity installations by version number across common paths
3. Copies your assets and applies proper import settings
4. Builds compressed asset bundles with platform specific optimizations
5. Removes temporary files automatically

Supported Features

• Unity Version Auto Discovery: Just specify the version (e.g., 2022.3.35f1)
• Cross Platform: Windows, macOS, and Linux native executables
• Multiple Build Targets: Windows, macOS, Linux asset bundles
• Automatic Asset Import Settings: Textures, audio, shaders
• Terrain Texture Support: Special handling for terrain assets
• PSD File Support: Basic Photoshop document import
• Temporary Project Management: No manual Unity project required
• CI/CD Friendly: Works in automated build pipelines

Command Reference

assetbundlebuilder <unity-path-or-version> <asset-directory> <bundle-name> [output-directory] [options]

Arguments

• unity-path-or-version: Either Unity version (e.g., 2022.3.35f1) or full path to Unity executable
• asset-directory: Directory containing your mod's assets (textures, sounds, etc.)
• bundle-name: Name for the asset bundle (e.g., "mymod", "author.modname")
• output-directory: Where to create the asset bundles (optional, defaults to current directory)

Options

• --unity-version <version>: Explicitly specify Unity version
• --bundle-name <name>: Override bundle name (alternative to positional argument)
• --target <target>: Build target: windows, mac, or linux (default: windows)
• --temp-project <path>: Custom location for temporary Unity project
• --keep-temp: Don't delete temporary project (for debugging)

Examples

Windows

# Using .NET global tool
assetbundlebuilder 2022.3.35f1 "C:\MyMod\Assets" "mymod" "C:\MyMod\Output"

# Using specific Unity installation
assetbundlebuilder "C:\Unity\2022.3.35f1\Editor\Unity.exe" "C:\MyMod\Assets" "mymod" "C:\MyMod\Output"

macOS

# Using .NET global tool
assetbundlebuilder 2022.3.35f1 "/Users/me/MyMod/Assets" "mymod" "/Users/me/MyMod/Output"

# Using specific Unity installation
assetbundlebuilder "/Applications/Unity/Hub/Editor/2022.3.35f1/Unity.app/Contents/MacOS/Unity" "/Users/me/MyMod/Assets" "mymod" "/Users/me/MyMod/Output"

Linux

# Using .NET Global Tool
assetbundlebuilder 2022.3.35f1 "/home/user/MyMod/Assets" "mymod" "/home/user/MyMod/Output"

# Build only Linux bundles
assetbundlebuilder 2022.3.35f1 "/home/user/MyMod/Assets" "mymod" "/home/user/MyMod/Output" --target linux

Unity Installation Paths

The tool automatically searches these common Unity installation locations:

Windows

• C:\Program Files\Unity\Hub\Editor\
• C:\Program Files (x86)\Unity\Hub\Editor\
• %USERPROFILE%\Unity\Hub\Editor\

macOS

• /Applications/Unity/Hub/Editor/
• $HOME/Applications/Unity/Hub/Editor/

Linux

• /opt/unity/editor/
• $HOME/Unity/Hub/Editor/
• $HOME/.local/share/Unity/Hub/Editor/

CI/CD Integration

GitHub Actions

- name: Install AssetBundleBuilder
  run: dotnet tool install --global CryptikLemur.AssetBundleBuilder

- name: Build Asset Bundles
  run: assetbundlebuilder 2022.3.35f1 "./Assets" "mymod" "./Output"

Azure DevOps

- task: DotNetCoreCLI@2
  displayName: 'Install AssetBundleBuilder'
  inputs:
    command: 'custom'
    custom: 'tool'
    arguments: 'install --global CryptikLemur.AssetBundleBuilder'

- script: assetbundlebuilder 2022.3.35f1 "$(Build.SourcesDirectory)/Assets" "mymod" "$(Build.ArtifactStagingDirectory)"
  displayName: 'Build Asset Bundles'

Troubleshooting

Unity Not Found

# Try with full path instead
assetbundlebuilder "/path/to/Unity" "/path/to/assets" "/path/to/output"

# Or install Unity in standard location

Permission Errors (Linux/macOS)

# Make sure executable has proper permissions
chmod +x ./AssetBundleBuilder

# Or use .NET Global Tool instead
dotnet tool install --global AssetBundleBuilder.GlobalTool

Invalid Bundle Name

# Use a valid bundle name (alphanumeric, dots, underscores)
assetbundlebuilder 2022.3.35f1 "/path/to/assets" "valid_bundle_name" "/path/to/output"

Debugging

# Keep temporary project for inspection
assetbundlebuilder 2022.3.35f1 "/path/to/assets" "mybundle" "/path/to/output" --keep-temp

Uninstallation

.NET Global Tool

dotnet tool uninstall --global CryptikLemur.AssetBundleBuilder

Support

• Issues: GitHub Issues
• RimWorld Modding: RimWorld Discord