---
# System prepended metadata

title: PlaceHolder API變數教學
tags: [Plugins, Minecraft]

---

---
tags: Minecraft,Plugins
title: PlaceHolder API變數教學
author: Youzi#0753(856918496893599805)
---

# 插件：PlaceHolder API變數教學
###### 撰寫於(2022/01/27)

###### tags: `Minecraft` `Plugins`
> 由 <img src="https://images-ext-2.discordapp.net/external/ERVAyNrVJfgmbzcYNcPC95Ynrq1SQ3V1TRVFAkezM5Y/https/cdn.discordapp.com/avatars/856918496893599805/89d9fe477d93364a8d8a7ad3e88fba0b.png?width=20&height=20">**Youzi#0753** 撰寫
支援伺服器：[<img src="https://discordapp.com/api/guilds/540630552609554453/widget.png?style=shield" alt="">](https://discord.gg/Vq3F8DUNzf)

:::danger
插件不可使用`/reload` 來重載插件喔！
請使用`/papi reload` 來讀取變數！
:::
:::warning
如果你不知道甚麼是[Placeholder API](https://www.spigotmc.org/resources/placeholderapi.6245/)了話，請參閱：[維基Wiki](https://github.com/PlaceholderAPI)
:::
:::info
在這裡，我們將會用 "PAPI" 代表 **P**l**a**ceHolder A**PI** 的簡寫喔！
要使用變數，請使用 ``%變數名稱%`` 才能顯示出來喔！
:::


---

## 主要目錄
:::info
我們將會學到：
- [ ] 1. Ecloud
- [ ] 2. 插件內建
- [ ] 3. 複合格式
:::



---

## 1. Ecloud
:::info
[點我](https://api.extendedclip.com/all/) 前往ecloud變數大全

![](https://i.imgur.com/Gsal0XF.png)
:::
這裡有著許多的認證變數，像是我在 [DiscordSRV進階教學](/ACx_d743ReySwRQGsN2dlA) 中提到過`Player`、`Server`等這些變數都是在這裡可以找得到的，我們將以 `Server` 來當作範例：
### 1. 下載(這是基本)
> 輸入 `/papi ecloud download 變數名稱 (版本)` 來下載變數，其中(版本) 可以不須填寫，默認為下載最新版本。
> ![](https://i.imgur.com/khrs2PX.png)
> ![](https://i.imgur.com/8xT0yWc.png) <- 當時的最新版本

> 當你下載完成後，輸入 `/papi reload` 即可完成安裝！
> ![](https://i.imgur.com/BcSaR3u.png)
> ![](https://i.imgur.com/he5NLAX.png)
### 2. 使用
>找到[`Server`](https://api.extendedclip.com/expansions/server/) 變數，打開，右邊會有很多的變數，例如：`%server_name%`，你可以將這東西放在像是 記分板、TAB玩家列表等地方！
> ![](https://i.imgur.com/Elv3csw.png)
> 
> 例如這樣：
> ![](https://i.imgur.com/AETlSl6.png)

### 3. 修改
> 但是你會看到的並不是如同你想像的......要從Placeholder 的config檔案變更！
> 因為這個設定檔案因人而異，所以這邊我們無法使用程式框來表示 :/
> `plugins/PlaceholderAPI/config.yml`
> ![](https://i.imgur.com/KAJjQXU.png)
> ![](https://i.imgur.com/7DA2aJh.png)


---
## 2. 插件內建
這個部分個人覺得有點難說明，我也有在 [DiscordSRV進階教學](/ACx_d743ReySwRQGsN2dlA) 曾經講過，插件是可以跟插件互相支持的，所有支持的插件&可用的變數：[這裡](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders)

## 3. 複合格式
我們用[`Progress`](https://github.com/aBooDyy/Progress-Expansion)&[`Playerlist`](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders#playerlist)來說明：
> 一般來說變數的格式長這樣：%變數名稱%
> 但是有些可能長這樣：%變數名稱,內容,...%/%變數名稱_<數值>%
> 像是這種的我們在這邊都是稱為複合格式

> ![](https://i.imgur.com/S039kpP.png)
> ![](https://i.imgur.com/LLS2i68.png)
> 估計看說明也就眼花了吧www
> 主要這些都是以PAPI官方的說明為主，可能會因為時間的推移而導致部分的格式改變，所以我們這邊就不再多說明了


## 總結：
> 這可能是我最簡短的教學...或許哪一天我會自己發明一個PAPI?
##### 也順便祝我生日快樂！owo