Skip to main content
Version: Beta⚠️

PlaceHolderAPI

plugin needed

To follow this tutorial, you must have the PlaceHolderAPI installed.

Use PlaceHolderAPI's Placeholders​

If you want to expand your story with PlaceHolderAPI's placeholders, you can do that by checking if the PlaceHolderAPI icon is placed above the text box (see image):

PlaceHolderAPI Icon

By just using the PlaceHolderAPI's format, you can make them work. For example, %player_name% would give the name of a player.

Not working

If placeholders are not working, make sure you have the placeholder installed. For instance, with %player_name%, you must have installed player via the PlaceHolderAPI ecloud. To do this, just run: /papi ecloud install player.

Use TypeWriter's Placeholders​

TypeWriter provides two placeholders for use with the PlaceHolderAPI:

  • %typewriter_entryid%
  • %typewriter_entryname%

Both placeholders provide the same information, but you may choose to access them in different ways. It's generally recommended to use the entry ID for more reliable results, but the entry name is also an option.

To find the entry ID, refer to the following image:

PlaceHolderAPI Icon

Your placeholder for TypeWriter would be something like %typewriter_W2X2ZbG0pzXGsS6%.
Then, when calling the placeholder, it checks the ID and:

  • If their entry is a speaker, it gives the displayName back.
  • If their entry is a fact, it gives the fact value back.
  • If the entry is a sound, it gives the ID of the resource pack sound.
  • If the entry is a entity, it gives the displayName of the entity
  • If the entry is a lines entry, it gives the content of the lines entry.
  • If the entry is a quest, it gives the displayName of the quest.
  • If the entry is a objective, it gives the formatted displayName of the objective.
  • If the entry is a sidebar, it gives the title of the sidebar.

Custom placeholders​

Typewriter also has 2 custom placeholders, these are:

  • %typewriter_tracked_quest%: Shows the displayName of the currently tracked quest.
  • %typewriter_tracked_objectives%: Shows the objectives displayNames for the active objectives of the tracked quest.