Minecraft/visotaris-opmod
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
90 commits 1 branch 10 tags 2.7 MiB
  • Java 73%
  • Svelte 10.9%
  • Kotlin 10.4%
  • CSS 3.7%
  • JavaScript 1%
  • Other 1%
Find a file
Exact
DiamantTh 26fdad86ac Release 1.1.4-2
2026-05-15 23:22:21 +02:00
1.21.11 Release 1.0.3 2026-05-15 00:46:52 +02:00
26.1.2 Release 1.1.2 2026-05-15 22:30:40 +02:00
doc Add Minecraft 26.1.2 build target 2026-05-09 18:52:17 +02:00
gradle/wrapper feat: initial commit – No OP.Mod v0.1.0 2026-04-06 16:53:06 +02:00
src/main Release 1.1.4-2 2026-05-15 23:22:21 +02:00
webui build(webui): Vite-Bundle neu generieren 2026-05-02 02:42:18 +02:00
.gitignore feat(webui): Alpine.js → Svelte 5 2026-04-09 19:23:17 +02:00
build.gradle Release 1.0.1 2026-05-09 23:40:18 +02:00
gradle.properties Release 1.1.4-2 2026-05-15 23:22:21 +02:00
gradlew feat: initial commit – No OP.Mod v0.1.0 2026-04-06 16:53:06 +02:00
gradlew.bat feat: initial commit – No OP.Mod v0.1.0 2026-04-06 16:53:06 +02:00
LICENSE fix: LICENSE durch Standard-AGPL-3.0-Text ersetzt (Plattform-Erkennung) 2026-04-06 17:20:40 +02:00
README.md Rename 26 target to 26.1.2 2026-05-09 18:54:36 +02:00
settings.gradle Rename 26 target to 26.1.2 2026-05-09 18:54:36 +02:00

README.md

Visotaris OPMod

Eine freie, quelloffene Fabric-Client-Mod für Minecraft mit Fokus auf den OPSUCHT-Server.

Lizenz: AGPLv3+ · Minecraft: 1.21.11 / 26.1.2 · Loader: Fabric

Features

Visotaris OPMod ergänzt den Minecraft-Client um Komfort- und Auswertungsfunktionen, die speziell auf die Spielmechaniken von OPSUCHT ausgelegt sind.

Funktion Beschreibung
Marktpreis-Tooltips Zeigt aktuelle Kauf- und Verkaufspreise direkt im Item-Tooltip an
Merchant- & Shard-Werte Lädt Händler- und Splitter-Kurse und rechnet sie in Item-Bewertungen ein
Container-Overlay Zeigt den Gesamtwert von Kisten- und Shulker-Inhalten im Screen
Shulker-Rekursion Wertet Shulker-Box-Inhalte im Container-Overlay rekursiv mit aus
Quick-Buttons Schaltflächen in Kisten-Screens und Inventar für /jobs, /shard, /spawn
Job-Tracker Liest OPSUCHT-Job-Nachrichten aus dem Chat und berechnet Stundenwerte
HUD-Overlay Zeigt aktuellen Job, XP und geschätzte Stundenwerte im Spielbildschirm
/rename- & /sign-Schutz Fängt diese Befehle vor dem Absenden ab und fordert eine Bestätigung an
Offhand-Blocker Verhindert versehentliche Offhand-Swaps (F-Taste)
Amboss-Normalisierung Expandiert Kurzformen im Amboss-Rename-Feld: 1k → 1000, 2.5m → 2500000
Command-Kurzformen Dasselbe für Geld-Befehle: /pay spieler 1k, /bank deposit 2.5m u.v.m.
Inventar-voll-Warnung Pulsierender roter HUD-Hinweis wenn kein freier Inventar-Slot mehr vorhanden
Keybinds Konfigurierbare Tastenbelegungen (Einstellungen öffnen, HUD-Toggle, Markt-Refresh)
Config + ModMenu Alle Funktionen einzeln ein-/ausschaltbar über eine Einstellungsseite (ModMenu-kompatibel)
Discord RPC Optionaler Discord-Rich-Presence-Service (standardmäßig deaktiviert)

Warum eine eigene Mod?

Es gibt bereits eine OPSUCHT-eigene Client-Mod (im Folgenden „OPMOD"), die viele dieser Funktionen enthält. Visotaris OPMod ist kein direkter Ersatz oder Klon, sondern entstand aus zwei konkreten Gründen:

1. Lizenz und Quelloffenheit
OPMOD wird unter einer All Rights Reserved-Lizenz vertrieben. Quellcode ist nicht öffentlich zugänglich. Für mich ist Open Source keine bloße Präferenz, sondern eine Grundüberzeugung: FOSS ist in vielen Ökosystemen wichtig – von Betriebssystemen über Frameworks bis zu Spielmods. Ich schaue mir auch nicht-FOSS-Projekte an und schätze sie, aber wenn ich selbst etwas baue, dann offen und nachvollziehbar.

2. Eigene Kontrolle über die Implementierung
Eine eigene Codebasis erlaubt es, Designentscheidungen selbst zu treffen, auf Probleme schnell zu reagieren und die Mod ohne Abhängigkeit von der Entwicklung Dritter weiterzupflegen.

Diese Mod ist keine Kritik an den Entwicklern von OPMOD. Die Entscheidung für eine proprietäre Lizenz ist legitim – jedes Team trifft diese Entscheidung aus eigenen Gründen, und das ist ihr gutes Recht. Visotaris OPMod ist die freie Alternative für alle, denen Quelloffenheit bei Software wichtig ist.

Wie die Analyse erfolgte

Um zu verstehen, welche Funktionen sinnvoll sind und wie OPSUCHT-spezifische Mechaniken funktionieren, wurde OPMOD technisch analysiert. Das Vorgehen war:

  • Werkzeuge: Gängige Java-Dekompilier-Werkzeuge (z. B. Vineflower/Fernflower über IntelliJ, Bytecode-Viewer)
  • Gegenstand: Ausschließlich Clientlogik – OPMOD liest keine geheimen Serverdaten, sondern wertet sichtbare Chat-, Screen- und Item-Informationen aus sowie öffentliche OPSUCHT-APIs
  • Ergebnis: Kein Code wurde übernommen. Die Analyse diente ausschließlich dem Verständnis der Spielmechaniken und der OPSUCHT-Chat-/Screen-Formate

Das vollständige technische Analysedokument liegt unter doc/OPMOD-Architektur-und-Bauplan.md.

Build

Voraussetzungen: Java 21 für 1.21.11, Java 25 für 26.1.2, Gradle (Wrapper inklusive)

# Beide Mod-JARs bauen
./gradlew buildAll

# Einzelne Targets bauen
./gradlew :1.21.11:remapJar
./gradlew :26.1.2:shadowJar

JARs landen in 1.21.11/build/libs/ bzw. 26.1.2/build/libs/.

Kotlin + Java

Die Codebasis nutzt beide Sprachen:

  • Mixins (hooks/) → Java (sicherer mit Annotation-Prozessoren)
  • Services und Datenmodelle → Kotlin bevorzugt

Lizenz

Copyright (C) 2026 DiamantTh
Lizenziert unter der GNU Affero General Public License v3.0 oder später.
Siehe LICENSE.