Wiki 9Minecraft Titles Wiki
Titles WikiDocumentation › Adding Your Own Titles, Or Modifying Existing Ones

Adding Your Own Titles, Or Modifying Existing Ones

Datapack Basics

Going over how to use and create datapacks is beyond the scope of this wiki. However, here are two resources that will help make sense of them. The first is a tutorial on Youtube, and the second is instructions on how to create a datapack from the Minecraft wiki.

Template Datapack

1.16.x to 1.20.x

Modpack Makers

Titles are now added very similarly to advancements and recipes: each title requires its own json, and can be added, removed, or modified by using a data pack, and are located in a mod's "titles" folder. There is an example title json file available here: example json.

Mod Authors

Title jsons are now similar to advancement and recipe json, and can be added to your mod in a similar way. Make a "titles" folder inside your "data" folder. Then just begin adding title jsons to your "titles" folder (there is a link to the example json above).

Titles are still automatically rewarded through advancements, but if your mod wishes to reward titles through other objectives (such as quests), register them as usual with the "command" type, but you'll have to trigger the unlocking manually by using TitlesAPI.unlockTitle

1.12.x

There are two ways you can add your own titles. The options you have to add them depend on how you want them earned.

Title Archive

Under the titles config folder is an archive_titles.json file. Titles specified in this file are available to purchase with archive fragments (which are found as dungeon loot). The file has some titles defined by default, but feel free to remove them and add your own. Changing the json file is the only way to add archive titles at the moment. Unlockable Titles

You have two options with the usual way of earning titles. By far the simplest and easiest way is to make your own json file in the Titles config directory. Titles will read each json and load the titles listed. Titles also automatically unlocks titles attached to advancements. Alternative ways are listed below.

Mod Author

You can make a json named with your modid, put it in your resources, then copy it over to the Titles config directory. Or in your code you can go through the API.

If you are going to be unlocking titles through another method (such as quest rewards in a questing mod) you still have to register them with the API, but you will have to handle triggering them yourself. To do so, use TitlesAPI.addTitleToPlayer(player, titleKey)

Modpack Maker

If you want to make titles for mods that don't already have them, or working with Triumph, simply create a new json in the Titles config directory with the mod's modid and follow the format in the default minecraft.json and titles.json.

If they do already have json files, you can easily edit them to suit your needs.

NOTE: You will have to add you own resourcepack with a language file to translate the titles you will be making.

To unlock quest titles as a modpack maker, it is easiest for you to use to use the commands.

Complete Example

I have an advancement called "Spelunker". When I register it, Minecraft creates an advancement id. In this case it is titles:spelunker. There are two things you need to do with this in order to add a title.

Register your title

With code: Format: TitlesAPI.registerTitle(<modid>:<advancementId>, TitleInfo.TitleRarity.<rarity>) EX: TitlesAPI.registerTitle("titles:opulent", TitleInfo.TitleRarity.RARE);

With json:

{
   "COMMON": [
      "spelunker"
   ]
}

Add the proper entry to your lang file

Format: title.<modid>.<advancementId>=<title> EX: title.titles.spelunker=Spelunker