EXCLUSIVE SpigotVIP ⭐ ClueScrolls ⭐ ║ [1.8 TO 1.20] [250+ clue types] NEW Default Config + Rewards!!! 4.9.0

◦•●❤♡ ᴄᴏɴᴛᴀᴄᴛ Dekomori on discord ꜰᴏʀ ꜱᴜᴘᴘᴏʀᴛ ♡❤●•◦

Tested Minecraft Versions: 1.8 / 1.9 / 1.10 / 1.11 / 1.12 / 1.13 / 1.14 / 1.15 / 1.16 / 1.17 / 1.18



Clue scrolls is an amazing plugin to use on your factions, survival, prison servers, and more! You can create clues in the config which are used on the scrolls. When a player completes all the clues of a scroll they will automatically receive their rewards which are defined with weights via commands. You can even create command rewards which are given to the player as an item and can be executed by the player upon interaction.

A great and engaging alternative to traditional Quests or Missions.

Be sure to check out http://dev.electro2560.com/plugins/ClueScrolls/ for some additional info and screenshots.

Don't forget to check out the NEW documentation! https://wiki.electro2560.com/cluescrolls

• 1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17 and 1.18 support
• Highly configurable
• Create your own tiers
• Create your own clues
• Fully configured default configuration and rewards are provided
• Reward system to give items and/or execute command rewards
• 155+ unique clue types! Full list of clue types available here: https://wiki.electro2560.com/cluescrolls/clue-creation
• Full message customization
• Developer scrolls API
• Developer event API
• Vault integration
• Cooldowns for scroll purchases
• Customizable purchase and rewards inventories
• Purchase scrolls for experience, money, or other currencies
• Crosses out completed clues
• Option to show only one clue at a time
• Specify the number of clues put onto a generated scroll
• Specify the number of rewards a scroll will receive with ranges
• Make scrolls glow
• Title bar and chat notifications
• Command tab auto-complete
• Ability to not duplicate clues on a scroll
• Ability to not duplicate rewards given from a scroll
• Tier specific rewards
• Weights determine how common a reward is
• Automatically updates files when you download a new version
• WorldGuard, Towny, Votifier, ASkyBlock, ChatReaction, AutoSell, Vault, Boss, MythicMobs integration and much more! Full list of clue types available here: https://wiki.electro2560.com/cluescrolls/clue-creation
• Add clues to the tiers via a command.
• Custom inventory sounds
• Custom particle effects
• Brew potion clue
• cut blocks with shears (cobweb, leaves, etc?)
• debug feature
• Sound effects & particle effects for clue completion, opening a mystery scroll, etc.
• Option to randomly place reward items in GUI
• • Placeholders - Hooks with PlaceholderAPI and allows the ability to show the player how many clues they've completed, the tier
  • Riddle clues - Players need to solve a riddle in order to pass the stage, could have it so they need to be standing in a certain spot with specific items equipped or being held.
  • Spend Money clue - Requires the player to spend a certain amount of money in the shop
  • Post any additional ideas in the discussion.

Aliases: [cluescrolls, cluescroll]

• /cluescrolls - Open inventory
• /cluescrolls help - Help
• /cluescrolls give - Give a scroll to a player
• /cluescrolls giveall - Give a scroll to everyone online
• /cluescrolls reload - Reload all config files
• /cluescrolls additem - Add an item as a reward
• /cluescrolls addcommand - Add a command as a reward
• /cluescrolls removereward - Remove a reward
• /cluescrolls listrewards - List rewards
• /cluescrolls rewardinfo - Display info about a reward
• /cluescrolls getreward - Used to get a reward for debug purposes
• /cluescrolls resetcooldown - Reset cooldowns of specific identifiers or players. Useful for testing.
• /cluescrolls customtrigger - Trigger an event for a custom trigger

More command information available on the wiki: https://wiki.electro2560.com/cluescrolls#commands


Available at the documentation site: https://wiki.electro2560.com/cluescrolls#permissions



Installing Clue Scrolls is easy as can be. Follow the few steps below and you'll be all set.

1. Purchase and download the ClueScrolls.jar.
2. Upload the ClueScrolls.jar into your plugins folder.
3. (Optional) - If you wish to use any features which involves the exchange of money, you will need vault. You can download and follow the instructions found here.
4. Start/restart/reload your server. Default configuration files will automatically be generated at this point in your plugins/ClueScrolls/ directory.
5. Read about the configuration files, clue creation, and adding rewards found below to configure the plugin exactly to your liking.
6. Have fun! Feel free to PM or post to the discussion any issues you experience or recommendations you have for features.

The default config, rewards, and messages file will be generated automatically when you first load ClueScrolls! The following links can be used as a reference.

config.yml [1.8.x-1.12.x]
config.yml [1.13.x]
config.yml [1.14.x+]
rewards.yml [1.8.4+]
messages.yml


Work-in-progress /cluescrolls editor
(Displaying the defaults clues + rewards)

Editor menu viewing default tiers

Viewing default legendary tier clues

Viewing default common rewards

Viewing default special rewards

Viewing default legendary rewards

NEW documentation is available at https://wiki.electro2560.com/cluescrolls/clue-creation
Be sure to check it out for more details, examples, and a full list of all clues available

Under the clues section of a tier, you can add and edit your clues.

The clueType must be the name of the clue type. Below this section is a list of all clue types that you can currently use.

