From e7db45f98d45f7918f88380a674859708e9b8fa5 Mon Sep 17 00:00:00 2001
From: Jean-Luc Makiola <business@jeanlucmakiola.de>
Date: Mon, 1 Jun 2026 22:47:40 +0200
Subject: [PATCH] feat(io): MusicLevel enum (Off/Low/Med/High)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../thb/jeanluc/adventure/io/MusicLevel.java  | 26 +++++++++++++++++
 .../jeanluc/adventure/io/MusicLevelTest.java  | 29 +++++++++++++++++++
 2 files changed, 55 insertions(+)
 create mode 100644 Semesterprojekt/src/main/java/thb/jeanluc/adventure/io/MusicLevel.java
 create mode 100644 Semesterprojekt/src/test/java/thb/jeanluc/adventure/io/MusicLevelTest.java

diff --git a/Semesterprojekt/src/main/java/thb/jeanluc/adventure/io/MusicLevel.java b/Semesterprojekt/src/main/java/thb/jeanluc/adventure/io/MusicLevel.java
new file mode 100644
index 0000000..79d2091
--- /dev/null
+++ b/Semesterprojekt/src/main/java/thb/jeanluc/adventure/io/MusicLevel.java
@@ -0,0 +1,26 @@
+package thb.jeanluc.adventure.io;
+
+/** Background-music volume level, cycled in the Settings menu. */
+public enum MusicLevel {
+    OFF, LOW, MEDIUM, HIGH;
+
+    /** Target MASTER_GAIN in decibels. Irrelevant for {@link #OFF} (playback disabled). */
+    public float gainDb() {
+        return switch (this) {
+            case OFF -> Float.NEGATIVE_INFINITY;
+            case LOW -> -20f;
+            case MEDIUM -> -10f;
+            case HIGH -> 0f;
+        };
+    }
+
+    /** @return true when music should play. */
+    public boolean isOn() {
+        return this != OFF;
+    }
+
+    /** Next level in the cycle (wraps HIGH → OFF). */
+    public MusicLevel next() {
+        return values()[(ordinal() + 1) % values().length];
+    }
+}
diff --git a/Semesterprojekt/src/test/java/thb/jeanluc/adventure/io/MusicLevelTest.java b/Semesterprojekt/src/test/java/thb/jeanluc/adventure/io/MusicLevelTest.java
new file mode 100644
index 0000000..237bab8
--- /dev/null
+++ b/Semesterprojekt/src/test/java/thb/jeanluc/adventure/io/MusicLevelTest.java
@@ -0,0 +1,29 @@
+package thb.jeanluc.adventure.io;
+
+import org.junit.jupiter.api.Test;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+class MusicLevelTest {
+
+    @Test
+    void gainIncreasesWithLevel() {
+        assertThat(MusicLevel.LOW.gainDb()).isLessThan(MusicLevel.MEDIUM.gainDb());
+        assertThat(MusicLevel.MEDIUM.gainDb()).isLessThan(MusicLevel.HIGH.gainDb());
+    }
+
+    @Test
+    void isOnOnlyWhenNotOff() {
+        assertThat(MusicLevel.OFF.isOn()).isFalse();
+        assertThat(MusicLevel.LOW.isOn()).isTrue();
+        assertThat(MusicLevel.HIGH.isOn()).isTrue();
+    }
+
+    @Test
+    void nextCyclesThroughAllAndWraps() {
+        assertThat(MusicLevel.OFF.next()).isEqualTo(MusicLevel.LOW);
+        assertThat(MusicLevel.LOW.next()).isEqualTo(MusicLevel.MEDIUM);
+        assertThat(MusicLevel.MEDIUM.next()).isEqualTo(MusicLevel.HIGH);
+        assertThat(MusicLevel.HIGH.next()).isEqualTo(MusicLevel.OFF);
+    }
+}