Log warnings instead of crashing when Hexical is outdated (fix #62)

Author: object-Object

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and [Pydantic's HISTORY.md](https://github.com/pydantic/pydantic/blob/main/HISTORY.md), and this project *mostly* adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [UNRELEASED]
+
+### Fixed
+
+- Fixed a crash when closing the Splicing Table with Hexical 1.5.0 installed ([#62](https://github.com/object-Object/HexDebug/issues/62)).
+
 ## `0.7.0+1.20.1` - 2025-10-02
 
 ### Added

Fabric/src/main/kotlin/gay/object/hexdebug/fabric/HexDebugClientAbstractionsImpl.kt

@@ -2,12 +2,23 @@
 
 package gay.`object`.hexdebug.fabric
 
+import gay.`object`.hexdebug.HexDebug
 import gay.`object`.hexdebug.fabric.interop.FabricHexDebugHexicalInterop
 import net.fabricmc.loader.api.FabricLoader
+import net.fabricmc.loader.api.Version
 import net.minecraft.client.Minecraft
+import kotlin.jvm.optionals.getOrNull
+
+private val HEXICAL_MIN_VERSION: Version = Version.parse("2.0.0")
+private var hasLoggedWarning = false
 
 fun sendHexicalKeyEvent(client: Minecraft, keyCode: Int, scanCode: Int, isPressed: Boolean) {
-    if (FabricLoader.getInstance().isModLoaded("hexical")) {
+    val hexical = FabricLoader.getInstance().getModContainer("hexical").getOrNull() ?: return
+    val hexicalVersion = hexical.metadata.version
+    if (hexicalVersion >= HEXICAL_MIN_VERSION) {
         FabricHexDebugHexicalInterop.sendKeyEvent(client, keyCode, scanCode, isPressed)
+    } else if (!hasLoggedWarning) {
+        HexDebug.LOGGER.error("Hexical splicing table interop requires hexical>=${HEXICAL_MIN_VERSION.friendlyString}, but found ${hexicalVersion.friendlyString}. Disable Hexical interop in HexDebug's client config to suppress this message.")
+        hasLoggedWarning = true
     }
 }

Fabric/src/main/resources/fabric.mod.json

@@ -57,5 +57,8 @@
     "emi": ">=${versions.emi}",
     "modmenu": ">=${versions.modMenu}",
     "hexical": ">=${versions.hexical}"
+  },
+  "conflicts": {
+    "hexical": "<${versions.hexical}"
   }
 }