跳到主要内容

详细版教程

这一节是给完全没有配置经验的人写的。不需要懂代码,不需要懂 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 键,而且同一层级的缩进必须完全对齐。

绝大多数"我照着抄了但是不生效"的问题,最后都是缩进错了。后面每个示例都会标注缩进关系,照着抄的时候留意一下就行。

遇到问题的通用办法​

不管出什么问题,先做这两件事,能解决大部分情况:

  1. 在游戏里或控制台执行 /tsl debug,开启调试模式,插件会把它每一步在做什么都打印出来
  2. 看服务器控制台有没有黄色或红色的报错,插件的提示都以 [Treasure] 开头

具体的症状对照表在 出问题了怎么办。

想快速查配置项?​

这一节是教程,讲的是"怎么做"和"为什么"。如果你已经熟悉插件,只想查某个配置项的取值和默认值,去 配置文件 那一页,那里是按文件组织的参考手册。