154 lines
4.7 KiB
Markdown
154 lines
4.7 KiB
Markdown
---
|
||
front:
|
||
hard: 入门
|
||
time: 10分钟
|
||
---
|
||
|
||
# 接入Vault
|
||
|
||
本篇教程针对 `Vault 1.7` 为蓝本进行教学，版本不一致时可作为参考，然后查阅相关开发API进行调整
|
||
|
||
## 引入库到本地项目
|
||
|
||
在你可以实际使用 `Vault` ，你首先需要将第三方库通过 Gradle 或者 Maven 导入到你的本地项目
|
||
您可以使用下方仓库进行引入
|
||
|
||
### Maven
|
||
|
||
```xml
|
||
<repositories>
|
||
<repository>
|
||
<id>jitpack.io</id>
|
||
<url>https://jitpack.io</url>
|
||
</repository>
|
||
</repositories>
|
||
<dependencies>
|
||
<dependency>
|
||
<groupId>com.github.MilkBowl</groupId>
|
||
<artifactId>VaultAPI</artifactId>
|
||
<version>1.7</version>
|
||
<scope>provided</scope>
|
||
</dependency>
|
||
</dependencies>
|
||
```
|
||
|
||
### Gradle
|
||
```kotlin
|
||
repositories {
|
||
maven {
|
||
url 'https://jitpack.io'
|
||
}
|
||
}
|
||
dependencies {
|
||
compileOnly "com.github.MilkBowl:VaultAPI:1.7"
|
||
}
|
||
```
|
||
|
||
## 实现 Vault
|
||
|
||
通过一个简单的例子，从而快速了解如何获得 经济、权限、聊天 Service
|
||
|
||
```java
|
||
package com.example.plugin;
|
||
|
||
import net.milkbowl.vault.chat.Chat;
|
||
import net.milkbowl.vault.economy.Economy;
|
||
import net.milkbowl.vault.economy.EconomyResponse;
|
||
import net.milkbowl.vault.permission.Permission;
|
||
|
||
import org.bukkit.command.Command;
|
||
import org.bukkit.command.CommandSender;
|
||
import org.bukkit.entity.Player;
|
||
import org.bukkit.plugin.RegisteredServiceProvider;
|
||
import org.bukkit.plugin.java.JavaPlugin;
|
||
|
||
public class ExamplePlugin extends JavaPlugin {
|
||
|
||
private static Economy econ = null;
|
||
private static Permission perms = null;
|
||
private static Chat chat = null;
|
||
|
||
@Override
|
||
public void onDisable() {
|
||
getLogger().info(String.format("[%s] Disabled Version %s", getDescription().getName(), getDescription().getVersion()));
|
||
}
|
||
|
||
@Override
|
||
public void onEnable() {
|
||
if (!setupEconomy() ) {
|
||
getLogger().severe(String.format("[%s] - Disabled due to no Vault dependency found!", getDescription().getName()));
|
||
getServer().getPluginManager().disablePlugin(this);
|
||
return;
|
||
}
|
||
setupPermissions();
|
||
setupChat();
|
||
}
|
||
|
||
private boolean setupEconomy() {
|
||
if (getServer().getPluginManager().getPlugin("Vault") == null) {
|
||
return false;
|
||
}
|
||
RegisteredServiceProvider<Economy> rsp = getServer().getServicesManager().getRegistration(Economy.class);
|
||
if (rsp == null) {
|
||
return false;
|
||
}
|
||
econ = rsp.getProvider();
|
||
return econ != null;
|
||
}
|
||
|
||
private boolean setupChat() {
|
||
RegisteredServiceProvider<Chat> rsp = getServer().getServicesManager().getRegistration(Chat.class);
|
||
chat = rsp.getProvider();
|
||
return chat != null;
|
||
}
|
||
|
||
private boolean setupPermissions() {
|
||
RegisteredServiceProvider<Permission> rsp = getServer().getServicesManager().getRegistration(Permission.class);
|
||
perms = rsp.getProvider();
|
||
return perms != null;
|
||
}
|
||
|
||
public boolean onCommand(CommandSender sender, Command command, String commandLabel, String[] args) {
|
||
if(!(sender instanceof Player)) {
|
||
getLogger().info("Only players are supported for this Example Plugin, but you should not do this!!!");
|
||
return true;
|
||
}
|
||
|
||
Player player = (Player) sender;
|
||
|
||
if(command.getLabel().equals("test-economy")) {
|
||
// Lets give the player 1.05 currency (note that SOME economic plugins require rounding!)
|
||
sender.sendMessage(String.format("You have %s", econ.format(econ.getBalance(player.getName()))));
|
||
EconomyResponse r = econ.depositPlayer(player, 1.05);
|
||
if(r.transactionSuccess()) {
|
||
sender.sendMessage(String.format("You were given %s and now have %s", econ.format(r.amount), econ.format(r.balance)));
|
||
} else {
|
||
sender.sendMessage(String.format("An error occured: %s", r.errorMessage));
|
||
}
|
||
return true;
|
||
} else if(command.getLabel().equals("test-permission")) {
|
||
// Lets test if user has the node "example.plugin.awesome" to determine if they are awesome or just suck
|
||
if(perms.has(player, "example.plugin.awesome")) {
|
||
sender.sendMessage("You are awesome!");
|
||
} else {
|
||
sender.sendMessage("You suck!");
|
||
}
|
||
return true;
|
||
} else {
|
||
return false;
|
||
}
|
||
}
|
||
|
||
public static Economy getEconomy() {
|
||
return econ;
|
||
}
|
||
|
||
public static Permission getPermissions() {
|
||
return perms;
|
||
}
|
||
|
||
public static Chat getChat() {
|
||
return chat;
|
||
}
|
||
}
|
||
``` |