安装与更新
安装
确保你使用了Bukkit/ Spigot 服务端核心。你可以在这里找到有关服务端搭建的更多信息:https://www.spigotmc.org/wiki/spigot/ 需要注意的是,插件一开始是设计与 CraftBukkit(或相似的 Spigot)一同使用的。Bukkit 的 API 缺少了一些插件正常运行的必要内容。这表示其他服务端核心(Tekkit、Forge 等)不兼容此插件。
其他 CraftBukkit 或 Spigot 改版/分支可能兼容,但不会受到官方支持。如果你在使用这些核心运行本插件时遇到问题,请先通过安装最新版的 Spigot 核心来排除服务端本身的问题。
在这里下载最新版的 Shopkeepers:https://dev.bukkit.org/projects/shopkeepers/files 每个发行版都会标注其支持的 Bukkit/Minecraft 版本。
关闭服务器。将
Shopkeeper.jar
放入服务器的plugins
文件夹。之后重启服务器。检查控制台日志是否存在报错,确保一切正常工作。
安装成功后,你可能需要进行一些额外设置。
- 可选:本插件将会在
Shopkeepers
文件夹下生成一个config.yml
。这里有一些你可以自行调整的选项。你可以阅读配置文件章节了解更多。 - 可选:如果你安装了权限管理插件,你可能需要将对应权限分配给玩家和管理组成员。你可以阅读权限章节了解更多。
- 一切准备妥当之后,你就可以着手创建商店了!
- 如果你遇到了问题(或者有其他想问的),那么阅读常见问题章节。
文件夹结构
本插件会在服务器的插件目录下创建存储文件夹:<服务端路径>/plugins/Shopkeepers/
整个文件夹结构会像这样:
Ruby
../plugins/ # 服务的插件文件夹
+--Shopkeepers/ # 插件的存储文件夹
|-- config.yml # 配置文件
+-- data/
|-- save.yml # 已保存的商店数据 (商店, 交易记录, ..)
|-- save.yml.tmp # 临时文件, 仅在保存插件数据时短暂存在
+-- lang/
|-- language-en-default.yml # 默认的语言文件, 无法修改, 用作其他语言的模板
|-- # 额外的语言文件 (可选)
+-- trade-logs/
|-- # CSV 交易记录文件 (如果配置文件启用了交易日志)
更新
大多数情况下,更新本插件只需关闭服务器、替换 Shopkeepers.jar,然后重启服务器。
不过,为确保问题不会出现,建议按照如下步骤进行更新:
- 阅读自当前安装版本至最新版所有更新的更新日志。有些时候这些日志包含了潜在问题与迁移指导。如果你正在从远古版本迁移至新版,你甚至可能需要从插件初次发布的日志读起,因为最新版不一定能支持从你安装的版本迁移数据。
- 备份本插件的文件夹,防止数据丢失。
- 有些时候默认的配置文件会发生变化,新的设置会生成而旧设置会被删除。检查更新日志来确认任何需要手动迁移的配置选项。如果你遇到了可能会删除配置文件的情况,请让插件先生成一份默认文件,然后对着它将旧版配置逐一应用。