
About this Mod
About
RuneFinder automatically scans any opened chest, locates items that match a name you specify, and tosses them onto the ground for pickup by hoppers.
Despite the name, RuneFinder isn’t limited to runes. It was made for the Complex server, where hundreds of look-alike “rune” items made manual sorting a nightmare, so I made the mod. It works with any item, on any server.
RuneFinder is fully client-side.
Commands
Core
| Action | Command |
|---|---|
| Toggle the mod on/off | /rf |
| Search for items | /rf find <item name> |
Presets
Presets let you autocomplete item names for different servers.
| Action | Command |
|---|---|
| Set preset | /rf preset <preset> |
| Clear preset | /rf preset clear |
Arrays
Arrays let you save areas and limit which chests RuneFinder works in.
| Action | Command |
|---|---|
| Add array | /rf array add <name> <posA> <posB> |
| Remove array | /rf array remove <name> |
| List arrays | /rf array list |
Restrict to Arrays
| Action | Command |
|---|---|
| Toggle restrict mode | /rf restrictarrays |
| Enable restrict mode | /rf restrictarrays on |
| Disable restrict mode | /rf restrictarrays off |
When enabled, RuneFinder will only work on chests inside saved arrays.
Config
RuneFinder creates a config file in:
.minecraft/config/rune-finder.json5
Presets Config
Presets are lists of item names used for autocomplete in /rf find.
Example:
activePreset: "complex",
presets: {
complex: {
items: [
"Rune 1",
"Rune 2",
"Oak Log",
"paper"
]
}
}
You can add your own presets and select them with:
/rf preset <name>
Complex Server Preset
I made a preset for the Complex server here:
https://github.com/sandstorrm/runefinder-presets/blob/main/complex.json5
This preset is not included in the mod by default, since server items can change.
Just copy the contents into your config file.
Other Config Options
You can also configure:
- drop delays
- arrays
- restrict to arrays mode
Available Versions
How to Install Rune Finder on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "Rune Finder". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11, 1.21.10, 1.21.9 (+8 more)
Server-side
~ OptionalRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Rune Finder server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is Rune Finder compatible with fabric?
Rune Finder officially supports fabric for Minecraft 1.21.11, 1.21.10, 1.21.9. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Rune Finder – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Rune Finder consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Rune Finder with just one click on your server.