Documentation

​
​

Development

User Acquisition

Monetization

Industry

Unity Gaming Services CLI

v1.5

Legacy
​

GitHub Repository

Unity Gaming Services CLI

v1.5

Legacy
​

​
​
Unity Gaming Services CLI
  • Overview
Get started
  • Install the CLI
  • Set up a Common Configuration
  • Get Authenticated
  • Use Your First Command
Base commands
  • Configuration
  • Deploy
  • Environment
  • Fetch
  • Login
  • Logout
  • Status
Deployment definition
  • What is a Deployment Definition
  • Commands for Deployment Definition
  • Excludes
  • Troubleshooting Deployment Definition
Samples
  • CI/CD Pipeline Usage
  • Deploy Samples
  • File Type Associations
  • Redirecting Command Result to File
Troubleshooting
  • Project Roles
  • Unauthorized (Error 403)
CLI Services Documentation
  • Access
  • Cloud Code
  • Cloud Content Delivery
  • Cloud Save
  • Economy
  • Game Server Hosting
  • Leaderboards
  • Lobby
  • Matchmaker
  • Player
  • Remote Config
  • Scheduler
  • Triggers
  1. Overview

What is a Deployment Definition

Understand how Deployment Definition files group deployable assets by directory.
Read time 1 minute
Last updated 3 months ago

Definition

A Deployment Definition (
.ddef
extension) file is a logical grouping of deployable assets that is based on its location in a directory. A Deployment Definition contains all files in its directory and sub-directories, unless another Deployment Definition is found. Only a single Deployment Definition may exist in a single directory.

Deployment Definition Structure

A deployment definition is represented by the following json. The
name
is used to give information when using Deployment Definitions with the UGS CLI. The
excludePaths
are used to give more flexibility to deployment definitions. More information can be found here.
{ "name": "example", "excludePaths": [ ]}

Example

Given the following hierarchy, the Deployment Definitions
CloudCode.ddef
,
CloudCodeTests.ddef
, and
RemoteConfig.ddef
would be responsible for the following files:
  • CloudCode.ddef
    • scriptA.js
      • scriptB.js
  • CloudCodeTests.ddef
    • scriptA.test.js
      • scriptB.test.js
  • RemoteConfig.ddef
    • configA.rc
      • configB.rc
Assets/├── DeployableAssets/│ ├── CloudCode/│ │ ├── CloudCode.ddef│ │ ├── scriptA.js│ │ ├── scriptB.js│ │ └── Tests/│ │ ├── CloudCodeTests.ddef│ │ ├── scriptA_test.js│ │ └── scriptB_test.js│ └── Remote Config/│ ├── RemoteConfig.ddef│ ├── configA.rc│ └── configB.rc

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Definition

    • Deployment Definition Structure

    • Example