Skip to content

Commit

Permalink
vault & VaultUnlocked & ServiceIO
Browse files Browse the repository at this point in the history
  • Loading branch information
postyizhan committed Dec 14, 2024
1 parent ba60e16 commit 9b0a96d
Show file tree
Hide file tree
Showing 3 changed files with 148 additions and 18 deletions.
81 changes: 81 additions & 0 deletions docs-java/process/plugin/Front-Plugin/Vault/ServiceIO.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
---
title: ServiceIO
sidebar_position: 2
---

# ServiceIO

[![](https://img.shields.io/github/v/release/TheNextLvl-net/service-io)](https://github.com/TheNextLvl-net/service-io/releases)
[![](https://img.shields.io/github/languages/code-size/TheNextLvl-net/service-io)](https://github.com/TheNextLvl-net/service-io)
[![](https://img.shields.io/github/license/TheNextLvl-net/service-io)](https://github.com/TheNextLvl-net/service-io/blob/main/LICENSE)

一个现代的 Vault 替代品,旨在提供增强功能、更好性能和插件间无缝集成

:::tip

ServiceIO 仅支持 Paper 的最新版本(1.21+)

ServiceIO旨在作为 Vault 的全面替代,可以直接删除 Vault 插件,所有依赖 Vault 的现有插件将继续无缝与 ServiceIO 协同工作。

:::

## 为何选择ServiceIO?

ServiceIO是 VaultAPI 过时限制的前沿解决方案。尽管 Vault 仍然可用,但它依赖于已弃用和支持的代码,迫使开发者处理不安全的 null 接口,可能导致不稳定性与错误。

ServiceIO 通过提供强大的 null 标注、全面的文档和维护良好的源码解决了这些问题。此外,它支持异步数据加载和缓存结果,提升性能和扩展性。

ServiceIO 的一个关键特性是与现有 Vault 接口的无缝集成,允许插件同时使用两个 API,无需额外修改代码。这确保了平稳过渡,同时利用现代、可靠的平台优势。

此外,ServiceIO 支持不同插件间的数据转换,包括 banks, permissions, chat 和 groups。这消除了开发者编写自定义转换逻辑的需要,节省时间和精力。对于服务器所有者而言,这意味着更换插件比以往任何时候都更为顺畅,确保操作平稳且灵活,而无需手动迁移数据的烦恼。

## 命令

- /service convert banks:转换所有 banks 和 bank accounts
- /service convert chat:转换所有聊天数据(前缀、后缀、昵称等)
- /service convert economy:转换所有经济数据(账户和余额)
- /service convert groups:转换所有群组数据(群组、前缀、后缀、权限、成员)
- /service convert permissions:转换所有权限数据(用户、权限)

## 信息

- /service info bank: 查看已安装的 bank 提供插件
- /service info chat: 查看已安装的 chat 提供插件
- /service info economy: 查看已安装的经济提供插件
- /service info groups: 查看已安装的群组提供插件
- /service info permissions: 查看已安装的权提供插件

## 权限

- /service convert:需要 service.convert
- /service info:需要 service.info
- service.admin 权限允许访问所有 ServiceIO 命令
- 且 vault.admin 等同于 service.admin

## 链接

:::info

`Bukkit` https://dev.bukkit.org/projects/vault

`SpigotMC` https://www.spigotmc.org/resources/.34315

`MineBBS` https://www.minebbs.com/resources/.7869

`GitHub` https://github.com/milkbowl/Vault

`插件百科` https://github.com/milkbowl/Vault

`VaultUnlocked(Vault 增强版)` https://github.com/TheNewEconomy/VaultUnlocked

`ServiceIO(Vault 超级增强版,1.21+)` https://hangar.papermc.io/TheNextLvl/ServiceIO

:::

## 联系

[![](https://img.shields.io/discord/1293606111177609277?logo=discord&label=Discord)](https://thenextlvl.net/discord) <- 点击加入 作者的 Discord

Check failure on line 77 in docs-java/process/plugin/Front-Plugin/Vault/ServiceIO.md

View workflow job for this annotation

GitHub Actions / deploy

Line length

docs-java/process/plugin/Front-Plugin/Vault/ServiceIO.md:77:121 MD013/line-length Line length [Expected: 120; Actual: 136] https://github.com/DavidAnson/markdownlint/blob/v0.35.0/doc/md013.md

Check failure on line 77 in docs-java/process/plugin/Front-Plugin/Vault/ServiceIO.md

View workflow job for this annotation

GitHub Actions / deploy

Line length

docs-java/process/plugin/Front-Plugin/Vault/ServiceIO.md:77:121 MD013/line-length Line length [Expected: 120; Actual: 136] https://github.com/DavidAnson/markdownlint/blob/v0.35.0/doc/md013.md

Check failure on line 77 in docs-java/process/plugin/Front-Plugin/Vault/ServiceIO.md

View workflow job for this annotation

GitHub Actions / deploy

Line length

docs-java/process/plugin/Front-Plugin/Vault/ServiceIO.md:77:121 MD013/line-length Line length [Expected: 120; Actual: 136] https://github.com/DavidAnson/markdownlint/blob/v0.35.0/doc/md013.md

## Bstats

[![](https://bstats.org/signatures/bukkit/TheNextLvl%20ServiceIO.svg)](https://bstats.org/plugin/bukkit/TheNextLvl%20ServiceIO/23083)
62 changes: 62 additions & 0 deletions docs-java/process/plugin/Front-Plugin/Vault/VaultUnlocked.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
---
title: VaultUnlocked
sidebar_position: 1
---

# VaultUnlocked

Vault 的分支版本,提供更多功能

## 安装

`VaultUnlocked.jar` 放入 `plugins` 文件夹中,其余将自动处理。如果你想调整配置,可修改配置文件,但通常情况下并不需要。详情参阅 AdvancedConfiguration 部分。

## 功能

- 无需源代码集成:作为独立插件运作,只需引入 jar 文件即可。避免多个插件冲突,便捷集成。
- 广泛插件兼容:支持经济和权限类型的插件抽象层,提升兼容性。
- Freedom of Choice One of the best aspects of Bukkit is the freedom to choose what to use. More options benefit developers, so here’s to embracing choice!

Check failure on line 18 in docs-java/process/plugin/Front-Plugin/Vault/VaultUnlocked.md

View workflow job for this annotation

GitHub Actions / deploy

Line length

docs-java/process/plugin/Front-Plugin/Vault/VaultUnlocked.md:18:121 MD013/line-length Line length [Expected: 120; Actual: 155] https://github.com/DavidAnson/markdownlint/blob/v0.35.0/doc/md013.md

Check failure on line 18 in docs-java/process/plugin/Front-Plugin/Vault/VaultUnlocked.md

View workflow job for this annotation

GitHub Actions / deploy

Line length

docs-java/process/plugin/Front-Plugin/Vault/VaultUnlocked.md:18:121 MD013/line-length Line length [Expected: 120; Actual: 155] https://github.com/DavidAnson/markdownlint/blob/v0.35.0/doc/md013.md

Check failure on line 18 in docs-java/process/plugin/Front-Plugin/Vault/VaultUnlocked.md

View workflow job for this annotation

GitHub Actions / deploy

Line length

docs-java/process/plugin/Front-Plugin/Vault/VaultUnlocked.md:18:121 MD013/line-length Line length [Expected: 120; Actual: 155] https://github.com/DavidAnson/markdownlint/blob/v0.35.0/doc/md013.md

## 特性

- 多货币支持
- 更友好的 PR
- Folia 支持

## 权限

- vault.admin:拥有权限的玩家将收到更新提醒

## 链接

:::info

`Bukkit` https://dev.bukkit.org/projects/vault

`SpigotMC` https://www.spigotmc.org/resources/.117277

`Modrinth` https://modrinth.com/plugin/vaultunlocked

`MineBBS` https://www.minebbs.com/resources/.10014

`GitHub` https://github.com/TheNewEconomy/VaultUnlocked

:::

笨蛋镜像下载 [点击这里](https://dl.yizhan.wiki/plugins/VaultUnlocked-2.3.0.jar)

## 联系

[![](https://img.shields.io/badge/Discord-creatorfromhell-blue?logo=Discord)](https://discord.gg/WNdwzpy) <- 点击加入 作者的 Discord

## 开源许可

Copyright (C) 2024 Daniel "creatorfromhell" Vidmar

VaultUnlocked 是 GNU Lesser General Public License(GPLv3)的自由软件,可以重新分发和修改。更多信息请参考许可证。

www.gnu.org www.gnu.org

## Bstats

[![](https://bstats.org/signatures/bukkit/VaultUnlocked.svg)](https://bstats.org/plugin/bukkit/VaultUnlocked/22252)
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Vault
slug: Vault
sidebar_position: 2
---

Expand All @@ -9,15 +10,13 @@ sidebar_position: 2

`Bukkit` https://dev.bukkit.org/projects/vault

`SpigotMC` https://www.spigotmc.org/resources/.34315/
`SpigotMC` https://www.spigotmc.org/resources/.34315

`GitHub` https://github.com/milkbowl/Vault

`插件百科` https://github.com/milkbowl/Vault
`MineBBS` https://www.minebbs.com/resources/.7869

`VaultUnlocked(Vault 增强版)` https://github.com/TheNewEconomy/VaultUnlocked
`GitHub` https://github.com/milkbowl/Vault

`ServiceIO(Vault 超级增强版,1.21+)` https://hangar.papermc.io/TheNextLvl/ServiceIO
`插件百科` https://mineplugin.org/Vault

:::

Expand All @@ -36,15 +35,3 @@ sidebar_position: 2
人话:Vault只是提供经济的插件的前置,本身并不提供经济功能,就是给众多经济系统提供了一个统一接口

想要经济可以看看 [XConomy页面](XConomy.md)

### VaultUnlocked

VaultUnlocked 是 Vault 的分支版本,有多货币支持和 Folia 支持,[下载](https://github.com/TheNewEconomy/VaultUnlocked/releases/tag/2.3.0)

[下载镜像](https://dl.yizhan.wiki/plugins/VaultUnlocked-2.3.0.jar)

### ServiceIO

ServiceIO 是 Vault 的分支版本,支持 1.21 +, 无缝兼容 Vault,拥有更好的性能和更多的功能

[下载](https://hangar.papermc.io/TheNextLvl/ServiceIO) 非常强大

0 comments on commit 9b0a96d

Please sign in to comment.