Streamlining Minecraft Lore Editing with MCLoreChat
Adding rich, colorful descriptions to items in Minecraft is one of the most creative ways to build immersive server experiences. Whether you are designing custom weapons, quest rewards, or roleplay artifacts, the process of writing and applying lore can quickly become tedious. Typing long strings of color codes, managing line breaks, and copying text between tools often breaks the flow of creativity. MCLoreChat changes that by bridging your Minecraft server directly with Discord, turning a simple chat message into a powerful lore editor.
What Exactly Is MCLoreChat?
MCLoreChat is a Spigot plugin that hosts a Discord bot right from your server. It allows you to edit and add lored items far more easily than traditional in-game commands. Instead of wrestling with formatting inside Minecraft’s limited chat box, you can write entire paragraphs in Discord, apply color codes with minimal effort, and then queue that lore for instant use on any item you are holding. The plugin works in two directions: you can send lore from an existing item to Discord for editing, and you can push freshly written lore back into the game.
There are two major versions of the plugin. The legacy 1.0 version uses a designated Discord channel and simple commands like !LoreAdd and !Lorehand. The modern 2.0 version introduces a complete overhaul with a lore queue system, an interactive GUI, and a seamless linking process between Minecraft accounts and Discord users. Both versions are open source, so server owners can inspect or modify the code to fit their needs.
How the Discord Bot Integration Works
At its core, MCLoreChat turns a Discord bot into a remote lore clipboard. After a quick setup, players can link their Minecraft account to their Discord account using a simple PIN code. Once linked, any lore they send to the bot—either in a direct message or a server channel—gets stored in their personal lore queue. In the game, holding an item and opening the GUI with /dlore gui displays all queued lore snippets. A single click applies the selected lore to the held item, complete with name, color codes, and line breaks.
The linking process is straightforward. A player runs /dlore link in Minecraft, which generates a four-digit PIN. They then send that PIN to the Discord bot via DM. The bot automatically associates the Discord account with the Minecraft player, and from that moment on, any lore sent to the bot becomes available in the player’s queue. Multiple Minecraft accounts can be linked to the same Discord user, making it perfect for alt accounts or staff members managing several characters.
Setting Up the Bot on Your Server
To get started, you need to create a Discord bot through the Discord Developer Portal and obtain its token. Once you have the token, place the correct MCLoreChat jar file into your server’s plugins folder. After starting the server, run /dlore token [your_token] and then /dlore start. The bot will come online and provide an invite link so you can add it to your Discord server. Even if the bot is in a public channel, only players who have successfully linked their accounts can use the lore features, keeping the system secure.
Managing plugins like this is much simpler when you use a modern launcher. For instance, you can easily install MCLoreChat via the foxygame.net launcher, a convenient and flexible Minecraft launcher that lets you download mods and plugins right from its menu. This approach saves time and keeps your server setup organized without hunting for files across different sites.
Commands and Permissions at a Glance
The plugin comes with a clear set of commands and permissions, giving server admins full control over who can use each feature. Here is a breakdown of the main commands available in version 2.0:
- /dlore help – Displays detailed information about all Discord Lore commands.
- /dlore link – Generates a PIN to link your Minecraft account with Discord.
- /dlore gui – Opens the interactive lore queue GUI to apply lore to the held item.
- /dlore set – Instantly applies your latest queued lore to the item you are holding, bypassing the GUI.
- /dlore send – Sends the lore of the held item to the Discord bot, complete with color codes and formatting.
- /dlore clear – Empties your entire lore queue.
- /dlore token [token] – Sets the Discord bot token (admin only).
- /dlore start – Starts the bot (admin only).
- /dlore stop – Stops the bot (admin only).
Permissions are granular, allowing you to grant access to specific functions. The main permission nodes include:
- mclore.* – Wildcard permission for all MCLoreBot commands.
- mclore.start – Permission to start the bot.
- mclore.stop – Permission to stop the bot.
- mclore.token – Permission to set the bot token.
- mclore.link – Permission to link an account.
- mclore.gui – Permission to open the lore GUI.
- mclore.clear – Permission to clear the lore queue.
- mclore.set – Permission to apply lore directly.
- mclore.dlore – Permission to use the base /dlore command.
- mclore.send – Permission to send lore to Discord.
Mastering Lore Formatting
Writing lore for MCLoreChat is intuitive once you understand a few simple rules. In version 2.0, you can write entire paragraphs without repeating color codes on every line. Start the first line with a color code like &2, and all subsequent lines automatically inherit that color until you specify a new one. For example:
Name:&2Another Example
>&d This lore only has one colour code per paragraph and only indicates it at the start.
>&eThough you can still change it &bmid-sentence&e!
The > symbol followed by a color code sets the color for the entire paragraph. You can still insert mid-sentence color changes as needed. Line breaks are created simply by starting a new line in your Discord message. For version 2.2 and Minecraft 1.21+, you can also use the break:[number] syntax to automatically insert line breaks after a certain character count, ignoring color codes and never splitting words.
To send lore from Discord to the game, right-click the message, select Apps, and then choose "Queue as Lore." The bot confirms the action, and the lore appears in your GUI. To reverse the process, hold an item in Minecraft and type /dlore send. The bot will DM you the item’s current lore with all formatting intact, ready for editing.
Legacy Version 1.0: A Simpler Approach
The original 1.0 version of MCLoreChat works on older Spigot versions (1.12–1.15.2) and uses a designated Discord channel. Commands like !LoreAdd [playername] [item] and !Lorehand directly modify items. The !Lorehand command overwrites the lore and name of whatever item the player is holding, while !LoreAdd can insert a new item into the player’s inventory. The in-game command /sendlore exports the held item’s lore to the channel. Configuration is done via a config file where you set the bot token and channel name. This version is still functional for servers that prefer a channel-based workflow without the GUI.
Why MCLoreChat Transforms Server Lore Management
For roleplay servers, adventure maps, or any community that relies heavily on custom items, MCLoreChat eliminates the friction of lore editing. Staff members can collaborate on item descriptions in Discord, preview changes, and apply them instantly without logging in and out or using clunky in-game editors. The lore queue acts as a clipboard history, letting you store multiple snippets and apply them as needed. The ability to send lore back to Discord means you can archive, share, or tweak existing items effortlessly.
Server owners also benefit from the clear permission system, which prevents abuse while allowing trusted players to enhance their own gear. The open-source nature of the plugin means you can adapt it to unique server mechanics or integrate it with other systems.
Final Thoughts
MCLoreChat is more than just a convenience tool—it redefines how Minecraft servers handle item lore. By connecting the flexibility of Discord with the precision of in-game commands, it turns a traditionally cumbersome task into a smooth, collaborative process. Whether you choose the modern 2.0 version with its GUI and queue system or the straightforward 1.0 channel-based approach, your server’s storytelling potential expands dramatically. Setting up the bot takes only a few minutes, and once players link their accounts, the creative possibilities are endless. If you have ever spent too long typing color codes or fixing broken line breaks, this plugin is the upgrade your server deserves.