Polymorphic Refined Storage

[1.2.0] - 2026-06-05

Added

• Standalone — no Polymorph dependency — RS Polymorph no longer requires the Polymorph mod. The recipe-selection UI (side button + popup) and the per-grid selection persistence are now provided entirely by RS Polymorph itself. The side button is the native Refined Storage AbstractSideButtonWidget; the popup is a self-contained RecipeSelectorPopup (own item-grid widget + render/click mixin on the grid screen); the per-grid choice is persisted on the grid block entity via loader Data Attachments (NeoForge AttachmentType / Fabric persistent attachment) behind a Services.GRID_STORE abstraction. The printed-pattern tag stays a vanilla DataComponentType. The Polymorph-only classes (RsGridRecipeData, MixinSelectionWidget, MixinRecipeManagerSafety) were removed. Result: a true Refined Storage add-on that works everywhere RS does, with no third-party recipe-selection dependency.
• Minecraft 26.1.2 / Refined Storage 3.2.0 (NeoForge) — A parallel build targets the new Minecraft 26.1.2 (year-based versioning, Java 25) against Refined Storage 3.2.0, sharing the 1.21.1 codebase. RS 3.x kept the same com.refinedmods.refinedstorage.common.* structure, so the mixins carry over; the few MC 26.x renames (ResourceLocation→Identifier, GuiGraphics→GuiGraphicsExtractor) are applied by a build-time source remap, and the handful of files touching the reworked recipe API (server.getRecipeManager()/RS3 RecipeProvider, single-arg assemble, RecipeHolder.id() now a ResourceKey) and the new two-phase GUI render pipeline (extractRenderState/extractContents) are forked under common-261. MixinPatternResolver is re-targeted with @WrapOperation onto RS3's Platform.getClientRecipeProvider().getRecipesFor(...). Build with Gradle on JDK 25: ./gradlew :neoforge-261:build -Dorg.gradle.java.home=<jdk25>.
• Fabric support — one mod, two loaders — RS Polymorph now ships for Fabric in addition to NeoForge, both for Minecraft 1.21.1. The project was restructured into a MultiLoader layout (common + neoforge + fabric): all gameplay logic and every mixin live in common and are shared verbatim by both loaders. Because the mixins target Refined Storage 2 and Polymorph classes (never Minecraft) with remap=false, and both RS2 and Polymorph ship their public surface in a shared cross-loader module, the injection logic resolves byte-for-byte identically on NeoForge and Fabric with no per-loader rewrite.
• Loader-agnostic core — Introduced a small platform abstraction so common never references a loader API: Services/NetworkPlatform resolve the active loader's networking via ServiceLoader, the selected_recipe data component is registered by each loader and injected into the shared core, and SelectRecipePacket exposes a pure applyOnServer(ServerPlayer, ResourceLocation) that each loader drives from its own packet receiver (NeoForge IPayloadContext, Fabric ServerPlayNetworking).
• Combined single jar (optional) — In addition to the two per-loader jars, an optional fused jar (rspolymorph-<version>.jar) that loads on both NeoForge and Fabric is produced via ModFusioner (./gradlew fusejars). The per-loader jars remain the primary, most robust distribution.
• First-open tutorial card — The first time a player opens an RS grid, a one-time, bilingual card explains the recipe-selection feature (button + popup) and is dismissed by a click or by pressing Space/Enter. The "seen" flag is persisted client-side (config/rspolymorph_tutorial.flag, written off the render thread, fail-soft) so it never reappears. Screen-reader users get a one-shot narrator announcement.
• Redesigned recipe selector popup — The selection popup was reworked to look native: a titled header, inset slot frames, a gold highlight on the recipe the grid is currently producing, on-screen clamping, item-count decorations, and a single readable recipe name on hover. Per-frame allocations in the render path were removed.

Fixed

