Skip to content

Slimefun Legacy 4.1.37

Choose a tag to compare

View all tags
@github-actions github-actions released this 23 Aug 15:34
· 0 commits to 68a1802366c7c27919f10672d325a30119fbde10 since this release
v4.1.37
5c9041b

Slimefun Legacy 4.1.37 — Search Performance, Guide Categories & Energy Visualizer

Slimefun Legacy 4.1.37 is a focused performance, compatibility and quality-of-life release. It substantially reduces repeated work in Slimefun Guide searches, adds addon-friendly guide category inheritance, and adds an opt-in gold particle visualizer directly to the Energy Regulator.

⚡ Guide search performance

Both the classic Slimefun search and the Enhanced Guide now use a shared cached search index.

  • Stable searchable metadata such as item name, ID, addon and lore is normalized and cached instead of rebuilt for every query.
  • Enhanced search keeps a pre-sorted name view instead of sorting the full registry on every search.
  • id:, addon:, group:, category: and recipe: filters short-circuit so unrelated metadata is not resolved.
  • Player-sensitive group and recipe labels are resolved lazily only when a query actually needs them.
  • Classic search preserves its existing registry-order behavior and result cap.
  • Enhanced search preserves smart-search fields, sorting and pagination while doing substantially less repeated work.

This work addresses reports of noticeable MSPT increases while using Slimefun search on servers with large addon registries.

🗂️ Guide category inheritance for addons

Slimefun Legacy now supports optional high-level guide category metadata directly on an ItemGroup.

  • Addons can call ItemGroup#setCategory(...) once and every item in that group inherits the declared guide category.
  • ItemGroup#getCategoryId() exposes the declared category to guide integrations.
  • Canonical category IDs are provided for weapons, tools, armor, machines, energy tech, resources, magic, food, logistics, decoration and misc.
  • Enhanced Guide searches can use category: to find every item in a declared category.
  • Normal smart searches also consider cached category IDs without adding expensive per-search metadata work.
  • Enhanced Guide item lore now distinguishes the traditional Slimefun Group from the new high-level Guide Category.
  • Existing addons do not need to opt in, and no existing ItemGroup behavior is removed.

This is an additive compatibility feature inspired by newer Slimefun guide work while preserving Slimefun4's familiar ItemGroup-first guide architecture.

✨ Energy Regulator network visualizer

Right-click an Energy Regulator to open its new visualizer control.

  • Toggle the connected Energy Network overlay on or off from the regulator itself.
  • Uses a clean warm-gold DUST particle effect.
  • The overlay is player-specific; other players do not see your visualization.
  • Only one regulator is selected per player at a time.
  • Rendering is range-limited, pulsed every 10 ticks and capped at 160 particles per pass.
  • The visualizer does not intentionally load chunks.
  • The existing legacy blue network display behavior remains available for existing callers.

The feature remains subject to the server's existing network-visualizer configuration switch.

🛡️ Compatibility

No existing Slimefun item IDs, recipes, research IDs, machine storage formats, database schemas or saved-world formats are intentionally changed in 4.1.37. Normal Cargo and Energy transfer semantics remain unchanged.

  • Paper 26.2 / Minecraft 26.2 — primary supported line
  • Purpur based on Paper 26.2 — supported
  • Folia based on Paper 26.2 — experimental
  • Paper/Purpur 1.21.11 — compatibility line
  • Java 25 — supported production runtime
  • Slimefun-owned classes continue targeting Java 21 bytecode

The updated 4.1.37 candidate passed the project build, gameplay correctness checks, Public API compatibility, Paper 26.2 runtime smoke, Purpur/Folia 26.2 runtime smoke, Paper/Purpur 1.21.11 compatibility, cross-fork probes and the full addon compatibility matrix before being merged.

📦 Upgrading

4.1.37 is intended as a straightforward drop-in upgrade from 4.1.36.

  1. Stop the server normally.
  2. Back up worlds, Slimefun data and databases.
  3. Replace the previous Slimefun Legacy JAR with the latest 4.1.37 JAR from this release.
  4. Start the server normally.
  5. Do not use /reload for the upgrade.

---Note: IE2, SlimeTinker, Dynatech, FastMachines, Fluffy Machines, Networks Exp, and Slimefun Advancements have been updated too!

Slimefun Legacy 4.1.37 — faster guide searches, smarter addon organization, clearer power networks.

Assets 3
Loading