Skip to content

EssentialsX Migration

EssentialsLite provides a narrow EssentialsX import path. It is not a general EssentialsX migration tool.

Import Command

Grant the operator or administrator the essentials.import permission, then run:

/essentialslite import

The importer reads EssentialsX data from the sibling plugin path:

../Essentials/userdata

The supported imported data is:

  • Homes
  • Kits
  • Money

Writes are performed asynchronously. Back up both plugin data directories before starting an import, and do not treat command completion as proof that every source record was valid.

Risks and Limits

The import operates on the audited EssentialsX userdata location and supported data types only. It does not perform a general migration of all EssentialsX configuration, commands, permissions, or other plugin data. Verify imported homes, kits, and balances after the operation, especially when the source path, user data, or configuration differs from the expected layout.