# Build 2880

## Added

• Fixed-time backup schedules:** The checkpoint: and world-backup: sections in database.yml support a times list of UTC HH:mm values. For example, times: ["00:00", "06:00", "12:00", "18:00"] runs four times daily.
• A non-empty times list takes precedence over interval-hours; an empty list keeps the interval-based schedule. Times are polled once per minute, and each configured minute fires at most once.
• Optional world backups:** Minecraft world folders, including the overworld, nether, and end, can be backed up and restored through /sf checkpoint worlds. World archives are stored separately from regular checkpoints and use independent retention. This feature is disabled by default.
• World snapshot metadata:** Each snapshot contains worlds.zip and metadata.json, including a checksum, per-world file counts, and capture versions. Worlds are saved on the main thread, while ZIP compression runs off-thread. Volatile lock files such as session.lock and *.lock are excluded.
• World backup commands:** Available operations include worlds, worlds list, worlds create (admin), worlds info <id>, and worlds restore <id> confirm (console-only).
• World-backup configuration:** The world-backup section supports enabled and automatic (both default to false), interval-hours (default 6), keep (default 3), and worlds. An empty worlds list auto-detects the primary world and its _nether / _the_end companions.

## Changed

• Transactional storage restore:** applyPendingStorageRestore now uses same-filesystem renames instead of creating a full pre-restore snapshot. It moves the live block sections aside, extracts the staged archive into the empty data root, and restores the originals if the apply fails.
• Space-efficient rollback:** Rename-based rollback does not require extra disk space. If moving a section back still fails, the original remains in the scratch directory and its exact recovery path is logged. This replaces the earlier snapshot-ZIP rollback.
• Lag-tolerant scheduling:** Fixed-time jobs check the interval between the previous check and the current time, avoiding missed schedules when low server TPS delays polling. Large forward clock jumps trigger a job once rather than once for every missed day.
• Thread visibility:** Storage-engine task fields are now volatile to improve visibility between asynchronous schedulers and shutdown.
• Startup schedule status:** The storage banner shows the active schedule as either an interval, such as every 6h, or a list of UTC times.

## Fixed

• Storage restore rollback:** If a staged storage restore fails partway through, such as when the disk fills during replacement, the original data is restored. Failed staging data is also cleaned up.
• Apply storage restores during startup:** Restored block data is staged under <dataFolder>/storage-restore-pending/ and applied by CheckpointService.applyPendingStorageRestore(...) from Slimefun.onLoad(), before Slimefun loads block data into memory. This prevents shutdown from overwriting restored files with older in-memory state. A restart is required to apply the restore.
• Prevent partial combined restores:** If a both-scope restore stages storage but the database restore fails, the staged storage restore is discarded so it cannot apply on the next startup. The database portion is rolled back separately.
• Legacy sound configuration:** Existing sounds.yml files containing old Bukkit sound enum names are validated and translated to registry keys. Unknown values fall back to built-in defaults, preventing guide page-turn sound crashes on newer server versions.
• Deferred inventory cleanup:** Deferred inventories for destroyed blocks are removed, while entries for moved blocks are carried across with the block.
• Cleaner automatic error reporting:** Addon linkage errors and plugin enable/disable lifecycle failures are skipped because they recur on restart and are already logged to the console. Genuine runtime SEVERE errors continue to be reported.
• Daily report limit:** Automatic reports retain one-hour duplicate suppression and the 20-per-10-minute burst cap, with a new limit of two reports per rolling 24 hours. The counter resets on restart.

## Performance

• Cached block-storage snapshot:** BlockStorage.getRawStorage() now caches its snapshot and rebuilds it only when the block set changes, avoiding repeated full-map reconstruction and allocation overhead.
• Less cargo inventory copying:** Cargo hot paths read live-backed block states rather than deep-copying vanilla container state.
• Lower debug overhead:** Cargo filter and insert paths avoid allocating debug arguments while debug logging is disabled.
• Reusable item wrappers:** Cargo distribution reuses an ItemStackWrapper until the stack amount changes, reducing metadata cloning while preserving routing behavior.

