ShatteredScrolls - Speedgot

ShatteredScrolls -----

Teleport and warp with scrolls, in style!

Updated some code to better follow modern expectations, and updated the core plugin to load on more modern versions.

Requires ShatteredCore. Get that here (not the -api, -javadoc, or -sources jars).

----------, May 19, 2024

Version 2 Beta

I recoded this plugin awhile back. I've tested this with all that I can, but it changes a lot. A quick summary:
Back up your configs before updating!

You now need ShatteredCore. You can get that here. I'll post it to Spigot soon for Aternos users.
Scrolls now can be given out that are bound to Essentials warps, and an API exists to add other warps.
Scrolls now can be bound in different ways, and that can also be expanded through an API.
Scrolls now have arbitrary costs, and more can be added through an API.
Scrolls now can be refueled with a configurable item, and each use of the item can give a configurable number of charges back.
Scrolls now can have a crafting recipe set.
There are now unlimited types of scrolls.
This *should* convert without issues from v1, but that's the part I worry about the most. Back up your configs.

If you have any questions or issues to report, please do so on my Discord before writing a review.

----------, Mar 9, 2021

Crafting Update

Warning! This update has config changes! Old configs will work, but not all settings will apply!

Additions

Add an option to configure the recipe of the unbound scroll.

Changes

Add a section to the config to handle crafting recipes.

New Config

Code (YAML):

config:
== : ScrollConfig # DO NOT DELETE THIS LINE!
scroll-unbound-name : "&bUnbound Teleportation Scroll"
scroll-unbound-lore : |-
&8 ---= [ &7Description &8 ]= ---
&7An unbound teleportation scroll.
&7Right click it to bind it to your location.
&7It has &f %charges%&7 charges.
scroll-bound-position-name : "&bTeleportation Scroll"
scroll-bound-position-lore : |-
&8 ---= [ &7Description &8 ]= ---
&7A bound teleportation scroll.
&7It goes to &f %x% %y% %z%&7 in &f%world%&7.
&7It has &f %charges%&7 charges remaining.
scroll-bound-location-name : "&bTeleportation Scroll"
scroll-bound-location-lore : |-
&8 ---= [ &7Description &8 ]= ---
&7A bound teleportation scroll.
&7It goes to &f %destination%&7.
&7It has &f %charges%&7 charges remaining.
scroll-unbound-glow : false
scroll-bound-glow : true
scroll-material : PAPER
refund-invalid : true
allow-crafting : true
cooldown : 5000 # Cooldown between usages. Minimum 10.
model : 0 # Sets custom model data if the server supports it.
charges : 5 # The default number of charges. Set to -1024 for infinity.
cost:
== : ScrollCost # DO NOT DELETE THIS LINE!
type : POTION # Options: XP, HUNGER, HEALTH. Defaults to XP if invalid.
data : # Accepts a number or a potion effect, depending on type. Defaults to 5 if invalid.
== : PotionEffect
effect : 9 # Nausea, see https://minecraft.gamepedia.com/Status_effect#Data_values
duration : 100 # Duration in ticks.
amplifier : 0
ambient : false
particles : true
recipe:
== : ScrollRecipe # DO NOT DELETE THIS LINE!
amount : 1 # The number of scrolls that should be crafted.
recipe : # The shape of the recipe.
- " E "
- "EPE"
- " E "
mapping : # The characters in the recipe.
E : ENDER_PEARL
P : PAPER

----------, Jan 23, 2020

Naming Update

Warning! This update has config changes! Old configs will work, but not all settings will apply!
Specifically, this update moves the property scroll-bound-name to scroll-location-bound-name and scroll-bound-position-name so that they can have different names and use placeholders.

Additions