A simple, configurable, advanced plugin to control the sound/music in Minecraft based on the NoteBlock API.
Features
- Music can be played when starting a mob fight
- Signs player, plays music if clicked
- Configurable fading effects when a music starts, stops, or suddenly end to fluidly change the song between playlists
- Handle the music per region for WorldGuard (7.0)
- Fallout-like radio, radios that are synchronized together so that everyone has the same music, in the same moment !
- PlaceHolders
- Quests handle, with QuestCreator plugin
- Mythic Mobs handling, with, obviously, MythicMobs plugin !
- CrackShot handling, if you shoot on an entity
And new features upcoming, so stay tuned !
Integrations and dependencies
/!\ The plugin depends on NoteBlock API
AND MLib (since 1.0.3), you need to download it and install it to your server first ! /!\
Issues, suggestions and support
Issues/Suggestions click this link
Support/wiki click this link
Available commands
- /anbs reload | To reload the plugin
- /anbs song play | Plays the music
- /anbs song stop | Stops the music
- /anbs song volume [0~100] | Change the volume from 0 to 100
- /anbs radio join <NameOfTheRadio> | Joins the radio you want
- /anbs radio leave | Leaves the radio you're listening to
Permissions
In the order of the Command section,
- anbs.reload | To reload the plugin
- anbs.song.play
- anbs.song.stop
- anbs.song.volume
- anbs.radio.join (for all radios)
- anbs.radio.join.{radio} (for a specific radio)
- anbs.radio.leave
- anbs.sign.create
- anbs.sign.join
- anbs.sign.leave
Placeholders available
%anbs_player_song_volume%
%anbs_player_is_song_playing%
%anbs_player_song_current_ticks%
%anbs_player_song_max_ticks%
%anbs_player_song_author%
%anbs_player_song_title%
%anbs_player_song_description%
%anbs_player_song_file_name%
%anbs_player_radio_name%
%anbs_player_radio_listeners%
For any further specifications please go to the
wiki page c:
Default config
Code (YAML):
#First of all, if you need support go to : https://gitlab.com/iiztp/advancednbs/-/wikis/home
#If you find any bugs or have any suggestion : https://gitlab.com/iiztp/advancednbs/-/issues
#The priority of the music is : Mute > Radio > Fight > Region
#Activates the debug, mostly helps me to find bugs but can help you too to know what's going on
debug
: false
#Randomize the playlists
isRandom
: true
#Store the needed on a database or on file
database:
enable
: false
host
: ''
name
: ''
user
: ''
password
: ''
#Number between 0 and 100
defaultVolume
: 100
mode
:
#When the player is taking a fight
combat:
triggers:
beinghit
: true
hitanentity
: true
#Names of the combat sounds, found in the combat folder
sounds
:
[
]
#Unique sounds for entities when taking a fight
#If activated, this will have the priority over the 'sounds' playlist
useEntities
: false
#Deactivation radius (10, 10, 10 means a full squared of ten by ten by ten blocks)
deactivation:
x
: 5
y
: 5
z
: 5
#Go to the combat folder and create folders named with the name of the entities, and put the songs you want to play in it
#MythicMobs users : You can put your entities here too
#example: AngrySludge
entities
:
[
]
#When the player has finished a music, it goes under "withoutMusic" mode
withoutMusic
:
#Number of seconds of waiting before launching a new music
afterCombat
: 10
afterRegionLeave
: 10
afterSong
: 10
#Radios are basically inspired from the Fallout games
#To create a radio just put the name below and then create a folder in the radios folder entitled the name you put
#and then put your nbs files in it
radios
:
[
]
#When you create a sign to join a radio it will have this pattern
#Placeholders: %r - Name of radio, %rl - Number of listeners
signPattern:
radio:
join
:
- '&5
[ANBS
]'
- '&1Join radio'
- '&a
%r'
- '&2
%rl listeners'
leave
:
- '&5
[ANBS
]'
- '&4Leave radio'
- ''
- ''
#WorldGuard Only
#The playlists are a basic folder inside the folder "playlists" (created by the plugin)
#You need to create it, and then put the .nbs files you want to put as a playlist
#and then put the {world}.{region}
worldguard
:
#If true, creates the folders of the regions of WorldGuard and you just need to put the .nbs files in it
use_region_folders
: false
playlists:
example1
:
- world.test1
example2
:
- world.test2
#QuestCreator Only
QuestCreator:
playlists
:
#Put here the playlist folders you want and the quests that will play those playlist, when the player(s)
#is/are starting the quest and/or completing it
start:
example1
:
- quest1
- quest2
complete:
example2
:
- quest2
- quest3
Default lang.yml
Code (YAML):
#First of all, if you need support go to : https://gitlab.com/iiztp/advancednbs/-/wikis/home
#Category "Lang.yml and messages"
#If you find any bugs or have any suggestion : https://gitlab.com/iiztp/advancednbs/-/issues
#Quick reminder :
# %r refers to the radio name, returns nothing if there is no radio
# %rl refers to the listeners of the radio, returns -1 if there is no radio
# %v refers to the volume of the player
# %a refers to the song author, returns nothing if there is no song
# %t refers to the song title, returns nothing if there is no song
# %d refers to the song description, returns nothing if there is no song
# %fn refers to the song filename, returns nothing if there is no song
#For some code reasons, you cannot use the placeholders in string errors, you normally don't need them tho :keepo:
#Send a message in the chat if there is an action made
active
: true
player:
music:
play
:
"&a[AdvancedNBS] Playing %t - %a"
played
:
"&4[AdvancedNBS] Song is already playing!"
stop
:
"&4[AdvancedNBS] Stopped"
stopped
:
"&4[AdvancedNBS] Song is already stopped!"
next
:
"&a[AdvancedNBS] Now playing %t - %a, %fn"
volumeChange
:
"&a[AdvancedNBS] Your volume is now at %v/100"
volumeError
:
"&4[AdvancedNBS] You must enter a valid number between 0 and 100"
noPlaylist
:
"&4[AdvancedNBS] No playlist loaded!"
radio:
join
:
"&a[AdvancedNBS] You joined the %r radio. There is %rl listeners."
joined
:
"&4[AdvancedNBS] You already listen to this radio!"
resume
:
"&a[AdvancedNBS] Resumed %r radio."
leave
:
"&4[AdvancedNBS] You left the %r radio. You have now the world's music"
notExist
:
"&4[AdvancedNBS] This radio does not exists!"
noRadio
:
"&4[AdvancedNBS] You do not listen to any radio!"
noPermission
:
"&4[AdvancedNBS] You do not have the permission to go in this radio!"
Special thank's to GuillaumeVDN for his support.