将 地理寻宝 带入你的 Minecraft 服务器!
此插件允许玩家在服务器周围隐藏和寻找 Minecache(或“Cache”),同时允许管理员进行管控。
开发者注意:在 v0.3.1.0 之后,artifact id 现在为 minecaching,而非 Minecaching!
开发者注意:部分 API 内容已移至新插件 RDSCommons!
RDSCommons 是一个用于 Minecaching 及未来插件共享代码的新插件。
有关更多信息,请参阅 面向开发者 / 迁移至 RDSCommons!
面向服务器所有者:
安装
你可以在 这里 找到 Minecaching 的最新版本。
Minecaching 还需要一个依赖插件 RDSCommons,你可以在 这里 找到它。
服务器所有者可以在配置文件中控制许多设置,例如缓存放置的限制、允许的缓存类型等。
操作员拥有某些命令的访问权限,例如 /verify,并且可以(默认情况下)绕过 /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 将 Minecaching 添加到你的项目中。
添加为依赖项
快照 (Snapshots):
<repository>
<id>dumaven-snapshots</id>
<name>Digitalunderworlds Maven Snapshots</name>
<url>https://maven.digitalunderworlds.com/snapshots</url>
</repository>
发布版 (Releases):
<repository>
<id>dumaven-releases</id>
<name>Digitalunderworlds Maven Releases</name>
<url>https://maven.digitalunderworlds.com/releases</url>
</repository>
然后,
<dependency>
<groupId>net.realdarkstudios</groupId>
<artifactId>minecaching</artifactId>
<version>0.4.0.0-snapshot-24w13a</version>
</dependency>
你可以在此处查看版本 here
注意:只有完整版本发布(如 0.2.0.7)可在 Releases maven 中获取。
如果你想能够使用任何版本(包括发布版),请选择 Snapshot 仓库!
迁移至 RDSCommons
在 0.4.0.0 版本中,创建了一个新插件(RDSCommons)来保存 Minecaching 及未来项目所需的共享代码。
要开始使用 RDSCommons,你需要更新至版本 Snapshot 24w13a 或更高版本。
然后,添加以下依赖项,并将 (version) 替换为你所需的最小版本:
<dependency>
<groupId>net.realdarkstudios</groupId>
<artifactId>rdscommons</artifactId>
<version>[(version), 1.0.99999.0)</version>
<scope>provided</scope>
</dependency>
变更摘要:
- 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 中)
注册本地化配置:
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
- 以及其他更多更改
Bring Geocaching to your Minecraft server!
This plugin allows players to hide and find Minecaches (or "Caches") around the server while allowing operators to manage it.
DEVELOPERS: After v0.3.1.0, the artifact id is now minecaching, not Minecaching!
DEVELOPERS: Some API stuff has moved to a new plugin, RDSCommons!
RDSCommons is a new plugin for shared code across Minecaching and future plugins.
See For Developers / Transferring To RDSCommons for more information!
For Server Owners:
Installation
You can find the latest version of Minecaching here.
Minecaching also requires a dependency plugin, RDSCommons, which you can find here.
Server owners can control many things, such as restrictions on where the caches are placed, the types of allowed caches, and more in the config!
Operators have access to certain commands, such as /verify and can (by default) bypass /delete and /edit checks.
For non-english servers, you should change the language in plugins\Minecaching\config.yml.
In there you can also find many other options, such as changing the /mcstats scoring, configuring auto-updates, and more.
You can also change some config values in-game by using /mca conf
Permission Nodes
| Permission Node |
Who has it by default? |
| minecaching.* |
Nobody |
| 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 |
Everyone |
| minecaching.command.delete |
Everyone |
| minecaching.command.disable |
OP |
| minecaching.command.edit |
Everyone |
| minecaching.command.hint |
Everyone |
| minecaching.command.list |
Everyone |
| minecaching.command.locate |
Everyone |
| minecaching.command.log |
Everyone |
| minecaching.command.logbook |
Everyone |
| minecaching.command.maintainer |
Everyone |
| minecaching.command.publish |
OP |
| minecaching.command.stats |
Everyone |
| minecaching.misc.* |
OP |
For Developers:
You can use the Digitalunderworlds Maven to add Minecaching to your project
Adding as a dependency
Snapshots:
<repository>
<id>dumaven-snapshots</id>
<name>Digitalunderworlds Maven Snapshots</name>
<url>https://maven.digitalunderworlds.com/snapshots</url>
</repository>
Releases:
<repository>
<id>dumaven-releases</id>
<name>Digitalunderworlds Maven Releases</name>
<url>https://maven.digitalunderworlds.com/releases</url>
</repository>
Then,
<dependency>
<groupId>net.realdarkstudios</groupId>
<artifactId>minecaching</artifactId>
<version>0.4.0.0-snapshot-24w13a</version>
</dependency>
You can view versions here
NOTE: Only full version releases (such as 0.2.0.7) are available in the Releases maven.
If you want to be able to use ANY version, including releases, pick the Snapshot repository!
Transferring to RDSCommons
With 0.4.0.0, a new plugin (RDSCommons) was created to hold shared code for Minecaching and future projects.
To start using RDSCommons, you will need to update to version Snapshot 24w13a or above.
Then, add this dependency, replacing (version) with the minimum version you require:
<dependency>
<groupId>net.realdarkstudios</groupId>
<artifactId>rdscommons</artifactId>
<version>[(version), 1.0.99999.0)</version>
<scope>provided</scope>
</dependency>
Changes Summary:
- 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 (some keys are instead in commons.util.MessageKeys)
Registering A Localization:
import net.realdarkstudios.minecaching.api.Minecaching;
import net.realdarkstudios.minecaching.api.MinecachingAPI;
import net.realdarkstudios.minecaching.api.misc.Config;
// OLD IMPORTS
import net.realdarkstudios.minecaching.api.misc.LocalizationProvider;
import net.realdarkstudios.minecaching.api.misc.Localization;
// NEW IMPORTS
import net.realdarkstudios.commons.CommonsAPI;
import net.realdarkstudios.commons.util.LocalizationProvider;
import net.realdarkstudios.commons.util.Localization;
@Override
public void onEnable() {
Localization exampleLocalization;
// OLD
exampleLocalization = MinecachingAPI.getLocalizationProvider().load(Minecaching.getInstance());
// NEW
exampleLocalization = CommonsAPI.get().registerLocalization(Minecaching.getInstance(), Config.getInstance().getServerLocale());
}
MCMessages was also removed. Please switch over to LocalizedMessages.
You may also implement IRDSPlugin in your main plugin class to be compliant for any plugin requesting your Version information
You can see the full changelog message below:
Snapshot 24w13a Changelog
Added:
- MAVEN SOURCES + JAVADOCS to (hopefully) all future Minecaching releases
- MCMessageKeys.Command.Stats.NONE
- MinecachingAPI#getCommonsAPI
Removed:
- MinecachingAPI#getConfigDataVersion
- MinecachingAPI#getMinecacheDataVersion
- MinecachingAPI#getPlayerDataVersion
- MinecachingAPI#getLogbookDataVersion
- MinecachingAPI#tInfo(String, Object...)
- MinecachingAPI#tWarning(String, Object...)
- (ALL CLASSES BELOW ARE IN RDSCommons)
- AutoUpdater
- BaseEvent
- BooleanMenuItem
- CancellableBaseEvent
- CloseMenuItem
- ErrorMenuItem
- GoBackMenuItem
- Localization
- LocalizationProvider
- MCMenu
- MCMenuHolder
- MenuItem
- MenuItemClickEvent
- MenuItemState
- MultiStateMenuItem
- PaginationMenu
- PaginationMenuItem
- PaginationPageItem
- RefreshPaginationMenuItem
- SkullMenuItem
- TextComponentBuilder
Refactors:
- MessageKeys -> MCMessageKeys
Changes:
- (BUGFIX) Added checks if there are 0 caches (caused issues with adding caches and stats)
- Switched over to RDSCommons
- UUID check is now in PlayerDataObject#update
- RDSCommons dependency
- MinecachingAPI#getLogger now returns an RDSLogHelper
- And more
评论 0
登录后参与评分
还没有评论,来抢沙发吧