• Recipe selection on NeoForge — Selecting a recipe threw UnsupportedOperationException server-side: the per-grid map decoded from the attachment codec is a Guava ImmutableMap, so put/remove failed. NeoForgeGridRecipeStore.set now copies-on-write into a fresh HashMap before setData. Affected both 1.21.1 and 26.1.2 NeoForge.
• Overlapping slot tooltip — Refined Storage's grid screens override renderTooltip per subclass (CraftingGridScreen/PatternGridScreen/AbstractGridScreen) and draw the hovered-slot tooltip themselves, so a mixin on vanilla AbstractContainerScreen.renderTooltip was bypassed and the underlying "Stick" tooltip drew over the popup. The suppression mixin now targets those RS classes and fires whenever the popup is open. The 26.x render pipeline differs, so its fork is a fail-soft no-op.
• Per-MC-version recipe parsing — Crafting-recipe ingredient JSON differs between MC versions (1.21.1 uses object form {"item":"..."}, 26.x uses bare strings). The test recipes are split per version and merged by a build task, so the test items now craft on every target.

Changed

• Refined Storage 2 baseline bumped to 2.0.8 — The Fabric build pulls Refined Storage 2.0.8 and Polymorph 1.1.0+1.21.1 from the Modrinth maven; the declared refinedstorage dependency floor stays >= 2.0.1. RS 2.x and RS 3.x share the same internal package structure (com.refinedmods.refinedstorage.common.*), so the mixins are forward-compatible across the RS 2.x line with no signature changes.
• Build toolchain — Migrated to the MultiLoader-Template build (Gradle 9.5.1, Fabric Loom 1.16.3 for the Fabric module, ModDevGradle 2.0.140 for the common/NeoForge modules). The Gradle wrapper was bumped from 9.2.1 to 9.5.1 to satisfy Loom 1.16.3.

Known limitations

• Fabric on Minecraft 26.1.2 not yet enabled — Minecraft 26.1.x ships un-obfuscated (no Mojang ProGuard mappings), which only fabric-loom 1.17.0-alpha+ supports, and that alpha conflicts with the stable Loom 1.16.3 used by the 1.21.1 Fabric module in the same build. The fabric-261 module (sources, entrypoints, metadata) is implemented but excluded from the default build; enable it on a branch that bumps Loom once a stable Loom with 26.x support lands. NeoForge 26.1.2 ships normally.

Ajouts

• Autonome — plus de dépendance à Polymorph — RS Polymorph ne requiert plus le mod Polymorph. L'UI de sélection de recette (bouton latéral + popup) et la persistance du choix par grille sont désormais fournies entièrement par RS Polymorph. Le bouton latéral est l'AbstractSideButtonWidget natif de Refined Storage ; le popup est un RecipeSelectorPopup autonome (widget de grille d'items + mixin de rendu/clic sur l'écran de grille) ; le choix par grille est persisté sur le block entity via les Data Attachments du loader (NeoForge AttachmentType / attachment persistant Fabric) derrière une abstraction Services.GRID_STORE. Le tag du patron imprimé reste un DataComponentType vanilla. Les classes spécifiques à Polymorph (RsGridRecipeData, MixinSelectionWidget, MixinRecipeManagerSafety) ont été supprimées. Résultat : un véritable add-on Refined Storage qui fonctionne partout où RS fonctionne, sans dépendance tierce de sélection de recette.
• Minecraft 26.1.2 / Refined Storage 3.2.0 (NeoForge) — Un build parallèle cible le nouveau Minecraft 26.1.2 (versioning par année, Java 25) avec Refined Storage 3.2.0, en partageant la base de code 1.21.1. RS 3.x a conservé la même structure com.refinedmods.refinedstorage.common.*, donc les mixins sont repris ; les quelques renommages MC 26.x (ResourceLocation→Identifier, GuiGraphics→GuiGraphicsExtractor) sont appliqués par un remap de sources au build, et les fichiers touchant l'API de recette remaniée (server.getRecipeManager()/RecipeProvider RS3, assemble à un argument, RecipeHolder.id() désormais un ResourceKey) et le nouveau pipeline de rendu GUI à deux phases (extractRenderState/extractContents) sont forkés sous common-261. MixinPatternResolver est re-ciblé avec @WrapOperation sur Platform.getClientRecipeProvider().getRecipesFor(...) de RS3. Build avec Gradle sur JDK 25 : ./gradlew :neoforge-261:build -Dorg.gradle.java.home=<jdk25>.
• Support Fabric — un seul mod, deux loaders — RS Polymorph est désormais publié pour Fabric en plus de NeoForge, tous deux pour Minecraft 1.21.1. Le projet a été restructuré en architecture MultiLoader (common + neoforge + fabric) : toute la logique de jeu et chaque mixin vivent dans common et sont partagés à l'identique par les deux loaders. Comme les mixins ciblent des classes de Refined Storage 2 et de Polymorph (jamais de Minecraft) avec remap=false, et que RS2 comme Polymorph exposent leur surface publique dans un module commun cross-loader, la logique d'injection se résout octet pour octet de façon identique sur NeoForge et Fabric, sans réécriture par loader.
• Noyau agnostique du loader — Ajout d'une petite abstraction de plateforme pour que common ne référence jamais une API de loader : Services/NetworkPlatform résolvent le réseau du loader actif via ServiceLoader, le data component selected_recipe est enregistré par chaque loader puis injecté dans le noyau partagé, et SelectRecipePacket expose un applyOnServer(ServerPlayer, ResourceLocation) pur que chaque loader pilote depuis son propre récepteur de paquet (NeoForge IPayloadContext, Fabric ServerPlayNetworking).
• Jar unique combiné (optionnel) — En plus des deux jars par loader, un jar fusionné optionnel (rspolymorph-<version>.jar) chargeable sur NeoForge ET Fabric est produit via ModFusioner (./gradlew fusejars). Les jars par loader restent la distribution principale, la plus robuste.
• Carte tuto au premier lancement — La première fois qu'un joueur ouvre une grille RS, une carte unique et bilingue explique la sélection de recette (bouton + popup) ; elle se ferme d'un clic ou en appuyant sur Espace/Entrée. Le drapeau « vu » est persisté côté client (config/rspolymorph_tutorial.flag, écrit hors du thread de rendu, fail-soft) pour ne jamais réapparaître. Les utilisateurs de lecteur d'écran reçoivent une annonce narrateur unique.
• Popup de sélection redesigné — Le popup a été retravaillé pour un rendu natif : en-tête titré, slots en relief, surbrillance dorée sur la recette actuellement produite, calage à l'écran, décorations de quantité, et un seul nom de recette lisible au survol. Les allocations par frame du rendu ont été supprimées.

