AdvancedNBS

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 ! /!\

• Integration for WorldGuard (Version 7.0, not 6.0 anymore) - SoftDependance
• Integration for PlaceholderAPI - SoftDependance
• Integration for QuestCreator - SoftDependance
• Integration for MythicMobs - SoftDependance
• Integration for CrackShot - SoftDependance

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

#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

#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.