Writing a Custom Splash Text File (Step by Step)
Understanding Custom Splash Texts in Minecraft
Custom splash texts offer a unique way to personalize your Minecraft experience, allowing you to display your own messages on the game’s title screen. These custom messages are integrated into the game through resource packs, a fundamental system for modifying various aspects of Minecraft’s appearance and sounds. The process differs slightly between Minecraft Java Edition and Minecraft Bedrock Edition, primarily concerning the file formats and folder structures involved.
![]()
Key Mechanics of Splash Text Implementation
At the core of custom splash texts is the resource pack system. For Minecraft Java Edition, splash texts are housed within a plain text file named splashes.txt. Conversely, Minecraft Bedrock Edition utilizes a JSON file named splashes.json for the same purpose. These files must reside within a very specific hierarchical folder structure inside your resource pack to be recognized by the game.
- For Minecraft Java Edition, the required path within the resource pack is
assets/minecraft/texts/. Yoursplashes.txtfile will be placed directly into thistextsfolder. Each individual splash text you wish to display should occupy its own line within thesplashes.txtfile. - For Minecraft Bedrock Edition, the
splashes.jsonfile is typically located within the resource pack’s main directory, though its exact placement can vary slightly depending on the pack’s overall structure. Crucially, Bedrock Edition resource packs also necessitate amanifest.jsonfile to define the pack’s properties. Thesplashes.jsonfile in Bedrock Edition stores splash texts as string elements within a JSON array. It also supports a special parameter,"canMerge", which determines whether your custom splash texts will appear alongside the game’s default vanilla splashes. Formatting codes, such as those using the§symbol for color, are supported in Bedrock Edition splash texts.
Regardless of the edition, for your custom splash texts to appear, the resource pack containing them must be actively selected and enabled within Minecraft’s options menu. The game then randomly selects one of the available splash texts, whether vanilla or custom, to display on the title screen.
Step-by-Step Process for Creating a Custom Splash Text Resource Pack
Creating your custom splash text resource pack involves a series of structured steps to ensure proper functionality and recognition by Minecraft. Follow these instructions carefully:
1. Establish a Working Folder
Begin by creating a dedicated, empty folder on your computer. This will serve as the root directory for your resource pack. A descriptive name, such as “Custom Splash Pack” or “My Splash Texts,” is recommended for easy identification.
2. Set Up the Folder Structure
Inside your newly created working folder, you must meticulously recreate the specific directory path required by Minecraft. This structure is critical for the game to locate your custom files:
- First, create a folder named
assets. - Inside the
assetsfolder, create another folder namedminecraft. - Finally, inside the
minecraftfolder, create a folder namedtexts.
The complete path from your main working folder should now resemble YourWorkingFolder/assets/minecraft/texts/.
3. Create the Splash Text File
The next step is to create the file that will contain your custom splash messages:
- For Minecraft Java Edition: Navigate into the
textsfolder and create a new text file namedsplashes.txt. Open this file with a plain text editor. On each new line, type one of your desired custom splash messages. For example:Hello, Minecraft!My custom splash!Enjoy the game!
- For Minecraft Bedrock Edition: In your resource pack’s main working folder (not inside
assets/minecraft/texts/unless specified by a complex pack structure, usually it’s at the root or a subfolder liketexts/directly under the pack root), create a new file namedsplashes.json. This file must contain a JSON array of strings. Additionally, remember that Bedrock resource packs require amanifest.jsonfile in the root of the pack. An examplesplashes.jsonstructure would be:[ "Bedrock Splash One!", "Another custom splash for Bedrock.", "§cRed Bedrock Splash!" ]You can also include the
"canMerge"parameter within the JSON structure to control interaction with vanilla splashes. For example, to allow merging:{ "splashes": [ "Bedrock Splash One!", "Another custom splash for Bedrock.", "§cRed Bedrock Splash!" ], "canMerge": true }Ensure proper JSON syntax with curly brackets, square brackets, and commas as needed.
4. Create pack.mcmeta
This critical file defines your resource pack’s properties for Minecraft Java Edition. Create a new text file named pack.mcmeta in the root of your main working folder (e.g., YourWorkingFolder/pack.mcmeta). The content should be in JSON format:
{
"pack": {
"pack_format": 15,
"description": "My Awesome Custom Splashes"
}
}
The pack_format number must correspond to your Minecraft version. The description can be any text you wish to display in the resource pack selection menu.
5. Add pack.png (Optional)
For a visual identifier, you can include a custom icon for your resource pack. Create a 128×128 pixel PNG image and name it pack.png. Place this file in the root of your main working folder, alongside pack.mcmeta.
6. Compress the Resource Pack
Once all files are in place, you need to package your resource pack:
- For Minecraft Java Edition: Select all the contents within your main working folder (e.g., the
assetsfolder,pack.mcmeta, andpack.png) and compress them into a standard ZIP archive. - For Minecraft Bedrock Edition: Similarly, zip the contents of your main working folder. After zipping, rename the
.zipfile extension to.mcpack. This special extension allows Bedrock to directly install the pack.
7. Install the Resource Pack
Open Minecraft and navigate to the “Options” menu. From there, select “Resource Packs.” You will see a button labeled “Open Pack Folder” (or similar). Click this button, which will open the directory where Minecraft expects to find resource packs. Drag your newly created .zip (Java) or .mcpack (Bedrock) file into this folder.
8. Activate the Resource Pack
Return to the Minecraft resource pack menu. Your custom pack should now appear in the list of “Available Resource Packs.” Click the arrow or button next to your pack’s icon to move it to the “Selected Resource Packs” column. Ensure your custom pack is above any other packs that might also modify splash texts if you want yours to take precedence.
9. Reload Minecraft
After activating the pack, the changes might not immediately display. For Minecraft Java Edition, often entering and then exiting a game world, or restarting the entire Minecraft client, is necessary for the new splash texts to appear. For Bedrock, returning to the main menu after activation is usually sufficient.
Important Tips for Success
- Text Editor for Encoding: When editing
splashes.txtfor Java Edition, use a text editor that supports UTF-8 without a Byte Order Mark (BOM), such as Notepad++. This prevents the inclusion of invisible characters that can cause display issues. - JSON Formatting: For Bedrock’s
splashes.json, absolute precision in JSON formatting is crucial. Ensure all curly brackets{}, square brackets[], and commas are correctly placed and balanced. pack_formatVersion: Thepack_formatvalue inpack.mcmetamust be updated to match the specific version of Minecraft Java Edition you are playing. Outdated formats may prevent the pack from loading.- Multiple Splashes: You can add as many custom splash texts as you like. They will be randomly selected by the game on startup.
- Bedrock
"canMerge": In Bedrock Edition, if you want your custom splashes to appear alongside the game’s default splashes, ensure you set"canMerge": truewithin yoursplashes.jsonfile.
Common Mistakes to Avoid
Several pitfalls can prevent your custom splash texts from working correctly:
- Incorrect File Encoding: Using an editor that adds a BOM to
splashes.txtcan result in garbled text on screen, often appearing as “ZWN BSP” or strange arrow characters. Always use UTF-8 without BOM. - Hidden File Extensions: Ensure your operating system is configured to show file name extensions. Otherwise, you might inadvertently name files like
pack.mcmeta.txtinstead of the correctpack.mcmeta. - Improper Folder Structure: Any deviation from the exact
assets/minecraft/texts/path for Java Edition, or incorrect placement for Bedrock files, will cause the resource pack to fail to load or recognize the splash texts. - Forgetting to Activate: The resource pack must be moved from the “Available” to the “Selected” column in Minecraft’s resource pack menu.
- Not Reloading Minecraft: Changes often require a game reload, entering and exiting a world, or a full restart of the client to take effect.
- Incorrect JSON Syntax: For Bedrock’s
splashes.json, even a single misplaced comma or bracket will render the file unreadable to the game. - Bedrock
.mcpackRenaming: For Bedrock Edition, failing to rename the zipped folder to an.mcpackfile will prevent it from being easily installed and recognized. - Modifying
minecraft.jar: A common but outdated and unsupported method is to manually modify the game’s core files. Always use the resource pack system for custom content to avoid game corruption and compatibility issues.
By following this comprehensive guide and paying attention to the specific requirements for your Minecraft edition, you can successfully create and implement your own custom splash texts, adding a personal touch to your game’s title screen.