Schem-Converter

Convert .litematic files between NBT versions directly in Discord with a simple slash command.

---

What is it?

A Discord bot that takes a .litematic schematic file and converts its internal NBT version (4 → 5 → 6 → 7) and all the tag formats that go with it.
Perfect when you need to open a modern schematic in an older version of Litematica, or vice‑versa.

Features

• Accepts .litematic files via Discord's /schem-convert command.
• Detects the current NBT version of the file.
• Provides a dropdown menu to select the target NBT version:
  • NBT 7 (1.20.5 – 1.21+)
  • NBT 6 (1.17 – 1.20.4)
  • NBT 5 (1.13 – 1.16.5)
  • NBT 4 (Legacy, pre-1.13)
• Returns the converted .litematic file directly in the ephemeral reply.

Requirements

• Node.js v18 or higher
• A Discord bot application (see Discord Developer Portal)

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/litematic-converter-bot.git
   cd litematic-converter-bot

2. Install dependencies:

   npm install

3. Create a .env file in the root directory with the following contents:

   TOKEN=your_bot_token_here
   CLIENT_ID=your_application_id_here

Registering Slash Commands

Run the deployment script once (or whenever you modify the command):

npm run deploy

Starting the Bot

npm run start

Usage

1. In any text channel, use the slash command:

   /schem-convert

2. Attach a .litematic file when prompted.
3. The bot will reply with a dropdown menu showing the current NBT version.
4. Select the target NBT version from the dropdown.
5. The bot will process the file and send back the converted .litematic file. All messages are ephemeral (visible only to you).

Dependencies

discord.js versions 14.14.1.

prismarine-nbt versions 2.5.0.

License

MIT © froyln / CodeW4VE.