<div align="center"> <a href="https://github.com/Nat1anWasTaken/Notebot"> <img src="src/main/resources/assets/notebot/icon.png" alt="Logo" width="80" height="80"> </a> <h3 align="center">Notebot</h3> A mod plays noteblock nicely for you! <a href="https://github.com/Nat1anWasTaken/Notebot">Explore the docs »</a> <a href="https://github.com/Nat1anWasTaken/Notebot">View Demo</a> · <a href="https://github.com/Nat1anWasTaken/Notebot/issues">Report Bug</a> · <a href="https://github.com/Nat1anWasTaken/Notebot/issues">Request Feature</a> </div>  <details> <summary>Table of Contents</summary> <ol> <li> <a href="#about-the-project">About The Project</a> <ul> <ll><a href="#special-thanks">Special Thanks</a></ll> </ul> </li> <li> <a href="#getting-started">Getting Started</a> <ul> <li><a href="#for-players">For Players</a></li> <li><a href="#for-developers">For Developers</a></li> </ul> </li> <li><a href="#usage">Usage</a></li> <li><a href="#roadmap">Roadmap</a></li> <li><a href="#contributing">Contributing</a></li> <li><a href="#license">License</a></li> <li><a href="#contact">Contact</a></li> </ol> </details>

About The Project

A mod plays noteblock nicely for you!

Special Thanks

Thanks BleachDev for creating and open-sourcing BleachHack! That inspired me a lot and this mod is heavily based on BleachHack's Notebot module!

(<a href="#readme-top">back to top</a>)

Getting Started

How to use the mod.

For Players

Download the latest release from the Releases page and put it in your mods' folder.

For Developers

If you want to contribute to the project, you can clone the repository and build it yourself.

Requirements:

JDK 21 installed and selected (Minecraft 1.20.5+ runs on Java 21)

Clone the repo

git clone https://github.com/Nat1anWasTaken/Notebot.git

Make your changes
Run the dev client
```
./gradlew runClient
```
Build the jar
```
./gradlew jar
```

The jar will be in build/libs/

Code Style

This project uses Google Java Format via Spotless.

Format code: ./gradlew spotlessApply
Check formatting: ./gradlew spotlessCheck

CI runs spotlessCheck and fails if formatting is not compliant.

(<a href="#readme-top">back to top</a>)

Usage

Install the mod, See Getting Started
Put .nbs files in the notebot/songs folder, Note that .txt and .midi files are also supported
Launch the game and join a world. This is a client-side mod, so you can use it both in singleplayer and multiplayer
Do /notebot queue add {song} to add your song into the queue
Do /notebot start to start playing the song

(<a href="#readme-top">back to top</a>)

Roadmap

[x] Queue
[x] Multi-Instruments support
[x] Fairplay mode

See the open issues for a full list of proposed features (and known issues).

(<a href="#readme-top">back to top</a>)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

(<a href="#readme-top">back to top</a>)

License

Distributed under the GNU General Public License. See LICENSE for more information.

(<a href="#readme-top">back to top</a>)

Contact

Discord - Nat1an#0001 - nathan@nat1an.xyz

Project Link: https://github.com/Nat1anWasTaken/Notebot

(<a href="#readme-top">back to top</a>)

Notebot

Install / Use

README