原神乐器

# Changes

## Instruments

### Added 2 new instruments:
- Ukulele
- Djem Djem Drum
- Textures, as always, made by the awesome [Gen](https://www.planetminecraft.com/member/genmode/)!

#### Ukulele
- The 3rd and upper octave of the Ukulele serves for **chords**.
- This behavior can be toggled within the Ukulele's *Instrument Options*, allowing for an extended 3rd octave *(Treble mode)*.
- MIDI overflow for this instrument cannot surpass the 3rd octave.

#### Djem Djem Drum
- It makes funny sounds

## Advancements

Added 2 new advancements:

### Chasing Waves
Play any of the People of the Springs' instruments

### Master of the Springs
Play all of the People of the Springs' instruments

## Recipes

### The following recipes have changed:
- Arataki's Great and Glorious Drum
- Uses **Spruce Planks** instead of **Acacia Planks**.
- Floral Zither
- Now matches that of the Ukulele and the Even More Instruments! Guitar

## UI Tweaks

- Arataki's Great and Glorious Drum MIDI Options Screen's Dominant Drum Type option is now displayed as a big button instead of a small one

## Tags

### Added:
- `genshin/people_of_the_springs`
- 4 instrument family tags
- `instrument_families/brass`
- `instrument_families/percussion`
- `instrument_families/woodwinds`
- `instrument_families/drums`

### Changes:
- Renamed `genshin_instruments` to `genshin/instruments`

# Fixed:

## MIDI

- On some MIDI devices, releasing a note counts as a note being pressed
- Fixes infinite sustain on sustainable instruments (Nightwind Horn)
- Improper MIDI IN device validation (fixes game freezing)

## Since RC1:

- Fixed Ukulele & Djem Djem Drum not being apart of the "A Band of One" advancement

# Changes

## Instruments

### Added 2 new instruments:
- Ukulele
- Djem Djem Drum
- Textures, as always, made by the awesome [Gen](https://www.planetminecraft.com/member/genmode/)!

#### Ukulele
- The 3rd and upper octave of the Ukulele serves for **chords**.
- This behavior can be toggled within the Ukulele's *Instrument Options*, allowing for an extended 3rd octave *(Treble mode)*.
- MIDI overflow for this instrument cannot surpass the 3rd octave.

#### Djem Djem Drum
- It makes funny sounds

## Advancements

Added 2 new advancements:

### Chasing Waves
Play any of the People of the Springs' instruments

### Master of the Springs
Play all of the People of the Springs' instruments

## Recipes

### The following recipes have changed:
- Arataki's Great and Glorious Drum
- Uses **Spruce Planks** instead of **Acacia Planks**.
- Floral Zither
- Now matches that of the Ukulele and the Even More Instruments! Guitar

## UI Tweaks

- Arataki's Great and Glorious Drum MIDI Options Screen's Dominant Drum Type option is now displayed as a big button instead of a small one

## Tags

### Added:
- `genshin/people_of_the_springs`
- 4 instrument family tags
- `instrument_families/brass`
- `instrument_families/percussion`
- `instrument_families/woodwinds`
- `instrument_families/drums`

### Changes:
- Renamed `genshin_instruments` to `genshin/instruments`

# Fixed:

## MIDI

- On some MIDI devices, releasing a note counts as a note being pressed
- Fixes infinite sustain on sustainable instruments (Nightwind Horn)
- Improper MIDI IN device validation (fixes game freezing)

## Since RC1:

- Fixed Ukulele & Djem Djem Drum not being apart of the "A Band of One" advancement

# Changes

## Instruments

### Added 2 new instruments:
- Ukulele
- Djem Djem Drum
- Textures, as always, made by the awesome [Gen](https://www.planetminecraft.com/member/genmode/)!

#### Ukulele
- The 3rd and upper octave of the Ukulele serves for **chords**.
- This behavior can be toggled within the Ukulele's *Instrument Options*, allowing for an extended 3rd octave *(Treble mode)*.
- MIDI overflow for this instrument cannot surpass the 3rd octave.

#### Djem Djem Drum
- It makes funny sounds

## Advancements

Added 2 new advancements:

### Chasing Waves
Play any of the People of the Springs' instruments

### Master of the Springs
Play all of the People of the Springs' instruments

## Recipes

### The following recipes have changed:
- Arataki's Great and Glorious Drum
- Uses **Spruce Planks** instead of **Acacia Planks**.
- Floral Zither
- Now matches that of the Ukulele and the Even More Instruments! Guitar

## UI Tweaks

- Arataki's Great and Glorious Drum MIDI Options Screen's Dominant Drum Type option is now displayed as a big button instead of a small one

## Tags

### Added:
- `genshin/people_of_the_springs`
- 4 instrument family tags
- `instrument_families/brass`
- `instrument_families/percussion`
- `instrument_families/woodwinds`
- `instrument_families/drums`

### Changes:
- Renamed `genshin_instruments` to `genshin/instruments`

# Fixed:

## MIDI

- On some MIDI devices, releasing a note counts as a note being pressed
- Fixes infinite sustain on sustainable instruments (Nightwind Horn)
- Improper MIDI IN device validation (fixes game freezing)

# Genshin Instruments v4.0.2

## Changes
- Renamed author name to StavWasPlayZ

## Fixed
- Background of instruments sometimes appearing at full alpha
- Instrument block entities not getting properly removed

# Genshin Instruments v4.0.2

## Changes
- Renamed author name to StavWasPlayZ

## Fixed
- Background of instruments sometimes appearing at full alpha
- Instrument block entities not getting properly removed

# Genshin Instruments v4.0.2

## Changes
- Renamed author name to StavWasPlayZ

## Fixed
- Background of instruments sometimes appearing at full alpha
- Instrument block entities not getting properly removed

# Genshin Instruments v4.0.2

## Changes
- Renamed author name to StavWasPlayZ

## Fixed
- Background of instruments sometimes appearing at full alpha
- Instrument block entities not getting properly removed

# Genshin Instruments v4.0.2

## Changes
- Renamed author name to StavWasPlayZ

## Fixed
- Background of instruments sometimes appearing at full alpha
- Instrument block entities not getting properly removed

# Genshin Instruments v4.0.2

## Changes
- Renamed author name to StavWasPlayZ

## Fixed
- Background of instruments sometimes appearing at full alpha
- Instrument block entities not getting properly removed

# Genshin Instruments v4.0.2

## Changes
- Renamed author name to StavWasPlayZ

## Fixed
- Background of instruments sometimes appearing at full alpha
- Instrument block entities not getting properly removed
- Defined version range being incorrect

# Genshin Instruments v4.0.2

## Changes
- Renamed author name to StavWasPlayZ

## Fixed
- Background of instruments sometimes appearing at full alpha
- Instrument block entities not getting properly removed

# Genshin Instruments v4.0.2

## Changes
- Renamed author name to StavWasPlayZ

## Fixed
- Background of instruments sometimes appearing at full alpha
- Instrument block entities not getting properly removed

# Genshin Instruments v4.0.2

## Changes
- Renamed author name to StavWasPlayZ

## Fixed
- Background of instruments sometimes appearing at full alpha
- Instrument block entities not getting properly removed

# Genshin Instruments v4.0.1

Fixed:
- Opening the instrument settings screen causes improper closing of the instrument

# Genshin Instruments v4.0

Hey everyone! Sorry I'm late for the game!

This update introduces the long-awaited **Nightwind Horn**!

Enjoy thy playings!~

## Changes
- Added the **Nightwind Horn**
- The Nightwind Horn is a *sustainable instrument*. You can hold it to make a loooong sound!
- The longer you press, the more echo there will eventually be.
- The sound decays after a period of time.
- Textures, as always, made by the awesome [Gen](https://www.planetminecraft.com/member/genmode/)!
- Added pitch-fixed note layout variants for ABC and do re mi

### MIDI
- MIDI overflows now sound *much* better more polished.
- Before, it would sample the current sound in the octave; and pitch it by 1 octave.
- Now, the sampled sound is always the *highest / lowest* in the instrument, pitched by the offset of the note pressed.
- For example, to play C4, we take B3 - then pitch it up by **1** to get C4.
- Previously, would take C3, then pitch it up by **12** to get a C4.
- The default sensitivty level is now 80%

## Fixed
- Game crashing for some PCs not using English as their language locale
- Players being seen as not playing and not being heard when joining a world or dimension where a player has already entered playing mode
- Incorrect naming of Arataki's Great and Glorious Drum
- Some instrument option toggles' previous value being discarded on screen refresh
- Some MIDI devices' names having weird whitespaces
- **\[FABRIC\]** Mixin conflicts on `Entity#getPersistentData`

## API Changes
Wayy too many lmao.
If you run into migration problems, feel free to contact me, and I'll help you out resolve it directly. I'll dedicate some time to update the wiki in the future.

### Noteable Changes:
- Added the ability to implement custom holdable instruments and sounds via `HeldNoteSoundRegistrar`
- All instrument packet utility methods have been moved from the generic `ServerUtil` to their respective sound type packet util classes (`NoteSoundPacketUtil`, `HeldNoteSoundPacketUtil`).
- Added InstrumentScreenRegistry in place of the old "load it yourself" method. See implementation for more details.
- **\[FABRIC ONLY\]** To add an item to the Instruments tab, you now must use the `GICreativeModeTabs#addToInstrumentsTab`.
- Priority is first given to the Genshin Instruments mod (0), then EMI (1). You should thus set yours starting 3, or (much better) use the `GICreativeModeTabs#getUniquePriority` method to generate your own, consistantly unique priority identifier.
- This generator uses `String#hashCode` on your mod ID, so a hash collision *may* occur? But extroadinarily low chances.
- This works to resolve the messy instruments tab when using EMI.

### Instrument Events
- `InstrumentPlayedEvent` is now divided into `NoteSoundPlayedEvent` and `HeldNoteSoundPlayedEvent`. The original can still be used to catch all said events.
- The `ByPlayer` variants are now integrated into the aforementioned events as an `InstrumentPlayedEvent.EntityInfo` optional.
- Added `InstrumentOpenStateChangedEvent`. Self-explanatory.

---

P.S: I'm sorry this took me an eternity.

Though, you have to still consider that I am the *only* developer and maintainer of this project, so things *will have* to move my speed.

I'm also a student. And I also have other projects.


As you have seen above, I've made *a lot* of changes (over the course of *~4 months!*) to the core mod, whilst also making sure to keep API compatibility and support for both foreign programmers (if any; else still maintain good code practices) - and the Even More Instruments! mod.

I was not prepared for a sustained instrument to be implemented in Genshin, and I thus also did not consider it from the start that I'll *ever* have - or need - to do it. *(maybe as a nieche concept that never will get implemented bc time.)*

Though, evidently, this forced change. And forced change it did.
And if you don't believe me, [see it for yourself](https://github.com/StavWasPlayZ/Genshin-Instruments/compare/7a9992b06331787b3e89ad004a3ec0bbd4404c2cd39860437204e1940d75f1d65a536fc67235cdce).

I did not even have the time to play the new summer event :(

Anyways, let's hope that the Natlan instrument doesn't have a new, game-breaking mechanic again.
Else... Yeah, mental teardown.

(Otherwise, addition should be swift! :3)

# Genshin Instruments v4.0

Hey everyone! Sorry I'm late for the game!

This update introduces the long-awaited **Nightwind Horn**!

Enjoy thy playings!~

## Changes
- Added the **Nightwind Horn**
- The Nightwind Horn is a *sustainable instrument*. You can hold it to make a loooong sound!
- The longer you press, the more echo there will eventually be.
- The sound decays after a period of time.
- Textures, as always, made by the awesome [Gen](https://www.planetminecraft.com/member/genmode/)!
- Added pitch-fixed note layout variants for ABC and do re mi

### MIDI
- MIDI overflows now sound *much* better more polished.
- Before, it would sample the current sound in the octave; and pitch it by 1 octave.
- Now, the sampled sound is always the *highest / lowest* in the instrument, pitched by the offset of the note pressed.
- For example, to play C4, we take B3 - then pitch it up by **1** to get C4.
- Previously, would take C3, then pitch it up by **12** to get a C4.
- The default sensitivty level is now 80%

## Fixed
- Game crashing for some PCs not using English as their language locale
- Players being seen as not playing and not being heard when joining a world or dimension where a player has already entered playing mode
- Incorrect naming of Arataki's Great and Glorious Drum
- Some instrument option toggles' previous value being discarded on screen refresh
- Some MIDI devices' names having weird whitespaces

## API Changes
Wayy too many lmao.
If you run into migration problems, feel free to contact me, and I'll help you out resolve it directly. I'll dedicate some time to update the wiki in the future.

### Noteable Changes:
- Added the ability to implement custom holdable instruments and sounds via `HeldNoteSoundRegistrar`
- All instrument packet utility methods have been moved from the generic `ServerUtil` to their respective sound type packet util classes (`NoteSoundPacketUtil`, `HeldNoteSoundPacketUtil`).
- Added InstrumentScreenRegistry in place of the old "load it yourself" method. See implementation for more details.
- **\[FABRIC ONLY\]** To add an item to the Instruments tab, you now must use the `GICreativeModeTabs#addToInstrumentsTab`.
- Priority is first given to the Genshin Instruments mod (0), then EMI (1). You should thus set yours starting 3, or (much better) use the `GICreativeModeTabs#getUniquePriority` method to generate your own, consistantly unique priority identifier.
- This generator uses `String#hashCode` on your mod ID, so a hash collision *may* occur? But extroadinarily low chances.
- This works to resolve the messy instruments tab when using EMI.

### Instrument Events
- `InstrumentPlayedEvent` is now divided into `NoteSoundPlayedEvent` and `HeldNoteSoundPlayedEvent`. The original can still be used to catch all said events.
- The `ByPlayer` variants are now integrated into the aforementioned events as an `InstrumentPlayedEvent.EntityInfo` optional.
- Added `InstrumentOpenStateChangedEvent`. Self-explanatory.

---

P.S: I'm sorry this took me an eternity.

Though, you have to still consider that I am the *only* developer and maintainer of this project, so things *will have* to move my speed.

I'm also a student. And I also have other projects.


As you have seen above, I've made *a lot* of changes (over the course of *~4 months!*) to the core mod, whilst also making sure to keep API compatibility and support for both foreign programmers (if any; else still maintain good code practices) - and the Even More Instruments! mod.

I was not prepared for a sustained instrument to be implemented in Genshin, and I thus also did not consider it from the start that I'll *ever* have - or need - to do it. *(maybe as a nieche concept that never will get implemented bc time.)*

Though, evidently, this forced change. And forced change it did.
And if you don't believe me, [see it for yourself](https://github.com/StavWasPlayZ/Genshin-Instruments/compare/7a9992b06331787b3e89ad004a3ec0bbd4404c2cd39860437204e1940d75f1d65a536fc67235cdce).

I did not even have the time to play the new summer event :(

Anyways, let's hope that the Natlan instrument doesn't have a new, game-breaking mechanic again.
Else... Yeah, mental teardown.

(Otherwise, addition should be swift! :3)

## Fixed:
- Opening the instrument settings screen causes improper closing of the instrument

# Genshin Instruments v4.0

Hey everyone! Sorry I'm late for the game!

This update introduces the long-awaited **Nightwind Horn**!

Enjoy thy playings!~

## Changes
- Added the **Nightwind Horn**
- The Nightwind Horn is a *sustainable instrument*. You can hold it to make a loooong sound!
- The longer you press, the more echo there will eventually be.
- The sound decays after a period of time.
- Textures, as always, made by the awesome [Gen](https://www.planetminecraft.com/member/genmode/)!
- Added pitch-fixed note layout variants for ABC and do re mi

### MIDI
- MIDI overflows now sound *much* better more polished.
- Before, it would sample the current sound in the octave; and pitch it by 1 octave.
- Now, the sampled sound is always the *highest / lowest* in the instrument, pitched by the offset of the note pressed.
- For example, to play C4, we take B3 - then pitch it up by **1** to get C4.
- Previously, would take C3, then pitch it up by **12** to get a C4.
- The default sensitivty level is now 80%

## Fixed
- Game crashing for some PCs not using English as their language locale
- Players being seen as not playing and not being heard when joining a world or dimension where a player has already entered playing mode
- Incorrect naming of Arataki's Great and Glorious Drum
- Some instrument option toggles' previous value being discarded on screen refresh
- Some MIDI devices' names having weird whitespaces
- **\[FABRIC\]** Mixin conflicts on `Entity#getPersistentData`

## API Changes
Wayy too many lmao.
If you run into migration problems, feel free to contact me, and I'll help you out resolve it directly. I'll dedicate some time to update the wiki in the future.

### Noteable Changes:
- Added the ability to implement custom holdable instruments and sounds via `HeldNoteSoundRegistrar`
- All instrument packet utility methods have been moved from the generic `ServerUtil` to their respective sound type packet util classes (`NoteSoundPacketUtil`, `HeldNoteSoundPacketUtil`).
- Added InstrumentScreenRegistry in place of the old "load it yourself" method. See implementation for more details.
- **\[FABRIC ONLY\]** To add an item to the Instruments tab, you now must use the `GICreativeModeTabs#addToInstrumentsTab`.
- Priority is first given to the Genshin Instruments mod (0), then EMI (1). You should thus set yours starting 3, or (much better) use the `GICreativeModeTabs#getUniquePriority` method to generate your own, consistantly unique priority identifier.
- This generator uses `String#hashCode` on your mod ID, so a hash collision *may* occur? But extroadinarily low chances.
- This works to resolve the messy instruments tab when using EMI.

### Instrument Events
- `InstrumentPlayedEvent` is now divided into `NoteSoundPlayedEvent` and `HeldNoteSoundPlayedEvent`. The original can still be used to catch all said events.
- The `ByPlayer` variants are now integrated into the aforementioned events as an `InstrumentPlayedEvent.EntityInfo` optional.
- Added `InstrumentOpenStateChangedEvent`. Self-explanatory.

---

P.S: I'm sorry this took me an eternity.

Though, you have to still consider that I am the *only* developer and maintainer of this project, so things *will have* to move my speed.

I'm also a student. And I also have other projects.


As you have seen above, I've made *a lot* of changes (over the course of *~4 months!*) to the core mod, whilst also making sure to keep API compatibility and support for both foreign programmers (if any; else still maintain good code practices) - and the Even More Instruments! mod.

I was not prepared for a sustained instrument to be implemented in Genshin, and I thus also did not consider it from the start that I'll *ever* have - or need - to do it. *(maybe as a nieche concept that never will get implemented bc time.)*

Though, evidently, this forced change. And forced change it did.
And if you don't believe me, [see it for yourself](https://github.com/StavWasPlayZ/Genshin-Instruments/compare/7a9992b06331787b3e89ad004a3ec0bbd4404c2cd39860437204e1940d75f1d65a536fc67235cdce).

I did not even have the time to play the new summer event :(

Anyways, let's hope that the Natlan instrument doesn't have a new, game-breaking mechanic again.
Else... Yeah, mental teardown.

(Otherwise, addition should be swift! :3)

# Genshin Instruments v4.0

Hey everyone! Sorry I'm late for the game!

This update introduces the long-awaited **Nightwind Horn**!

Enjoy thy playings!~

## Changes
- Added the **Nightwind Horn**
- The Nightwind Horn is a *sustainable instrument*. You can hold it to make a loooong sound!
- The longer you press, the more echo there will eventually be.
- The sound decays after a period of time.
- Textures, as always, made by the awesome [Gen](https://www.planetminecraft.com/member/genmode/)!
- Added pitch-fixed note layout variants for ABC and do re mi

### MIDI
- MIDI overflows now sound *much* better more polished.
- Before, it would sample the current sound in the octave; and pitch it by 1 octave.
- Now, the sampled sound is always the *highest / lowest* in the instrument, pitched by the offset of the note pressed.
- For example, to play C4, we take B3 - then pitch it up by **1** to get C4.
- Previously, would take C3, then pitch it up by **12** to get a C4.
- The default sensitivty level is now 80%

## Fixed
- Game crashing for some PCs not using English as their language locale
- Players being seen as not playing and not being heard when joining a world or dimension where a player has already entered playing mode
- Incorrect naming of Arataki's Great and Glorious Drum
- Some instrument option toggles' previous value being discarded on screen refresh
- Some MIDI devices' names having weird whitespaces

## API Changes
Wayy too many lmao.
If you run into migration problems, feel free to contact me, and I'll help you out resolve it directly. I'll dedicate some time to update the wiki in the future.

### Noteable Changes:
- Added the ability to implement custom holdable instruments and sounds via `HeldNoteSoundRegistrar`
- All instrument packet utility methods have been moved from the generic `ServerUtil` to their respective sound type packet util classes (`NoteSoundPacketUtil`, `HeldNoteSoundPacketUtil`).
- Added InstrumentScreenRegistry in place of the old "load it yourself" method. See implementation for more details.
- **\[FABRIC ONLY\]** To add an item to the Instruments tab, you now must use the `GICreativeModeTabs#addToInstrumentsTab`.
- Priority is first given to the Genshin Instruments mod (0), then EMI (1). You should thus set yours starting 3, or (much better) use the `GICreativeModeTabs#getUniquePriority` method to generate your own, consistantly unique priority identifier.
- This generator uses `String#hashCode` on your mod ID, so a hash collision *may* occur? But extroadinarily low chances.
- This works to resolve the messy instruments tab when using EMI.

### Instrument Events
- `InstrumentPlayedEvent` is now divided into `NoteSoundPlayedEvent` and `HeldNoteSoundPlayedEvent`. The original can still be used to catch all said events.
- The `ByPlayer` variants are now integrated into the aforementioned events as an `InstrumentPlayedEvent.EntityInfo` optional.
- Added `InstrumentOpenStateChangedEvent`. Self-explanatory.

---

P.S: I'm sorry this took me an eternity.

Though, you have to still consider that I am the *only* developer and maintainer of this project, so things *will have* to move my speed.

I'm also a student. And I also have other projects.


As you have seen above, I've made *a lot* of changes (over the course of *~4 months!*) to the core mod, whilst also making sure to keep API compatibility and support for both foreign programmers (if any; else still maintain good code practices) - and the Even More Instruments! mod.

I was not prepared for a sustained instrument to be implemented in Genshin, and I thus also did not consider it from the start that I'll *ever* have - or need - to do it. *(maybe as a nieche concept that never will get implemented bc time.)*

Though, evidently, this forced change. And forced change it did.
And if you don't believe me, [see it for yourself](https://github.com/StavWasPlayZ/Genshin-Instruments/compare/7a9992b06331787b3e89ad004a3ec0bbd4404c2cd39860437204e1940d75f1d65a536fc67235cdce).

I did not even have the time to play the new summer event :(

Anyways, let's hope that the Natlan instrument doesn't have a new, game-breaking mechanic again.
Else... Yeah, mental teardown.

(Otherwise, addition should be swift! :3)

# Genshin Instruments v4.0

Hey everyone! Sorry I'm late for the game!

This update introduces the long-awaited **Nightwind Horn**!

Enjoy thy playings!~

## Changes
- Added the **Nightwind Horn**
- The Nightwind Horn is a *sustainable instrument*. You can hold it to make a loooong sound!
- The longer you press, the more echo there will eventually be.
- The sound decays after a period of time.
- Textures, as always, made by the awesome [Gen](https://www.planetminecraft.com/member/genmode/)!
- Added pitch-fixed note layout variants for ABC and do re mi

### MIDI
- MIDI overflows now sound *much* better more polished.
- Before, it would sample the current sound in the octave; and pitch it by 1 octave.
- Now, the sampled sound is always the *highest / lowest* in the instrument, pitched by the offset of the note pressed.
- For example, to play C4, we take B3 - then pitch it up by **1** to get C4.
- Previously, would take C3, then pitch it up by **12** to get a C4.
- The default sensitivty level is now 80%

## Fixed
- Game crashing for some PCs not using English as their language locale
- Players being seen as not playing and not being heard when joining a world or dimension where a player has already entered playing mode
- Incorrect naming of Arataki's Great and Glorious Drum
- Some instrument option toggles' previous value being discarded on screen refresh
- Some MIDI devices' names having weird whitespaces

## API Changes
Wayy too many lmao.
If you run into migration problems, feel free to contact me, and I'll help you out resolve it directly. I'll dedicate some time to update the wiki in the future.

### Noteable Changes:
- Added the ability to implement custom holdable instruments and sounds via `HeldNoteSoundRegistrar`
- All instrument packet utility methods have been moved from the generic `ServerUtil` to their respective sound type packet util classes (`NoteSoundPacketUtil`, `HeldNoteSoundPacketUtil`).
- Added InstrumentScreenRegistry in place of the old "load it yourself" method. See implementation for more details.
- **\[FABRIC ONLY\]** To add an item to the Instruments tab, you now must use the `GICreativeModeTabs#addToInstrumentsTab`.
- Priority is first given to the Genshin Instruments mod (0), then EMI (1). You should thus set yours starting 3, or (much better) use the `GICreativeModeTabs#getUniquePriority` method to generate your own, consistantly unique priority identifier.
- This generator uses `String#hashCode` on your mod ID, so a hash collision *may* occur? But extroadinarily low chances.
- This works to resolve the messy instruments tab when using EMI.

### Instrument Events
- `InstrumentPlayedEvent` is now divided into `NoteSoundPlayedEvent` and `HeldNoteSoundPlayedEvent`. The original can still be used to catch all said events.
- The `ByPlayer` variants are now integrated into the aforementioned events as an `InstrumentPlayedEvent.EntityInfo` optional.
- Added `InstrumentOpenStateChangedEvent`. Self-explanatory.

---

P.S: I'm sorry this took me an eternity.

Though, you have to still consider that I am the *only* developer and maintainer of this project, so things *will have* to move my speed.

I'm also a student. And I also have other projects.


As you have seen above, I've made *a lot* of changes (over the course of *~4 months!*) to the core mod, whilst also making sure to keep API compatibility and support for both foreign programmers (if any; else still maintain good code practices) - and the Even More Instruments! mod.

I was not prepared for a sustained instrument to be implemented in Genshin, and I thus also did not consider it from the start that I'll *ever* have - or need - to do it. *(maybe as a nieche concept that never will get implemented bc time.)*

Though, evidently, this forced change. And forced change it did.
And if you don't believe me, [see it for yourself](https://github.com/StavWasPlayZ/Genshin-Instruments/compare/7a9992b06331787b3e89ad004a3ec0bbd4404c2cd39860437204e1940d75f1d65a536fc67235cdce).

I did not even have the time to play the new summer event :(

Anyways, let's hope that the Natlan instrument doesn't have a new, game-breaking mechanic again.
Else... Yeah, mental teardown.

(Otherwise, addition should be swift! :3)

# Genshin Instruments v4.0

Hey everyone! Sorry I'm late for the game!

This update introduces the long-awaited **Nightwind Horn**!

Enjoy thy playings!~

## Changes
- Added the **Nightwind Horn**
- The Nightwind Horn is a *sustainable instrument*. You can hold it to make a loooong sound!
- The longer you press, the more echo there will eventually be.
- The sound decays after a period of time.
- Textures, as always, made by the awesome [Gen](https://www.planetminecraft.com/member/genmode/)!
- Added pitch-fixed note layout variants for ABC and do re mi

### MIDI
- MIDI overflows now sound *much* better more polished.
- Before, it would sample the current sound in the octave; and pitch it by 1 octave.
- Now, the sampled sound is always the *highest / lowest* in the instrument, pitched by the offset of the note pressed.
- For example, to play C4, we take B3 - then pitch it up by **1** to get C4.
- Previously, would take C3, then pitch it up by **12** to get a C4.
- The default sensitivty level is now 80%

## Fixed
- Game crashing for some PCs not using English as their language locale
- Players being seen as not playing and not being heard when joining a world or dimension where a player has already entered playing mode
- Incorrect naming of Arataki's Great and Glorious Drum
- Some instrument option toggles' previous value being discarded on screen refresh
- Some MIDI devices' names having weird whitespaces

## API Changes
Wayy too many lmao.
If you run into migration problems, feel free to contact me, and I'll help you out resolve it directly. I'll dedicate some time to update the wiki in the future.

### Noteable Changes:
- Added the ability to implement custom holdable instruments and sounds via `HeldNoteSoundRegistrar`
- All instrument packet utility methods have been moved from the generic `ServerUtil` to their respective sound type packet util classes (`NoteSoundPacketUtil`, `HeldNoteSoundPacketUtil`).
- Added InstrumentScreenRegistry in place of the old "load it yourself" method. See implementation for more details.
- **\[FABRIC ONLY\]** To add an item to the Instruments tab, you now must use the `GICreativeModeTabs#addToInstrumentsTab`.
- Priority is first given to the Genshin Instruments mod (0), then EMI (1). You should thus set yours starting 3, or (much better) use the `GICreativeModeTabs#getUniquePriority` method to generate your own, consistantly unique priority identifier.
- This generator uses `String#hashCode` on your mod ID, so a hash collision *may* occur? But extroadinarily low chances.
- This works to resolve the messy instruments tab when using EMI.

### Instrument Events
- `InstrumentPlayedEvent` is now divided into `NoteSoundPlayedEvent` and `HeldNoteSoundPlayedEvent`. The original can still be used to catch all said events.
- The `ByPlayer` variants are now integrated into the aforementioned events as an `InstrumentPlayedEvent.EntityInfo` optional.
- Added `InstrumentOpenStateChangedEvent`. Self-explanatory.

---

P.S: I'm sorry this took me an eternity.

Though, you have to still consider that I am the *only* developer and maintainer of this project, so things *will have* to move my speed.

I'm also a student. And I also have other projects.


As you have seen above, I've made *a lot* of changes (over the course of *~4 months!*) to the core mod, whilst also making sure to keep API compatibility and support for both foreign programmers (if any; else still maintain good code practices) - and the Even More Instruments! mod.

I was not prepared for a sustained instrument to be implemented in Genshin, and I thus also did not consider it from the start that I'll *ever* have - or need - to do it. *(maybe as a nieche concept that never will get implemented bc time.)*

Though, evidently, this forced change. And forced change it did.
And if you don't believe me, [see it for yourself](https://github.com/StavWasPlayZ/Genshin-Instruments/compare/7a9992b06331787b3e89ad004a3ec0bbd4404c2cd39860437204e1940d75f1d65a536fc67235cdce).

I did not even have the time to play the new summer event :(

Anyways, let's hope that the Natlan instrument doesn't have a new, game-breaking mechanic again.
Else... Yeah, mental teardown.

(Otherwise, addition should be swift! :3)

# Fixed - v3.4.1.1:
- NeoForge update listener
- Instrument background decorations sometimes not blending (alpha at 100%)

# Fixed - v3.4.1.1:
- NeoForge update listener
- Instrument background decorations sometimes not blending (alpha at 100%)

This version proposes API tweaks & changes, long-awaited community suggestions, and preparation for v4.0's new wind instrument.

# Changes
- Added Chinese support by charmaznable & SteveNotSet
- Added GUI visibility toggle (MoonstruckLucii suggestion)

## Achievements
- Master achievement now grants 5exp
- Root achievement now takes in any instrument, not just Genshin ones
- Specified Master achievement to be Genshin-specific

## MIDI
- New slider added: Sensitivity
Allows the player to control how sensitive dynamic touch input should be

## Technical
- Fixed conventional key namings in Player's InstrumentOpen NBT capability

### Tags
- New tag group: `genshin_instruments` to specify genshin-specific instruments

### API
- Moved wind instruments support from Even More Instruments! to Genshin Instruments

# Fixed
- Do-ReMi and Don-Ka labeling
- Volume slider saving a way too accurate representation of volume
- Potential resource leaks while reading Instrument styler sheets

This version proposes API tweaks & changes, long-awaited community suggestions, and preparation for v4.0's new wind instrument.

# Changes
- Added Chinese support by charmaznable & SteveNotSet
- Added GUI visibility toggle (MoonstruckLucii suggestion)

## Achievements
- Master achievement now grants 5exp
- Root achievement now takes in any instrument, not just Genshin ones
- Specified Master achievement to be Genshin-specific

## MIDI
- New slider added: Sensitivity
Allows the player to control how sensitive dynamic touch input should be

## Technical
- Fixed conventional key namings in Player's InstrumentOpen NBT capability

### Tags
- New tag group: `genshin_instruments` to specify genshin-specific instruments

### API
- Moved wind instruments support from Even More Instruments! to Genshin Instruments

# Fixed
- Do-ReMi and Don-Ka labeling
- Volume slider saving a way too accurate representation of volume
- Potential resource leaks while reading Instrument styler sheets

This version proposes API tweaks & changes, long-awaited community suggestions, and preparation for v4.0's new wind instrument.

# Changes
- Added Chinese support by charmaznable & SteveNotSet
- Added GUI visibility toggle (MoonstruckLucii suggestion)

## Achievements
- Master achievement now grants 5exp
- Root achievement now takes in any instrument, not just Genshin ones
- Specified Master achievement to be Genshin-specific

## MIDI
- New slider added: Sensitivity
Allows the player to control how sensitive dynamic touch input should be

## Technical
- Fixed conventional key namings in Player's InstrumentOpen NBT capability

### Tags
- New tag group: `genshin_instruments` to specify genshin-specific instruments

### API
- Moved wind instruments support from Even More Instruments! to Genshin Instruments

# Fixed
- Do-ReMi and Don-Ka labeling
- Volume slider saving a way too accurate representation of volume
- Potential resource leaks while reading Instrument styler sheets
- Instrument buttons sometimes appearing black (Forge-only)

This version proposes API tweaks & changes, long-awaited community suggestions, and preparation for v4.0's new wind instrument.

# Changes
- Added Chinese support by charmaznable & SteveNotSet
- Added GUI visibility toggle (MoonstruckLucii suggestion)

## Achievements
- Master achievement now grants 5exp
- Root achievement now takes in any instrument, not just Genshin ones
- Specified Master achievement to be Genshin-specific

## MIDI
- New slider added: Sensitivity
Allows the player to control how sensitive dynamic touch input should be

## Technical
- Fixed conventional key namings in Player's InstrumentOpen NBT capability

### Tags
- New tag group: `genshin_instruments` to specify genshin-specific instruments

### API
- Moved wind instruments support from Even More Instruments! to Genshin Instruments

# Fixed
- Do-ReMi and Don-Ka labeling
- Volume slider saving a way too accurate representation of volume
- Potential resource leaks while reading Instrument styler sheets
- Instrument buttons sometimes appearing black (Forge-only)

This version proposes API tweaks & changes, long-awaited community suggestions, and preparation for v4.0's new wind instrument.

# Changes
- Added Chinese support by charmaznable & SteveNotSet
- Added GUI visibility toggle (MoonstruckLucii suggestion)

## Achievements
- Master achievement now grants 5exp
- Root achievement now takes in any instrument, not just Genshin ones
- Specified Master achievement to be Genshin-specific

## MIDI
- New slider added: Sensitivity
Allows the player to control how sensitive dynamic touch input should be

## Technical
- Fixed conventional key namings in Player's InstrumentOpen NBT capability

### Tags
- New tag group: `genshin_instruments` to specify genshin-specific instruments

### API
- Moved wind instruments support from Even More Instruments! to Genshin Instruments

# Fixed
- Do-ReMi and Don-Ka labeling
- Volume slider saving a way too accurate representation of volume
- Potential resource leaks while reading Instrument styler sheets

This version proposes API tweaks & changes, long-awaited community suggestions, and preparation for v4.0's new wind instrument.

# Changes
- Added Chinese support by charmaznable & SteveNotSet
- Added GUI visibility toggle (MoonstruckLucii suggestion)

## Achievements
- Master achievement now grants 5exp
- Root achievement now takes in any instrument, not just Genshin ones
- Specified Master achievement to be Genshin-specific

## MIDI
- New slider added: Sensitivity
Allows the player to control how sensitive dynamic touch input should be

## Technical
- Fixed conventional key namings in Player's InstrumentOpen NBT capability

### Tags
- New tag group: `genshin_instruments` to specify genshin-specific instruments

### API
- Moved wind instruments support from Even More Instruments! to Genshin Instruments

# Fixed
- Do-ReMi and Don-Ka labeling
- Volume slider saving a way too accurate representation of volume
- Potential resource leaks while reading Instrument styler sheets
- Instrument buttons sometimes appearing black (Forge-only)

This version proposes API tweaks & changes, long-awaited community suggestions, and preparation for v4.0's new wind instrument.

# Changes
- Added Chinese support by charmaznable & SteveNotSet
- Added GUI visibility toggle (MoonstruckLucii suggestion)

## Achievements
- Master achievement now grants 5exp
- Root achievement now takes in any instrument, not just Genshin ones
- Specified Master achievement to be Genshin-specific

## MIDI
- New slider added: Sensitivity
Allows the player to control how sensitive dynamic touch input should be

## Technical
- Fixed conventional key namings in Player's InstrumentOpen NBT capability

### Tags
- New tag group: `genshin_instruments` to specify genshin-specific instruments

### API
- Moved wind instruments support from Even More Instruments! to Genshin Instruments

# Fixed
- Do-ReMi and Don-Ka labeling
- Volume slider saving a way too accurate representation of volume
- Potential resource leaks while reading Instrument styler sheets

This version proposes API tweaks & changes, long-awaited community suggestions, and preparation for v4.0's new wind instrument.

# Changes
- Added Chinese support by charmaznable & SteveNotSet
- Added GUI visibility toggle (MoonstruckLucii suggestion)

## Achievements
- Master achievement now grants 5exp
- Root achievement now takes in any instrument, not just Genshin ones
- Specified Master achievement to be Genshin-specific

## MIDI
- New slider added: Sensitivity
Allows the player to control how sensitive dynamic touch input should be

## Technical
- Fixed conventional key namings in Player's InstrumentOpen NBT capability

### Tags
- New tag group: `genshin_instruments` to specify genshin-specific instruments

### API
- Moved wind instruments support from Even More Instruments! to Genshin Instruments

# Fixed
- Do-ReMi and Don-Ka labeling
- Volume slider saving a way too accurate representation of volume
- Potential resource leaks while reading Instrument styler sheets
- Instrument buttons sometimes appearing black (Forge-only)

This patch introduces support for Minecraft 1.18.2, as well as a whole lot of bugfixes and feature tweaks, more efficient networking, and major API changes.
Let's explore it!


# Changes
- Major networking tweaks. Expect less delay in Multiplayer!
- Added ability to normalize the Vintage Lyre - converting it to a C major key. Enabled by default.
- Advancement background is now note-block textured
- ABC layout has been re-introduced

## MIDI
- The drum now toggles its usage from exlusively left to both left and right. It's just a visual thing, but a nice one imo
- Minimum MIDI velocity is now 6

## Technical
- Instrument JSON styler format has been refined. Legacy styler formats are still supported (for now), but are recommended to upgrade.
- Added model predicate `"genshinstrument:instrument_open"`
- Fixed incorrect assignment of `isOpen` tag for instrument open capability (Forge-only)
- Played hand has been added to the instrument open capability
- Added various more log messages for debugging


# Fixed:
- Random crashes upon opening an instrument
- Lower buttons pannel not centered
- (API) Instruments with 8 or more rows crashing on note layout


As per all patches since v3.0 (;-;), this is, like, 99% the last update feature update. Unless some issues arises.
I've been working tirelessly on this patch for the past few months, and I hope it will prove worthy! :)
So see you in, what's hopefully, v4.0!

This patch introduces support for Minecraft 1.18.2, as well as a whole lot of bugfixes and feature tweaks, more efficient networking, and major API changes.
Let's explore it!


# Changes
- Major networking tweaks. Expect less delay in Multiplayer!
- Added ability to normalize the Vintage Lyre - converting it to a C major key. Enabled by default.
- Advancement background is now note-block textured
- ABC layout has been re-introduced

## MIDI
- The drum now toggles its usage from exlusively left to both left and right. It's just a visual thing, but a nice one imo
- Minimum MIDI velocity is now 6

## Technical
- Instrument JSON styler format has been refined. Legacy styler formats are still supported (for now), but are recommended to upgrade.
- Added model predicate `"genshinstrument:instrument_open"`
- Fixed incorrect assignment of `isOpen` tag for instrument open capability (Forge-only)
- Played hand has been added to the instrument open capability
- Added various more log messages for debugging


# Fixed:
- Random crashes upon opening an instrument
- Lower buttons pannel not centered
- (API) Instruments with 8 or more rows crashing on note layout


As per all patches since v3.0 (;-;), this is, like, 99% the last update feature update. Unless some issues arises.
I've been working tirelessly on this patch for the past few months, and I hope it will prove worthy! :)
So see you in, what's hopefully, v4.0!

This patch introduces support for Minecraft 1.18.2, as well as a whole lot of bugfixes and feature tweaks, more efficient networking, and major API changes.
Let's explore it!


# Changes
- Major networking tweaks. Expect less delay in Multiplayer!
- Added ability to normalize the Vintage Lyre - converting it to a C major key. Enabled by default.
- Advancement background is now note-block textured
- ABC layout has been re-introduced

## MIDI
- The drum now toggles its usage from exlusively left to both left and right. It's just a visual thing, but a nice one imo
- Minimum MIDI velocity is now 6

## Technical
- Instrument JSON styler format has been refined. Legacy styler formats are still supported (for now), but are recommended to upgrade.
- Added model predicate `"genshinstrument:instrument_open"`
- Played hand has been added to the instrument open capability
- Added various more log messages for debugging


# Fixed:
- Drum note labels not properly saving (Fabric-only)
- Random crashes upon opening an instrument
- Lower buttons pannel not centered
- (API) Instruments with 8 or more rows crashing on note layout


As per all patches since v3.0 (;-;), this is, like, 99% the last update feature update. Unless some issues arises.
I've been working tirelessly on this patch for the past few months, and I hope it will prove worthy! :)
So see you in, what's hopefully, v4.0!

This patch introduces support for Minecraft 1.18.2, as well as a whole lot of bugfixes and feature tweaks, more efficient networking, and major API changes.
Let's explore it!


# Changes
- Major networking tweaks. Expect less delay in Multiplayer!
- Added ability to normalize the Vintage Lyre - converting it to a C major key. Enabled by default.
- Advancement background is now note-block textured
- ABC layout has been re-introduced

## MIDI
- The drum now toggles its usage from exlusively left to both left and right. It's just a visual thing, but a nice one imo
- Minimum MIDI velocity is now 6

## Technical
- Instrument JSON styler format has been refined. Legacy styler formats are still supported (for now), but are recommended to upgrade.
- Added model predicate `"genshinstrument:instrument_open"`
- Played hand has been added to the instrument open capability
- Added various more log messages for debugging


# Fixed:
- Drum note labels not properly saving (Fabric-only)
- Random crashes upon opening an instrument
- Lower buttons pannel not centered
- (API) Instruments with 8 or more rows crashing on note layout


As per all patches since v3.0 (;-;), this is, like, 99% the last update feature update. Unless some issues arises.
I've been working tirelessly on this patch for the past few months, and I hope it will prove worthy! :)
So see you in, what's hopefully, v4.0!

This patch introduces support for Minecraft 1.18.2, as well as a whole lot of bugfixes and feature tweaks, more efficient networking, and major API changes.
Let's explore it!


# Changes
- Major networking tweaks. Expect less delay in Multiplayer!
- Added ability to normalize the Vintage Lyre - converting it to a C major key. Enabled by default.
- Advancement background is now note-block textured
- ABC layout has been re-introduced

## MIDI
- The drum now toggles its usage from exlusively left to both left and right. It's just a visual thing, but a nice one imo
- Minimum MIDI velocity is now 6

## Technical
- Instrument JSON styler format has been refined. Legacy styler formats are still supported (for now), but are recommended to upgrade.
- Added model predicate `"genshinstrument:instrument_open"`
- Fixed incorrect assignment of `isOpen` tag for instrument open capability (Forge-only)
- Played hand has been added to the instrument open capability
- Added various more log messages for debugging


# Fixed:
- Random crashes upon opening an instrument
- Lower buttons pannel not centered
- (API) Instruments with 8 or more rows crashing on note layout


As per all patches since v3.0 (;-;), this is, like, 99% the last update feature update. Unless some issues arises.
I've been working tirelessly on this patch for the past few months, and I hope it will prove worthy! :)
So see you in, what's hopefully, v4.0!

This patch introduces support for Minecraft 1.18.2, as well as a whole lot of bugfixes and feature tweaks, more efficient networking, and major API changes.
Let's explore it!


# Changes
- Major networking tweaks. Expect less delay in Multiplayer!
- Added ability to normalize the Vintage Lyre - converting it to a C major key. Enabled by default.
- Advancement background is now note-block textured
- ABC layout has been re-introduced

## MIDI
- The drum now toggles its usage from exlusively left to both left and right. It's just a visual thing, but a nice one imo
- Minimum MIDI velocity is now 6

## Technical
- Instrument JSON styler format has been refined. Legacy styler formats are still supported (for now), but are recommended to upgrade.
- Added model predicate `"genshinstrument:instrument_open"`
- Played hand has been added to the instrument open capability
- Added various more log messages for debugging


# Fixed:
- Drum note labels not properly saving (Fabric-only)
- Random crashes upon opening an instrument
- Lower buttons pannel not centered
- (API) Instruments with 8 or more rows crashing on note layout


As per all patches since v3.0 (;-;), this is, like, 99% the last update feature update. Unless some issues arises.
I've been working tirelessly on this patch for the past few months, and I hope it will prove worthy! :)
So see you in, what's hopefully, v4.0!

This patch introduces support for Minecraft 1.18.2, as well as a whole lot of bugfixes and feature tweaks, more efficient networking, and major API changes.
Let's explore it!


# Changes
- Major networking tweaks. Expect less delay in Multiplayer!
- Added ability to normalize the Vintage Lyre - converting it to a C major key. Enabled by default.
- Advancement background is now note-block textured
- ABC layout has been re-introduced

## MIDI
- The drum now toggles its usage from exlusively left to both left and right. It's just a visual thing, but a nice one imo
- Minimum MIDI velocity is now 6

## Technical
- Instrument JSON styler format has been refined. Legacy styler formats are still supported (for now), but are recommended to upgrade.
- Added model predicate `"genshinstrument:instrument_open"`
- Played hand has been added to the instrument open capability
- Added various more log messages for debugging


# Fixed:
- Drum note labels not properly saving (Fabric-only)
- Random crashes upon opening an instrument
- Lower buttons pannel not centered
- (API) Instruments with 8 or more rows crashing on note layout


As per all patches since v3.0 (;-;), this is, like, 99% the last update feature update. Unless some issues arises.
I've been working tirelessly on this patch for the past few months, and I hope it will prove worthy! :)
So see you in, what's hopefully, v4.0!

This patch introduces support for Minecraft 1.18.2, as well as a whole lot of bugfixes and feature tweaks, more efficient networking, and major API changes.
Let's explore it!


# Changes
- Major networking tweaks. Expect less delay in Multiplayer!
- Added ability to normalize the Vintage Lyre - converting it to a C major key. Enabled by default.
- Advancement background is now note-block textured
- ABC layout has been re-introduced

## MIDI
- The drum now toggles its usage from exlusively left to both left and right. It's just a visual thing, but a nice one imo
- Minimum MIDI velocity is now 6

## Technical
- Instrument JSON styler format has been refined. Legacy styler formats are still supported (for now), but are recommended to upgrade.
- Added model predicate `"genshinstrument:instrument_open"`
- Fixed incorrect assignment of `isOpen` tag for instrument open capability (Forge-only)
- Played hand has been added to the instrument open capability
- Added various more log messages for debugging


# Fixed:
- Random crashes upon opening an instrument
- Lower buttons pannel not centered
- (API) Instruments with 8 or more rows crashing on note layout


As per all patches since v3.0 (;-;), this is, like, 99% the last update feature update. Unless some issues arises.
I've been working tirelessly on this patch for the past few months, and I hope it will prove worthy! :)
So see you in, what's hopefully, v4.0!

This patch introduces support for Minecraft 1.18.2, as well as a whole lot of bugfixes and feature tweaks, more efficient networking, and major API changes.
Let's explore it!


# Changes
- Major networking tweaks. Expect less delay in Multiplayer!
- Added ability to normalize the Vintage Lyre - converting it to a C major key. Enabled by default.
- Advancement background is now note-block textured
- ABC layout has been re-introduced

## MIDI
- The drum now toggles its usage from exlusively left to both left and right. It's just a visual thing, but a nice one imo
- Minimum MIDI velocity is now 6

## Technical
- Instrument JSON styler format has been refined. Legacy styler formats are still supported (for now), but are recommended to upgrade.
- Added model predicate `"genshinstrument:instrument_open"`
- Fixed incorrect assignment of `isOpen` tag for instrument open capability (Forge-only)
- Played hand has been added to the instrument open capability
- Added various more log messages for debugging


# Fixed:
- Tooltips not showing (1.19.2)
- Random crashes upon opening an instrument
- Lower buttons pannel not centered
- (API) Instruments with 8 or more rows crashing on note layout


As per all patches since v3.0 (;-;), this is, like, 99% the last update feature update. Unless some issues arises.
I've been working tirelessly on this patch for the past few months, and I hope it will prove worthy! :)
So see you in, what's hopefully, v4.0!

This patch introduces support for Minecraft 1.18.2, as well as a whole lot of bugfixes and feature tweaks, more efficient networking, and major API changes.
Let's explore it!


# Changes
- Major networking tweaks. Expect less delay in Multiplayer!
- Added ability to normalize the Vintage Lyre - converting it to a C major key. Enabled by default.
- Advancement background is now note-block textured
- ABC layout has been re-introduced

## MIDI
- The drum now toggles its usage from exlusively left to both left and right. It's just a visual thing, but a nice one imo
- Minimum MIDI velocity is now 6

## Technical
- Instrument JSON styler format has been refined. Legacy styler formats are still supported (for now), but are recommended to upgrade.
- Added model predicate `"genshinstrument:instrument_open"`
- Played hand has been added to the instrument open capability
- Added various more log messages for debugging


# Fixed:
- Tooltips not showing (1.19.2)
- Drum note labels not properly saving (Fabric-only)
- Random crashes upon opening an instrument
- Lower buttons pannel not centered
- (API) Instruments with 8 or more rows crashing on note layout


As per all patches since v3.0 (;-;), this is, like, 99% the last update feature update. Unless some issues arises.
I've been working tirelessly on this patch for the past few months, and I hope it will prove worthy! :)
So see you in, what's hopefully, v4.0!

This patch introduces support for Minecraft 1.18.2, as well as a whole lot of bugfixes and feature tweaks, more efficient networking, and major API changes.
Let's explore it!


# Changes
- Backported mod to Minecraft 1.18.2!
- Major networking tweaks. Expect less delay in Multiplayer!
- Added ability to normalize the Vintage Lyre - converting it to a C major key. Enabled by default.
- Advancement background is now note-block textured
- ABC layout has been re-introduced

## MIDI
- The drum now toggles its usage from exlusively left to both left and right. It's just a visual thing, but a nice one imo
- Minimum MIDI velocity is now 6

## Technical
- Instrument JSON styler format has been refined. Legacy styler formats are still supported (for now), but are recommended to upgrade.
- Added model predicate `"genshinstrument:instrument_open"`
- Fixed incorrect assignment of `isOpen` tag for instrument open capability (Forge-only)
- Played hand has been added to the instrument open capability
- Added various more log messages for debugging


# Fixed:
- Tooltips not showing (1.19.2)
- Random crashes upon opening an instrument
- Lower buttons pannel not centered
- (API) Instruments with 8 or more rows crashing on note layout


As per all patches since v3.0 (;-;), this is, like, 99% the last update feature update. Unless some issues arises.
I've been working tirelessly on this patch for the past few months, and I hope it will prove worthy! :)
So see you in, what's hopefully, v4.0!

This patch introduces support for Minecraft 1.18.2, as well as a whole lot of bugfixes and feature tweaks, more efficient networking, and major API changes.
Let's explore it!


# Changes
- Backported mod to Minecraft 1.18.2!
- Major networking tweaks. Expect less delay in Multiplayer!
- Added ability to normalize the Vintage Lyre - converting it to a C major key. Enabled by default.
- Advancement background is now note-block textured
- ABC layout has been re-introduced

## MIDI
- The drum now toggles its usage from exlusively left to both left and right. It's just a visual thing, but a nice one imo
- Minimum MIDI velocity is now 6

## Technical
- Instrument JSON styler format has been refined. Legacy styler formats are still supported (for now), but are recommended to upgrade.
- Added model predicate `"genshinstrument:instrument_open"`
- Played hand has been added to the instrument open capability
- Added various more log messages for debugging


# Fixed:
- Tooltips not showing (1.19.2)
- Drum note labels not properly saving (Fabric-only)
- Random crashes upon opening an instrument
- Lower buttons pannel not centered
- (API) Instruments with 8 or more rows crashing on note layout


As per all patches since v3.0 (;-;), this is, like, 99% the last update feature update. Unless some issues arises.
I've been working tirelessly on this patch for the past few months, and I hope it will prove worthy! :)
So see you in, what's hopefully, v4.0!

# v3.3.1.1
Fixed shared instrument option not being present (Fabric only)

# v3.3.1
## Changes:
- Updated mod to Minecraft 1.20.2!
- Reworked instrument textures by [GenMode](https://modrinth.com/user/GenMode)!
- Pitch slider now has character-accurate accidental symbols
- Added instrument volume slider (for sounds produced by you; heard by all other players)
- Sliced all GUI textures (except accidentals) (complied with 1.20.2's GUI atlases "deprecation")
- The root advancement "A Bard's Journey" is now an announceable toast
## MIDI
- Supports for Touch (dynamic volumes determined by input velocity)
- Added the option to disable this behavior ("Fixed Touch")
- MIDI pedal input is now supported by multisound instruments (such as the Zither) to toggle between 2 different sound types
- Added option to listen to a specific/all MIDI channels
- Octave shifting is now bound from -5 to 5 (previously -4/4)

## Fixed:
- QWERTY layout option showing for QWERTY users
- Infinitely reloading resources if no instrument styler was found

Right, last one. For sures.

# Changes:
- Bumped mod to Minecraft 1.20.2!
- Reworked instrument textures by [GenMode](https://modrinth.com/user/GenMode)!
- Pitch slider now has character-accurate accidental symbols
- Added instrument volume slider (for sounds produced by you; heard by all other players)
- Sliced all GUI textures (except accidentals) (complied with 1.20.2's GUI atlases "deprecation")
- The root advancement "A Bard's Journey" is now an announceable toast
## MIDI
- Supports for Touch (dynamic volumes determined by input velocity)
- Added the option to disable this behavior ("Fixed Touch")
- MIDI pedal input is now supported by multisound instruments (such as the Zither) to toggle between 2 different sound types
- Added option to listen to a specific/all MIDI channels
- Octave shifting is now bound from -5 to 5 (previously -4/4)

# Fixed:
- QWERTY layout option showing for QWERTY users
- Infinitely reloading resources if no instrument styler was found

Right, last one. For sures.

# Changes:
- Reworked instrument textures by [GenMode](https://modrinth.com/user/GenMode)!
- Pitch slider now has character-accurate accidental symbols
- Added instrument volume slider (for sounds produced by you; heard by all other players)
- Sliced all GUI textures (except accidentals) (complied with 1.20.2's GUI atlases "deprecation")
- The root advancement "A Bard's Journey" is now an announceable toast
## MIDI
- Supports for Touch (dynamic volumes determined by input velocity)
- Added the option to disable this behavior ("Fixed Touch")
- MIDI pedal input is now supported by multisound instruments (such as the Zither) to toggle between 2 different sound types
- Added option to listen to a specific/all MIDI channels
- Octave shifting is now bound from -5 to 5 (previously -4/4)

# Fixed:
- QWERTY layout option showing for QWERTY users
- Infinitely reloading resources if no instrument styler was found

Right, last one. For sures.

# Changes:
- Reworked instrument textures by [GenMode](https://modrinth.com/user/GenMode)!
- Pitch slider now has character-accurate accidental symbols
- Added instrument volume slider (for sounds produced by you; heard by all other players)
- Sliced all GUI textures (except accidentals) (complied with 1.20.2's GUI atlases "deprecation")
- The root advancement "A Bard's Journey" is now an announceable toast
## MIDI
- Supports for Touch (dynamic volumes determined by input velocity)
- Added the option to disable this behavior ("Fixed Touch")
- MIDI pedal input is now supported by multisound instruments (such as the Zither) to toggle between 2 different sound types
- Added option to listen to a specific/all MIDI channels
- Octave shifting is now bound from -5 to 5 (previously -4/4)

# Fixed:
- QWERTY layout option showing for QWERTY users
- Infinitely reloading resources if no instrument styler was found

Right, last one. For sures.

# Changes:
- Reworked instrument textures by [GenMode](https://modrinth.com/user/GenMode)!
- Pitch slider now has character-accurate accidental symbols
- Added instrument volume slider (for sounds produced by you; heard by all other players)
- Sliced all GUI textures (except accidentals) (complied with 1.20.2's GUI atlases "deprecation")
- The root advancement "A Bard's Journey" is now an announceable toast
## MIDI
- Supports for Touch (dynamic volumes determined by input velocity)
- Added the option to disable this behavior ("Fixed Touch")
- MIDI pedal input is now supported by multisound instruments (such as the Zither) to toggle between 2 different sound types
- Added option to listen to a specific/all MIDI channels
- Octave shifting is now bound from -5 to 5 (previously -4/4)

# Fixed:
- QWERTY layout option showing for QWERTY users
- Infinitely reloading resources if no instrument styler was found

Right, last one. For sures.

# Changes:
- Reworked instrument textures by [GenMode](https://modrinth.com/user/GenMode)!
- Pitch slider now has character-accurate accidental symbols
- Added instrument volume slider (for sounds produced by you; heard by all other players)
- Sliced all GUI textures (except accidentals) (complied with 1.20.2's GUI atlases "deprecation")
- The root advancement "A Bard's Journey" is now an announceable toast
## MIDI
- Supports for Touch (dynamic volumes determined by input velocity)
- Added the option to disable this behavior ("Fixed Touch")
- MIDI pedal input is now supported by multisound instruments (such as the Zither) to toggle between 2 different sound types
- Added option to listen to a specific/all MIDI channels
- Octave shifting is now bound from -5 to 5 (previously -4/4)

# Fixed:
- QWERTY layout option showing for QWERTY users
- Infinitely reloading resources if no instrument styler was found

Right, last one. For sures.

# Changes:
- Reworked instrument textures by [GenMode](https://modrinth.com/user/GenMode)!
- Pitch slider now has character-accurate accidental symbols
- Added instrument volume slider (for sounds produced by you; heard by all other players)
- Sliced all GUI textures (except accidentals) (complied with 1.20.2's GUI atlases "deprecation")
- The root advancement "A Bard's Journey" is now an announceable toast
## MIDI
- Supports for Touch (dynamic volumes determined by input velocity)
- Added the option to disable this behavior ("Fixed Touch")
- MIDI pedal input is now supported by multisound instruments (such as the Zither) to toggle between 2 different sound types
- Added option to listen to a specific/all MIDI channels
- Octave shifting is now bound from -5 to 5 (previously -4/4)

# Fixed:
- QWERTY layout option showing for QWERTY users
- Infinitely reloading resources if no instrument styler was found

Right, last one. For sures.

# Changes:
- Reworked instrument textures by [GenMode](https://modrinth.com/user/GenMode)!
- Pitch slider now has character-accurate accidental symbols
- Added instrument volume slider (for sounds produced by you; heard by all other players)
- Sliced all GUI textures (except accidentals) (complied with 1.20.2's GUI atlases "deprecation")
- The root advancement "A Bard's Journey" is now an announceable toast
## MIDI
- Supports for Touch (dynamic volumes determined by input velocity)
- Added the option to disable this behavior ("Fixed Touch")
- MIDI pedal input is now supported by multisound instruments (such as the Zither) to toggle between 2 different sound types
- Added option to listen to a specific/all MIDI channels
- Octave shifting is now bound from -5 to 5 (previously -4/4)

# Fixed:
- QWERTY layout option showing for QWERTY users
- Infinitely reloading resources if no instrument styler was found

Right, last one. For sures.

# Changes:
- Reworked instrument textures by [GenMode](https://modrinth.com/user/GenMode)!
- Pitch slider now has character-accurate accidental symbols
- Added instrument volume slider (for sounds produced by you; heard by all other players)
- Sliced all GUI textures (except accidentals) (complied with 1.20.2's GUI atlases "deprecation")
- The root advancement "A Bard's Journey" is now an announceable toast
## MIDI
- Supports for Touch (dynamic volumes determined by input velocity)
- Added the option to disable this behavior ("Fixed Touch")
- MIDI pedal input is now supported by multisound instruments (such as the Zither) to toggle between 2 different sound types
- Added option to listen to a specific/all MIDI channels
- Octave shifting is now bound from -5 to 5 (previously -4/4)

# Fixed:
- QWERTY layout option showing for QWERTY users
- Infinitely reloading resources if no instrument styler was found

Right, last one. For sures.

# Changes:
- Reworked instrument textures by [GenMode](https://modrinth.com/user/GenMode)!
- Pitch slider now has character-accurate accidental symbols
- Added instrument volume slider (for sounds produced by you; heard by all other players)
- Sliced all GUI textures (except accidentals) (complied with 1.20.2's GUI atlases "deprecation")
- The root advancement "A Bard's Journey" is now an announceable toast
## MIDI
- Supports for Touch (dynamic volumes determined by input velocity)
- Added the option to disable this behavior ("Fixed Touch")
- MIDI pedal input is now supported by multisound instruments (such as the Zither) to toggle between 2 different sound types
- Added option to listen to a specific/all MIDI channels
- Octave shifting is now bound from -5 to 5 (previously -4/4)

# Fixed:
- QWERTY layout option showing for QWERTY users
- Infinitely reloading resources if no instrument styler was found

Remeber when I said that v3.0 is the last feature patch? and v3.1?
.. Ahem

I am truely ending this off introducing **MIDI SUPPORT!**
This is a feature I dreamed of implementing for too long, and seeing it finally come to fruitation is nothing short of amazing to me!

Also, with the introduction of global resource pack, I may be able to craft some pretty fancy stuff for you, guys! Do stay tuned for that :D

Aside from any future bugs, I no longer plan to update this mod with any new features. Burnout has long since kicked in (proof on github :p), and studies continue literally this week (assuming our government gets its stuff together). I want to properly enjoy my final days of freedom for once 😴


# Changes
- The default transposition keys are now <kbd>Left Shift</kbd> for up and <kbd>Left Alt</kbd> for down
- Global texture packs! Modify `is_global_pack` under `genshinstrument:textures/gui/instrument/instruments.meta.json` to enable
## MIDI Support!
- **Extend accidentals**: When overflowing the notes on a MIDI device, will automatically adjust the pitch to low/high C respectively (Blame Minecraft for the limitation).
- **Octave Shifting**: Shifts Middle C's location by the specified index (Up to 7 octaves on both sides [-4 / 4]).
## Note Layouts
- Added QWERTY layout labels (shown to users who are using any other layout)
- Arataki's Great and Glorious Drum now has Note Name and Do Re Mi layouts
- When the Accurate Notes option is off, will show the unicode-accurate accidental symbols *(♯ and ♭)* for Do Re Mi and Note Name layouts
- Do Re Mi layout is now all lowercase
- Removed ABC-type layouts

# Fixed
- Transposition keys not working on instrument options screen
- Sound type instrument screens (Floral Zither) overflowing to lower buttons
- Bright pixels on the Floral Zither's texture


See you in (most likely) v4.0!

Remeber when I said that v3.0 is the last feature patch? and v3.1?
.. Ahem

I am truely ending this off introducing **MIDI SUPPORT!**
This is a feature I dreamed of implementing for too long, and seeing it finally come to fruitation is nothing short of amazing to me!

Also, with the introduction of global resource pack, I may be able to craft some pretty fancy stuff for you, guys! Do stay tuned for that :D

Aside from any future bugs, I no longer plan to update this mod with any new features. Burnout has long since kicked in (proof on github :p), and studies continue literally this week (assuming our government gets its stuff together). I want to properly enjoy my final days of freedom for once 😴


# Changes
- Global texture packs! Modify `is_global_pack` under `genshinstrument:textures/gui/instrument/instruments.meta.json` to enable
## MIDI Support!
- **Extend accidentals**: When overflowing the notes on a MIDI device, will automatically adjust the pitch to low/high C respectively (Blame Minecraft for the limitation).
- **Octave Shifting**: Shifts Middle C's location by the specified index (Up to 7 octaves on both sides [-4 / 4]).
## Note Layouts
- Added QWERTY layout labels (shown to users who are using any other layout)
- Arataki's Great and Glorious Drum now has Note Name and Do Re Mi layouts
- When the Accurate Notes option is off, will show the unicode-accurate accidental symbols *(♯ and ♭)* for Do Re Mi and Note Name layouts
- Do Re Mi layout is now all lowercase
- Removed ABC-type layouts

# Fixed
- Transposition keys not working on instrument options screen
- Sound type instrument screens (Floral Zither) overflowing to lower buttons
- Bright pixels on the Floral Zither's texture


See you in (most likely) v4.0!

Remeber when I said that v3.0 is the last feature patch? and v3.1?
.. Ahem

I am truely ending this off introducing **MIDI SUPPORT!**
This is a feature I dreamed of implementing for too long, and seeing it finally come to fruitation is nothing short of amazing to me!

Also, with the introduction of global resource pack, I may be able to craft some pretty fancy stuff for you, guys! Do stay tuned for that :D

Aside from any future bugs, I no longer plan to update this mod with any new features. Burnout has long since kicked in (proof on github :p), and studies continue literally this week (assuming our government gets its stuff together). I want to properly enjoy my final days of freedom for once 😴


# Changes
- The default transposition keys are now <kbd>Left Shift</kbd> for up and <kbd>Left Alt</kbd> for down
- Global texture packs! Modify `is_global_pack` under `genshinstrument:textures/gui/instrument/instruments.meta.json` to enable
## MIDI Support!
- **Extend accidentals**: When overflowing the notes on a MIDI device, will automatically adjust the pitch to low/high C respectively (Blame Minecraft for the limitation).
- **Octave Shifting**: Shifts Middle C's location by the specified index (Up to 7 octaves on both sides [-4 / 4]).
## Note Layouts
- Added QWERTY layout labels (shown to users who are using any other layout)
- Arataki's Great and Glorious Drum now has Note Name and Do Re Mi layouts
- When the Accurate Notes option is off, will show the unicode-accurate accidental symbols *(♯ and ♭)* for Do Re Mi and Note Name layouts
- Do Re Mi layout is now all lowercase
- Removed ABC-type layouts

# Fixed
- Transposition keys not working on instrument options screen
- Sound type instrument screens (Floral Zither) overflowing to lower buttons
- Bright pixels on the Floral Zither's texture


See you in (most likely) v4.0!

Remeber when I said that v3.0 is the last feature patch? and v3.1?
.. Ahem

I am truely ending this off introducing **MIDI SUPPORT!**
This is a feature I dreamed of implementing for too long, and seeing it finally come to fruitation is nothing short of amazing to me!

Also, with the introduction of global resource pack, I may be able to craft some pretty fancy stuff for you, guys! Do stay tuned for that :D

Aside from any future bugs, I no longer plan to update this mod with any new features. Burnout has long since kicked in (proof on github :p), and studies continue literally this week (assuming our government gets its stuff together). I want to properly enjoy my final days of freedom for once 😴


# Changes
- Global texture packs! Modify `is_global_pack` under `genshinstrument:textures/gui/instrument/instruments.meta.json` to enable
## MIDI Support!
- **Extend accidentals**: When overflowing the notes on a MIDI device, will automatically adjust the pitch to low/high C respectively (Blame Minecraft for the limitation).
- **Octave Shifting**: Shifts Middle C's location by the specified index (Up to 7 octaves on both sides [-4 / 4]).
## Note Layouts
- Added QWERTY layout labels (shown to users who are using any other layout)
- Arataki's Great and Glorious Drum now has Note Name and Do Re Mi layouts
- When the Accurate Notes option is off, will show the unicode-accurate accidental symbols *(♯ and ♭)* for Do Re Mi and Note Name layouts
- Do Re Mi layout is now all lowercase
- Removed ABC-type layouts

# Fixed
- Transposition keys not working on instrument options screen
- Sound type instrument screens (Floral Zither) overflowing to lower buttons
- Bright pixels on the Floral Zither's texture


See you in (most likely) v4.0!

Remeber when I said that v3.0 is the last feature patch? and v3.1?
.. Ahem

I am truely ending this off introducing **MIDI SUPPORT!**
This is a feature I dreamed of implementing for too long, and seeing it finally come to fruitation is nothing short of amazing to me!

Also, with the introduction of global resource pack, I may be able to craft some pretty fancy stuff for you, guys! Do stay tuned for that :D

Aside from any future bugs, I no longer plan to update this mod with any new features. Burnout has long since kicked in (proof on github :p), and studies continue literally this week (assuming our government gets its stuff together). I want to properly enjoy my final days of freedom for once 😴


# Changes
- The default transposition keys are now <kbd>Left Shift</kbd> for up and <kbd>Left Alt</kbd> for down
- Global texture packs! Modify `is_global_pack` under `genshinstrument:textures/gui/instrument/instruments.meta.json` to enable
## MIDI Support!
- **Extend accidentals**: When overflowing the notes on a MIDI device, will automatically adjust the pitch to low/high C respectively (Blame Minecraft for the limitation).
- **Octave Shifting**: Shifts Middle C's location by the specified index (Up to 7 octaves on both sides [-4 / 4]).
## Note Layouts
- Added QWERTY layout labels (shown to users who are using any other layout)
- Arataki's Great and Glorious Drum now has Note Name and Do Re Mi layouts
- When the Accurate Notes option is off, will show the unicode-accurate accidental symbols *(♯ and ♭)* for Do Re Mi and Note Name layouts
- Do Re Mi layout is now all lowercase
- Removed ABC-type layouts

# Fixed
- Transposition keys not working on instrument options screen
- Sound type instrument screens (Floral Zither) overflowing to lower buttons
- Bright pixels on the Floral Zither's texture


See you in (most likely) v4.0!

Remeber when I said that v3.0 is the last feature patch? and v3.1?
.. Ahem

I am truely ending this off introducing **MIDI SUPPORT!**
This is a feature I dreamed of implementing for too long, and seeing it finally come to fruitation is nothing short of amazing to me!

Also, with the introduction of global resource pack, I may be able to craft some pretty fancy stuff for you, guys! Do stay tuned for that :D

Aside from any future bugs, I no longer plan to update this mod with any new features. Burnout has long since kicked in (proof on github :p), and studies continue literally this week (assuming our government gets its stuff together). I want to properly enjoy my final days of freedom for once 😴


# Changes
- Global texture packs! Modify `is_global_pack` under `genshinstrument:textures/gui/instrument/instruments.meta.json` to enable
## MIDI Support!
- **Extend accidentals**: When overflowing the notes on a MIDI device, will automatically adjust the pitch to low/high C respectively (Blame Minecraft for the limitation).
- **Octave Shifting**: Shifts Middle C's location by the specified index (Up to 7 octaves on both sides [-4 / 4]).
## Note Layouts
- Added QWERTY layout labels (shown to users who are using any other layout)
- Arataki's Great and Glorious Drum now has Note Name and Do Re Mi layouts
- When the Accurate Notes option is off, will show the unicode-accurate accidental symbols *(♯ and ♭)* for Do Re Mi and Note Name layouts
- Do Re Mi layout is now all lowercase
- Removed ABC-type layouts

# Fixed
- Transposition keys not working on instrument options screen
- Sound type instrument screens (Floral Zither) overflowing to lower buttons
- Bright pixels on the Floral Zither's texture


See you in (most likely) v4.0!

Remeber when I said that v3.0 is the last feature patch? and v3.1?
.. Ahem

I am truely ending this off introducing **MIDI SUPPORT!**
This is a feature I dreamed of implementing for too long, and seeing it finally come to fruitation is nothing short of amazing to me!

Also, with the introduction of global resource pack, I may be able to craft some pretty fancy stuff for you, guys! Do stay tuned for that :D

Aside from any future bugs, I no longer plan to update this mod with any new features. Burnout has long since kicked in (proof on github :p), and studies continue literally this week (assuming our government gets its stuff together). I want to properly enjoy my final days of freedom for once 😴


# Changes
- Global texture packs! Modify `is_global_pack` under `genshinstrument:textures/gui/instrument/instruments.meta.json` to enable
## MIDI Support!
- **Extend accidentals**: When overflowing the notes on a MIDI device, will automatically adjust the pitch to low/high C respectively (Blame Minecraft for the limitation).
- **Octave Shifting**: Shifts Middle C's location by the specified index (Up to 7 octaves on both sides [-4 / 4]).
## Note Layouts
- Added QWERTY layout labels (shown to users who are using any other layout)
- Arataki's Great and Glorious Drum now has Note Name and Do Re Mi layouts
- When the Accurate Notes option is off, will show the unicode-accurate accidental symbols *(♯ and ♭)* for Do Re Mi and Note Name layouts
- Do Re Mi layout is now all lowercase
- Removed ABC-type layouts

# Fixed
- Transposition keys not working on instrument options screen
- Sound type instrument screens (Floral Zither) overflowing to lower buttons
- Bright pixels on the Floral Zither's texture


See you in (most likely) v4.0!

Remeber when I said that v3.0 is the last feature patch? and v3.1?
.. Ahem

I am truely ending this off introducing **MIDI SUPPORT!**
This is a feature I dreamed of implementing for too long, and seeing it finally come to fruitation is nothing short of amazing to me!

Also, with the introduction of global resource pack, I may be able to craft some pretty fancy stuff for you, guys! Do stay tuned for that :D

Aside from any future bugs, I no longer plan to update this mod with any new features. Burnout has long since kicked in (proof on github :p), and studies continue literally this week (assuming our government gets its stuff together). I want to properly enjoy my final days of freedom for once 😴


# Changes
- The default transposition keys are now <kbd>Left Shift</kbd> for up and <kbd>Left Alt</kbd> for down
- Global texture packs! Modify `is_global_pack` under `genshinstrument:textures/gui/instrument/instruments.meta.json` to enable
## MIDI Support!
- **Extend accidentals**: When overflowing the notes on a MIDI device, will automatically adjust the pitch to low/high C respectively (Blame Minecraft for the limitation).
- **Octave Shifting**: Shifts Middle C's location by the specified index (Up to 7 octaves on both sides [-4 / 4]).
## Note Layouts
- Added QWERTY layout labels (shown to users who are using any other layout)
- Arataki's Great and Glorious Drum now has Note Name and Do Re Mi layouts
- When the Accurate Notes option is off, will show the unicode-accurate accidental symbols *(♯ and ♭)* for Do Re Mi and Note Name layouts
- Do Re Mi layout is now all lowercase
- Removed ABC-type layouts

# Fixed
- Transposition keys not working on instrument options screen
- Sound type instrument screens (Floral Zither) overflowing to lower buttons
- Bright pixels on the Floral Zither's texture


See you in (most likely) v4.0!

Backported the mod to Minecraft 1.19.2

### Changes:
- New transposition system! Use the set keybinds to pitch your instruments up or down by 1 semitone (default: Left Alt = down, Right Alt = up).
### Fixed:
- Humongous notes on large GUI scales
- Note: it is recommended to use fixed GUI scales and not automatic ones!
- Block instruments not closing at far distances
- Pitch Db being default rather than C

Backported the mod to Minecraft 1.19.3

### Changes:
- New transposition system! Use the set keybinds to pitch your instruments up or down by 1 semitone (default: Left Alt = down, Right Alt = up).
### Fixed:
- Humongous notes on large GUI scales
- Note: it is recommended to use fixed GUI scales and not automatic ones!
- Block instruments not closing at far distances
- Pitch Db being default rather than C

Backported the mod to Minecraft 1.19.4

### Changes:
- New transposition system! Use the set keybinds to pitch your instruments up or down by 1 semitone (default: Left Alt = down, Right Alt = up).
### Fixed:
- Humongous notes on large GUI scales
- Note: it is recommended to use fixed GUI scales and not automatic ones!
- Block instruments not closing at far distances
- Pitch Db being default rather than C

Backported the mod to Minecraft 1.20

### Changes:
- New transposition system! Use the set keybinds to pitch your instruments up or down by 1 semitone (default: Left Alt = down, Right Alt = up).
### Fixed:
- Humongous notes on large GUI scales
- Note: it is recommended to use fixed GUI scales and not automatic ones!
- Block instruments not closing at far distances
- Pitch Db being default rather than C

Migrated the mod to Fabric!

### Changes:
- New transposition system! Use the set keybinds to pitch your instruments up or down by 1 semitone (default: Left Alt = down, Right Alt = up).
### Fixed:
- Humongous notes on large GUI scales
- Note: it is recommended to use fixed GUI scales and not automatic ones!
- Block instruments not closing at far distances
- Pitch Db being default rather than C

Backported mod to Minecraft version 1.19.2

# Changes up to v3.2.3

## v3.2.3
### Changes:
- New transposition system! Use the set keybinds to pitch your instruments up or down by 1 semitone (default: Left Shift = down, Right Shift = up).
### Fixed:
- Humongous notes on large GUI scales
- Note: it is recommended to use fixed GUI scales and not automatic ones!
- Block instruments not closing at far distances
- Pitch Db being default rather than C

## v3.2.2
- Fixed Forge config screen crashing
- General networking optimizations

Backported mod to Minecraft version 1.19.3

# Changes up to v3.2.3

## v3.2.3
### Changes:
- New transposition system! Use the set keybinds to pitch your instruments up or down by 1 semitone (default: Left Shift = down, Right Shift = up).
### Fixed:
- Humongous notes on large GUI scales
- Note: it is recommended to use fixed GUI scales and not automatic ones!
- Block instruments not closing at far distances
- Pitch Db being default rather than C

## v3.2.2
- Fixed Forge config screen crashing
- General networking optimizations

Backported mod to Minecraft version 1.19.4

# Changes up to v3.2.3

## v3.2.3
### Changes:
- New transposition system! Use the set keybinds to pitch your instruments up or down by 1 semitone (default: Left Shift = down, Right Shift = up).
### Fixed:
- Humongous notes on large GUI scales
- Note: it is recommended to use fixed GUI scales and not automatic ones!
- Block instruments not closing at far distances
- Pitch Db being default rather than C

## v3.2.2
- Fixed Forge config screen crashing
- General networking optimizations

Backported mod to Minecraft version 1.20

# Changes up to v3.2.3

## v3.2.3
### Changes:
- New transposition system! Use the set keybinds to pitch your instruments up or down by 1 semitone (default: Left Shift = down, Right Shift = up).
### Fixed:
- Humongous notes on large GUI scales
- Note: it is recommended to use fixed GUI scales and not automatic ones!
- Block instruments not closing at far distances
- Pitch Db being default rather than C

## v3.2.2
- Fixed Forge config screen crashing
- General networking optimizations

Definitely the last feature update!! 😭

# Changes up to v3.2.3

## v3.2.3
### Changes:
- New transposition system! Use the set keybinds to pitch your instruments up or down by 1 semitone (default: Left Shift = down, Right Shift = up).
### Fixed:
- Humongous notes on large GUI scales
- Note: it is recommended to use fixed GUI scales and not automatic ones!
- Block instruments not closing at far distances
- Pitch Db being default rather than C

## v3.2.2
- Fixed Forge config screen crashing
- General networking optimizations

Backported the mod to Minecraft 1.19.2

# Changes up to v3.2.2

## v3.2.2
- Fixed modmenu config screen crashing
- General networking optimizations

## 3.2.1
Minor networking optimization

## v3.2
### Changes:
- The Glorious Drum is now more similar to Genshin's
- Pitch now affects the representation of note symbols in addition to accidentals, resulting in ✨accurate notes✨
### Fixed:
- Incompatibility with Visual Overhaul mod
- Note symbols being offset and sometimes funky
- Game crashing upon having instrument options open & clearing one's inventory

Backported the mod to Minecraft 1.19.3

# Changes up to v3.2.2

## v3.2.2
- Fixed modmenu config screen crashing
- General networking optimizations

## 3.2.1
Minor networking optimization

## v3.2
### Changes:
- The Glorious Drum is now more similar to Genshin's
- Pitch now affects the representation of note symbols in addition to accidentals, resulting in ✨accurate notes✨
### Fixed:
- Incompatibility with Visual Overhaul mod
- Note symbols being offset and sometimes funky
- Game crashing upon having instrument options open & clearing one's inventory

Backported the mod to Minecraft 1.19.4

# Changes up to v3.2.2

## v3.2.2
- Fixed modmenu config screen crashing
- General networking optimizations

## 3.2.1
Minor networking optimization

## v3.2
### Changes:
- The Glorious Drum is now more similar to Genshin's
- Pitch now affects the representation of note symbols in addition to accidentals, resulting in ✨accurate notes✨
### Fixed:
- Incompatibility with Visual Overhaul mod
- Note symbols being offset and sometimes funky
- Game crashing upon having instrument options open & clearing one's inventory

Backported the mod to Minecraft 1.20

# Changes up to v3.2.2

## v3.2.2
- Fixed modmenu config screen crashing
- General networking optimizations

## 3.2.1
Minor networking optimization

## v3.2
### Changes:
- The Glorious Drum is now more similar to Genshin's
- Pitch now affects the representation of note symbols in addition to accidentals, resulting in ✨accurate notes✨
### Fixed:
- Incompatibility with Visual Overhaul mod
- Note symbols being offset and sometimes funky
- Game crashing upon having instrument options open & clearing one's inventory

Migrated mod to Fabric!

# Changes up to v3.2.2

## v3.2.2
- Fixed modmenu config screen crashing
- General networking optimizations

## 3.2.1
Minor networking optimization

## v3.2
### Changes:
- The Glorious Drum is now more similar to Genshin's
- Pitch now affects the representation of note symbols in addition to accidentals, resulting in ✨accurate notes✨
### Fixed:
- Note symbols being offset and sometimes funky
- Game crashing upon having instrument options open & clearing one's inventory

Backported mod to Minecraft version 1.19.2

# Changes up to v3.2.1

## 3.2.1
Fixed some players being unable to receive any of the mod's packets (packets were being incorrectly registered)

## v3.2
### Changes:
- The Glorious Drum is now more similar to Genshin's
- Pitch now affects the representation of note symbols in addition to accidentals, resulting in ✨accurate notes✨
### Fixed:
- Incompatibility with Visual Overhaul mod
- Note symbols being offset and sometimes funky
- Game crashing upon having instrument options open & clearing one's inventory

Backported mod to Minecraft version 1.19.3

# Changes up to v3.2.1

## 3.2.1
Fixed some players being unable to receive any of the mod's packets (packets were being incorrectly registered)

## v3.2
### Changes:
- The Glorious Drum is now more similar to Genshin's
- Pitch now affects the representation of note symbols in addition to accidentals, resulting in ✨accurate notes✨
### Fixed:
- Incompatibility with Visual Overhaul mod
- Note symbols being offset and sometimes funky
- Game crashing upon having instrument options open & clearing one's inventory

Backported mod to Minecraft version 1.19.4

# Changes up to v3.2.1

## 3.2.1
Fixed some players being unable to receive any of the mod's packets (packets were being incorrectly registered)

## v3.2
### Changes:
- The Glorious Drum is now more similar to Genshin's
- Pitch now affects the representation of note symbols in addition to accidentals, resulting in ✨accurate notes✨
### Fixed:
- Incompatibility with Visual Overhaul mod
- Note symbols being offset and sometimes funky
- Game crashing upon having instrument options open & clearing one's inventory

Fixed some players being unable to receive any of the mod's packets (packets were being incorrectly registered)

Fixed some players being unable to receive any of the mod's packets (packets were being incorrectly registered)

Backported mod to Minecraft version 1.20


# Changes:
- The Glorious Drum is now more similar to Genshin's
- Pitch now affects the representation of note symbols in addition to accidentals, resulting in ✨accurate notes✨
# Fixed:
- Incompatibility with Visual Overhaul mod
- Note symbols being offset and sometimes funky
- Game crashing upon having instrument options open & clearing one's inventory

DEFINITELY LAST ONE!! HUGE CHANGES!! AAAA IM EXCITED
Even More Instruments?? 👀👀

# Changes:
- The Glorious Drum is now more similar to Genshin's
- Pitch now affects the representation of note symbols in addition to accidentals, resulting in ✨accurate notes✨
# Fixed:
- Incompatibility with Visual Overhaul mod
- Note symbols being offset and sometimes funky
- Game crashing upon having instrument options open & clearing one's inventory

Removed log messages; fixed incompatibility with Visual Overhaul mod

Attempted to fix crashing issues for Fabric 1.20.1.

Please report any issues to: https://github.com/StavWasPlayZ/Genshin-Instruments-Fabric/issues

Attempted to fix crashing issues for Fabric 1.20.1.

Please report any issues to: https://github.com/StavWasPlayZ/Genshin-Instruments-Fabric/issues

Backported the mod to Minecraft version 1.19.2


## Changes:
- Improved instrument textures
- Pitch is now determined by accurate note scales
- This thus fixes the issue of inaccurate representations of note labels & accidentals

## Fixed:
- Zither's sound type button overflowing to the Done button
- Left-hand display of instruments
- Note buttons' text labels overflowing to the instrument options
- Issues playing with navigation

Backported the mod to Minecraft version 1.19.3


## Changes:
- Improved instrument textures
- Pitch is now determined by accurate note scales
- This thus fixes the issue of inaccurate representations of note labels & accidentals

## Fixed:
- Zither's sound type button overflowing to the Done button
- Left-hand display of instruments
- Note buttons' text labels overflowing to the instrument options
- Issues playing with navigation

Backported the mod to Minecraft version 1.19.4


## Changes:
- Improved instrument textures
- Pitch is now determined by accurate note scales
- This thus fixes the issue of inaccurate representations of note labels & accidentals

## Fixed:
- Zither's sound type button overflowing to the Done button
- Left-hand display of instruments
- Note buttons' text labels overflowing to the instrument options

Backported the mod to Minecraft version 1.20


## Changes:
- Improved instrument textures
- Pitch is now determined by accurate note scales
- This thus fixes the issue of inaccurate representations of note labels & accidentals

## Fixed:
- Zither's sound type button overflowing to the Done button
- Left-hand display of instruments
- Note buttons' text labels overflowing to the instrument options

Fixed shared notes not displaying when options are open

Backported the mod to Minecraft version 1.19.2


## Changes:
- Improved instrument textures
- Pitch is now determined by accurate note scales
- This thus fixes the issue of inaccurate representations of note labels & accidentals
- Implemented the generic grid instrument options as the default config screen for Forge's mod menu

## Fixed:
- Zither's sound type button overflowing to the Done button
- Left-hand display of instruments
- Note buttons' text labels overflowing to the instrument options
- Issues playing with navigation

Backported the mod to Minecraft version 1.19.3


## Changes:
- Improved instrument textures
- Pitch is now determined by accurate note scales
- This thus fixes the issue of inaccurate representations of note labels & accidentals
- Implemented the generic grid instrument options as the default config screen for Forge's mod menu

## Fixed:
- Zither's sound type button overflowing to the Done button
- Left-hand display of instruments
- Note buttons' text labels overflowing to the instrument options
- Issues with playing with navigation

Backported the mod to Minecraft version 1.19.4


## Changes:
- Improved instrument textures
- Pitch is now determined by accurate note scales
- This thus fixes the issue of inaccurate representations of note labels & accidentals
- Implemented the generic grid instrument options as the default config screen for Forge's mod menu

## Fixed:
- Zither's sound type button overflowing to the Done button
- Left-hand display of instruments
- Note buttons' text labels overflowing to the instrument options

Backported the mod to Minecraft version 1.20


## Changes:
- Improved instrument textures
- Pitch is now determined by accurate note scales
- This thus fixes the issue of inaccurate representations of note labels & accidentals
- Implemented the generic grid instrument options as the default config screen for Forge's mod menu

## Fixed:
- Zither's sound type button overflowing to the Done button
- Left-hand display of instruments
- Note buttons' text labels overflowing to the instrument options

Fixed shared notes not displaying when options are open

Migrated the mod version to Fabric

****

ik i said it was the last release but fr now loll

## Changes:
- Improved instrument textures
- Pitch is now determined by accurate note scales
- This thus fixes the issue of inaccurate representations of note labels & accidentals

## Fixed:
- Zither's sound type button overflowing to the Done button
- Left-hand display of instruments
- Note buttons' text labels overflowing to the instrument options

ik i said it was the last release but fr now loll

## Changes:
- Improved instrument textures
- Pitch is now determined by accurate note scales
- This thus fixes the issue of inaccurate representations of note labels & accidentals
- Implemented the generic grid instrument options as the default config screen for Forge's mod menu

## Fixed:
- Zither's sound type button overflowing to the Done button
- Left-hand display of instruments
- Note buttons' text labels overflowing to the instrument options

Backported the mod to Minecraft version 1.19.2!

# All Changes Up To v3.0

## v3.0

- New pitch-accurate accidentals system! Support for flats, sharps, and their doubly variants
- Added Note Label type
- Implemented pitch names in slider
- Fixed ABC label type
- Fixed notes playing twice on keyboard
- Arabic language support
- Partial, at least. It was all mostly from Google Translate. In regards to this and Russian, please correct me on anything you can, or provide new translations! It would really help me <3

(See issues link to submit a bug/feature request/question of any kind)


This will most likely be the final content release for this mod! I am very satisfied to where this project has come, and frankly ceased development. Almost every feature I desired has been implemented, in my opinion, in the best way it could :D
Thus, new updates will only drop for new instruments, as well as upcoming Minecraft versions. I will begin backporting this version up to 1.19.2 starting with Forge.

Enjoy an update-less mod!


### Regarding The Major Release

The decision behind this is that this is, as per se, 99% the last feature version of this mod, and a rounded release number suits the occasion. This was a humongous update, too.
Nevertheless, my goal is that every release of new Genshin insturments, the major version will go up with it such that it will match the supported Genshin version.


## v2.8.2
- Improved drum sounds

## v2.8.1
- Fixed drum and zither shared playing issues

Backported the mod to Minecraft version 1.19.3!


# All Changes Up To v3.0

## v3.0

- New pitch-accurate accidentals system! Support for flats, sharps, and their doubly variants
- Added Note Label type
- Implemented pitch names in slider
- Fixed ABC label type
- Fixed notes playing twice on keyboard
- Arabic language support
- Partial, at least. It was all mostly from Google Translate. In regards to this and Russian, please correct me on anything you can, or provide new translations! It would really help me <3

(See issues link to submit a bug/feature request/question of any kind)


This will most likely be the final content release for this mod! I am very satisfied to where this project has come, and frankly ceased development. Almost every feature I desired has been implemented, in my opinion, in the best way it could :D
Thus, new updates will only drop for new instruments, as well as upcoming Minecraft versions. I will begin backporting this version up to 1.19.2 starting with Forge.

Enjoy an update-less mod!


### Regarding The Major Release

The decision behind this is that this is, as per se, 99% the last feature version of this mod, and a rounded release number suits the occasion. This was a humongous update, too.
Nevertheless, my goal is that every release of new Genshin insturments, the major version will go up with it such that it will match the supported Genshin version.


## v2.8.2
- Improved drum sounds

## v2.8.1
- Fixed drum and zither shared playing issues

Backported the mod to Minecraft version 1.19.4!


# All Changes Up To v3.0

## v3.0

- New pitch-accurate accidentals system! Support for flats, sharps, and their doubly variants
- Added Note Label type
- Implemented pitch names in slider
- Fixed ABC label type
- Arabic language support
- Partial, at least. It was all mostly from Google Translate. In regards to this and Russian, please correct me on anything you can, or provide new translations! It would really help me <3

(See issues link to submit a bug/feature request/question of any kind)


This will most likely be the final content release for this mod! I am very satisfied to where this project has come, and frankly ceased development. Almost every feature I desired has been implemented, in my opinion, in the best way it could :D
Thus, new updates will only drop for new instruments, as well as upcoming Minecraft versions. I will begin backporting this version up to 1.19.2 starting with Forge.

Enjoy an update-less mod!


### Regarding The Major Release

The decision behind this is that this is, as per se, 99% the last feature version of this mod, and a rounded release number suits the occasion. This was a humongous update, too.
Nevertheless, my goal is that every release of new Genshin insturments, the major version will go up with it such that it will match the supported Genshin version.


## v2.8.2
- Improved drum sounds

## v2.8.1
- Fixed drum and zither shared playing issues

Backported the mod to Minecraft version 1.20!


# All Changes Up To v3.0

## v3.0

- New pitch-accurate accidentals system! Support for flats, sharps, and their doubly variants
- Added Note Label type
- Implemented pitch names in slider
- Fixed ABC label type
- Arabic language support
- Partial, at least. It was all mostly from Google Translate. In regards to this and Russian, please correct me on anything you can, or provide new translations! It would really help me <3

(See issues link to submit a bug/feature request/question of any kind)


This will most likely be the final content release for this mod! I am very satisfied to where this project has come, and frankly ceased development. Almost every feature I desired has been implemented, in my opinion, in the best way it could :D
Thus, new updates will only drop for new instruments, as well as upcoming Minecraft versions. I will begin backporting this version up to 1.19.2 starting with Forge.

Enjoy an update-less mod!


### Regarding The Major Release

The decision behind this is that this is, as per se, 99% the last feature version of this mod, and a rounded release number suits the occasion. This was a humongous update, too.
Nevertheless, my goal is that every release of new Genshin insturments, the major version will go up with it such that it will match the supported Genshin version.


## v2.8.2
- Improved drum sounds

## v2.8.1
- Fixed drum and zither shared playing issues

- Fixed notes playing twice on key press

- Fixed notes playing twice on key press

Migrated the mod to Fabric!


# All Changes Up To v3.0

## v3.0

- New pitch-accurate accidentals system! Support for flats, sharps, and their doubly variants
- Added Note Label type
- Implemented pitch names in slider
- Fixed ABC label type
- Arabic language support
- Partial, at least. It was all mostly from Google Translate. In regards to this and Russian, please correct me on anything you can, or provide new translations! It would really help me <3

(See issues link to submit a bug/feature request/question of any kind)


This will most likely be the final content release for this mod! I am very satisfied to where this project has come, and frankly ceased development. Almost every feature I desired has been implemented, in my opinion, in the best way it could :D
Thus, new updates will only drop for new instruments, as well as upcoming Minecraft versions. I will begin backporting this version up to 1.19.2 starting with Forge.

Enjoy an update-less mod!


### Regarding The Major Release

The decision behind this is that this is, as per se, 99% the last feature version of this mod, and a rounded release number suits the occasion. This was a humongous update, too.
Nevertheless, my goal is that every release of new Genshin insturments, the major version will go up with it such that it will match the supported Genshin version.


## v2.8.2
- Improved drum sounds

## v2.8.1
- Fixed drum and zither shared playing issues

Backported mod version v3.0 to Minecraft version 1.19.2!


# All Changes Up To v3.0

## v3.0

- New pitch-accurate accidentals system! Support for flats, sharps, and their doubly variants
- Added Note Label type
- Implemented pitch names in slider
- Fixed ABC label type
- Arabic language support
- Partial, at least. It was all mostly from Google Translate. In regards to this and Russian, please correct me on anything you can, or provide new translations! It would really help me <3

(See issues link to submit a bug/feature request/question of any kind)


This will most likely be the final content release for this mod! I am very satisfied to where this project has come, and frankly ceased development. Almost every feature I desired has been implemented, in my opinion, in the best way it could :D
Thus, new updates will only drop for new instruments, as well as upcoming Minecraft versions. I will begin backporting this version up to 1.19.2 starting with Forge.

Enjoy an update-less mod!


### Regarding The Major Release

The decision behind this is that this is, as per se, 99% the last feature version of this mod, and a rounded release number suits the occasion. This was a humongous update, too.
Nevertheless, my goal is that every release of new Genshin insturments, the major version will go up with it such that it will match the supported Genshin version.


## v2.8.2
- Improved drum sounds

## v2.8.1
- Fixed drum and zither shared playing issues

## v2.8
- Added the staff instrument background

## v2.7.7
- All instrument sounds now play locally on a range of 5 blocks

## v2.7.6
Bugfixes and API improvements

## v2.7.5
- New shared play screen implementation!

## v2.7.1
- Fixed play ring's alpha channel rendering incorrectly

## v2.6
- Added the visual play ring from Genshin

## v2.5.1
- Fixed pitch slider being offset and not navigation-friendly

## v2.5
- Implemented GUI keyboard navigation

## v2.4.1
- Fixed instrument screen being present after item removal

## v2.4
- Minor technical fixes

## v2.3
- Texture fixes

Backported mod version v3.0 to Minecraft version 1.19.3!


# All Changes Up To v3.0

## v3.0

- New pitch-accurate accidentals system! Support for flats, sharps, and their doubly variants
- Added Note Label type
- Implemented pitch names in slider
- Fixed ABC label type
- Arabic language support
- Partial, at least. It was all mostly from Google Translate. In regards to this and Russian, please correct me on anything you can, or provide new translations! It would really help me <3

(See issues link to submit a bug/feature request/question of any kind)


This will most likely be the final content release for this mod! I am very satisfied to where this project has come, and frankly ceased development. Almost every feature I desired has been implemented, in my opinion, in the best way it could :D
Thus, new updates will only drop for new instruments, as well as upcoming Minecraft versions. I will begin backporting this version up to 1.19.2 starting with Forge.

Enjoy an update-less mod!


### Regarding The Major Release

The decision behind this is that this is, as per se, 99% the last feature version of this mod, and a rounded release number suits the occasion. This was a humongous update, too.
Nevertheless, my goal is that every release of new Genshin insturments, the major version will go up with it such that it will match the supported Genshin version.


## v2.8.2
- Improved drum sounds

## v2.8.1
- Fixed drum and zither shared playing issues

## v2.8
- Added the staff instrument background

## v2.7.7
- All instrument sounds now play locally on a range of 5 blocks

## v2.7.6
Bugfixes and API improvements

## v2.7.5
- New shared play screen implementation!

## v2.7.1
- Fixed play ring's alpha channel rendering incorrectly

## v2.6
- Added the visual play ring from Genshin

## v2.5.1
- Fixed pitch slider being offset and not navigation-friendly

## v2.5
- Implemented GUI keyboard navigation

Backported mod version v3.0 to Minecraft version 1.19.4!


# All Changes Up To v3.0

## v3.0

- New pitch-accurate accidentals system! Support for flats, sharps, and their doubly variants
- Added Note Label type
- Implemented pitch names in slider
- Fixed ABC label type
- Arabic language support
- Partial, at least. It was all mostly from Google Translate. In regards to this and Russian, please correct me on anything you can, or provide new translations! It would really help me <3

(See issues link to submit a bug/feature request/question of any kind)


This will most likely be the final content release for this mod! I am very satisfied to where this project has come, and frankly ceased development. Almost every feature I desired has been implemented, in my opinion, in the best way it could :D
Thus, new updates will only drop for new instruments, as well as upcoming Minecraft versions. I will begin backporting this version up to 1.19.2 starting with Forge.

Enjoy an update-less mod!


### Regarding The Major Release

The decision behind this is that this is, as per se, 99% the last feature version of this mod, and a rounded release number suits the occasion. This was a humongous update, too.
Nevertheless, my goal is that every release of new Genshin insturments, the major version will go up with it such that it will match the supported Genshin version.


## v2.8.2
- Improved drum sounds

## v2.8.1
- Fixed drum and zither shared playing issues

## v2.8
- Added the staff instrument background

## v2.7.7
- All instrument sounds now play locally on a range of 5 blocks

## v2.7.6
Bugfixes and API improvements

## v2.7.5
- New shared play screen implementation!

## v2.7.1
- Fixed play ring's alpha channel rendering incorrectly

Backported mod version v3.0 to Minecraft version 1.20


# All Changes Up To v3.0

## v3.0

- New pitch-accurate accidentals system! Support for flats, sharps, and their doubly variants
- Added Note Label type
- Implemented pitch names in slider
- Fixed ABC label type
- Arabic language support
- Partial, at least. It was all mostly from Google Translate. In regards to this and Russian, please correct me on anything you can, or provide new translations! It would really help me <3

(See issues link to submit a bug/feature request/question of any kind)


This will most likely be the final content release for this mod! I am very satisfied to where this project has come, and frankly ceased development. Almost every feature I desired has been implemented, in my opinion, in the best way it could :D
Thus, new updates will only drop for new instruments, as well as upcoming Minecraft versions. I will begin backporting this version up to 1.19.2 starting with Forge.

Enjoy an update-less mod!


### Regarding The Major Release

The decision behind this is that this is, as per se, 99% the last feature version of this mod, and a rounded release number suits the occasion. This was a humongous update, too.
Nevertheless, my goal is that every release of new Genshin insturments, the major version will go up with it such that it will match the supported Genshin version.


## v2.8.2
- Improved drum sounds

## v2.8.1
- Fixed drum and zither shared playing issues

## v2.8
- Added the staff instrument background

- New pitch-accurate accidentals system! Support for flats, sharps, and their doubly variants
- Added Note Label type
- Re-implemented pitch names in slider
- Fixed ABC label type
- Arabic language support
- Partial, at least. It was all mostly from Google Translate. In regards to this and Russian, please correct me on anything you can, or provide new translations! It would really help me <3

(See issues link to submit a bug/feature request/question of any kind)


This will most likely be the final content release for this mod! I am very satisfied to where this project has come, and frankly ceased development. Almost every feature I desired has been implemented, in my opinion, in the best way it could :D
Thus, new updates will only drop for new instruments, as well as upcoming Minecraft versions. I will begin backporting this version up to 1.19.2 starting with Forge.

Enjoy an update-less mod!


## Regarding The Major Release

The decision behind this is that this is, as per se, 99% the last feature version of this mod, and a rounded release number suits the occasion. This was a humongous update, too.
Nevertheless, my goal is that every release of new Genshin insturments, the major version will go up with it such that it will match the supported Genshin version.

- Improved drum sounds
- Optimized note buttons' UI lookup

Fixed drum and zither shared playing issues

- Fixed client classes leaking to server-side (dedicated servers not running with the mod)
- Fixed manual clicks locking the notes

Backported the mod to Minecraft version 1.19.2

Backported the mod to Minecraft version 1.19.3

This version is likely to malfunction, since my IDE decided it was not its day.
For instance, I seem to not be able to run it on a dedicated server, nor click more than once manually on a note.

Backported the mod to Minecraft version 1.19.4

Backported the mod to Minecraft 1.20

**Migrated features from Forge:**

- Added instrument background visualizations
- Added an option to turn this off at the Instrument Options screen
- Changed the order of the buttons in the Instrument Options screen

- Added instrument background visualizations
- Added an option to turn this off at the Instrument Options screen
- Changed the order of the buttons in the Instrument Options screen

Migrated the mod to Fabric!!

- Fixed FPS not getting pulled correctly
- Fixed instrument and options screens appearing off-center

Downgraded mod to 1.19.2

- Update to 1.20.1
- Pitch slider now has note names

All instrument sounds now play locally on a range of 5 blocks

Fixed Zither options screen overflowing

New shared play screen implementation!

Fixed play ring's alpha channel rendering incorrectly

Upgraded mod to MC V1.20

Added the visual play ring from Genshin

Fixed pitch slider being offset and not navigation-friendly

- Updated game version to 1.19.4

- GUI is now more navigation-friendly

Feature Changes:
* The instrument screen now closes when it is not present in the player's inventory

Technical Changes:
* API tweaks & fixes

Minor technical fixes and changes

Feature Changes:
* Fixed drum alpha texture issues
* Step size of pitch slider is now 0.05

Technical changes:
* Better API implementation & documentation

This update focuses on applying the final polishes necessary for making this mod a usable API for other mods to use.
My intention is to make a sequel mod expanding on Genshin's instruments with various other music production concepts in mind, as well as more instruments and those other digital thingies that are not instruments.

Regardless, this IS probably the last of the 1.19.3 releases of this mod.

Feature Changes:
- Fixed texture alpha issues

Technical changes:
- Fixed server attempting to load client configs

This will most likely be the last update, at least for 1.19.3. I will update the mod to 1.19.4 once Forge's got their stuff ready.

Feature Changes:
- New advancements
- New recipes

Technical Changes:
- Added genshinstrumentplayinstrument trigger
- Fired when a player plays the specified instrument
- Conditions:
- instrument: An item. It must be an instrument.