Installation and Updating

安装

1. 请确认你正在运行 受支持的 Bukkit / Spigot 服务器核心 最新版. 你可以在此处找到有关服务器设置的更多信息: https://www.spigotmc.org/wiki/spigot/ 请注意插件基于CraftBukkit构建(或Spigot). Bukkit缺少让插件正常工作的必要API. 这代表 其他服务端 (Tekkit, Forge, 以及其他.) 将不能运行此插件. 其他 CraftBukkit 或 Spigot 衍生物/分支 _可能_可以运行, 但它们不在我的技术支持范围内. 所以如果你运行这些服务端时遇到问题, 请先尝试能否在最新版Spigot服务端上重现该问题.
2. 从这里 下载 最新版的Shopkeepers: https://dev.bukkit.org/projects/shopkeepers/files 每一个正式更新都有写明支持的 Bukkit / Minecraft 版本.
3. 关闭服务器. 将下载的 Shopkeepers.jar 拖入服务器的插件文件夹. 重启服务器.
4. 检查服务器的日志看是否出现问题, 然后检查所有东西都在正常工作.

安装成功后你可能想要进行一些自定义化操作:

• Shopkeepers 将会在其文件夹中创建一个 config.yml 文件. 有很多个配置选项供你自定义化Shopkeepers. 前往 配置文件 | Configuration 页面来查阅更多信息.
• 如果你使用了某款权限插件, 你可能希望给你的玩家和管理员分配他们需要的权限节点. 前往 权限 | Permissions 页面来查阅更多信息.
• 当你配置好所有东西后你就可以开始 创建商店 | Creating Shops 了!
• 当你运行时遇到问题 (或者有其他想问的问题), 可以看看 常见问题 | Frequently Asked Questions 页面.

目录结构

Shopkeepers 将在服务器的插件文件中创建其插件文件夹: <服务器目录>/plugins/Shopkeepers/

整个目录结构如下所示:

../plugins/ # 服务器的插件文件夹
    +--Shopkeepers/ # 插件文件夹
        |-- config.yml # 配置选项及提示信息
        |-- save.yml # 已保存的Shopkeeepers商店信息 (商店, 交易项, ..)
        |-- # 其他语言文件 (可选项)

升级

通常情况下只需关闭服务器 -> 替换 Shopkeepers.jar 文件 -> 重启服务器即可完成大多数Shopkeepers更新.

然而, 为了防止出现问题，你在更新时应该始终遵循这些步骤:

1. 阅读你所安装版本之后 所有更新日志. 有时更新日志会包含有关潜在问题和迁移数据的说明. 如果你从一个非常古老的版本更新到新版, 当最新版不再支持从你安装的版本迁移数据时甚至可能需要先更新为两者之间的较新版.

2. 备份 更新前的Shopkeeper插件文件夹, 以防数据丢失.

3. 有时配置选项会出现改动, 比如添加新的配置选项或者删除旧配置选项. 查看更新日志以寻找 配置文件迁移 需要进行哪些手动操作. 如果运行时遇到问题, 先尝试删除(记得备份)配置文件, 使插件在下次启动时重新创建默认配置文件, 然后重新配置一遍配置选项.