# Placeholders

You can use a placeholder with [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) to show the remaining countdown duration of a chest.

There are 2 available placeholder formats:

*  `%treasurechests_countdown_digital_<chest-id>%`
  * This will appear like **03:47:23**

    
* `%treasurechests_countdown_cozy_<chest-id>%`
  * This will appear like **3h 47m 23s**

    

 ![](https://s3.eu-west-3.amazonaws.com/guflimc-outline/uploads/0ccbeec6-617c-4986-be81-0c4264a71364/6682fbde-b768-4265-9a4d-c661827f4e12/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA36KVU76QO4JLROPB%2F20260916%2Feu-west-3%2Fs3%2Faws4_request&X-Amz-Date=20260916T070000Z&X-Amz-Expires=86400&X-Amz-Signature=2f5a6b0ec3b0d97a5b1d01f5e0952ee3bb5008018db27f438ce394e4660cb9cd&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =493x473")

 ![](https://s3.eu-west-3.amazonaws.com/guflimc-outline/uploads/0ccbeec6-617c-4986-be81-0c4264a71364/b7da0a4f-2ddd-473b-8af1-e5e954dfe94e/treasurechests.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA36KVU76QO4JLROPB%2F20260916%2Feu-west-3%2Fs3%2Faws4_request&X-Amz-Date=20260916T070000Z&X-Amz-Expires=86400&X-Amz-Signature=3d84c93ca0764d6938e933952259a29ed18f566c9c2c33b70a3b27daa72fb575&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =493x355")


Because chest ids are pretty long, you can also put the first few characters. For example with the chest in the image you can put `%treasurechests_countdown_b9f71%`. If multiple chest ids start with the same prefix, you should make the prefix longer to prevent conflicts.

---

**Documents**

- [Getting started](https://wiki.guflimc.com/s/treasurechests/doc/getting-started-bn2XsW8ASS)
- [Configuration](https://wiki.guflimc.com/s/treasurechests/doc/configuration-9zucuUu8bL)
- [Placeholders](https://wiki.guflimc.com/s/treasurechests/doc/placeholders-rz04TWhwjR)