Initial commit

Author: remakefactory

.github/workflows/build.yml

@@ -0,0 +1,52 @@
+name: Release Mod
+
+on:
+  push:
+    branches:
+      - 1.20.1
+
+jobs:
+  build-and-release:
+    if: "startsWith(github.event.head_commit.message, 'v1') || startsWith(github.event.head_commit.message, 'v2') || startsWith(github.event.head_commit.message, 'v3')"
+
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v3
+
+      - name: Make gradlew executable
+        run: chmod +x ./gradlew
+
+      - name: Run Spotless Check
+        run: ./gradlew spotlessCheck
+
+      - name: Build with Gradle
+        run: ./gradlew build
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: build/libs/*.jar
+
+          tag_name: ${{ github.event.head_commit.message }}
+
+          name: ${{ github.event.head_commit.message }}
+
+          body: |
+            Automated release based on commit message.
+
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,119 @@
+# User-specific stuff
+.idea/
+
+*.iml
+*.ipr
+*.iws
+
+# IntelliJ
+out/
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Package Files #
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+
+*~
+
+# temporary files which can be created if a process still has a handle open of a deleted file
+.fuse_hidden*
+
+# KDE directory preferences
+.directory
+
+# Linux trash folder which might appear on any partition or disk
+.Trash-*
+
+# .nfs files are created when an open file is removed but is still being accessed
+.nfs*
+
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+# Windows thumbnail cache files
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+
+# Dump file
+*.stackdump
+
+# Folder config file
+[Dd]esktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+
+.gradle
+build/
+
+# Ignore Gradle GUI config
+gradle-app.setting
+
+# Cache of project
+.gradletasknamecache
+
+**/build/
+
+# Common working directory
+run/
+runs/
+
+# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
+!gradle-wrapper.jar

README.md

@@ -0,0 +1,62 @@
+<div >
+
+**English** | [简体中文](README_zh_CN.md)
+
+</div>
+
+# ExtendedPick
+
+**ExtendedPick** is a Minecraft Forge mod that significantly upgrades the standard "Pick Block" (Middle-Click) functionality. It allows players to find items in their inventory more intelligently, even if the item is buried inside a backpack or has slightly different NBT data.
+
+## Features
+
+### 1. Smart / Fuzzy Matching
+The vanilla Pick Block function requires an exact item match. ExtendedPick introduces `ISearchHelper`, allowing for "best match" scoring.
+- If you try to pick a block and don't have the *exact* item, the mod searches your inventory for the most similar item based on registered logic.
+- It prioritizes the Hotbar but will swap items from the main inventory if necessary.
+
+### 2. Deep Search (Container Support)
+If the item isn't found in your main inventory, ExtendedPick can search **inside** item containers (like Backpacks, Shulker Boxes, or Bundles) that you are carrying.
+- This is handled via the `IDeepSearchProvider` API.
+- If the item is found inside a container, the mod communicates with the server to extract it automatically (configurable).
+
+### 3. Advanced Creative Entity Picking
+Enhances Creative Mode picking for entities:
+- **Ctrl + Pick Block (Middle Click)** on an Entity will copy the Entity with its full NBT data (excluding position/UUID), allowing you to place down an exact copy of that mob.
+
+### 4. Configurable
+The mod allows customization via `ExtendedPickClientConfig`:
+- Toggle Deep Search.
+- Enable/Disable debug logging for picking actions.
+- Toggle Creative NBT picking behavior.
+
+## For Developers (API)
+
+ExtendedPick provides an API for other mods to integrate their items and containers.
+
+### `ISearchHelper`
+Implement this interface to define how two items should be compared (Fuzzy Search).
+```java
+public class MyISearchHelper implements ISearchHelper {
+    @Override
+    int getMatchScore(@NotNull ItemStack target, @NotNull ItemStack candidate){
+       //Logic to Match Score
+    }
+}
+```
+
+### `IDeepSearchProvider`
+Implement this interface to allow ExtendedPick to look inside your mod's containers (e.g., backpacks).
+```java
+public class MyBackpackProvider implements IDeepSearchProvider {
+    @Override
+    public void forEachItem(ItemStack container, Consumer<IndexedStack> action) {
+        // Logic to iterate container contents
+    }
+
+    @Override
+    public ItemStack extract(ServerPlayer player, ItemStack container, int index) {
+        // Logic to remove item from container and give to player
+    }
+}
+```

README_zh_CN.md

@@ -0,0 +1,56 @@
+# ExtendedPick (中文说明)
+
+**ExtendedPick** 是一个 Minecraft Forge模组，它极大地增强了原版“选取方块”（Pick Block / 中键选取）的功能。即使物品藏在背包中或 NBT 数据略有不同，它也能帮助玩家智能地在物品栏中找到目标物品。
+
+## 主要功能
+
+### 1. 智能/模糊匹配 (Smart Matching)
+原版的选取方块功能通常需要物品完全一致才能选中。ExtendedPick 引入了 `ISearchHelper` 机制，支持评分制的“最佳匹配”。
+- 当你尝试选取一个方块，且身上没有完全一样的物品时，模组会搜索你的物品栏，寻找最相似的替代品。
+- 优先检索快捷栏，如果物品在背包主栏中，会自动切换到快捷栏。
+
+### 2. 深度搜索 (Deep Search)
+如果物品不在你的主物品栏中，ExtendedPick 可以搜索你携带的**容器物品内部**（例如背包、潜影盒或收纳袋）。
+- 这是通过 `IDeepSearchProvider` API 实现的。
+- 如果在容器内找到了目标物品，模组会向服务器发送数据包，自动将其提取出来（此功能可配置）。
+
+### 3. 创造模式实体增强
+增强了创造模式下对实体的选取功能：
+- **Ctrl + 中键** 点击实体：将复制该实体及其完整的 NBT 数据（排除坐标/UUID），让你能生成一个属性完全相同的生物副本。
+
+### 4. 高度可配置
+可以通过 `ExtendedPickClientConfig` 进行自定义：
+- 开启/关闭深度搜索。
+- 开启/关闭选取操作的调试日志 (Debug Log)。
+- 切换创造模式 NBT 选取行为。
+
+## 开发者接口 (API)
+
+ExtendedPick 提供了简单的 API，允许其他模组兼容其物品和容器。
+
+### `ISearchHelper`
+实现此接口以定义两个物品之间的相似度比较逻辑（模糊搜索）。
+```java
+public class MyISearchHelper implements ISearchHelper {
+    @Override
+    int getMatchScore(@NotNull ItemStack target, @NotNull ItemStack candidate){
+        //打分逻辑
+    }
+}
+```
+
+### `IDeepSearchProvider`
+实现此接口以允许 ExtendedPick 搜索你模组中的容器（如背包）。
+```java
+public class MyBackpackProvider implements IDeepSearchProvider {
+    @Override
+    public void forEachItem(ItemStack container, Consumer<IndexedStack> action) {
+        // 遍历容器内容的逻辑
+    }
+
+    @Override
+    public ItemStack extract(ServerPlayer player, ItemStack container, int index) {
+        // 从容器中提取物品并交给玩家的逻辑
+    }
+}
+```