将[寻宝游戏](https://www.geocaching.com)带到你的Minecraft服务器！
这个插件允许玩家在服务器上隐藏和找到寻宝缓存（"Cache"），同时允许操作者管理它。
> 开发者：从v0.3.1.0开始，artifact id现在是`minecaching`，不再是`Minecaching`！
> 开发者：**一些API功能已迁移到新的插件，RDSCommons!**
>
> RDSCommons 是一个用于Minecaching和未来插件之间共享代码的新插件。
> 更多信息请参见`为开发者 / 迁移到RDSCommons`！
## 面向服务器所有者：
### 安装
你可以在[这里](https://modrinth.com/project/minecaching/)找到Minecaching的最新版本。
**Minecaching还需要一个依赖插件，RDSCommons，你可以在[这里](https://modrinth.com/project/rdscommons/)找到它。**
服务器所有者可以控制许多事情，例如对缓存放置位置的限制，允许的缓存类型等等，都在配置文件中。
操作员可以访问某些命令，例如`/verify`，并且默认情况下可以 (by default) 绕过`/delete`和`/edit`检查。
对于非英语服务器，你应该在`plugins\Minecaching\config.yml`中更改语言。
在其中你还可以找到许多其他选项，例如更改`/mcstats`计分、配置自动更新等等。
你还可以通过使用`/mca conf`在游戏中更改一些配置值。
### 权限节点
| 权限节点 |
默认谁拥有它？ |
| minecaching.* |
没有人 |
| minecaching.bypass.* |
OP |
| minecaching.bypass.delete_others |
OP |
| minecaching.bypass.edit_others |
OP |
| minecaching.admin.* |
OP |
| minecaching.admin.* |
OP |
| minecaching.admin.config |
OP |
| minecaching.admin.force_stat_update |
OP |
| minecaching.admin.reload |
OP |
| minecaching.admin.server_data |
OP |
| minecaching.command.* |
OP |
| minecaching.command.admin |
OP |
| minecaching.command.archive |
OP |
| minecaching.command.create |
所有人 |
| minecaching.command.delete |
所有人 |
| minecaching.command.disable |
OP |
| minecaching.command.edit |
所有人 |
| minecaching.command.hint |
所有人 |
| minecaching.command.list |
所有人 |
| minecaching.command.locate |
所有人 |
| minecaching.command.log |
所有人 |
| minecaching.command.logbook |
所有人 |
| minecaching.command.maintainer |
所有人 |
| minecaching.command.publish |
OP |
| minecaching.command.stats |
所有人 |
| minecaching.misc.* |
OP |
## 面向开发者：
你可以使用[Digitalunderworlds Maven](https://maven.digitalunderworlds.com)将Minecaching添加到你的项目
作为依赖项添加
#### 快照：
```xml
dumaven-snapshots
Digitalunderworlds Maven Snapshots
https://maven.digitalunderworlds.com/snapshots
```
#### 发布版：
```xml
dumaven-releases
Digitalunderworlds Maven Releases
https://maven.digitalunderworlds.com/releases
```
然后，
```xml
net.realdarkstudios
minecaching
0.4.0.0-snapshot-24w13a
```
你可以在[这里](https://maven.digitalunderworlds.com/#/snapshots/net/realdarkstudios/minecaching)查看版本
> 注意：只有完整的版本发布版（例如0.2.0.7）在发布版maven中可用。
> 如果你想能够使用任何版本，包括发布版，请选择快照仓库！
迁移到RDSCommons
从0.4.0.0开始，创建了一个新的插件（RDSCommons）来存储Minecaching和未来项目之间的共享代码。
要开始使用RDSCommons，你需要更新到快照版本24w13a或更高版本。
然后，添加此依赖项，将 (version) 替换为所需的最小版本：
```xml
net.realdarkstudios
rdscommons
[(version), 1.0.99999.0)
provided
```
#### 更改摘要：
- PACKAGE net.realdarkstudios.minecaching.api.menu.impl -> net.realdarkstudios.commons.menu
- minecaching.api.misc.AutoUpdater -> commons.util.AutoUpdater
- minecaching.api.misc.AutoUpdater.Version -> commons.util.Version
- minecaching.api.misc.Localization -> commons.util.Localization
- minecaching.api.misc.LocalizationProvider -> commons.util.LocalizationProvider
- minecaching.api.util.LocalizedMessages -> commons.util.LocalizedMessages
- minecaching.api.util.TextComponentBuilder -> commons.util.TextComponentBuilder
- minecaching.api.util.MessagesKeys -> minecaching.api.util.MCMessageKeys (一些键现在在 commons.util.MessageKeys 中)
**注册一个本地化**:
```java
import net.realdarkstudios.minecaching.api.Minecaching;
import net.realdarkstudios.minecaching.api.MinecachingAPI;
import net.realdarkstudios.minecaching.api.misc.Config;
// 旧的导入
import net.realdarkstudios.minecaching.api.misc.LocalizationProvider;
import net.realdarkstudios.minecaching.api.misc.Localization;
// 新的导入
import net.realdarkstudios.commons.CommonsAPI;
import net.realdarkstudios.commons.util.LocalizationProvider;
import net.realdarkstudios.commons.util.Localization;
@Override
public void onEnable() {
Localization exampleLocalization;
// 旧的方式
exampleLocalization = MinecachingAPI.getLocalizationProvider().load(Minecaching.getInstance());
// 新的方式
exampleLocalization = CommonsAPI.get().registerLocalization(Minecaching.getInstance(), Config.getInstance().getServerLocale());
}
```
`MCMessages` 也被删除了。请切换到 `LocalizedMessages`。
你也可以在你的主要插件类中实现 `IRDSPlugin`，以符合任何请求你的 `Version` 信息插件。
你可以在下面的更改日志信息中看到完整的更改日志：
快照 24w13a 更改日志
新增：
- MAVEN SOURCES + JAVADOCS，希望可以为所有未来版本的 Minecaching 提供
- MCMessageKeys.Command.Stats.NONE
- MinecachingAPI#getCommonsAPI
移除：
- MinecachingAPI#getConfigDataVersion
- MinecachingAPI#getMinecacheDataVersion
- MinecachingAPI#getPlayerDataVersion
- MinecachingAPI#getLogbookDataVersion
- MinecachingAPI#tInfo(String, Object...)
- MinecachingAPI#tWarning(String, Object...)
- (所有以下类都在 RDSCommons 中)
- AutoUpdater
- BaseEvent
- BooleanMenuItem
- CancellableBaseEvent
- CloseMenuItem
- ErrorMenuItem
- GoBackMenuItem
- Localization
- LocalizationProvider
- MCMenu
- MCMenuHolder
- MenuItem
- MenuItemClickEvent
- MenuItemState
- MultiStateMenuItem
- PaginationMenu
- PaginationMenuItem
- PaginationPageItem
- RefreshPaginationMenuItem
- SkullMenuItem
- TextComponentBuilder
重构：
- MessageKeys -> MCMessageKeys
更改:
- (BUGFIX) 添加了检查是否存在 0 个缓存（导致添加缓存和统计数据时出现问题）
- 已切换到 RDSCommons
- UUID 检查现在在 PlayerDataObject#update 中
- RDSCommons 依赖项
- MinecachingAPI#getLogger 现在返回 RDSLogHelper
- 更多
