skUnity Docs

Some more updating 26 days, 23 hours and 49 minutes ago

read the changelog

View Update

The Next Big One [3.3.0] 84 days, 14 hours and 16 minutes ago

Please read the GitHub changelog, this is a fairly large update.

View Update

Small Fix [3.2.1] 102 days and 31 minutes ago

Please see GitHub changelog for all changes

View Update

The Something Update [3.2.0] 103 days, 19 hours and 14 minutes ago

Please read GitHub changelog for all changes

View Update

Some More Stuff [2.18.0] 243 days, 3 hours and 7 minutes ago

️ VERSION SUPPORT :
- Support for Minecraft 1.17.1 has been dropped, see Outdated for outdated versions
- Support is now only for Minecraft 1.18.2+ (keep in mind, I will only support the latest release of each Minecraft major release, ex: 1.19.4 is supported, but 1.19, 1.19.1, 1.19.2 and 1.19.3 are NOT supported)

SKRIPT SUPPORT :
- This will be the last version of SkBee to support Skript 2.6.4 and below.
- Future builds of SkBee will be aimed towards Skript 2.7+ due to major API changes in Skript.

️ THIS UPDATE ‍:
FIXED:
- Fixed a bug with NBT lists, cleared caused issues when setting tags in an empty list
- Fixed some parsing issues with game events
- Fixed a bug with ingredients of recipe expression not properly managing recipe keys
- Fixed an issue with printing compounds when the parent was removed
- Fixed a bug with NBT sub compounds when setting to itself (internal issues with parenting)
- Fixed more issues with NBT of Slots (I hope this doesn't break other stuff)

ADDED:
- Added fake damage cause to damage entity by entity effect (use the last damage cause expression to retrieve)
- Added an expression to get the cooking time of a cooking recipe
- Added an expression to get the earned XP of a cooking recipe
- Added the entity teleport event
- Added the async chat event (this is used for text components)
- Added an expression for the message/format in an async chat event (Returns as text components)
- Added an effect to replace text in text components
- Added a condition to check if a Player/OfflinePlayer is connected (this will help in while loops when players re-log, as the condition will break)

CHANGED:
- Removed "other elements" message from loading, since you can't disable this
- Register particle type after ItemType to prevent comparison issues
- Temporarily removed smithing recipes (Bukkit split this up into 2 new recipes... the new ones will come in the future)

View Update

I dunno [2.17.0] 260 days, 3 hours and 58 minutes ago

️ VERSION SUPPORT :
- Support for Minecraft 1.17.1 has been dropped, see Outdated for outdated versions
- Support is now only for Minecraft 1.18.2+ (keep in mind, I will only support the latest release of each Minecraft major release, ex: 1.19.4 is supported, but 1.19, 1.19.1, 1.19.2 and 1.19.3 are NOT supported)

️ THIS UPDATE ‍:
ADDED:
- Added a type/expression to get the LoadLevel of a chunk
- Added an expression to get some objects from NamespacedKeys (such as items, entity types, enchantments)
- Added a section to TextComponents to be able to run code in a click event
- Added an effect to update server recipes/resources (Requires Paper 1.20.1+)
- Added support for add/remove/reset display entity view range
- Added a condition to check if a team is registered
- Added an effect to make a RangeEntity perform a ranged attack
- Added an expression to change the charging attack of a RangedEntity (basically makes them raise their arms and keep them up)
- Added an expression to customize chat completions of players
- Added an event for when a player clicks an unknown entity
- Added an effect to list/unlist players from other players (essentially show/hide players in tablist)
- Added a condition to check if players are listed/unlisted for players

CHANGED:
- Changed display view range expression to support add/remove/reset

FIXED:
- Fixed a bug with setting display view range of display entities not working
- Fixed a bug with Paper's quit reason erroring on Spigot servers

REMOVED:
- Removed armor change event, this has been in Skript since Skript 2.5

View Update

Some Fixes [2.16.1] 279 days, 20 hours and 55 minutes ago

View Update

The "A Little More Cowbell" Update [2.16.0] 284 days, 18 hours and 40 minutes ago

️ VERSION SUPPORT :
- Support for Minecraft 1.17.1 has been dropped, see Outdated for outdated versions
- Support is now only for Minecraft 1.18.2+ (keep in mind, I will only support the latest release of each Minecraft major release, ex: 1.19.4 is supported, but 1.19, 1.19.1, 1.19.2 and 1.19.3 are NOT supported)

️ THIS UPDATE ‍:
FIXED:
- Fixed an issue with entity tags not returning all values
- Fixed docs on anvil rename text expression

ADDED:
- Added a serializer for namespaced keys
- Added temporary comparators for potion effect type and block data (until Skript fixes these)
- Added expression for quit reason
- Added a bunch of conditions, effects and expressions for spawners
- Added expression to get/set a lock (string) of a block (containers and beacons)
- For those who are wondering this refers to blocks like beacons, shulker boxes, chest and furnaces. There is still a bunch more not listed here that it works.
- Added condition to check if a block (containers and beacons) is locked
- Added an event and a bunch of expressions for entities shooting bows
- Added an event for bell ring
- Added a bunch of paper events for pre creature spawning
- Added an effect for aborting a pre creature spawn event
- When used the creature will not attempt to spawn in again, this is used mainly for blanket blocking
- Added a bunch of expressions and events for beacon block states
- Added an expression to get the client brand name of a player

CHANGED:
- Changed patterns a bit for namespaced keys
- Updated docs for open sign effect to make it even more obvious that a block is required
- Bound listener will only register if a bound event is used (this could greatly help performance if not using bound events)
- Removed the optional "item" in the nbt [item] [compound] expression (as it does nothing and is not needed anymore)

View Update

Small Fix [2.15.1] 298 days, 2 hours and 5 minutes ago

View Update

Yet Another Bounds Update [2.15.0] 300 days, 18 hours and 14 minutes ago

applescript
create [a] copy of [bound] %bound% (with|using) [the] id %string%

- Added an expression to get

last created bound

this is set each time a bound is copied or created.
- Added even more event tracking into bound enter/exit
- Added new config options for toggling which events we track for the bound enter/exit events
- This can be found inside of the

plugins/SkBee/config.yml

file
- Added options for

all temporary bounds` and `all non-temporary bounds

to all bounds expressions

CHANGED:
- Moved

all bounds in %world%

into it's own separate expression

Big thanks to @Fusezion for all the bound updates!

View Update

Small Fixes [2.14.1] 310 days, 3 hours and 28 minutes ago

bar players of %bossbar%` expression in favour of just adding/removing players to/from bossbars directly, ex: `add player to bossbar named "test"

- Changed the BossBar expressions to include

with id` to be more clear as `named

seems a bit confusing

View Update

Even More Stuff [2.14.0] 312 days, 1 hour and 32 minutes ago

all available potion effect types

not working on Spigot

CHANGED:
- Structures now save rotation/mirror/integrity/includeEntities (structure must be saved for this to actually save)
- Changed the unload world effect to not attempt to unload the main world (you just can't do it)
- Added a warning to

save [structure] %structure%

effect, in the future "structure" won't be optional, so start including that.

View Update

Latest Release 412 days, 4 hours and 3 minutes ago

This update will always take you to the latest release of SkBee on GitHub

View Update

Some Changes [2.1.0] 625 days, 3 hours and 20 minutes ago

See GitHub Changelog for changes

View Update

Big NBT Update [2.0.0] 637 days, 2 hours and 10 minutes ago

See GitHub change log for full details

View Update

Small Fixes [1.17.3] 658 days and 50 minutes ago

See GitHub change log for full details

View Update

Small Changes [1.17.2] 664 days, 1 hour and 47 minutes ago

WARNING:
In a future release of SkBee, NBT related syntax that uses strings will be removed, and SkBee will focus on the use of NBT compounds.
This is mainly due to the mess of code I have had to write for string related NBT, and I want to work on cleaning this all up.

Example of what will be removed:

set nbt-block at player to furnace with nbt "{someNBT:1}"
give player a diamond sword with nbt "{myCustomNBT:1}"
add "{SomeNBT:1}" to nbt of player

Don't worry though, cause these simply can be replaced with the nbt compound from string expression:

set {_n} to nbt compound from "{someNBT:1}"
set nbt-block at player to furnace with nbt {_n}

set {_nbt} to nbt compound from "{myCustomNBT:1}"
give player a diamond sword with nbt {_nbt}

add nbt compound of "{SomeNBT:1}" to nbt compound of player
# OR
set {_n} to nbt compound from "{SomeNBT:1}"
add {_n} to nbt compound of player

This change will most likely happen in SkBee 1.18.0. I just wanted to give everyone plenty of time to switch over to using NBT compounds.

Release News:
CHANGED:
- added pattern for `all boss bars` (all custom boss bars registered to the server)
- added missing "placed on" item flag
- hidden flags now defaults to all flags if not specified

View Update

Small Fixes [1.17.1] 671 days, 22 hours and 48 minutes ago

Example of what will be removed:

set nbt-block at player to furnace with nbt "{someNBT:1}"
give player a diamond sword with nbt "{myCustomNBT:1}"
add "{SomeNBT:1}" to nbt of player

Don't worry though, cause these simply can be replaced with the nbt compound from string expression:

This change will most likely happen in SkBee 1.18.0. I just wanted to give everyone plenty of time to switch over to using NBT compounds.

Release News:
FIXED:
- Changed pattern in "entity block storage" expression due to a conflict
- Appended "effect" to potion effect causes due to a conflict
- Fixed an issue with bossbar types loading
- Delay removing boards from players (fixes a bug when modifying the board when a player logs out, thus creating a new board)
- Fixed a bug with a missing constructor for MerchantRecipe in 1.17.x
- Changed the return of boss bar progress from integer to float (making it more precise)
- Fixed an error when running older builds of MC 1.17.1, and missing structure elements

ADDED:
- Added an option in the config to disable the update checker
- Added player purchase event

View Update

The New Horizons Update [1.17.0] 676 days, 2 hours and 24 minutes ago

Example of what will be removed:

set nbt-block at player to furnace with nbt "{someNBT:1}"
give player a diamond sword with nbt "{myCustomNBT:1}"
add "{SomeNBT:1}" to nbt of player

Don't worry though, cause these simply can be replaced with the nbt compound from string expression:

This change will most likely happen in SkBee 1.18.0. I just wanted to give everyone plenty of time to switch over to using NBT compounds.

Release News:
ADDED:
- Statistics
- Villager elements (level, experience, profession, type)
- Merchant elements (merchants, merchant recipes, trade select event)
- Update particle effect to include force
- New /skbee info command (used for debugging purposes)
- New update checker (will print in console if an update is available)
- Expression for getting ticks/seconds/minutes/hours from a timespan
- Potion change event
- Show demo screen effect
- Effect to load/unload a chunk (with optional ticket)
- Breed event, event values, expression for breed event entities (parents, baby, breeder)
- Advancement objects, event, expressions
- WorldBorder elements (including virtual world borders for players)
- Expression to get/set spell of a spell caster

View Update

Small Fixes [1.16.3] 681 days, 3 hours and 24 minutes ago

set nbt-block at player to furnace with nbt "{someNBT:1}"
give player a diamond sword with nbt "{myCustomNBT:1}"

Don't worry though, cause these simply can be replaced with the nbt compound from string expression:

set {_n} to nbt compound from "{someNBT:1}"
set nbt-block at player to furnace with nbt {_n}

set {_nbt} to nbt compound from "{myCustomNBT:1}"
give player a diamond sword with nbt {_nbt}

I'm not totally sure WHICH version of SkBee this change will happen, I just wanted to give everyone plenty of time to switch over to using NBT compounds.

Release News:
FIXED:
- Fixed an issue when merging NBT compounds of blocks/entities
- Fixed an issue when trying to remove a bound (error saying can not create bound)

View Update

Some Fixes [1.16.2] 688 days, 1 hour and 26 minutes ago

set nbt-block at player to furnace with nbt "{someNBT:1}"
give player a diamond sword with nbt "{myCustomNBT:1}"

Don't worry though, cause these simply can be replaced with the nbt compound from string expression:

set {_n} to nbt compound from "{someNBT:1}"
set nbt-block at player to furnace with nbt {_n}

set {_nbt} to nbt compound from "{myCustomNBT:1}"
give player a diamond sword with nbt {_nbt}

I'm not totally sure WHICH version of SkBee this change will happen, I just wanted to give everyone plenty of time to switch over to using NBT compounds.

Release News:
FIXED:
- Fixed a bug with `session.lock` when cloning a world
- Fixed an error when trying to save a non-keyed bossbar into a var, and vars loading on startup
- Fixed an issue when trying to set the lines/title of a scoreboard when a player is offline

View Update

Small Fixes [1.16.1] 692 days, 2 hours and 52 minutes ago

set nbt-block at player to furnace with nbt "{someNBT:1}"
give player a diamond sword with nbt "{myCustomNBT:1}"

Don't worry though, cause these simply can be replaced with the nbt compound from string expression:

set {_n} to nbt compound from "{someNBT:1}"
set nbt-block at player to furnace with nbt {_n}

set {_nbt} to nbt compound from "{myCustomNBT:1}"
give player a diamond sword with nbt {_nbt}

I'm not totally sure WHICH version of SkBee this change will happen, I just wanted to give everyone plenty of time to switch over to using NBT compounds.

Release News:
FIXED:
- fixed an error when trying to get block states from an empty structure object
- fixed an error with getting the player in an anvil prepare event

View Update

Big Changes [1.16.0] 699 days, 3 hours and 56 minutes ago

This is a fairly large update which includes a new BossBar system as well as a completely new Scoreboard system.

CHANGED:
- SkBee now only supports Minecraft 1.17.1+ and requires Java 17+
- New scoreboard system using packet based scoreboards. The old scoreboard system used team based scoreboards, which ended up screwing up vanilla team stuff. This new system sends scoreboard packets directly to the player, leaving all vanilla team stuff alone.
The syntaxes for this scoreboard system are the same, so if you are currently using SkBee boards, you won't have to change any of your code.
- Updated Team system. Since SkBee is no longer using team based scoreboards, this system has been re-written to use vanilla MC teams. And hopefully this fixes any issues that we had before, whether they be timing/loading issues, or issues with other plugins. Syntax is the same so no need to change your code.
- Updated NBT-API to support MC 1.19 NBT

ADDED:
- Added expressions to get the level/enchantment of an `enchantment type`
- Added the ability to send text components in action bars
- Added the ability to get/set font for text components
- Added the ability to send normal strings in `send component` effect
- Added a condition to check if a location is within 2 other locations
- Added ability to broadcast with components `broadcast component %component%`
- Added BossBar elements

FIXED:
- Fixed an issue with knockback victim/attacker expression where victim and attacker were backwards

REMOVED:
- Removed old structure elements
- Removed old particle effect patterns

View Update

Some Fixes [1.15.3] 731 days and 6 minutes ago

FIXED:
- Fixed a bug when loading text components on Spigot due to a previous change that supported something on paper
- Fixed a bug with the "using" part of translate components
- Fixed an error for a null line when setting scoreboard lines

View Update

Small Changes [1.15.2] 779 days and 3 hours ago

FIXED:
- Fixed an issue when trying to add to tab completions
- Fixed incorrect doc in Bound ID
- Fixed some bugs in the block data item expression
- Fixed some bugs with some types in the board expressions
- Fixed a bug with NBT throwing an error when not available
- Fixed an issue with translate components of a slot
- Fixed a bug with comparing a team color to color

ADDED:
- Added entity types to available materials expression
- Added an option to unregister a team
- Added an option to get a list of all registered teams
- Added fish event state type and expression
- Added fish event caught/hook expression
- Added a key bind component

View Update

Small Changes [1.15.1] 795 days and 42 minutes ago

ADDED:
- Added NBT support for MC 1.18.2

View Update

A Big Update [1.15.0] 825 days and 29 minutes ago

ADDED:
- Added a slew of team related syntaxes. One thing to note, these syntaxes will only work if SkBee's scoreboard system is enabled. These were mainly added to circumvent the issue that SkBee's boards break vanilla teams. If you aren't using SkBee's board system, I highly recommend not using these team syntaxes. Maybe in the future I will make these work whether or not using SkBee's boards, but as of right now, they won't serve a purpose.
- Added an expression to get the exact target block. The main difference between this and Skript's target block expression, is this one will account for the hitbox of a block. Example is a torch. Skript's expression will see a torch as a FULL block, so if you aren't actually looking directly at the torch, it would still count it as the target block. SkBee's expression will only count the torch if the hitbox of the torch is being looked at. Also SkBee's expression will ignore fluids as target blocks.
- Added an expression to get a list of available materials/item-types/block-types/block-data.
- Added an effect to parse a string/text as Skript code. This works similarly to how Skript's effect commands work in chat/console, but you can use it anywhere in your code. While this is often considered useless, Ive heard a few people request it, so I figured it could be a good idea to add it.
- Added an expression to get/set the owners/members of a bound. These values will be saved as UUIDs in the bound config.
- Added an expression to get the id of a bound.
- Added an expression to get a list of entities within a bound. This expression can be hard on a server, so I do not recommend running it often.
- Added an expression to get a list of all bounds
- Added more options for translation components. As of Paper 1.17.1, several more objects can translate including GameRules, PotionEffectTypes, Attributes, Difficulty, Enchantments, FireworkEffectTypes, Entities and Blocks.

FIXED:
- Fixed an issue with `hover event showing %itemtype%`, syntax had to change a bit, see docs for update
- Fixed an issue when text components are disabled in config, throwing an error to text components being used in scoreboards

View Update

Small Fixes [1.14.2] 846 days, 17 hours and 19 minutes ago

FIXED:
- Fixed an issue with loading bounds when a world is null

ADDED:
- Added an all tags of NBT compound expression to get all available tags from a compound

CHANGED:
- Add a proper parser for Bounds.

View Update

Small Fixes [1.14.1] 863 days, 19 hours and 24 minutes ago

FIXED:
- Fixed an issue with the spawn entity with NBT effect in future Skript versions
- Fixed an issue with full bounds not going below 0 in MC 1.18 worlds (also added an updater for previously created full bounds)

CHANGED:
- Changed minecraft tag expression to accept custom tags (can be used in data packs)
- Added support for multiple players in open sign effect

View Update

Big Changes [1.14.0] 877 days, 19 hours and 47 minutes ago

ADDED:
- Added game event syntaxes (Minecraft's internal system thus far only used to activate Sculk sensors)
- Added support for saving NBT Files

CHANGED:
- Changed syntax a bit more for particles, to heavily increase speed of use

REMOVED:
- Removed piston shifting for custom NBT blocks (this system didn't work properly)

View Update

Small Changes [1.13.1] 884 days, 23 hours and 34 minutes ago

FIXED:
- Fixed some errors when NBT is invalid
- Fixed some issues with no clip expression

CHANGED:
- Changed the prefix of the syntax for spawning particles. New prefix `(spawn|play|lerp|draw|make)`. (`(spawn|play)` are now deprecated and will throw a warning when using. These 2 for some reason are INSANELY slow at parsing (on average 2 seconds per line), and the new ones `(lerp|draw|make)` are MUCH faster (on average 0.05 seconds))
- Added support for Spigot in the open sign effect. This was added to Spigot in MC 1.18.

ADDED:
- Added the ability to add 2 NBT compounds together.
ex:

set {_n1} to nbt compound from "{test:1}"
set {_n2} to nbt compound from "{blah:2}"
add {_n2} to {_n1}

output = `{test:1,blah:2}`
This will merge the 2 compounds together. From my understanding, if you merge 2 compounds that have the same key, the latter will overwrite the former.
- Added a new expression for getting the NBT type of a tag
ex:

set {_t} to tag type of tag "blah" of {_n}

- Added support to delete a saved structure file.

View Update

MC 1.18 Update [1.13.0] 890 days, 20 hours and 23 minutes ago

ADDED:
- Added support for MC 1.18 NBT
- Added new expression for loaded chunks in a world
- Added new expression for coordinates of a chunk
- Added new expression for block in a chunk (based on coords of a chunk 0-15)

REMOVED:
- Removed support for MC 1.15.x and below. SkBee now only supports the last 3 major versions of Minecraft (1.16.x -> 1.18.x)

View Update

Small Fix [1.13.0-Beta2] 892 days and 1 hour ago

FIXED:
- Fixed a bug with NBT compound of block entity

View Update

Prep for 1.18 [1.13.0-Beta1] 894 days, 5 hours and 11 minutes ago

NOTE:
- Removed support for MC 1.15.x and below (SkBee now only supports latest 3 versions of Minecraft)
- Prepared for MC 1.18 (There may still be some bugs, please test carefully, and report bugs)
- This is a beta release of SkBee. It is advised not to use this on production servers. Please test wisely and report any bugs found

ADDED:
- Added Minecraft 1.18 NBT support (This is a preliminary test of NBT for MC 1.18, things may not work 100% as expected, report any bugs found)

View Update

Small Fix [1.12.4] 901 days, 23 hours and 28 minutes ago

FIXED:
- Fixed an error when cloning worlds and deleting world files

View Update

Structure Additions [1.12.3] 908 days, 19 hours and 55 minutes ago

ADDED:
- Added some new expressions for structures, to get information about the blocks held in a structure. (This includes an expression to get the blockstates in a structure, and some expressions to get offset, block data and item type of these blockstates) See WIKI for more info

View Update

Small Fixes [1.12.2] 915 days, 19 hours and 51 minutes ago

FIXED:
- Fixed an issue with structures throwing errors

CHANGED:
- Reverted a change in the last update for structures, that conflicted with SkJade, unfortunately this had to be reverted as it created more issue. As of right now, SkJade is using the wrong codename for a ClassInfo, and SkBee will not work with SkJade if structures are enabled in SkBee. If you use SkBee AND SkJade, and dont use the structure system, simply disable it in SkBee's config

ADDED:
- Added bound ID option to bound enter/exit events, ex: `on enter bound with id "my-bound":`
- Added `event-string` to bound events, which will return the bound ID that was entered/exited

View Update

Bug Fixes [1.12.1] 917 days, 2 hours and 33 minutes ago

FIXED:
- Fixed a conflict issue with new structures and other addons
- Fixed an issue with recipes in knowledge book throwing an error when no 'plugin' was used

View Update

Structure Update [1.12.0] 919 days, 23 hours and 56 minutes ago

ADDED:
- Added a completely new structure system. This system uses structure objects, which can be manipulated, saved, and placed in a world.
- new Structure Wiki

CHANGED:
- Old structure system has now been deprecated. Advised to use new structure system.
- When 1.18 comes out, the old system will not work, as I will no longer update it with the updated external API. This is a personal choice, as the new system is much better.

EXAMPLE:
Small example of how the new system would work:

# CREATE/SAVE
set {_s} to structure named "test" # loads a structure that is already saved, or creates a new one if not found
fill structure {_s} between {loc1} and {loc2} # fills the structure object with blocks from the world
save structure {_s} # saves it to file

# LOAD/PLACE
set {_s} to structure named "test"
place structure {_s} at location of target block # places the structure in the world

View Update

Small Fix [1.11.4] 934 days, 20 hours and 34 minutes ago

FIXED:
- Fixed an issue where getting the "custom" tag from a compound would return none

View Update

Small Fix [1.11.3] 964 days, 17 hours and 5 minutes ago

FIXED:
- Fixed an issue with VirtualFurnaces in 1.17+ where the furnace arrow and flame didn't move

View Update

Bug Fix Update [1.11.2] 1051 days, 17 hours and 23 minutes ago

FIXED:
- Fixed a bug when loading on < 1.17
- Change World Create Option expression (“seed” -> “world seed”) to fix a conflict issue with Skript

View Update

The 1.17 Structure Update [1.11.1] 1054 days, 3 hours and 10 minutes ago

ADDED:
- Added support for 1.17 structures
- Added support for 1.17 particles
- Added functions for dustTransition and Vibration particle options

FIXED:
- Fixed an issue with custom nbt compounds when printing to string
- Fixed an issue if a structure failed to paste the proceeding code would not execute

View Update

The Cave Update [1.11.0] 1062 days, 21 hours and 31 minutes ago

CHANGED:
- dropped legacy server (1.12.2 and below) support
- updated NBT for MC 1.17

REMOVED:
- removed 'reduce debug' effect (too hard to keep up-to-date)

NOTES:
- SkBee no longer supports 1.12.2 and below. This is due to the amount of messy code to try keep this plugin working across 2 very different APIs. IF you require 1.12.2 or below support, please consider using SkBee 1.10.x
- Structure support does not currently work for MC 1.17. This is not a bug, I am just waiting on the structure API to be updated (I have no ETA for this).

View Update

Small Fixes [1.10.2] 1195 days, 13 hours and 56 minutes ago

IMPORTANT NOTE:
SkBee 1.10.x will be the last version to support legacy console versions (ie: 1.8.x - 1.12.x)
Due to the many issues I have had to fix revolving around legacy servers, I find this too hard to continue offering legacy support.
Come 1.11 ... SkBee will strictly support MC 1.13+
That said, if you are using a legacy server version, please ensure to report any bugs you find ASAP so they can be fixed before I move onto SkBee 1.11

Changelog:
See GitHub for changelog.

View Update

Small Fixes [1.10.1] 1199 days, 12 hours and 6 minutes ago

View Update

The "Big Ten" Update [1.10.0] 1207 days, 18 hours and 51 minutes ago

This update brings a bunch of new things, and a few fixes. That in mind, I have tested as much as I can, but please report any bugs you may find.

FIXED:
- Fixed an issue with sending components on legacy servers
- Fixed an issue with NBT and some items not returning an item
- Fixed an issue with book pages on legacy versions
- Fixed an issue with blocks of bounds throwing a null error
- Fixed an issue with text components not formatting HEX colours

ADDED:
- Added support for all args in tab complete event
- Added support for setting NBT tags to booleans (will be converted internally to a byte)
- Added an effect for opening/closing containers (chests/barrels/shulker boxes)
- Added ‘Minecraft tags’ (for more info, see WIKI)
- Added ‘material choices’ which can be used in recipes (for more info, see WIKI)
- Added support for ‘material choices’ in recipes, thus allowing to set an ingredient to a choice of items. (Ex: an ingredient can allow for all planks)
- Added support for NBT on all blocks (this is a semi-hacky method, use with caution) (for more info, see WIKI)
- Added support for NBT tag types, thus allowing to specify what type you would like the tag to be set as (ex: let’s you distinguish if a tag should be set as an int, byte, short, etc)

CHANGED:
- Changed a bunch of stuff with how NBT is set. This is all internal, but will help reduce the amount of code you will need to write. You will be able to directly set custom tags of blocks/entities, without having to get the compound, manipulate it, then set it back.

View Update

Small Bug Fixes [1.9.1] 1239 days, 18 hours and 17 minutes ago

See GitHub for changelog.

View Update

The Particle Update [1.9.0] 1245 days, 19 hours and 26 minutes ago

This update is a bit small, but it brings a big new particle system that will hopefully be easier to handle than Skript's particle system.

See GitHub for full changelog

View Update

Small Fix [1.8.5] 1253 days, 14 hours and 22 minutes ago

See GitHub for changelog

View Update

Small Fixes [1.8.4] 1255 days, 22 hours and 34 minutes ago

This update brings a few bug fixes, some small changes, a couple new features.
Please see GitHub for changelog.

View Update

Small Fixes [1.8.3] 1275 days, 7 hours and 24 minutes ago

FIXED:
- Fixed an issue with structures being limited to 32x32x32
- Fixed an issue with creating a new full bound and the location variables being manipulated

CHANGED:
- Added some missing things in the lang file
- Added support for more patterns in scoreboard lines/title

View Update

Small Update [1.8.2] 1280 days, 10 hours and 25 minutes ago

CHANGED:
- Changed the API for NBT-API to official NBT-API (its literally the same thing just not my fork)
- Updated the StructureBlockLib for full support of 1.16.4 (StructureBlockLib did a major change to their API, so I'm hoping everything still works as intended.. I did light testing and it seems ok)

View Update

Small Update [1.8.1] 1283 days, 9 hours and 34 minutes ago

CHANGED:
- Added temporary support for 1.16.4 NBT. (Due to the NBT-API not yet updated, I had to manually update a fork myself. This has not been fully tested. Small testing shows NBT appears to be working, but please test fully before using on a production server ... at this time, please do not report NBT related bugs.. I will be updating the official NBT-API when it is available)

NOTE:
- Im well aware that structures are not working on 1.16.4 yet. They will work as soon as the structure API for 1.16.4 is available.

View Update

The World Creation Update [1.8.0] 1287 days, 21 hours and 46 minutes ago

FIXED:
- Fixed an NPE with NBT being applied to non-existent items

ADDED:
- Added a world creator system (this is semi-experimental, it is disabled by default in the SkBee config.yml. If you wish to use this feature you will need to enable it. Please use with caution) (See WIKI for more details on this system)
- Added player sheer entity event (requires Paper)
- Added entity pig zap event (requires Paper)
- Added projectile collide event (requires Paper)
- Added entity knockback event (requires Paper)
- Added an expression for victim/attacker in the knockback event
- Added xp orb merge event (requires Paper)
- Added player pickup xp event (requires Paper)
- Added player elytra boost event (requires Paper)
- Added a text component click event for changing book pages
- Added an expression for getting/setting book pages (See WIKI for more info)

CHANGED:
- Changed the syntax for the knowledge book expression due to clashing with other syntaxes

View Update

Small Changes and Fixes [1.7.2] 1297 days, 20 hours and 40 minutes ago

CHANGED:
- Better handling of translation components for items
- Changed boards to re-load boards if the server is reloaded

FIXED:
- Fixed an issue where tab args would stop the completions
- Fixed an issue where attempting to load a structure at a null location would throw a console error
- Fixed an issue where getting NBT from a “dead” entity would return null
- Fixed an issue with hidden flags on older versions of Skript throwing errors

View Update

Small Changes [1.7.1] 1303 days, 20 hours and 52 minutes ago

FIXED:
- Fixed an issue with clearing tab completions in console when no command is present

ADDED:
- Added support for custom NBT on entities and blocks (tile entities) [This is done in a different manner, please see WIKI] (NOTE: This is only available on 1.14+)

View Update

The TabCompletion Update [1.7.0] 1310 days, 16 hours and 11 minutes ago

FIXED:
- Fixed an issue with set block with nbt missing item types
- Fixed some issues with line splits in scoreboards
- Fixed an issue with NBT compounds from non-tile entity blocks

ADDED:
- Added an expression for Entity Visibility. (Available for 1.15+ for item frames, and 1.16.3+ for all other living entities)
- Added an effect to apply bonemeal to a block (Available I believe on 1.16.2+)
- Added some tab complete syntaxes, see WIKI

CHANGED:
- Changed scoreboards, so the toggle option will show the players old scoreboard when toggled off (useful when using other plugins with scoreboards

View Update

The NBT Compound Update [1.6.0] 1328 days and 22 hours ago

WARNING - This is a fairly large update. Please make sure to backup any important data before updating to this version of SkBee. If you find a major issue, please report it, and possibly downgrade to the previous version of SkBee until the issue is resolved.

ADDED:
- Added an NBT Compound type (see WIKI)
- Added an expression to create NBT compounds from entities, items, blocks (tile entities), strings and files
- Added an expression for “pretty NBT” (this is the same as using vanilla Minecraft’s `/data` command)

FIXED:
- Fixed an issue with the spawn with NBT effect failing on legacy server versions

CHANGED:
- Changed tag expression to support setting/deleting tags from NBT compounds
- Changed many NBT expressions/effects to support NBT compounds

NOTE:
- Due to how NBT tag types are handled, the NBT API, and mashing this all together with Skript, some tag types may get set weird. I have tried my best to automate this process as much as possible, but do please keep an eye on how tag types are handled and report any issues found.

View Update

Small Fixes [1.5.2] 1349 days and 14 hours ago

FIXED:
- Fixed an issue with structures pasting structure voids
- Fixed an issue with tag of expression throwing an error when NBT is null

CHANGED:
- Changed file NBT to support `.nbt` files

ADDED:
- Added an expression to get a UUID as an int array or least/most bits (used for NBT strings)
- Added an effect to open a sign’s GUI to the player, allowing them to edit a sign

View Update

Small Changes 1354 days, 23 hours and 54 minutes ago

FIXED:
- Fixed an issue with item variables not working in hover events

CHANGED:
- Scoreboards now support 128char lines (in 1.13+)
- Scoreboard lines now support text components

ADDED:
- Added support for legacy scoreboards (32char lines each)
- Added support for translatable text components
- Added an expression for formatting text components

View Update

A Big One [1.5.0] 1358 days, 23 hours and 45 minutes ago

FIXED:
- Fixed an error with block cuboid expression
- Fixed an error with recipes
- Fixed an issue with scoreboards not showing line 8

ADDED:
- Added block data as an option when setting a block with NBT (since Skript now has block data)
- Added hidden dye flag
- Added some text component syntaxes
- Added some pathfinding syntaxes
- Added an “entity physical interact” event, called when an entity physically interacts with a block (ie: trampling farmland)
- Added a “player recipe book click” event, called when a player clicks on a recipe in their recipe book
- Added an “entity pathfind event” event, called when an entity starts to pathfind
- Added a “skeleton horse trap” event, called when a skeleton horse trap summons their other skeleton horses
- Added an “anvil damage” event, called when an anvil takes damage

CHANGED:
- Changed the toggle option for scoreboards, can now just toggle (which will reverse whatever the state currently is)
- Update StructureBlock API for 1.16.2 support
- Big update to internal NBTApi (just some code cleanup)

View Update

Tiny Update [1.4.11] 1365 days, 22 hours and 7 minutes ago

CHANGED:
- Updated support for 1.16.2 NBT
- Better error handling when NBT support is unavailable (for future releases of Minecraft)

NOTE:
- Still no support for 1.16.2 structures until the StructureBlock API has been updated

View Update

Some New Stuff [1.4.10] 1368 days, 21 hours and 40 minutes ago

CHANGED:
- Changed the spawn entity with NBT effect to use consumers internally. This means the NBT will be applied to the entity BEFORE it actually spawns in the world, which means adding things like invisible to an armor stand, will make sure the armor stand is not visible for a split second. (This will only work on versions of Spigot that have the consumer class for spawning - I believe this was added in 1.11.x)
- Changed the NBT of object expression to be able to get FULL NBT of an item. This is the just like the item nbt except it will also contain the item's namespace and item stack size.
ex:

# Player's tool being a diamond sword of sharpness 3
send "%nbt of player's tool%"
#output -> {Enchantments:[{id:"minecraft:sharpness",lvl:3s}],Damage:0}

send "%full nbt of player's tool%"
#output -> {id:"minecraft:diamond_sword",tag:{Damage:0,Enchantments:[{id:"minecraft:sharpness",lvl:3s}]},Count:1b}

ADDED:
- Added an expression to get an item from an NBT string. Could be useful in conjunction with `full nbt of item` for serializing.

set {_i} to item from nbt "{id:""minecraft:diamond_sword"",tag:{Damage:0,Enchantments:[{id:""minecraft:sharpness"",lvl:3s}]},Count:1b}"

FIXED:
- Fixed an issue with nested tags not returning lists
- Fixed an issue with nested tags throwing an NPE when tag is invalid

View Update

Small Update [1.4.9] 1370 days, 22 hours and 30 minutes ago

ADDED:
- Added a syntax to check if a player has discovered a recipe (This is only available on 1.16+ since that is when Bukkit added this method)
%players% (has|have) [not] discovered recipe[s] %strings%

View Update

Small Update [1.4.8] 1373 days, 15 hours and 28 minutes ago

CHANGED:
- Changed the syntax for BlockData when running Skript 2.5-beta1+ due to Skript adding its own block data system
Old:

block[ ](data|state) [(tags|tag %-string%|without update[s])]"

New:
The part within the parenthesis is no longer optional. (Again, only on Skript 2.5-beta1+)

block[ ](data|state) (tags|tag %-string%|without update[s])"

If using Skript 2.5-beta1+ simply remove the quotes around your block data and replace commas with a semi colon,
example:

#from
set block data of target block to "campfire[lit=false,waterlogged=true]"
#to
set block data of target block to campfire[lit=false;waterlogged=true]

View Update

Small Fixes [1.4.7] 1379 days, 20 hours and 18 minutes ago

FIXED:
- Fixed an issue with nested tags not working and/or throwing errors
- Fixed an issue with getting/settings block NBT from a non tile entity throwing errors

CHANGED:
- Added an option to setting block data to not update neighbouring blocks.

View Update

Small Changes [1.4.6] 1392 days, 20 hours and 57 minutes ago

FIXED:
- Fixed an issue with not being able to store enchants on a slot of an inventory

CHANGED:
- Updated StructureBlockLib version (I dont think anything actually changed)
- Added an auto-disabler for Structure elements when a new MC version comes out, and StructureBlockLib has not updated yet. This message will let users know why exactly its not working.
- Added "state" to the syntax of block data elements, since Minecraft actually calls them BlockStates where as Bukkit calls them BlockData

View Update

Return of Structures [1.4.5] 1398 days, 22 hours and 48 minutes ago

CHANGED:
- Structures now work again in 1.16.1

FIXED:
- Fixed an issue with NBT in inventory slots

View Update

Some Fixes [1.4.4] 1399 days, 11 hours and 29 minutes ago

FIXED:
- Fixed a small issue with virtual furnaces throwing errors
- Fixed an issue where input slots of virtual furnaces kept smelting even if the output slot was full, thus losing items.
- Fixed an issue with null NBT throwing invalid error, now it will pass

ADDED:
- Added support to retrieve UUIDs from NBT (NBT actually stores UUIDs in a split format, this joins it together)
- Added changers to bounds coord expression for adding/subtracting to/from coords rather than just setting them
- Added an option to modify NBT of an inventory slot

NOTES:
- Structure elements for 1.16+ still not working. These elements use an API called StructureBlockLib, which has still not updated for 1.16.x yet.

View Update

Small Fixes [1.4.3] 1401 days, 15 hours and 20 minutes ago

FIXED:
- Fixed an issue with some NBT throwing null pointer errors

CHANGED:
- Changed NBT tags, so if they are not present, return null instead of full NBT string

View Update

It's Smithing Time [1.4.2] 1407 days, 16 hours and 48 minutes ago

ADDED:
- Added a syntax for registering smithing recipes (see DOCS)

View Update

Small Fix [1.4.1] 1408 days, 11 hours and 58 minutes ago

FIXED:
- Hopefully fixed an NPE with virtual furnaces

CHANGED:
- Temporarily disabled structure elements until StructureAPI is updated

View Update

Some New Stuff [1.4.0] 1413 days, 23 hours and 40 minutes ago

ADDED:
- Added support for 1.16.x NBT
- Added an expression to get all recipes from an item (see DOCS)
- Added an expression to get all ingredients for a recipe (see DOCS)

View Update

Small Fix [1.3.3] 1460 days, 21 hours and 7 minutes ago

FIXED:
- Fixed an issue with loading on Spigot

View Update

Small Fix [1.3.2] 1463 days, 21 hours and 21 minutes ago

FIXED:
- Fixed an issue with NBT strings that have variables in them. (The validator was just not having it)

View Update

Small Changes [1.3.1] 1464 days, 7 hours and 5 minutes ago

ADDED:
- Added an armor change event (see DOCS)
- Added an expression to get the item changed in the armor change event (see DOCS)

CHANGED:
- Changed some error handling for NBT

View Update

The Virtual Furnace Update [1.3.0] 1470 days, 20 hours and 55 minutes ago

ADDED:
- Added virtual furnaces (items, fuels, recipes) see WIKI
- Added an effect to reduce the player's debug screen

CHANGED:
- Spawning an entity with NBT now uses Skript's last spawned entity, so you can retrieve the entity via Skript's last spawned entity expression

FIXED:
- Removed an old debug message

View Update

Small Update [1.2.0] 1487 days, 16 hours and 30 minutes ago

ADDED:
- Added some better debug messages for invalid NBT strings
- Added a total experience expression (See DOCS)

View Update

Recipe Changes [1.1.0] 1507 days, 23 hours and 55 minutes ago

CHANGED
- Recipes can now be registered from any event (not just `on skript load`)
- You can now remove MC recipes, custom recipes and recipes from other plugins (previously just MC recipes)

View Update

Small Fixes [1.0.2] 1513 days, 21 hours and 8 minutes ago

FIXED:
- Fixed an issue with bound events not working

ADDED:
- Added entity noClip expression from Sk-NBeeT

View Update

Small Fixes [1.0.1] 1522 days, 20 hours and 49 minutes ago

FIXED:
- Fixed some small issues with the tag expression throwing errors
- Fixed an issue with the tag expression not properly returning a list
- Fixed an issue with the tag expression not working with the nested delimiter

View Update

SkBee 1523 days, 17 hours and 32 minutes ago

SkBee is a Skript addon which brings a whole bunch of new elements to your Skript experience.
This add-on adds many more syntaxes, to help make your server the best it can be.

Elements:
This is only a small list of the many things included:
- NBT elements such as get/set NBT of items, blocks (tile entities) and entities
- ScoreBoards super duper simple anti-flicker scoreboards
- Recipes add custom recipes and remove vanilla recipes
- BlockData get/set block data with ease
- Structures use vanilla Minecraft's structure system for saving/pasting structures in your world
- WorldCreator allows you to create custom worlds, similarly to how multiverse does. (Check out Death_Source's example script to see it in action)
- BossBar allows you to create custom BossBars for your server.
- Advancements allows you to do some very mild stuff but if you want a better advancement experience check out Skript-Advancements by HotPocket

Requirements:
- Skript(dur) - Supported on bensku's fork (tested on 2.6) [Certain elements may work on other versions of Skript, such as older versions, but these versions of Skript are NOT supported by SkBee. So they may work, but I will not fix issues that are present on older versions and not present on Bensku's fork]
- Spigot/Paper - Different elements require different versions of Spigot/Paper (SkBee only supports the latest 3 major Minecraft versions. So right now, only 1.18.2+ is supported ... for outdated legacy server versions please see the OUTDATED tab on GitHub)
- Java 17+

Support:
- You can usually find someone to help you on the skUnity Discord.
- For bugs/issues please post on the GitHub Issue Tracker
- DO NOT pm me for support, these will be ignored.
- DO NOT use reviews for support, these will be ignored.

Users:

Wiki:
- SkBee's WIKI has a decent amount of information regarding some of the more complicated syntaxes (ie: Recipes)

Docs:

Reviews:
- While I do appreciate all reviews, please keep your review focused on the plugin.
- DO NOT use reviews for support. These will be ignored.

made in Canada

View Update

SkBee by ShaneBee

Some more updating 26 days, 23 hours and 49 minutes ago

The Next Big One [3.3.0] 84 days, 14 hours and 16 minutes ago

Small Fix [3.2.1] 102 days and 31 minutes ago

The Something Update [3.2.0] 103 days, 19 hours and 14 minutes ago

Some More Stuff [2.18.0] 243 days, 3 hours and 7 minutes ago

I dunno [2.17.0] 260 days, 3 hours and 58 minutes ago

Some Fixes [2.16.1] 279 days, 20 hours and 55 minutes ago

The "A Little More Cowbell" Update [2.16.0] 284 days, 18 hours and 40 minutes ago

Small Fix [2.15.1] 298 days, 2 hours and 5 minutes ago

Yet Another Bounds Update [2.15.0] 300 days, 18 hours and 14 minutes ago

Small Fixes [2.14.1] 310 days, 3 hours and 28 minutes ago

Even More Stuff [2.14.0] 312 days, 1 hour and 32 minutes ago

Latest Release 412 days, 4 hours and 3 minutes ago

Some Changes [2.1.0] 625 days, 3 hours and 20 minutes ago

Big NBT Update [2.0.0] 637 days, 2 hours and 10 minutes ago

Small Fixes [1.17.3] 658 days and 50 minutes ago

Small Changes [1.17.2] 664 days, 1 hour and 47 minutes ago

Spoiler: NBT

Small Fixes [1.17.1] 671 days, 22 hours and 48 minutes ago

Spoiler: NBT

The New Horizons Update [1.17.0] 676 days, 2 hours and 24 minutes ago

Spoiler: NBT

Small Fixes [1.16.3] 681 days, 3 hours and 24 minutes ago

Some Fixes [1.16.2] 688 days, 1 hour and 26 minutes ago

Small Fixes [1.16.1] 692 days, 2 hours and 52 minutes ago

Big Changes [1.16.0] 699 days, 3 hours and 56 minutes ago

Some Fixes [1.15.3] 731 days and 6 minutes ago

Small Changes [1.15.2] 779 days and 3 hours ago

Small Changes [1.15.1] 795 days and 42 minutes ago

A Big Update [1.15.0] 825 days and 29 minutes ago

Small Fixes [1.14.2] 846 days, 17 hours and 19 minutes ago

Small Fixes [1.14.1] 863 days, 19 hours and 24 minutes ago

Big Changes [1.14.0] 877 days, 19 hours and 47 minutes ago

Small Changes [1.13.1] 884 days, 23 hours and 34 minutes ago

MC 1.18 Update [1.13.0] 890 days, 20 hours and 23 minutes ago

Small Fix [1.13.0-Beta2] 892 days and 1 hour ago

Prep for 1.18 [1.13.0-Beta1] 894 days, 5 hours and 11 minutes ago

Small Fix [1.12.4] 901 days, 23 hours and 28 minutes ago

Structure Additions [1.12.3] 908 days, 19 hours and 55 minutes ago

Small Fixes [1.12.2] 915 days, 19 hours and 51 minutes ago

Bug Fixes [1.12.1] 917 days, 2 hours and 33 minutes ago

Structure Update [1.12.0] 919 days, 23 hours and 56 minutes ago

Small Fix [1.11.4] 934 days, 20 hours and 34 minutes ago

Small Fix [1.11.3] 964 days, 17 hours and 5 minutes ago

Bug Fix Update [1.11.2] 1051 days, 17 hours and 23 minutes ago

The 1.17 Structure Update [1.11.1] 1054 days, 3 hours and 10 minutes ago

The Cave Update [1.11.0] 1062 days, 21 hours and 31 minutes ago

Small Fixes [1.10.2] 1195 days, 13 hours and 56 minutes ago

Small Fixes [1.10.1] 1199 days, 12 hours and 6 minutes ago

The "Big Ten" Update [1.10.0] 1207 days, 18 hours and 51 minutes ago

Small Bug Fixes [1.9.1] 1239 days, 18 hours and 17 minutes ago

The Particle Update [1.9.0] 1245 days, 19 hours and 26 minutes ago

Small Fix [1.8.5] 1253 days, 14 hours and 22 minutes ago

Small Fixes [1.8.4] 1255 days, 22 hours and 34 minutes ago

Small Fixes [1.8.3] 1275 days, 7 hours and 24 minutes ago

Small Update [1.8.2] 1280 days, 10 hours and 25 minutes ago

Small Update [1.8.1] 1283 days, 9 hours and 34 minutes ago

The World Creation Update [1.8.0] 1287 days, 21 hours and 46 minutes ago

Small Changes and Fixes [1.7.2] 1297 days, 20 hours and 40 minutes ago

Small Changes [1.7.1] 1303 days, 20 hours and 52 minutes ago

The TabCompletion Update [1.7.0] 1310 days, 16 hours and 11 minutes ago

The NBT Compound Update [1.6.0] 1328 days and 22 hours ago

Small Fixes [1.5.2] 1349 days and 14 hours ago

Small Changes 1354 days, 23 hours and 54 minutes ago

A Big One [1.5.0] 1358 days, 23 hours and 45 minutes ago

Tiny Update [1.4.11] 1365 days, 22 hours and 7 minutes ago

Some New Stuff [1.4.10] 1368 days, 21 hours and 40 minutes ago

Small Update [1.4.9] 1370 days, 22 hours and 30 minutes ago

Small Update [1.4.8] 1373 days, 15 hours and 28 minutes ago

Small Fixes [1.4.7] 1379 days, 20 hours and 18 minutes ago

Small Changes [1.4.6] 1392 days, 20 hours and 57 minutes ago

Return of Structures [1.4.5] 1398 days, 22 hours and 48 minutes ago

Some Fixes [1.4.4] 1399 days, 11 hours and 29 minutes ago

Small Fixes [1.4.3] 1401 days, 15 hours and 20 minutes ago

It's Smithing Time [1.4.2] 1407 days, 16 hours and 48 minutes ago

Small Fix [1.4.1] 1408 days, 11 hours and 58 minutes ago

Some New Stuff [1.4.0] 1413 days, 23 hours and 40 minutes ago

Small Fix [1.3.3] 1460 days, 21 hours and 7 minutes ago

Small Fix [1.3.2] 1463 days, 21 hours and 21 minutes ago