# @dcl/sdk

> Main SDK package for building Decentraland scenes.

Latest version **7.29.0** (published 2026-09-15) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @dcl/sdk
pnpm add @dcl/sdk
yarn add @dcl/sdk
bun add @dcl/sdk
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 7.29.0 |
| Published | 2026-09-15 |
| First published | 2022-06-21 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 5 |
| Unpacked size | 416.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 40 |
| Author | Decentraland |
| Maintainers | decentralandbot, imazzara |

## Links

- npm: https://www.npmjs.com/package/@dcl/sdk
- Repository: https://github.com/decentraland/js-sdk-toolchain
- Homepage: https://github.com/decentraland/js-sdk-toolchain#readme
- Issues: https://github.com/decentraland/js-sdk-toolchain/issues
- npm.io page: https://npm.io/package/@dcl/sdk

## Dependencies (5)

- [@dcl/ecs](https://npm.io/package/@dcl/ecs.md) 7.29.0
- [@dcl/ecs-math](https://npm.io/package/@dcl/ecs-math.md) 2.1.0
- [@dcl/react-ecs](https://npm.io/package/@dcl/react-ecs.md) 7.29.0
- [@dcl/js-runtime](https://npm.io/package/@dcl/js-runtime.md) 7.29.0
- [@dcl/sdk-commands](https://npm.io/package/@dcl/sdk-commands.md) 7.29.0

## Recent versions

- 7.29.0 (latest) — 2026-09-15
- 7.29.1-36863326504.commit-aa54c50 (auth-server) — 2026-10-01
- 7.29.1-36591934525.commit-48aa9b5 (next) — 2026-09-29
- 7.29.1-35901015152.commit-d1b7b96 (experimental-bevy) — 2026-09-23
- 7.26.1-32979311771.commit-17041c9 (experimental) — 2026-08-26
- 7.25.1-30828532396.commit-0c215c3 (protocol-squad) — 2026-08-03
- 7.8.16 (ci) — 2025-07-07
- 7.29.1-36637355925.commit-d261ba1 — 2026-09-29
- 7.29.1-36625469671.commit-2d5ffac — 2026-09-29
- 7.29.1-36624944101.commit-bb81ac6 — 2026-09-29
- 7.29.1-36041177279.commit-502e633 — 2026-09-24
- 7.29.1-35917671376.commit-046b268 — 2026-09-23
- 7.29.1-35862852104.commit-1f44e80 — 2026-09-23
- 7.29.1-35861881691.commit-e4e55e9 — 2026-09-23
- 7.29.1-35738531793.commit-ac557b7 — 2026-09-22
- … 1285 more at https://npm.io/package/@dcl/sdk/versions

## README

# @dcl/sdk

Main SDK package for building Decentraland scenes.

## Overview

The Decentraland SDK provides a complete framework for creating interactive 3D scenes in the Decentraland metaverse. It includes:

- Entity Component System (ECS) for scene development
- UI components and layout tools
- Asset management utilities
- Scene networking capabilities
- Input handling and interactions

## Installation

```bash
npm install @dcl/sdk
```

## Quick Start

1. Create a new scene:

```bash
npx @dcl/sdk-commands init
```

2. Start the development server:

```bash
npm start
```

## Usage

```typescript
import { engine, Entity, Transform, GltfContainer } from '@dcl/sdk/ecs'

// Create an entity
const entity = engine.addEntity()

// Add components
Transform.create(entity, {
  position: { x: 8, y: 0, z: 8 },
  scale: { x: 1, y: 1, z: 1 }
})

GltfContainer.create(entity, {
  src: 'models/myModel.glb'
})
```

## Features

### Components

- Transform
- GltfContainer
- Material
- UiTransform
- AudioSource
- And many more...

### Systems

- Input handling
- Physics
- Animation
- Networking

### UI Framework

- Flexbox layout
- React-like components
- Event handling

## Development

### Building the Package

```bash
make build
```

### Testing

```bash
# Run all tests
make test
```

### Development Commands

For local development, you can also use:

```bash
# Clean all build artifacts and reinstall dependencies
make clean && make install

# Format and fix linting issues
make lint-fix

# Update dependencies across packages
make sync-deps
```

## Documentation

- [SDK Documentation](https://docs.decentraland.org/creator/development-guide/sdk7/sdk-101/)
- [Scene Examples](https://github.com/decentraland/sdk7-goerli-plaza)
- [ECS](https://docs.decentraland.org/creator/development-guide/sdk7/entities-components/)

## Architecture Decisions

For a deeper understanding of the SDK architecture:

- [ADR-117: CRDT Protocol for Scenes](https://adr.decentraland.org/adr/ADR-117)
- [ADR-123: Schema and Serialization](https://adr.decentraland.org/adr/ADR-123)
- [ADR-165: Component Declaration](https://adr.decentraland.org/adr/ADR-165)

---
_Source: https://npm.io/package/@dcl/sdk · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._