Skip to content
iPlugin

Placeholder types

Understand the differences between action, int, text and other placeholders

Kether statement references often show syntax like this:

location {action} {action} {action} {action} [and {action} {action}]
subtitle {action} [by {int} {int} {int}]

This chapter explains what each placeholder means and how to fill it in.

For a more complete statement reference, see Kether Explorer - TabooLib.

Placeholder types

Different placeholders expect different kinds of values:

PlaceholderMeaningExamples
{action}An action that executes or evaluates to a valueinline "xxx", &money, player location
{text}Text, usually a quoted string"Hello"
{int}An integer100, 5, 0
{double}A decimal number1.5, 0.5
{condition}An action that returns true or falsecheck money >= 100, perm "xxx"

Check the expected type at each position before writing the statement.


{action} — an expression that produces a value

{action} expects an expression that executes and returns a result, rather than only a hard-coded value.

Possible values:

  • inline "{{ sender }}" — resolve a string.
  • &money — read the variable containing the current amount of money.
  • player location — get the player's location.
  • check money >= 100 — return true or false.
  • sender — get the current player's name.

For example:

subtitle {action}

Here, {action} needs to produce the subtitle text. You could supply:

  • "A fixed subtitle" — a literal string.
  • inline "Subtitle for {{ sender }}" — a string with an embedded expression.
  • &subtitle_var — a string stored in a variable.

{text} — text

{text} expects text, usually a literal string wrapped in quotation marks.

Examples:

tell {text}
tell "Hello"
tell inline "{{ sender }} completed the quest"

When the syntax for tell shows {text}, you can supply "Hello" directly or use inline "..." to produce the text.


{int} / {double} — numbers

{int} means an integer. {double} means a decimal number.

Example:

subtitle {action} [by {int} {int} {int}]

The three placeholders after by usually specify fade-in, stay and fade-out durations in ticks. Supply integers, for example:

title "Main title" subtitle "Subtitle" by 10 40 10

Coordinates in a location statement use {action} or {double}. For example:

location world 0 100 0

Here, 0, 100 and 0 are literal numbers.


{condition} — true or false

{condition} expects an action that returns true or false.

Common choices:

  • check money >= 100 — compare values.
  • perm "myplugin.vip" — check a permission.

Examples:

if {condition} then {action} [else {action}]
if check money >= 100 then { tell "You have enough money" }
if perm "myplugin.admin" then { give diamond 1 }

How to choose the right type

  1. Read the syntax. The documentation or statement list identifies each position with a type such as {action}, {int} or {text}.

  2. Consider what the value represents.

    • A value that must be evaluated → usually {action}.
    • Fixed text → usually {text} or a quoted string.
    • A number → {int} or {double}.
    • A true-or-false decision → {condition}.
  3. Check the complete reference. If you are unsure, use Kether Explorer to look up the full syntax and placeholder descriptions.

Understanding the expected type before filling in a placeholder helps avoid mistakes.