详细版教程
这一节是给完全没有配置经验的人写的。不需要懂代码,不需要懂 YAML,不需要提前了解任何名词。
这个插件到底在做什么
一句话:它能让玩家在世界里看到一个箱子,走过去右键就能开出奖励,但这个箱子实际上并不存在。
"并不存在"是这个插件最重要的特点。你可以把它理解成一种障眼法:
- 服务器并没有真的在那个位置放一个箱子
- 服务器只是给玩家的游戏客户端发了一条消息,说"你那个位置有个箱子"
- 于是玩家的屏幕上就出现了一个箱子
- 别的玩家如果没有收到这条消息,就什么都看不到
这样做有几个好处:不会破坏你的地图存档,不会被玩家用工具挖走,每个玩家可以看到属于自己的那一份宝箱,互相不抢。
阅读顺序
建议按这个顺序看,每一节都建立在前一节的基础上:
| 顺序 | 页面 | 你会学到 |
|---|---|---|
| 1 | 名词解释 | 看懂后面所有内容需要的词汇 |
| 2 | 第一个宝箱 | 从装插件到玩家能开箱的完整流程 |
| 3 | 宝箱长什么样 | 换成陷阱箱、末影箱、自定义头颅 |
| 4 | 宝箱出现在哪里 | 固定刷新点和随机刷新点怎么配 |
| 5 | 奖励怎么配 | 概率、数量、显示效果 |
| 6 | 要钥匙才能开 | 让玩家必须拿着特定物品才能开箱 |
| 7 | 出问题了怎么办 | 按症状对照的排查手册 |
需要准备什么
- 一个 1.12.2 或更高版本的服务端(Spigot、Paper 都可以)
- 能编辑服务器上文件的方式(FTP、面板的文件管理器、或者直接本地开服)
- 一个文本编辑器,推荐 VSCode 或 Notepad++,不要用 Windows 自带的记事本
为什么不要用记事本
Windows 记事本容易把文件存成带 BOM 的编码,或者把缩进弄乱,这两种情况都会让插件读不懂你的配置。VSCode、Notepad++、Sublime 这类编辑器都没有这个问题。
一个心理准备
这个插件的配置文件用的是 YAML 格式。YAML 有一个非常严格的规矩:
缩进必须用空格,不能用 Tab 键,而且同一层级的缩进必须完全对齐。
绝大多数"我照着抄了但是不生效"的问题,最后都是缩进错了。后面每个示例都会标注缩进关系,照着抄的时候留意一下就行。
遇到问题的通用办法
不管出什么问题,先做这两件事,能解决大部分情况:
- 在游戏里或控制台执行
/tsl debug,开启调试模式,插件会把它每一步在做什么都打印出来 - 看服务器控制台有没有黄色或红色的报错,插件的提示都以
[Treasure]开头
具体的症状对照表在 出问题了怎么办。
想快速查配置项?
这一节是教程,讲的是"怎么做"和"为什么"。如果你已经熟悉插件,只想查某个配置项的取值和默认值,去 配置文件 那一页,那里是按文件组织的参考手册。