The data is optional and can be used to specify specific requirements that must be met in order to count towards that clue. If you don't want to specify any data, you don't need to include it in the config. In the list below this section, there is a list for each clue type with the various data types you can specify. Some you specify text, others you specify numbers, and others are material types, entity types, color types, etc which can be found in the links below.
Material - https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
Entity - https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
Horse Variant - https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/Horse.Variant.html
Horse Style - https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/Horse.Style.html
Horse Color - https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/Horse.Color.html
Dye Color - https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/DyeColor.html
Bucket Contents - water, lava, or milk

The amount is simply the number of times that clue must be completed. You can also use a range such as 10-25.

The lore is what is displayed on the scroll item.

The objective and clueName are used in title bar messages when you complete a clue, and if you have only one clue being revelled on a scroll at a time, in a chat message telling the player more information on their next clue.

If there is a certain data you don't want to specify, you can either use the wildcard character to skip over and ignore it, or just don't including it in the config. When using the wildcard character * for either a data or metadata, it should be noted that is must always be surrounded by single quotes to prevent errors when loading the plugin configuration. It is just the way YAML treats the character. You should use it as a value like so '*'.

Some Examples:
Internal Clues (data):

• break (material, blockdata, blockx, blocky, blockz, world)
• place (material, blockdata, blockx, blocky, blockz, world)
• breed (entitytype, entitycustomname, world)
• bucketfill (bucketcontents, world)
• bucketempty (bucketcontents, world)
• chat (sentence)
• command (command, fullcommand)
• craft (material, itemdata, itemname, world)
• death (cause, world)
• eat (material, itemdata, itemname, world)
• enchant (material, itemdata, itemname, world)
• expgain (world)
• fish (material, itemdata, itemname, world)
• glide (world)
• harvest (material, blockdata, world)
• horsejump (variant, color, style, world)
• interactentity (entitytype, entitycustomname, world)
• kill (entitytype, entitycustomname, world)
• permission (permission)
• ride (vehicletype [an entitytype], world)
• shear (entitytype, woolcolor [DyeColor string] or wooldata [to specify the data id value of the color], world)
• swim (world)
• tame (entitytype, entitycustomname, world)
• walk (world)

External Clues (data):

ASkyBlock

• askyblock_challengecomplete (challengename, rewardtext)
• askyblock_islandcreate (schematicname, protectionsize)
• askyblock_islandreset ()
• askyblock_enterisland (islandowner [player name], protectionsize)
• askyblock_exitisland (islandowner [player name], protectionsize)
• askyblock_joinisland (islandowner [player name], protectionsize)
• askyblock_leaveisland (islandowner [player name], protectionsize)
• askyblock_minishopbuy (material, itemdata)
• askyblock_minishopsell (material, itemdata)
• askyblock_jointeam (teamleader [player name])
• askyblock_leaveteam (teamleader [player name])
• askyblock_warpcreate ()
• askyblock_warpremove ()
• askyblock_visitisland (islandowner (player name), protectionsize)

AuctionHouse

• auctionhouse_sell (soldprice, material, itemdata, itemname)
• auctionhouse_start (startingprice, material, itemdata, itemname)
• auctionhouse_win (soldprice, material, itemdata, itemname)

Auctions

• auctions_sell (soldprice, bidincrement, material, itemdata, itemname)
• auctions_start (startingprice, bidincrement, material, itemdata, itemname)
• auctions_win (soldprice, bigincrement, material, itemdata, itemname)

AutoRank

• autorank_promote (fromgroup, togroup, world)

AutoSell

• autosell_autosell (material, itemdata)
• autosell_sellall (material, itemdata)
• autosell_signsellall (material, itemdata)

Boss

• boss_death (entitytype, entitycustomname, bossname, world)

ChatReaction

• chatreaction_win (word)

CrateReloaded

• cratereloaded_opencrate (cratename, cratetype)

CrazyCrates

• crazycrates_opencrate (cratename, cratetype)

DeluxeChat

• deluxechat_chat (cratename, cratetype)

EpicBosses

• epicbosses_death (entitytype, bossname, world)

MoreFish

• morefish_catch (length, name rarity)

MythicMobs

• mythicmobs_death (entitytype, entitycustomname, mythicmobtype, world)

Towny

• towny_townenter (town, world)
• towny_townexit (town, world)
• towny_towncreate (town, world)
• towny_nationenter (nation, world)
• towny_nationexit (nation, world)
• towny_nationcreate (nation, world)

uSkyBlock

• uskyblock_islandcreate (schematicname)
• uskyblock_joinisland (islandowner)
• uskyblock_leaveisland (islandowner)
• uskyblock_islandrestart ()

Votifier
Also works with NuVotifier

• votifier_vote (service, address)

World Guard

• worldguard_regionenter (region, world)
• worldguard_regionexit (region, world)

Full list of clues is available on the wiki!
https://wiki.electro2560.com/cluescrolls/clue-creation

There are two types of rewards: item and command. To add rewards, use the following commands.

/cluescrolls additem [Tier] [Name] [Weight]

/cluescrolls addcommand [Tier] [Name] [Weight] [Command].

Adding an item adds the item in your main hand to the rewards for the given tier.

When adding a command you can use the placeholder %player% to represent the player's name.

The higher the weight (can be any number, even above 100), the higher the chance of it being given as a reward.

Official Test Server
demo.electro2560.com (Versions 1.8-1.15.2)
Current ClueScroll files on demo: download

Servers Using Clue Scrolls
banditprison.org
play.celestialgaming.net
mc.b-zone.ro
play.voyagepvp.com
play.venomcraft.win (1.8+)
play.townyquest.com (1.15.1)

Want your server featured here? Send me a PM or post in the discussion.

More info available at: https://wiki.electro2560.com/cluescrolls#api

Metrics: http://mcstats.org/plugin/ClueScrolls/ (Added since the first release)