BSLib

插件

· 作者 bogdan6736

BSLib Library 旨在消除样板代码,简化开发流程,并将现代响应式编程范式引入 Minecraft 生态。

0 本站下载 0 关注 更新于 8 个月前

最新 1.0.0-SNAPSHOT · 1.21.11 · Bukkit / Paper

一键开服(送7天)

BSLib 首个快照版本发布:现代化 Minecraft 插件开发

我放弃了这个库,它变得太复杂了!!

我们很高兴地宣布 BSLib 的首个快照版本发布。BSLib 是一个强大且全面的框架,旨在彻底改变您在 Minecraft Paper 服务器上开发插件的方式。BSLib 致力于消除样板代码,简化开发工作流程,并将现代响应式编程范式引入 Minecraft 生态系统。

文档

为什么选择 BSLib?

BSLib 基于 状态驱动开发 的原则构建,允许您以声明式方式定义插件的逻辑和 UI。这意味着您可以减少在手动更新上花费的时间,而将更多时间专注于创新功能。主要亮点包括:

  • 响应式 UI:创建动态且响应式的 GUI、记分板和其他游戏内元素,当您的数据发生变化时,它们会自动更新,类似于现代 Web 框架。
  • 零样板设置:通过 @AutoScan 和 FrameworkPlugin,BSLib 自动处理依赖注入、命令注册、事件监听和配置加载,显著减少了设置时间。
  • 强大的异步操作:使用 AsyncChain 安全地管理复杂的异步任务,防止常见的并发问题并确保服务器性能流畅。
  • 声明式命令系统:使用简单的注解定义命令和子命令,并附带自动补全和权限处理功能。
  • 灵活的状态持久化:轻松将插件数据保存到 YAML 或 JSON,具备自动脏数据跟踪和可配置的自动保存间隔。
  • 热重载功能:无需完全重启服务器即可更新插件配置并重新注入服务,极大地加快了您的开发周期。

快速开始

要将 BSLib 集成到您的项目中,您需要在 plugin.yml 文件中声明对 BSLib-paper 插件的依赖,并在构建配置中添加 BSLib 库的依赖项。请将 LATEST_SNAPSHOT_TAG 替换为 BSLib GitHub 仓库中实际的最新提交哈希值或发布标签。

插件依赖 (plugin.yml)

为了使您的插件能够正确使用 BSLib-paper,您 必须 在 plugin.yml 文件中将其声明为依赖项。这确保了 BSLib-paper 会在您的插件之前加载,并且其服务可用。

name: YourPluginName
version: 1.0.0
main: com.yourplugin.YourPluginMainClass
author: YourName
depend: [BSLib]

或者,如果您的插件在没有 BSLib 的情况下仍能运行(尽管功能可能受限),您可以使用 softdepend 代替 depend。

name: YourPluginName
version: 1.0.0
main: com.yourplugin.YourPluginMainClass
author: YourName
softdepend: [BSLib]

库依赖 (构建系统)

Gradle (Groovy DSL)

步骤 1. 在您的 settings.gradle 中添加 JitPack 仓库:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

步骤 2. 在您的 build.gradle 中添加依赖:

	dependencies {
	        implementation 'com.github.Fragmer2.BSLib:bslib-api:7a5257256f'
	}

Gradle (Kotlin DSL)

步骤 1. 在您的 settings.gradle.kts 中添加 JitPack 仓库:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        mavenCentral()
        maven { url = uri("https://jitpack.io") }
    }
}

步骤 2. 在您的 build.gradle.kts 中添加依赖:

	dependencies {
	        implementation("com.github.Fragmer2.BSLib:bslib-api:7a5257256f")
	}

Maven

步骤 1. 在您的 pom.xml 中添加 JitPack 仓库:

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

步骤 2. 在您的 pom.xml 中添加依赖:

	<dependency>
	    <groupId>com.github.Fragmer2.BSLib</groupId>
	    <artifactId>bslib-api</artifactId>
	    <version>7a5257256f</version>
	</dependency>

SBT

步骤 1. 在您的 build.sbt 中添加 JitPack 解析器:

resolvers += "jitpack" at "https://jitpack.io"

步骤 2. 在您的 build.sbt 中添加依赖:

	libraryDependencies += "com.github.Fragmer2.BSLib" % "bslib-api" % "7a5257256f"	

Leiningen

步骤 1. 在您的 project.clj 中添加 JitPack 仓库:

:repositories [["jitpack" "https://jitpack.io"]]

步骤 2. 在您的 project.clj 中添加依赖:

	:dependencies [[com.github.Fragmer2.BSLib/bslib-api "7a5257256f"]]	

反馈与贡献

这是一个早期的快照版本,我们非常鼓励您尝试使用 BSLib 并提供宝贵的反馈。您的意见对于塑造该框架的未来发展至关重要。请在 GitHub 仓库中报告任何问题或建议新功能。

感谢您成为 BSLib 旅程的一部分!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源