Correctifs

• Sélection de recette sur NeoForge — La sélection levait UnsupportedOperationException côté serveur : la map par grille décodée du codec d'attachment est une ImmutableMap Guava, donc put/remove échouaient. NeoForgeGridRecipeStore.set fait désormais une copie dans un nouveau HashMap avant setData. Affectait NeoForge 1.21.1 et 26.1.2.
• Tooltip de slot superposé — Les écrans de grille de Refined Storage overrident renderTooltip par sous-classe (CraftingGridScreen/PatternGridScreen/AbstractGridScreen) et dessinent eux-mêmes le tooltip du slot survolé ; un mixin sur le AbstractContainerScreen.renderTooltip vanilla était donc contourné et le tooltip « Stick » s'affichait par-dessus le popup. Le mixin de suppression cible désormais ces classes RS et s'active dès que le popup est ouvert. Le pipeline de rendu 26.x diffère, son fork est un no-op fail-soft.
• Parsing des recettes par version MC — Le JSON des ingrédients de craft diffère selon la version MC (1.21.1 en objet {"item":"..."}, 26.x en chaîne brute). Les recettes de test sont séparées par version et fusionnées par une tâche de build, donc les items de test se craftent désormais sur chaque cible.

Modifications

• Base Refined Storage 2 portée à 2.0.8 — Le build Fabric récupère Refined Storage 2.0.8 et Polymorph 1.1.0+1.21.1 depuis le maven Modrinth ; le plancher de dépendance refinedstorage déclaré reste >= 2.0.1. RS 2.x et RS 3.x partagent la même structure de packages interne (com.refinedmods.refinedstorage.common.*), donc les mixins sont compatibles ascendant sur toute la ligne RS 2.x sans changement de signature.
• Chaîne de build — Migration vers le build MultiLoader-Template (Gradle 9.5.1, Fabric Loom 1.16.3 pour le module Fabric, ModDevGradle 2.0.140 pour les modules common/NeoForge). Le wrapper Gradle est passé de 9.2.1 à 9.5.1 pour satisfaire Loom 1.16.3.