## Notes

• Backup retention:** Checkpoint retention is controlled by checkpoint.max-checkpoints; world-backup retention uses world-backup.keep. A new backup is written and verified before the oldest backup is removed.
• Investigated — no behavior change:** Cargo item filtering and Woodcutter/Programmable android block placement were left unchanged because they were identified as real workload rather than avoidable waste. A proposed wrapper-hoisting optimization was reverted because it could change slot selection after a partial insert.

## Build 2872 — 2026-09-23

• Branch:** update/paper-26.0.x

Performance + stability pass based on Spark profiles from a busy production server. No cargo/android behavior changes.

### Fixed

• Sound crash:** Legacy sounds.yml Bukkit enum names are now migrated to valid namespaced sound keys.
• Deferred inventories:** Entries are now removed when blocks are destroyed and moved correctly when blocks move.
• Auto-reporter noise:** Skips addon linkage errors and plugin lifecycle failures.
• Daily reporter limit:** Maximum **2 automatic reports / rolling 24h** per server.

### Performance

• BlockStorage:** getRawStorage() now uses a lazy cached snapshot instead of rebuilding the entire world map every call.
• Cargo:** Avoids unnecessary tile-entity/container state copies on hot paths.
• Cargo filters:** Removes debug varargs allocations when debug logging is disabled.
• Cargo distribution:** Reuses ItemStackWrapper until the stack amount changes, avoiding unnecessary ItemMeta clones.

### Investigated

• Cargo filter routing and Woodcutter/Programmable Android ticking are legitimate workload; no safe optimization found without changing behavior.
• Reverted unsafe distributeItem wrapper hoist because it could freeze stack amounts and change machine slot selection.

• Result:** Lower allocations and server-thread overhead while preserving existing cargo, android, and machine behavior.

### 2870

• Optimized BlockStorage#getRawStorage() with cached immutable snapshots.
• Fixed deferredInventories retention during destroy/move operations.
• Optimized Cargo Network block access by bypassing unnecessary snapshots.
• Reduced cargo routing CPU usage, allocations, and TPS impact.
• Fixed auto-report spam from addon lifecycle/linkage errors.
• Added a **2 reports/server/24h** limit.

# Slimefun4Core — Build 2860

## New Features

• Storage Migration System** — Safer migration and handling of existing Slimefun storage data.
• Checkpoint System** — Create verified recovery points before important data operations.
• Report System** — In-game reporting with Discord integration and diagnostic information.
• Addon Services Upgrade** — Improved addon management, syncing, updates and service handling.
• Addon GUI** — Manage addons directly through the Slimefun Guide.
• Automatic Error Detection** — Detect Slimefun/addon errors and generate useful diagnostic reports.
• Improved Error Handling** — Better error detection, logging and failure handling.

## Bug Fixes

• Fixed / working on multiple reported issues and internal errors.
• Fixed EXPLOSIVE_BOW entity errors.
• Fixed Slimefun storage and backup-related errors.
• Fixed Backpack lore NullPointerException issues.
• Fixed addon and configuration warnings.
• Fixed Discord addon-list formatting issues.
• Fixed broken characters appearing in log output.
• More bug fixes and internal improvements.

## Known Issues

• Addon downloads currently do not verify JAR SHA/signatures.
• Discord webhook delivery may fail without confirming successful delivery.

## Special Thanks

A special thanks to everyone who helped test, report issues, provide feedback, and follow the development of Slimefun4Core throughout this development cycle.

• Special thanks to:**

• m0iy_0
• dido__kf
• graxe_1h7
• pasindunayanajith_
• thefryguy_

Your bug reports, testing, feedback, and patience have helped make this release more stable and easier to maintain.

• Thank you for supporting Slimefun4Core.**

# Build 2834(fixes)

