> For the complete documentation index, see [llms.txt](https://beandocs.happyareabean.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://beandocs.happyareabean.cc/expansion/serverpinger/custom-dynamic.md).

# Custom Dynamic

📜 This pages contains all the information about Custom Dynamic.

{% hint style="info" %}
This feature has been added in v2.1+
{% endhint %}

## What is Custom Dynamic?

Custom Dynamic is a feature can let you decide which dynamic key you want to use.

**A brief explanation:** The difference between dynamic and custom dynamic is that different content can be designed for different scenarios.

For example, you want to display the server's online text, motd, and online/max player status at the same time. You only need to use a single placeholder to easily complete it through Custom Dynamic. The template you create can also be used unlimited times.

### Some example

Not using Custom Dynamic:

```yaml
%serverpinger_online_example.com:25565% | %serverpinger_motd_example.com:25565% | %serverpinger_players_example.com:25565%/%serverpinger_max_example.com:25565%
```

Using Custom Dynamic

```yaml
%serverpinger_dynamic_custom:exampletemplate_example.com:25565%
```

## How to use it?

The usage is very simple. You only need to use this placeholder format `%serverpinger_dynamic_custom:<template-name>_<IP:Port>%`

There is also a built-in example template called `example`, you can try it in your server too!

For instance you want to use the example template, you need to use this placeholder: `%serverpinger_dynamic_custom:example_mycoolserver.com:25565%`

It's very simple! Right?

## Create a Custom Dynamic

It is also easy to create a new custom dynamic template. You may need to follow an example configuration.

```yaml
  serverpinger:
    ...
    dynamic:
      ...
      custom:
        <template-name>: # The template name you want
          online: '&6&l<onlineplayers>/<max> &eplaying'
          offline: '&c&l[ OFFLINE ]'
```

### Note

* Please avoid for using `_` in your template name, it will cause problems.