KoksMiner is a fully client-side Fabric mod for configurable AFK mining automation. It combines stationary mining, movement routes, scheduled commands, automatic item dropping, safe auto-eating, tool protection, persistent statistics and an editable HUD.

The mod uses Minecraft's standard input and inventory mechanics. It requires no server-side installation.

Important: Automation may be prohibited by some servers. Always check the server rules before using KoksMiner.

Main features

Stationary mining or movement using Serpentine, Out and Back, Perimeter and Staircase routes.
Configurable rows, route length and time per block with a visual block-grid preview.
Independent scheduled commands with live HUD countdowns.
Per-slot ONE or STACK drop rules for all 36 inventory and hotbar positions.
Safe hotbar auto-eating with a configurable hunger threshold.
Tool protection that stops mining before the held item breaks.
Persistent statistics and an event log covering sessions, deaths and automation actions.
Movable, independently scalable status and notification HUD elements.
Responsive interface for Minecraft GUI scales 1–5.
English and Polish translations.

Controls

HOME — open the KoksMiner configuration screen.
END — start or stop the automation.

Both bindings are configurable in Minecraft's Controls menu.

Installation and compatibility

KoksMiner requires Fabric Loader, Fabric API and Java 21. It supports Minecraft 1.21.1–1.21.11, with a separate JAR for every exact game version. Install only the file matching your Minecraft version.

The mod is client-side only. Cloth Config, Mod Menu and server installation are not required.

Intentional limitations

KoksMiner does not include automatic camera rotation, intelligent block selection, pathfinding, obstacle avoidance, automatic tool switching, reconnecting or anti-cheat bypass features. Background operation requires Minecraft to continue processing ticks.

Responsible use

KoksMiner automates standard client inputs. It is not designed to be undetectable and cannot guarantee compliance with every server's rules. You are responsible for how and where you use it.

Modpack permission

Official KoksMiner files hosted on Modrinth may be included in Modrinth modpacks. The project is licensed under the MIT License.

-----------------------------------------

KoksMiner to w pełni klientowy mod Fabric do konfigurowalnego kopania AFK. Łączy kopanie stacjonarne, trasy ruchu, harmonogram komend, automatyczne wyrzucanie, bezpieczne auto-jedzenie, ochronę narzędzia, trwałe statystyki i edytowalny HUD.

Mod korzysta ze standardowych mechanizmów wejścia i ekwipunku Minecrafta. Nie wymaga instalacji po stronie serwera.

Ważne: Automatyzacja może być zabroniona regulaminem niektórych serwerów. Przed użyciem KoksMiner sprawdź zasady serwera.

Najważniejsze funkcje

Kopanie stacjonarne albo ruch po trasach: Serpentyna, Tam i z powrotem, Obwód oraz Schodki.
Konfigurowalne pasy, długość i czas pola wraz z podglądem na siatce bloków.
Niezależne harmonogramy komend z odliczaniem na HUD-zie.
Reguły wyrzucania ONE lub STACK dla wszystkich 36 pozycji ekwipunku i hotbara.
Bezpieczne auto-jedzenie z ustawianym progiem głodu.
Ochrona narzędzia zatrzymująca kopanie przed jego zniszczeniem.
Trwałe statystyki i dziennik sesji, śmierci oraz działań automatu.
Przesuwany HUD z niezależną skalą statusu i powiadomień.
Responsywny interfejs dla skali GUI Minecrafta 1–5.
Polskie i angielskie tłumaczenie.

Sterowanie

HOME — otwarcie konfiguracji KoksMiner.
END — uruchomienie lub zatrzymanie automatu.

Oba skróty można zmienić w ustawieniach sterowania Minecrafta.

Instalacja i zgodność

KoksMiner wymaga Fabric Loader, Fabric API i Java 21. Obsługuje Minecraft 1.21.1–1.21.11, przy czym każda dokładna wersja gry ma osobny JAR. Zainstaluj wyłącznie plik zgodny z numerem swojej wersji Minecrafta.

Mod działa tylko po stronie klienta. Cloth Config, Mod Menu ani instalacja na serwerze nie są wymagane.

Celowe ograniczenia

KoksMiner nie zawiera automatycznego obracania kamery, inteligentnego wybierania bloków, pathfindingu, omijania przeszkód, automatycznej zmiany narzędzia, reconnectu ani funkcji obchodzących antycheat. Działanie w tle wymaga, aby Minecraft nadal wykonywał ticki.

Odpowiedzialne korzystanie

KoksMiner automatyzuje standardowe wejścia klienta. Nie został zaprojektowany jako niewykrywalny i nie gwarantuje zgodności z regulaminem każdego serwera. Użytkownik odpowiada za sposób i miejsce korzystania z moda.

Zgoda na modpacki

Oficjalne pliki KoksMiner udostępnione na Modrinth mogą być dodawane do modpacków Modrinth. Projekt jest dostępny na licencji MIT.