## 🪨 Configurable Enhanced Furnaces

• Server owners can now customize **Enhanced Furnace speed,item output multipliers**.
• Added furnaces.speeds,furnaces.multipliers: to config.yml.
• Supports **All**

# Build 2832

## 📦 Cargo Manager Revamp

• Added **Cargo Grid Monitor** GUI
• Added real-time network item aggregation
• Added item **search**
• Added live per-tick throughput indicators:

• ▲ +X/tick Gain
• ▼ -X/tick Consume
• — 0/tick Stable
• Added **Total Net Throughput** display
• Added **Quick Deposit** in Slot 9

• Left-click: Deposit matching network items
• Right-click: Mass-deposit all eligible items
• Respects Cargo Output Node whitelists and filters

## 🪨 Enhanced Furnaces

• Added configurable furnace speeds in config.yml(owner side)

# SlimefunCore4 — Build 2813

## Fixed

• 🛠️ **Recipe Fix**: Fixed an issue with the Crucible recipe pattern not matching correctly in the Enhanced Crafting Table.
• 🐛 **Mechanism Fix**: Fixed a bug where items with incidental metadata (like durability damage) would unexpectedly disappear or be rejected when crafting generic recipe items (meta-mismatch fix).
• Fixed Slimefun dusts such as ALUMINUM_DUST incorrectly matching plain vanilla SUGAR.
• Prevented registered Slimefun items from being consumed by generic vanilla recipes like Christmas Caramel.

# 📋 Changelog — Build 2802

## 🔌 Addon Manager — Version- Filtering (fix)

• Addons now **auto-filter by server version** — only compatible addons show in /sf addon list
• Tab-completion only suggests addons available for your server version
• /sf addon status shows detected server version + compatible/total counts
• Fixed aggressive URL fallback that could load wrong-version addon jars

## ✨ Console Output Redesign

• Startup
• All startup steps
• Warning
• AddonManager logs

# 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.

# Changelog - #2708

## Latest Update

### 🐛 Fixed

• Fixed a critical backpack item duplication exploit.
• Backpacks now correctly save inventory changes when items are removed.
• Server restarts or shutdowns can no longer cause removed items to reappear inside backpacks.
• Prevented item duplication caused by backpack desynchronization after server reloads.

### ☁️ CloudConfig

• Updated the plugin to use the new **CloudConfig** system.
• Removed the outdated CloudConfig implementation.
• Added support for the latest plugin CloudConfig format.
• Manual plugin downloads now work correctly with the updated CloudConfig.

> **Note:** The addon manager **sometime** unavailable. Plugins can still be downloaded and installed manually without issues.

### ⚡ Improvements

• Improved overall plugin stability.
• Optimized internal code for better performance.
• Minor code cleanup and maintenance.

## ❤️ Special Thanks

Special thanks to **@graxe_1h7** for reporting the backpack duplication bug and providing detailed reproduction steps, logs, and a video. Your report helped us fix the issue quickly!

# SlimefunCore4 Changelog

## New Features & Improvements

### **Cargo Grid Monitor System (new)**

• Added a new Cargo Grid Monitor GUI for Cargo Manager.
• Added item categories for easier browsing.
• Added search support for item names, materials, and Slimefun IDs.
• 

### **Automatic Server Version Detection**

• Added automatic Minecraft server version detection.
• Improved compatibility checks for supported server versions.
• Reduced manual setup required for server owners.

### **Automatic Compatible Slimefun Updates**

• Improved Modrinth update checking.
• Added compatible-build selection based on server version.
• Added safer update validation before installing builds.
• Added cache fallback so startup stays safe if the API is unavailable.

### **Improved Console Logging**

• Added clear loading steps for services, items, resources, addons, tasks, and integrations.
• Improved startup diagnostics while keeping warnings/errors safe and visible.

# SlimefunCore4 — Changelog

## Build 2670 — 2026-05-19

### 🟢 Addon Manager

