Skip to content
Lumistra Docs

Migrating from MEE6

Supported formats

Section titled “Supported formats”
  • MEE6 CSV export - id,username,discriminator,xp,level,messages
  • MEE6 JSON export - {"players": [...]}

How to export from MEE6

Section titled “How to export from MEE6”
  1. Open your MEE6 dashboard
  2. Go to the Leaderboard section
  3. Export the data as CSV or JSON
  4. Save the file to your device

Running the import

Section titled “Running the import”
/import-levels file:<upload your export file>

Upload the CSV or JSON file directly in Discord. The bot reads the file and maps each member’s MEE6 level to equivalent XP in Lumistra’s system based on your current XP curve settings.

Constraints:

  • Max file size: 5 MB
  • Max users: 10,000 - if your export exceeds this, the first 10,000 entries are imported and the rest are noted in the response
  • File must be UTF-8 encoded
  • Only .csv and .json extensions accepted

If you’re running multiple leveling tracks, target a specific one with the leveler parameter:

/import-levels file:<file> leveler:main

What gets imported

Section titled “What gets imported”

The import maps MEE6 levels to Lumistra XP. Members receive the equivalent level based on your current XP curve.

What doesn’t transfer: message history, reaction history, streaks, lifecycle stages. Only the level-to-XP mapping comes across.

After the import

Section titled “After the import”

Run /leaderboard to check that levels look correct. Existing role rewards will trigger for imported levels on the next level-up event - members don’t receive role rewards retroactively just from the import itself.

Combining with harvest/replay

Section titled “Combining with harvest/replay”

The import gives members their MEE6 levels as a starting point. You can layer real activity on top:

  1. Import MEE6 levels - establishes base levels
  2. /harvest days:365 - capture the past year of server activity
  3. /replay - add real participation on top of the imported levels

Members end up with credit for both their MEE6 history and their actual recent activity in the server.