# BSLib First Snapshot Release: Modernizing Minecraft Plugin Development<\/p>\n
I GAVE UP ON THIS LIBBARY IT’S GETTING TO COMPLICATED!!<\/p>\n
We are thrilled to announce the first snapshot release of **BSLib**, a powerful and comprehensive framework designed to revolutionize the way you develop plugins for Minecraft Paper servers. BSLib aims to eliminate boilerplate code, streamline development workflows, and introduce modern reactive programming paradigms to the Minecraft ecosystem.<\/p>\n
DOCUMENTATION<\/p>\n
## Why BSLib?<\/p>\n
BSLib is built on the principle of **state-driven development**, allowing you to define your plugin’s logic and UI in a declarative manner. This means less time wrestling with manual updates and more time focusing on innovative features. Key highlights include:<\/p>\n
* **Reactive UI**: Create dynamic and responsive GUIs, scoreboards, and other in-game elements that automatically update when your data changes, similar to modern web frameworks.
\n* **Zero-Boilerplate Setup**: With `@AutoScan` and `FrameworkPlugin`, BSLib handles dependency injection, command registration, event listening, and configuration loading automatically, significantly reducing setup time.
\n* **Robust Asynchronous Operations**: Safely manage complex asynchronous tasks with `AsyncChain`, preventing common concurrency issues and ensuring smooth server performance.
\n* **Declarative Command System**: Define commands and subcommands using simple annotations, complete with automatic tab completion and permission handling.
\n* **Flexible State Persistence**: Easily save and load plugin data to YAML or JSON with automatic dirty tracking and configurable autosave intervals.
\n* **Live Reload Capabilities**: Update plugin configurations and re-inject services without a full server restart, drastically speeding up your development cycle.<\/p>\n
## Getting Started<\/p>\n
To integrate BSLib into your project, you need to declare a dependency on the `BSLib-paper` plugin in your `plugin.yml` file and add the BSLib library dependency to your build configuration. Replace `LATEST_SNAPSHOT_TAG` with the actual latest commit hash or release tag from the BSLib GitHub repository.<\/p>\n
### Plugin Dependency (plugin.yml)<\/p>\n
For your plugin to correctly utilize BSLib-paper, you **must** declare it as a dependency in your `plugin.yml` file. This ensures that BSLib-paper is loaded before your plugin and its services are available.<\/p>\n
“`yaml
\nname: YourPluginName
\nversion: 1.0.0
\nmain: com.yourplugin.YourPluginMainClass
\nauthor: YourName
\ndepend: [BSLib]
\n“`<\/p>\n
Alternatively, if your plugin can function with reduced features when BSLib is not present, you can use `softdepend` instead of `depend`.<\/p>\n
“`yaml
\nname: YourPluginName
\nversion: 1.0.0
\nmain: com.yourplugin.YourPluginMainClass
\nauthor: YourName
\nsoftdepend: [BSLib]
\n“`<\/p>\n
### Library Dependency (Build System)<\/p>\n
### Gradle (Groovy DSL)<\/p>\n
**Step 1. Add the JitPack repository to your `settings.gradle`:**<\/p>\n
“`groovy
\ndependencyResolutionManagement {
\n repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
\n repositories {
\n mavenCentral()
\n maven { url ‘https:\/\/jitpack.io’ }
\n }
\n}
\n“`<\/p>\n
**Step 2. Add the dependency to your `build.gradle`:**<\/p>\n
“`groovy
\n\tdependencies {
\n\t implementation ‘com.github.Fragmer2.BSLib:bslib-api:7a5257256f’
\n\t}
\n“`<\/p>\n
### Gradle (Kotlin DSL)<\/p>\n
**Step 1. Add the JitPack repository to your `settings.gradle.kts`:**<\/p>\n
“`kotlin
\ndependencyResolutionManagement {
\n repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
\n repositories {
\n mavenCentral()
\n maven { url = uri(“https:\/\/jitpack.io”) }
\n }
\n}
\n“`<\/p>\n
**Step 2. Add the dependency to your `build.gradle.kts`:**<\/p>\n
“`kotlin
\n\tdependencies {
\n\t implementation(“com.github.Fragmer2.BSLib:bslib-api:7a5257256f”)
\n\t}
\n“`<\/p>\n
### Maven<\/p>\n
**Step 1. Add the JitPack repository to your `pom.xml`:**<\/p>\n
“`xml **Step 2. Add the dependency to your `pom.xml`:**<\/p>\n “`xml ### SBT<\/p>\n **Step 1. Add the JitPack resolver to your `build.sbt`:**<\/p>\n “`scala **Step 2. Add the dependency to your `build.sbt`:**<\/p>\n “`scala ### Leiningen<\/p>\n **Step 1. Add the JitPack repository to your `project.clj`:**<\/p>\n “`clojure **Step 2. Add the dependency to your `project.clj`:**<\/p>\n “`clojure ## Feedback and Contributions<\/p>\n This is an early snapshot, and we highly encourage you to experiment with BSLib and provide your valuable feedback. Your input will be crucial in shaping the future development of this framework. Please report any issues or suggest features on the GitHub repository.<\/p>\n Thank you for being a part of the BSLib journey!<\/p>\n","protected":false},"excerpt":{"rendered":" BSLib Library aims to eliminate boilerplate code, streamline development workflows, and introduce modern reactive programming paradigms to the Minecraft ecosystem.<\/p>\n","protected":false},"featured_media":35182,"template":"","meta":{"_minecraft_slug":"bslib","_minecraft_project_id":"8U9ZLiYg","_minecraft_author":"bogdan6736","_minecraft_license":"Apache-2.0","_minecraft_downloads":27,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bslib.zip","_minecraft_size_bytes":212578,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:16:19.764412Z","_minecraft_date_created":"2026-02-25T01:51:35.047363Z","_minecraft_date_modified":"2026-02-24T02:05:15.344702Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bslib","_minecraft_icon_attachment_id":35182,"_minecraft_imported_at":"2026-06-01T17:00:25+00:00","_minecraft_import_hash":"0385d028884fdd6b2a5190783d14cba5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,873,126,90,127,128,129,91,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[36,94,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-35181","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-library","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20-1","minecraft_version-1-20-4","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n
\n
\n
\n
\n <\/repository>
\n<\/repositories>
\n“`<\/p>\n
\n\t
\n\t
\n\t
\n\t
\n\t<\/dependency>
\n“`<\/p>\n
\nresolvers += “jitpack” at “https:\/\/jitpack.io”
\n“`<\/p>\n
\n\tlibraryDependencies += “com.github.Fragmer2.BSLib” % “bslib-api” % “7a5257256f”
\n“`<\/p>\n
\n:repositories [[“jitpack” “https:\/\/jitpack.io”]]
\n“`<\/p>\n
\n\t:dependencies [[com.github.Fragmer2.BSLib\/bslib-api “7a5257256f”]]
\n“`<\/p>\n