• Multi-version addon URLs via addons.<key>.versions per SF4 build tag
• Auto-detects server Minecraft version on startup, shows only compatible addons
• Version-specific cloud-sync URL support via cloud-sync.version-urls
• /addon list shows server version, active build tag, and hidden addon count
• Old single-URL config format still works — automatically upgraded on load
• Remote sync no longer overwrites local enabled / download toggles

### 🔵 Safety

• Addon JARs only deleted when explicitly disabled or removed via command
• Deletion queue, addon logs, and config backups kept across restarts

### 🟡 World Backup

• New WorldBackupService — backs up world, world_nether, world_the_end on shutdown
• Skips live lock files, checks disk space before starting, auto-purges old backups
• Configurable via slimefun.world-backup in config.yml

### 🔶 Dough Bridge Layer

• Added io.github.thebusybiscuit.slimefun4.libraries.bridge — 13 wrapper classes

(SF4Items, SF4Colors, SF4ItemUtils, SF4InvUtils, SF4Patterns, SF4BlockPos,
SF4DataAPI, SF4ChatInput, SF4Vein, SF4PlayerUtils, SF4TaskQueue, SF4Config, SF4Collections)

• 144 internal call sites migrated to bridge — future Dough updates touch 13 files, not hundreds
• Public API and storage types kept as direct Dough imports for addon compatibility
• No gameplay or behaviour changes

# Quick fix sha256 wrong
> Fail all 3 attempts
> after Attempt 1 fails
> attempt 2 skips SHA, succeeds — logs real hash

# Addon Manager

• Build 2647**

## What's New

• Dynamic addon list showing cloud-managed and manually installed addons
• Status overview with managed, loaded, and unmanaged addon counts
• Smarter GitHub jar selection — matches by addon name first
• Managed addon detection now reads directly from the jar's plugin.yml
• Fallback flags for remote sync are now fully respected

• New Commands**

• /sf addon list — lists all addons (managed + installed)
• /sf addon status — shows addon counts and sync state
• /sf addon sync — manually trigger a cloud config sync
• /sf addon enable <name> — enable a managed addon
• /sf addon disable <name> — disable a managed addon
• /sf addon update <name> — update a specific addon
• /sf addon download <name> — download a managed addon
• /sf addon remove <name> — remove a managed addon

## Changelog

• improve performance
• fixed critical bug

# 🚀 SlimefunCore4 v2621

A stability-focused update with major storage improvements, Android system upgrades, and multiple critical fixes.

## ✨ Highlights

### 🧠 New Storage System (Major Upgrade)

• Introduced a **modular storage architecture**
• Added **SQLite backend support**
• Implemented **async save queue & caching**
• Added **data consistency checker & migration system**
• Improved overall **performance and reliability**

## 🔒 Storage Improvements

• Moved storage logic away from risky bootstrap path
• Added **atomic file saving** (prevents corruption)
• Fixed **research data issues**
• Added **validation systems**:

• Research validation
• Backpack size checks
• Improved safety:

• Null-safe item loading
• Optional-based lookups
• Immutable data views
• Dirty flag tracking per section

## 🤖 Android System Upgrades

• Added **bad-data recovery system**
• New **Android GUI status panel**:

• Running / Paused / Error states
• Step progress tracking
• Current command display
• Fuel buffer info
• Facing direction
• Last error reporting

## 📜 Script System Fixes

• Fixed script **rating system**
• Improved script **sorting**
• Fixed script browser **page issues**

## 🧩 Developer Changes

• Added new storage components:

• StorageException
• StorageSaveQueue
• StorageCache
• StorageFactory
• StorageConsistencyChecker
• StorageMigrator
• SQLiteStorage

## ⚠️ Notes

• This is an **experimental but stable build**
• Storage system is now **future-ready and extensible**
• Recommended to **backup data before upgrading**

💬 This update focuses on **making your server safer, faster, and more scalable** while preparing for future features.