AdvancedNBS icon

AdvancedNBS -----

An early advanced plugin to control the NoteBlock API



A simple, configurable, advanced plugin to control the sound/music in Minecraft based on the NoteBlock API.

[​IMG]

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.
Resource Information
Author:
----------
Total Downloads: 2,211
First Release: Jul 7, 2020
Last Update: Sep 11, 2021
Category: ---------------
All-Time Rating:
12 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings