HMLabs-Gaming/hm-scoreboard-toggle
Watch
1
0
Fork
You've already forked hm-scoreboard-toggle
 0
mirror of https://github.com/HMLabs-Gaming/hm-scoreboard-toggle.git synced 2026-11-04 07:22:25 +00:00
Code Activity
https://gaming.hmlabs.eu/hm-scoreboard-toggle
33 commits 1 branch 1 tag 110 KiB
  • Java 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
henrymmey dbff6e3dc2
 Merge branch 'main' of https://github.com/HMLabs-Gaming/hm-scoreboard-toggle
2026-10-14 00:11:37 +02:00
.github/workflows Add GitHub Actions workflow for mod release 2026-10-14 00:01:48 +02:00
gradle/wrapper Add Gradle wrapper JAR 2026-10-13 00:00:58 +02:00
src Add icon 2026-10-13 00:42:30 +02:00
.gitattributes Normalize repository line endings 2026-10-13 00:00:10 +02:00
.gitignore Ignore generated Gradle and IDE files 2026-10-13 00:00:07 +02:00
build.gradle Fix JAR task configuration-cache compatibility 2026-10-13 00:05:41 +02:00
gradle.properties Update gradle.properties 2026-10-14 00:11:06 +02:00
gradlew Add Gradle wrapper launcher 2026-10-13 00:00:41 +02:00
gradlew.bat Add Windows Gradle wrapper launcher 2026-10-13 00:00:43 +02:00
LICENSE Add MIT license 2026-10-13 00:00:12 +02:00
README.md Remove Modrinth badge from README 2026-10-14 00:05:16 +02:00
settings.gradle Configure Gradle project 2026-10-12 23:59:57 +02:00

README.md

HM Scoreboard Toggle

Curseforge GitHub

A minimal, client-side Fabric mod for Minecraft Java Edition 26.2. Press K to hide or show the vanilla scoreboard sidebar.

Features

  • Toggle the vanilla scoreboard sidebar with one key.
  • Default key: K; rebind it in Options → Controls → Key Binds → HM Scoreboard Toggle.
  • Client-side only. No server installation, commands, configuration files, chat messages, sounds, or extra network packets.
  • The scoreboard is visible by default when Minecraft starts. The setting lasts for the current client session.

Installation

  1. Install Fabric Loader for Minecraft 26.2 and Fabric API 0.161.0+26.2.
  2. Download or build hm-scoreboard-toggle-1.0.0.jar.
  3. Put the JAR in your Minecraft mods folder.
  4. Start the Fabric 26.2 profile and press K in a world.

Build from source

Install Java 25. Then run:

  • Windows: gradlew.bat build
  • Linux/macOS: chmod +x ./gradlew && ./gradlew build

The distributable JAR is written to build/libs/hm-scoreboard-toggle-1.0.0.jar (do not use the -sources.jar file).

Implementation

The mod registers a configurable Fabric key mapping and wraps the vanilla SCOREBOARD HUD element with Fabric's HudElementRegistry.replaceElement. When hidden, only that element's original renderer is skipped; when visible, the original vanilla renderer is called unchanged. No mixins or custom scoreboard rendering are used.

Compatibility

  • Minecraft Java Edition: 26.2
  • Fabric Loader: 0.19.5 or newer
  • Fabric API: 0.161.0+26.2
  • Java: 25 or newer

License

MIT. See LICENSE.