File Structure Configuration

Basic Usage (Template String)

files: {
  perNamespace: true,
  output: 'resources/{projectId}/configuration/{folder}/{namespace}.yml',
  assets: 'resources/{projectId}/assets/{namespace}/{asset}',  // Simple template
}

This puts all assets in: resources/myproject/assets/mynamespace/textures/item.png and resources/myproject/assets/mynamespace/models/item.json

Advanced Usage (Function)

files: {
  perNamespace: true,
  output: 'resources/{projectId}/configuration/{folder}/{namespace}.yml',
  
  // Use a function for complex logic!
  assets: (context) => {
    const { item, assetType, assetName, projectId, namespace, folder } = context;
    
    // Custom logic based on item type
    if (item.type === 'block') {
      if (assetType === 'model') {
        return `resources/${projectId}/assets/${namespace}/models/blocks/${assetName}`;
      } else if (assetType === 'texture') {
        return `resources/${projectId}/assets/${namespace}/customtextures/${assetName}`;
      }
    }
    
    if (item.type === 'item') {
      if (assetType === 'model') {
        return `resources/${projectId}/assets/${namespace}/models/items/${assetName}`;
      } else if (assetType === 'texture') {
        return `resources/${projectId}/assets/${namespace}/textures/items/${assetName}`;
      }
    }
    
    // Default fallback
    return `resources/${projectId}/assets/${namespace}/${assetType}s/${assetName}`;
  }
}

Function Context

The function receives an object with:

• item - The full item data (item.type, item.id, item.subtype, etc.)

• assetType - Either 'texture' or 'model'

• assetName - The filename (e.g., 'myweapon.png' or 'myweapon.json')

• projectId - The project name (e.g., 'myproject')

• namespace - The item's namespace (e.g., 'mynamespace')

• folder - The folder name (e.g., 'myfolder')

• textureCount - Number of textures this item has (e.g., 3)

• modelCount - Number of models this item has (e.g., 1)

Example: Organize by Item Subtype

assets: ({ item, assetType, assetName, projectId, namespace }) => {
  // Organize weapons separately from tools
  if (item.subtype === 'weapon') {
    return `resources/${projectId}/assets/${namespace}/${assetType}s/weapons/${assetName}`;
  }
  
  if (item.subtype === 'tool') {
    return `resources/${projectId}/assets/${namespace}/${assetType}s/tools/${assetName}`;
  }
  
  // Default
  return `resources/${projectId}/assets/${namespace}/${assetType}s/${assetName}`;
}

Example: Organize by Custom Module

assets: ({ item, assetType, assetName, projectId, namespace }) => {
  // Use custom module values
  const rarity = item.modules?.rarity || 'common';
  
  return `resources/${projectId}/assets/${namespace}/${assetType}s/${rarity}/${assetName}`;
}

This would create:

• resources/myproject/assets/mynamespace/textures/legendary/excalibur.png

• resources/myproject/assets/mynamespace/textures/common/stick.png

Example: Different Texture Folders by Type

assets: ({ item, assetType, assetName, projectId, namespace }) => {
  if (assetType === 'texture') {
    // Use different texture folders based on item type
    switch (item.type) {
      case 'block':
        return `resources/${projectId}/block_textures/${namespace}/${assetName}`;
      case 'item':
        return `resources/${projectId}/item_textures/${namespace}/${assetName}`;
      case 'furniture':
        return `resources/${projectId}/furniture_textures/${namespace}/${assetName}`;
      default:
        return `resources/${projectId}/textures/${namespace}/${assetName}`;
    }
  } else if (assetType === 'model') {
    // All models in one place
    return `resources/${projectId}/models/${namespace}/${assetName}`;
  }
}

Example: Organize by Asset Count

assets: ({ item, assetType, assetName, projectId, namespace, textureCount, modelCount }) => {
  // Items with multiple textures get a dedicated folder
  if (assetType === 'texture' && textureCount > 1) {
    // Create a folder for this item's multiple textures
    return `resources/${projectId}/assets/${namespace}/multitexture/${item.id}/${assetName}`;
  }
  
  // Items with multiple models
  if (assetType === 'model' && modelCount > 1) {
    return `resources/${projectId}/assets/${namespace}/multimodel/${item.id}/${assetName}`;
  }
  
  // Single-asset items
  return `resources/${projectId}/assets/${namespace}/${assetType}s/${assetName}`;
}

This creates:

• resources/myproject/assets/mynamespace/multitexture/complexitem/texture1.png

• resources/myproject/assets/mynamespace/multitexture/complexitem/texture2.png

• resources/myproject/assets/mynamespace/multitexture/complexitem/texture3.png

• resources/myproject/assets/mynamespace/textures/simpleitem.png (single texture)

Return Value

The function should return a string representing the relative path from the export root.

Do NOT include the base output path - that's added automatically.

✅ Good: resources/myproject/assets/mynamespace/textures/item.png ❌ Bad: C:/Users/.../Exports/craftengine/resources/...

Backwards Compatibility

Template strings still work! You can use either:

• String template: 'resources/{projectId}/assets/{namespace}/{asset}'

• Function: (context) => { ... }

Both options are fully supported.