NoteBlockAPI icon

NoteBlockAPI -----

Play .nbs files as noteblock sounds




Fixed compatibility with 1.21.3 (thanks to @DaJokni).

This version is still compatible with versions 1.8+.
----------, Nov 11, 2024

For latest news and support join my Discord.

Bug fixes:
  • Fixed SongStoppedEvent fired when setPlaying(true, null) was called
  • Various fixes for NoteBlocKSongPlayer
  • Fixed ArrayIndexOutOfBoundsException after player's teleportation
  • Fixed error on Purpur when stopping the server
  • Fixed stereo offset distance calculation
----------, Jul 10, 2023

For latest news and support join my Discord.

This version contains several bug fixes.
----------, Sep 5, 2020

For latest news and support join my Discord.

Performance improvements (thanks to Kneesnap)
New features:
  • You can check whether Song has stereo notes
  • Song metadata now contains original author as well
  • StereoMode now has fallback mode which is used in case that Song is has no stereo notes
  • Support for 10 octave range using resource pack - disabled by default (thanks to ishland)
  • Added resource pack for Minecraft Bedrock Edition (thanks to ishland)
  • Added fade option to setPlaying method
As 10 octave range requires resource pack always enable it only as optional feature.
----------, Aug 5, 2020

For latest news and support join my Discord.

Now compatible with OpenNoteBlockStudio 3.7.0+.

New features:
  • Support for per Note pitch (NBS v4.0)
  • Support for per Note volume (NBS v4.0)
  • New ChannelMode settings for mono/stereo modes (more here)
----------, Mar 29, 2020

Now compatible with NoteBlockStudio 3.6.0 (thanks to PseudoResonance)
----------, Aug 13, 2019

Added UUID variants of static methods in NoteBlockAPI class.
----------, Jul 29, 2019

Now compatible with NoteBlockStudio 3.5.0
----------, Jul 16, 2019

Fixed bug with new instruments from 1.14.
----------, Jul 6, 2019

!IMPORTANT!
Use Minecraft Note Block Studio 3.4.0 or newer. There is change in file structure. Songs from older versions may have problem with custom instruments.
If plugin that you use is using deprecated NoteBlockAPI structure, ask developer for update.

Changes:
  • Added EntitySongPlayer
  • Minor performace tweaks
----------, Jun 13, 2019

!IMPORTANT!
Use Minecraft Note Block Studio 3.4.0 or newer. There is change in file structure. Songs from older versions may have problem with custom instruments.
If plugin that you use is using deprecated NoteBlockAPI structure, ask developer for update.

Changes:
  • Now support 1.14 instruments.
  • Updated instruments resource pack for 1.14 - file name was changed - available on Github
  • All events are now called synchronously (fix error in 1.14)
  • You can now specify Song position in playlist when adding it using Playlist.insert method.
----------, May 29, 2019

Changes:
  • Added random/shuffle play WIKI
  • Reworked repeat/loop play WIKI
----------, Jan 21, 2019

Changes:
  • Players can be added and removed to and from SongPlayer using UUID
  • NoteBlockSongPlayer now plays song from center of the block
----------, Nov 24, 2018

bStats updated to v1.3.
Little fix for bStats.
----------, Oct 8, 2018

Changes:
  • Playlist improvements
  • RadioSongPlayer is now playing stereo by default to avoid volume changes on player rotation (thanks to micsa)
----------, Oct 4, 2018

Bug fix ;)
----------, Aug 11, 2018

Changes:
  • Reworked fade effects - see wiki
  • Added playlists
  • Added update check on server start
----------, Aug 10, 2018

NoteBlockAPI updated to 1.13

Changes:
  • Now support MC 1.8 - 1.13
  • Added javadocs
  • Added loops
  • Updated bStats to v1.2
Big structure changes!!
  • All classes have been sorted to packages.
  • Main class is now NoteBlockAPI instead of NoteBlockPlayerMain.
  • Backward compatibility is present, but does not contains new features and will be removed after most of plugins using this API will use new structure.
You are suggested to update to new structure ASAP!
----------, Aug 6, 2018

Changes:
  • Songs for 1.12 can now be played on 1.8 - 1.11 servers without errors
  • Created resource pack for using 1.12 instruments on 1.8 - 1.11 servers (avaiable on resource page/github)
----------, Oct 17, 2017

Changes:
  • Now handle corrupted files.
  • Added support for SoundCategory (works on 1.11+, disabled on lower)
----------, Oct 16, 2017

Fixed bug which was making incompatibility with some plugins.
----------, Sep 12, 2017

Changes:
  • Added bStats.
  • Added custom instruments support via resource pack.
  • Added pling support (custom instrument file has to be named pling.ogg in NoteBlockStudio)
  • Fixed 1.12 instruments.
----------, Jul 2, 2017

Changes:
  • Edited thread safety.
  • Added new 1.12 sounds (not tested!)
----------, May 14, 2017

New features for PositionSongPlayer and NoteBlockSongPlayer:
  • function isPlayerInRange - returns true if player is range, where he can hear sound
  • event PlayerRangeStateChangeEvent - fires when player stand in or out of song player region
----------, Mar 12, 2017

Added backward compatibility for 1.8+
----------, Mar 11, 2017

Api is now more thread safe.
----------, Mar 6, 2017

Changes:
  • Added ability to set distance of sound in PositionSongPlayer and NoteBlockSongPlayer (use setDistance function)
  • Synchronized versioning between maven pom, spigot and plugin.yml (Everything to 1.1.2)
----------, Dec 2, 2016

Updated note pitches.
----------, Mar 22, 2016

Resource Information
Author:
----------
Total Downloads: 96,356
First Release: Mar 1, 2016
Last Update: Nov 11, 2024
Category: ---------------
All-Time Rating:
45 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings