Commands
embr migrate
Last updated November 2, 2026
Moves a project from pesde, Wally, Forest, or Crater to Ember.
embr migrate [-y]
embr migrate finds pesde.toml, wally.toml, forest.json, and
crater.json in the current directory and lists them, all checked. It moves the files that stay
checked into ember.toml, and writes ember.toml when there is none.
Without a terminal, or with --yes, it moves every file it finds.
What moves and what stays#
Each setting that Ember has a place for moves to ember.toml, and leaves its
old file. A setting that Ember has no place for stays in the old file, so a
field that a later version of the other tool adds is never lost. A file with
nothing left in it is deleted.
ember.toml wins. Where it already sets a key, its own value stays, and
the entry in the old file goes all the same. The command names each such key.
A migration that would leave ember.toml unreadable writes nothing at all.
Lockfiles stay: pesde.lock, wally.lock, forest-lock.json, and
crater.lock. The next
embr install resolves again and writes ember.lock.
pesde#
| pesde.toml | ember.toml |
|---|---|
name, version, description, license, repository, private | [package] |
authors, when each one is a GitHub username | [package] authors |
[target] environment | [target] environment |
[target] lib | [target] main |
includes, workspace_members | [target] includes, workspace |
[indices], [wally_indices] | [indices] |
{ name = ... }, { wally = ... }, { workspace = ... } dependencies | [dependencies] |
[overrides], "foo>bar" | [overrides], "foo.bar" |
[scripts] build = "scripts/build.luau" | [scripts] build = "lune run scripts/build.luau" |
pesde's default index becomes pesde, and its default Wally index becomes
wally. So a project that already uses Ember's own default index keeps it.
pesde runs a script with Lune, so each script becomes a lune run command.
embr run appends its arguments to the command line, so the
script reads the same process.args. Lune has to be on PATH:
embr tool add lune-org/lune pins it for the project.
These stay in pesde.toml: git and path dependencies, [dev_dependencies],
[peer_dependencies], [engines], [patches], [place], [target] bin,
and the sourcemap_generator hook, which pesde runs by itself.
Wally#
| wally.toml | ember.toml |
|---|---|
[package] name, version, description, license, private | [package] |
[package] authors, when each one is a GitHub username | [package] authors |
[package] realm | [target] environment |
[package] include, exclude | [target] includes, excludes |
[package] registry | [indices] wally |
[dependencies] | [dependencies], index = "wally" |
[server-dependencies] | [dependencies], target = "roblox_server" |
These stay in wally.toml: [dev-dependencies], [place], and the dev
realm.
Forest#
| forest.json | ember.toml |
|---|---|
author and name | [package] name, as author/name |
version, description, license | [package] |
platform = "roblox" | [target] environment = "roblox" |
root | [target] main |
dependencies | [dependencies], index = "forest", keyed by the alias |
These stay in forest.json: mounts, overrides, excludes, packagesDir,
visibility, and every field of a UEFN project, which Ember does not install.
Crater#
Ember reads Crater's rules from .crater-declare, the file that Crater
0.5.5 and later write beside crater.json: the address of each registry
name, the realm of each dependency list, and the default of each field.
A crater.json with no .crater-declare beside it does not migrate.
Run any Crater command once to write the file.
| crater.json | ember.toml |
|---|---|
name, version, description, license, repository | [package] |
authors, when each one is a GitHub username | [package] authors |
can_publish | [package] private, the opposite value |
icon, a .png, .jpg, .webp, or .gif file (.gif from embr 0.13.0) | [package] logo |
import_to = "client" or "shared" | [target] environment = "roblox" |
import_to = "server" | [target] environment = "roblox_server" |
path_to_main, workspace | [target] main, workspace |
package_files.exclude, or exclude before Crater 0.5.7 | [target] excludes |
import_client | [dependencies] |
import_server | [dependencies], target = "roblox_server" |
scripts | [scripts], as they are |
tools, owner/repo@version | [tools] |
A dependency moves when Ember can install it: one whose registry name,
ember#, wally#, pesde#, forest#, or one of the project's own
registries, is at an address Ember reads. An ember# dependency takes
index = "ember" and needs no [indices] entry. A dependency with no
registry name moves when registry names one such index alone, and
registry then moves to [indices]. The alias before : is the key, else the short name, as
Crater names the link file.
| crater.json | ember.toml |
|---|---|
a/b or a/b^ | version = "^", the latest |
a/b^1.2.3, a/b@1.2.3 | version = "^1.2.3" |
a/b=1.2.3 | version = "=1.2.3" |
a/b+1.2.3 | version = ">=1.2.3" |
a/b~1.2.3 | version = "~1.2.3" |
These stay in crater.json: packages of a Crater registry, which Ember does
not read, path: and git+ dependencies, import_develop, registry,
registries, overrides, keywords, path_to_definition_files,
allow_files, and the script policy. crater init writes every field,
and a field equal to its default goes. crater.settings.json stays as
it is.
See also#
embr indexfor thewally,pesde, andforestindices.embr initto start a manifest from nothing.