2.6

docs/mcguide/28-电脑网络游戏/课程4：常见第三方库教程/30-Vault/1-Vault介绍.md

@@ -0,0 +1,16 @@
+---
+front:
+hard: 入门
+time: 5分钟
+---
+
+# Vault介绍
+
+`Vault` 插件是一个关于权限、聊天以及经济插件的前置插件，他能让这些插件快速地与 `Vault` 插件挂钩而不需要依赖于其他个别插件。
+多数关于注册和权限的前置插件配置过于繁琐且缺乏大部分功能，于是这个插件便诞生了。
+`Vault` 插件可以通过更加直观明了的方式解决这些问题，并为这些插件提供他们可能所需要的支持与依赖服务。
+
+> Vault虽然能够通过API管控经济方面的特性，但是他本身不存在任何存储功能
+
+[Vault的JavaDocs](https://milkbowl.github.io/VaultAPI/)
+

docs/mcguide/28-电脑网络游戏/课程4：常见第三方库教程/30-Vault/2-接入Vault.md

@@ -0,0 +1,154 @@
+---
+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;
+    }
+}
+```