# SlimefunCore 4.0 — Minecraft 26.x Release 🚀
## What's New
### 🎮 Minecraft 26.x Support
SlimefunCore now **exclusively targets Minecraft 26.x** — the new generation of Minecraft using the modern `year.drop.hotfix` versioning scheme.
- ✅ **Minecraft 26.1** (March 2026)
- ✅ **Minecraft 26.1.1 / 26.1.2** (April 2026 hotfix)
- ✅ **Minecraft 26.2 "Chaos Cubed"** (June 2026 — current stable)
- ✅ **Future-proof** — automatically compatible with 26.3+ and beyond via open-ended version matching
> **Note:** Minecraft 1.21.x support has been fully dropped. This is a clean replacement, not multi-version.
---
### 🗄️ New Storage & Database System
A completely redesigned storage backend that replaces the legacy flat-file system:
- **Modern database architecture** — scalable and reliable data persistence
- **Multi-backend support** — flexible storage options for servers of all sizes
- **Improved data integrity** — safer block data, player profile, and inventory handling
- **Seamless migration** — existing world data is automatically converted on first load
#### New Storage Commands (`/sf storage`)
Administer and monitor the database directly in-game:
- `/sf storage info` — View current provider, connection status, ping, and connection pool size
- `/sf storage stats` — View cache statistics (hit rate, entries, evictions)
- `/sf storage status` — One-line health summary
- `/sf storage verify` — Run a schema integrity check to find missing columns/tables
- `/sf storage repair` — Automatically repair missing schema columns
- `/sf storage cache clear` — Invalidate cached data for online players
- `/sf storage backup [create|list|restore|delete|verify]` — Fully integrated database backup manager
---
### ☕ Java 25 Support
Built and tested against **JDK 25** (Eclipse Adoptium) — fully compatible with the latest Java runtime.
---
### 🔧 Paper 26.x API Modernization
Under-the-hood updates to align with the latest Paper API:
- Migrated to **Component-based events** (Adventure API)
- Adopted **`DamageSource` builder** for modern damage events
- Switched to **`Registry.BIOME`** lookups (replacing deprecated `Biome.valueOf`)
- Updated potion system to **`setBasePotionType`** (replacing removed `PotionData`)
- Modernized **WorldEdit & mcMMO** integration hooks
---
## Requirements
| Requirement | Version |
|---|---|
| Minecraft | **26.1+** (any 26.x release) |
| Server | **Paper 26.x** (or forks: Purpur, Folia, etc.) |
| Java | **21+** (25 recommended) |
---
## Installation
1. Download the JAR from this page
2. Drop it into your server's `plugins/` folder
3. Restart your server
---
## Setting up the New Database System
By default, Slimefun 4.0 uses the familiar `legacy` file-based system to ensure backward compatibility and prevent unexpected migrations. To switch to the new database system, follow these steps:
1. **Stop your server.**
2. Open `plugins/Slimefun/database.yml` in your text editor.
3. Change the `provider` setting from `legacy` to your preferred database type (e.g., `sqlite`, `mysql`, `mariadb`, `postgresql`).
- For `sqlite`, no additional configuration is needed.
- For `mysql`/`mariadb`/`postgresql`, fill in the host, port, username, and password in the same file.
4. **Start your server.**
5. Slimefun will automatically connect to the database, initialize the tables, and seamlessly migrate your existing world data on the first load!
---
> **⚠️ Breaking Change:** This release does NOT support Minecraft 1.21.x or earlier. If you're running an older server, stay on the previous release.
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }