# \ud83c\udfb5 skNBS \u2013 Skript Addon for NoteBlockAPI<\/p>\n
skNBS is a Skript addon that integrates the NoteBlockAPI with Skript, allowing you to load `.nbs` songs, create playlists, and control playback directly from Skript.<\/p>\n
## \ud83d\udce6 Installation
\n1. Install Skript on your Spigot\/Paper server.
\n2. Install NoteBlockAPI.
\n3. Place the `skNBS.jar` into your `\/plugins` folder.
\n4. Restart the server.<\/p>\n
## \ud83d\udcd6 Syntax & Usage<\/p>\n
### \ud83c\udfb6 Songs
\nLoad an `.nbs` song from the `plugins\/NoteBlockAPI\/songs` folder:
\nUse code with caution.
\n“`
\nset {_song} to nbs song from “test.nbs”
\n“`
\n### \ud83d\udcd1 Playlists
\nCreate a playlist from multiple songs:
\nset {_song1} to nbs song from “intro.nbs”
\nset {_song2} to nbs song from “loop.nbs”
\nset {_playlist} to nbs playlist from {_song1} and {_song2}<\/p>\n
### \u25b6\ufe0f Playback Types
\n* **Radio:** Plays to players directly (no location).
\n “`
\n play radio nbs {_song} to all players
\n play radio nbs {_playlist} to player
\n “`
\n* **Position:** Plays from a location in the world with a range.
\n “`
\n play position nbs {_song} at location of player with range 32 to all players
\n “`
\n* **NoteBlock:** Plays from a specific NoteBlock.
\n “`
\n play noteblock nbs {_song} at target block with range 16 to {_p}
\n “`
\n* **Entity:** Plays from an entity (follows the entity).
\n “`
\n play entity nbs {_playlist} at {_mob} with range 24 to all players
\n “`<\/p>\n
### \u23ef Controls
\nPause, resume, or stop a SongPlayer:
\n“`
\npause nbs {_player}
\nresume nbs {_player}
\nstop nbs {_player}
\n“`
\n### \u23e9 Seeking
\nSkip forwards or backwards in a song\/playlist by seconds:
\nforward 10 seconds in nbs {_player} # skip ahead 10s
\nrewind 5 seconds in nbs {_player} # rewind 5s<\/p>\n
## \u26a0\ufe0f Notes
\n* Songs must be placed in `\/plugins\/NoteBlockAPI\/songs\/`.
\n* `SongPlayer` objects are returned when you start playback, so keep them in variables if you want to pause\/seek later.
\n* Playlists currently don\u2019t support seeking between songs.<\/p>\n
## \ud83d\udca1 Example Script
\n“`
\ncommand \/music:
\n trigger:
\n set {_song} to nbs song from “lobby.nbs”
\n play radio nbs {_song} to player
\n send “&aNow playing lobby music!” to player<\/p>\n
command \/dj:
\n trigger:
\n forward 30 seconds in nbs {_songplayer}
\n“`<\/p>\n
## \ud83d\udee0 API Reference<\/p>\n
### Expressions
\n* `nbs song from %string% \u2192 Song`
\n* `nbs playlist from %songs% \u2192 Playlist`<\/p>\n
### Effects
\n* `play radio nbs %song\/playlist% to %players%`
\n* `play position nbs %song\/playlist% at %location% with range %number% to %players%`
\n* `play noteblock nbs %song\/playlist% at %block% with range %number% to %players%`
\n* `play entity nbs %song\/playlist% at %entity% with range %number% to %players%`
\n* `pause nbs %songplayer%`
\n* `resume nbs %songplayer%`
\n* `stop nbs %songplayer%`
\n* `forward %number% seconds in nbs %songplayer%`
\n* `rewind %number% seconds in nbs %songplayer%`<\/p>\n","protected":false},"excerpt":{"rendered":"
Play .nbs song using this Skript Addon!<\/p>\n","protected":false},"featured_media":142345,"template":"","meta":{"_minecraft_slug":"sknbs","_minecraft_project_id":"rKaiEzXG","_minecraft_author":"Minetrio1256","_minecraft_license":"MIT","_minecraft_downloads":132,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"sknbs.zip","_minecraft_size_bytes":58901,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T18:57:46.159710Z","_minecraft_date_created":"2025-08-31T21:34:09.884701Z","_minecraft_date_modified":"2025-11-23T16:02:42.109621Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/sknbs","_minecraft_icon_attachment_id":142345,"_minecraft_imported_at":"2026-06-08T11:10:53+00:00","_minecraft_import_hash":"780c211b8bfa1c1da9809adbda4db372","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,92],"mod_loader":[132],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-142344","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n