# 黑曜石
一个旨在简化 Paper 插件开发的 API
[](https://modrinth.com/plugin/obsidiancore)
[](https://hangar.papermc.io/devadri/Obsidian)
# 信息
这个 API 旨在简化 Paper 插件的开发，
提供许多实用工具，让你的生活（和我）更轻松。
虽然提供了一个独立的插件版本，但建议将此 API 阴影到你的
插件中，因为这个 API 经常变化，并且独立的版本可能会导致
如果服务器所有者安装了依赖于此 API 不同版本的插件，则可能出现问题。
> ❗ 要使用此 API/插件，你需要 Java 17+。 如果你使用的是较低版本，请考虑升级
> ⚠️ 为了与仍然使用 Spigot 映射的 Paper 衍生版本保持兼容，你需要将你的插件设置为使用 Spigot 映射。
> 更多信息请参见 [PaperMC 文档](https://docs.papermc.io/paper/dev/project-setup/#plugin-remapping)
> ⚠️ 官方仅支持 Minecraft 1.17 或更高版本。 低于 1.17 的版本将不提供任何支持。
### 它主要用于我的插件，但如果你想，也可以在你的插件中使用它，请务必给予适当的信誉！
# 如何导入
## Gradle
````kotlin
repositories {
maven {
name = "devadri"
url = uri("https://repo.devadri.es/repository/releases") // 使用 dev 仓库进行 Beta 构建
}
}
dependencies {
implementation("me.devadri:obsidian:{VERSION}") // 将 {VERSION} 替换为所需的版本
}
````
## Maven
```xml
devadri
https://repo.devadri.es/repository/releases
me.devadri
obsidian
{VERSION}
```
# 鸣谢
- 感谢 [Byteflux](https://github.com/Byteflux) 和 [AlessioDP](https://github.com/AlessioDP)
创建了 [Libby](https://github.com/AlessioDP/libby/tree/gradle) 库，该库用于在运行时管理
依赖项。
- 感谢 [CryptoMorin](https://github.com/CryptoMorin) 创建了 [XSeries](https://github.com/CryptoMorin/XSeries) 库，
该库用于保持与 Minecraft 较旧和较新版本之间的兼容性，因为 ID 和 API 在
不同版本之间可能会发生变化。
