Voxel Shop beta is live. Expect occasional bugs. Learn more  
⭐ ClueScrolls ⭐ icon

⭐ ClueScrolls ⭐ 5.4.0

Complete scrolls and receive rewards! Similar to treasure wars! Quests Missions plugin

Page 1 2 3 ... 6
5.4.0 13 days ago
Minecraft 26.x compatibility and new clues
Minecraft 26.x compatibility and new clues
 
New clue types
 
Added 14 clue types. The data fields listed with each clue are optional filters. Existing world and WorldGuard region filters can also be used where supported.
 
Minecraft 26.x mechanics
 
- agelock - Lock or unlock an entity's age using a Golden Dandelion.
  Data: entitytype, entitycustomname, agelocked
 
- sulfurcubefeed - Feed blocks to Sulfur Cubes. Filters can check which block was fed and whether it replaced another block.
  Data: material, previousmaterial, replaced, entitycustomname
 
- sulfurcubegrow - Accelerate the growth of baby Sulfur Cubes.
  Data: matured, entitycustomname
 
- geyserlaunch - Get launched by a Potent Sulfur geyser.
  Data: None
 
- lunge - Use the spear's Lunge enchantment.
  Data: lungepower, material, enchantmentlevel, onground, foodlevel, itemcustomname
 
- bedsleepnight - Successfully sleep through the night. Entering a bed without skipping the night does not count.
  Data: material, color
 
Entity interactions
 
- entityplace - Place entities such as armor stands, boats, minecarts, paintings, item frames, and Cushions.
  Data: entitytype, entitycustomname, material, blocktype, blockface, hand, color, art
 
- entitybreak - Break placed entities, including paintings, item frames, and Cushions.
  Data: entitytype, entitycustomname, cause, damagetype, color, art
 
- entitymount - Mount an entity or sit on a Cushion.
  Data: entitytype, entitycustomname, color
 
- entityignite - Ignite an entity. Supports TNT Sulfur Cube priming on compatible Paper versions.
  Data: entitytype, entitycustomname, ignitiontype, source, duration, fusetime
 
Exploration, maps, and trading
 
- structurevisit - Enter a generated structure. Supports individual structures and groups, including villages, mineshafts, and Abandoned Camps.
  Data: structure, structuregroup, biome
 
- mapcreate - Create a filled map by using an empty map.
  Data: material, mapid, mapscale, biome
 
- mapdiscover - Reach the destination marked on an explorer map.
  Data: material, decorationtype, mapid, biome
 
- trade - Complete a villager or merchant trade, with filters for the merchant and traded items.
  Data: material, merchanttype, profession, ingredient1, ingredient2, custommodeldata
 
Configuration examples
 
These examples go under a tier's clues: section.
 
# Lock the age of 3 entities using Golden Dandelions
age_lock:
  lore: '&dLock %amount% mob ages: &a%completed%'
  clueType: agelock
  amount: 3
  objective: 'Lock the age of %amount% mobs'
  clueName: 'Age Lock'
  data:
    agelocked: true
 
# Feed 5 blocks to Sulfur Cubes
sulfur_cube_feed:
  lore: '&eFeed %amount% blocks to Sulfur Cubes: &a%completed%'
  clueType: sulfurcubefeed
  amount: 5
  objective: 'Feed %amount% blocks to Sulfur Cubes'
  clueName: 'Sulfur Cube Feeder'
 
# Accelerate Sulfur Cube growth
sulfur_cube_grow:
  lore: '&eHelp %amount% Sulfur Cubes grow: &a%completed%'
  clueType: sulfurcubegrow
  amount: 3
  objective: 'Accelerate Sulfur Cube growth %amount% times'
  clueName: 'Sulfur Cube Growth'
 
# Get launched by a Potent Sulfur geyser
geyser_launch:
  lore: '&6Get launched by a geyser: &a%completed%&7/&f%amount%'
  clueType: geyserlaunch
  amount: 1
  objective: 'Get launched by a Potent Sulfur geyser'
  clueName: 'Geyser Launch'
 
# Place armor stands
entity_place:
  lore: '&ePlace %amount% armor stands: &a%completed%'
  clueType: entityplace
  amount: 5
  objective: 'Place %amount% armor stands'
  clueName: 'Armor Stand Placement'
  data:
    entitytype: armor_stand
 
# Break paintings
entity_break:
  lore: '&eBreak %amount% paintings: &a%completed%'
  clueType: entitybreak
  amount: 3
  objective: 'Break %amount% paintings'
  clueName: 'Painting Removal'
  data:
    entitytype: painting
 
# Activate the Lunge enchantment
spear_lunge:
  lore: '&bUse Lunge %amount% times: &a%completed%'
  clueType: lunge
  amount: 10
  objective: 'Use the Lunge enchantment %amount% times'
  clueName: 'Spear Lunge'
 
# Successfully mount a horse
entity_mount:
  lore: '&eMount a horse: &a%completed%'
  clueType: entitymount
  amount: 1
  objective: 'Mount a horse'
  clueName: 'Horse Rider'
  data:
    entitytype: horse
 
# Sleep through the night
sleep_night:
  lore: '&bSleep through %amount% nights: &a%completed%'
  clueType: bedsleepnight
  amount: 3
  objective: 'Sleep through %amount% nights'
  clueName: 'Good Night'
 
# Discover a Desert Village
structure_visit:
  lore: '&eVisit a Desert Village: &a%completed%&7/&f%amount%'
  clueType: structurevisit
  amount: 1
  objective: 'Visit a Desert Village'
  clueName: 'Desert Explorer'
  data:
    structure: village_desert
 
# Create filled maps
map_create:
  lore: '&bCreate %amount% maps: &a%completed%'
  clueType: mapcreate
  amount: 5
  objective: 'Create %amount% filled maps'
  clueName: 'Cartographer'
 
# Follow an explorer map to its destination
map_discover:
  lore: '&6Discover an explorer map destination: &a%completed%'
  clueType: mapdiscover
  amount: 1
  objective: 'Discover an explorer map destination'
  clueName: 'Map Explorer'
 
# Trade with a librarian villager
villager_trade:
  lore: '&aTrade with librarians %amount% times: &f%completed%'
  clueType: trade
  amount: 10
  objective: 'Complete %amount% librarian trades'
  clueName: 'Librarian Trader'
  data:
    profession: librarian
 
Changes to existing clues
 
- bedsleep - (material, color) Added material and color filters, including support for Straw Beds.
- compost - Updated compost clues to work with Minecraft 26.3.
- loot - Added support for Abandoned Camp loot and other new loot locations.
- cartography - Improved tracking of completed cartography table tasks.
- craft - Improved tracking when crafting newer items.
- statistic - Fixed the newvalue filter to use the updated statistic value.
- bucketfill, bucketempty, bucketentity - Added support for new bucket contents, including Sulfur Cubes.
 
Completed-clue lore
 
Fixed completed clues not being fully crossed out when their lore uses multiple colors. The fix also applies to crystals and multiline lore, without changing the existing colors or gradients.
 
Other changes
 
- Updated Minecraft 26.1, 26.2, and 26.3 compatibility.
- Improved support for newer materials, entities, and biome identifiers.
- Fixed structure clue matching for IDs such as village_desert and minecraft:village_desert.
 
Version and platform requirements
 
- Spigot and Paper: Entity interactions, structure visits, map creation, and merchant trading are supported on compatible versions of both platforms.
- Paper only: geyserlaunch, lunge, and mapdiscover require the corresponding Paper APIs.
- Minecraft 26.1+: Golden Dandelion age locking.
- Minecraft 26.2+: Sulfur Cube feeding and growth.
- Minecraft 26.3+: Potent Sulfur geyser launches.
- Minecraft 1.20.4+: structurevisit.
- Minecraft 1.13+: mapcreate.
- Minecraft 1.14+: trade.
- Paper 1.21.5+: mapdiscover.
5.3.8 Apr 12, 2026
MC 26.1.1 support

- MC 26.1.1 support

- Adds CoinsEngine economy support

5.3.7 Mar 28, 2026
MC 26.1 support

MC 26.1 support

5.3.6 Feb 19, 2026
New Options
Changes
• Fixes SQL timeouts to improve database reliability.
• Adds restore-scrolls-after-death (restores clue scrolls after death).
• Adds restore-crystals-after-death (restores crystals after death).
 
New hide-first-clue options for tier scroll lore
• Adds hide-first-clue.lore-prefix to control the prefix shown on an unrevealed scroll.
• Adds hide-first-clue.lore-suffix to control the suffix shown on an unrevealed scroll.
 
How to use
• These only apply when hide-first-clue.enabled: true.
• If you set hide-first-clue.lore-prefix or hide-first-clue.lore-suffix, that text is shown only before reveal.
• If you set either one to [], that section is hidden on the unrevealed scroll.
• If you don’t set them, the scroll uses the normal lore-prefix / lore-suffix like before.
 

tiers:
common:
scroll:
title: '&8◆ &a&l&nCommon Clue Scroll&r &8◆'


# Shown after reveal (normal scroll)
lore-prefix:
- '&7Complete the tasks below to earn treasure.'
- '&r'
- '&a&l➤ CLUES:'
lore-suffix:
- ''
- '&7Expires: &e%date_expires%'


hide-first-clue:
enabled: true


# Shown before reveal (unrevealed scroll)
lore-prefix:
- '&d&lUNREVEALED SCROLL'
- '&7Right-click to reveal your first clue.'
lore:
- '&7★ &7???'
lore-suffix:
- ''
- '&8(Expiration is hidden until reveal)'


revealMessage: []

5.3.5 Jan 29, 2026
Fixes loading numeric lists for clue data

Fixes loading numeric lists for clue data

5.3.4 Jan 28, 2026
Fixes small bug with updating < 5.3.2 configs

Fixes small bug with updating < 5.3.2 configs

5.3.3 Jan 27, 2026
Expire setting update
  • Expire settings now have multiple types available: NONE, DURATION, DAILY, WEEKLY, MONTHLY, and FIXED_AT
expire:
type: DURATION
seconds: 3600

expire:
type: DAILY

expire:
type: DAILY
timezone: America/New_York
reset-time: "23:59:59"

expire:
type: WEEKLY

expire:
type: WEEKLY
week-boundary: MONDAY
reset-time: "23:59:59"

expire:
type: MONTHLY

expire:
type: MONTHLY
monthly-day: 14
reset-time: "23:59:59"

expire:
type: FIXED_AT
at: 1769476368

expire:
type: FIXED_AT
at: "2026-01-28"

expire:
type: FIXED_AT
at: "2026-01-28 11:59:59"


# Defaults used for scroll and crystal expiration
expiration-defaults:
# Use IANA time zone name such as 'America/New_York'
# https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
timezone: SYSTEM
# For WEEKLY: boundary day at reset-time
week-boundary: SUNDAY
# For MONTHLY: day-of-month at reset-time (31 automatically becomes the last day of month)
monthly-day: 31
# Default reset time used by DAILY/WEEKLY/MONTHLY expirations
reset-time: "23:59:59"

 


See the wiki for more examples: https://wiki.electro2560.com/cluescrolls#scroll-expiration

5.3.2 Jan 22, 2026
CustomFish catch clue / Kill clue now counts indirect kills

- Adds customfishing_catch (id, group, type, material, nick, amount, world) clue


- Kill clue now correctly counts indirect entity deaths


- Fixes bug with unobfuscated servers


 


customfishing_red_snapper_silver_star:
lore: '&a★ &fCatch %amount% Red Snappers: %completed%'
clueType: customfishing_catch
amount: 1-3
objective: Catch %amount% Red Snapper (Silver Star)
clueName: Red Snapper (Silver Star)
data:
id: red_snapper_fish_silver_star

 

5.3.1 Jan 19, 2026
Adds trial chamber clues

- Adds trialmobspawn (entitytype, spawner_state_ ominous_ biome)
- Adds trialvaultunlock (vaulttype, ominous, loottable, loottable_key, biome)


 


trial_mob_spawn_bogged:
lore: '&5★ &fFight %amount% bogged from trial spawners: %completed%'
clueType: trialmobspawn
amount: 10
objective: Fight %amount% bogged
clueName: Bogged Bait
data:
entitytype: bogged
ominous: false

trial_vault_unlock:
lore: '&6★ &fUnlock %amount% ominous vaults: %completed%'
clueType: trialvaultunlock
amount: 3
objective: Unlock %amount% ominous vaults
clueName: Vault Opener
data:
ominous: true
5.3.0 Jan 4, 2026
Fixes bugs with 1.21.10+ servers

Some plugin features such as tooltipStyle that require 1.21.3+ may not be loaded correctly on 1.21.10 and 1.21.11 servers

5.2.9 Jan 2, 2026
Fixes error loading on 1.8.x servers

Fixes error loading on 1.8.x servers

5.2.8 Dec 14, 2025
Piglin barter + 1.21.11 support
  • Adds 1.21.11 support
  • Adds piglinbarter (inputmaterial, outputmaterial, outputamount, custommodeldata, itemname) clue type
 
Example usage:

piglin_barter_example:
lore: '&c★ &fBarter for Crying Obsidian %amount% times: %completed%'
clueType: piglinbarter
amount: 2-5
objective: Obtain Crying Obsidian from Piglins
clueName: Nether Trader
data:
outputmaterial: crying_obsidian

5.2.7 Nov 27, 2025
Adds loot clue
  • Adds loot clue (loottable_key, loottable, lootcategory, inventorytype, biome, environment, loottable_path)
 
You can specify a specific loottable, or the recommended way is to specify a lootcategory.
 
Examples:
 

loot_shipwreck_any:
lore: '&a★ &fOpen %amount% shipwreck loot containers: %completed%'
clueType: loot
amount: 1-3
objective: Open %amount% shipwreck loot containers
clueName: Shipwreck Scavenger
data:
lootcategory: SHIPWRECK

loot_igloo_exact:
lore: '&a★ &fOpen %amount% igloo loot chests: %completed%'
clueType: loot
amount: 1-2
objective: Open %amount% igloo chests
clueName: Cold Cache
data:
loottable_key: minecraft:chests/igloo_chest
inventorytype: CHEST
biome: SNOWY_TAIGA

loot_end_any:
lore: '&a★ &fOpen %amount% End loot containers: %completed%'
clueType: loot
amount: 1-3
objective: Open %amount% End loot containers
clueName: End Raider
data:
environment: THE_END

 
Custom enums for loot clue:
lootcategory = VILLAGE, DUNGEON, MINESHAFT, STRONGHOLD, SHIPWRECK, OCEAN_RUIN, DESERT_PYRAMID, JUNGLE_TEMPLE, WOODLAND_MANSION, PILLAGER_OUTPOST, BASTION, NETHER_FORTRESS, RUINED_PORTAL, END_CITY, ANCIENT_CITY, TRIAL_CHAMBERS, IGLOO, OTHER, CUSTOM_OR_UNKNOWN.

environment is a dimension string: OVERWORLD, NETHER, THE_END, or the raw environment name for anything custom.
5.2.6 Nov 15, 2025
Sound tag volume and pitch

Sound message tags can now specify volume and/or pitch


 


Examples:

  • <sound>ENTITY_VILLAGER_NO
  • <sound volume="0.6">ENTITY_VILLAGER_NO
  • <sound pitch="1.2">ENTITY_VILLAGER_NO
  • <sound volume="0.6" pitch="1.2">ENTITY_VILLAGER_NO
5.2.5 Nov 10, 2025
New placeholders
  • Added %scroll_clues_completed%, %scroll_clues_total, and %scroll_clues_left% placeholders

image.png

5.2.4 Oct 8, 2025
1.21.9/10 + Variant update
  • Adds 1.21.9 and 1.21.10 support
  • Adds variant (see variant reference be, charged (for creepers true or false) and age (baby or adult) clue data to kill clue and projectileentityhit
Variant keys reference:
  • Chicken: minecraft:cold, minecraft:temperate, minecraft:warm
  • Cow: minecraft:cold, minecraft:temperate, minecraft:warm
  • Pig: minecraft:cold, minecraft:temperate, minecraft:warm
  • Frog: minecraft:cold, minecraft:temperate, minecraft:warm
  • Wolf: minecraft: pale, minecraft:ashen, minecraft:black, minecraft:chestnut, minecraft:rusty, minecraft:snowy, minecraft:spotted, minecraft:striped, minecraft:woods
  • Mooshroom (mushroom_cow): red, brown
     
Check /cluescrolls debug monitor [player] while playing in game to see clue data to use when creating your clues.
 
Example Clues:
 

kill_temperate_chicken:
  clueType: kill
  amount: 2
  clueName: 'Temperate Pecking'
  objective: '&7Kill &f%amount% &7temperate chickens'
  lore: '&7Kill &f%amount% &7temperate chickens: &f%completed%'
  data:
    entitytype: chicken
    variant: 'minecraft:temperate'
 
kill_warm_pig:
  clueType: kill
  amount: 2
  clueName: 'Warm Pork'
  objective: '&7Kill &f%amount% &7warm pigs'
  lore: '&7Kill &f%amount% &7warm pigs: &f%completed%'
  data:
    entitytype: pig
    variant: 'minecraft:warm'
 
kill_cold_cow:
  clueType: kill
  amount: 1
  clueName: 'Cold Cut'
  objective: '&7Kill &fone &7cold cow'
  lore: '&7Kill &fone &7cold cow: &f%completed%'
  data:
    entitytype: cow
    variant: 'minecraft:cold'
 
kill_brown_mooshroom:
  clueType: kill
  amount: 1
  clueName: 'Brown Bovine'
  objective: '&7Kill &fone &7brown mooshroom'
  lore: '&7Kill &fone &7brown mooshroom: &f%completed%'
  data:
    entitytype: mushroom_cow
    variant: 'brown'
 
kill_snowy_wolf:
  clueType: kill
  amount: 1
  clueName: 'Snow Hound'
  objective: '&7Kill &fone &7snowy wolf'
  lore: '&7Kill &fone &7snowy wolf: &f%completed%'
  data:
    entitytype: wolf
    variant: 'minecraft:snowy'
 
tag_cold_frog_arrow_no_kill:
  clueType: projectile_hit
  amount: 1
  clueName: 'Cold Tag'
  objective: '&9Projectile Hit &fone &7cold frog'
  lore: '&9Projectile Hit &fone &7cold frog &8with an arrow: &f%completed%'
  data:
    projectiletype: arrow
    entitytype: frog
    killed: false
    variant: 'minecraft:cold'
 
kill_baby_cow:
  clueType: kill
  amount: 1
  clueName: 'Baby Beef'
  objective: '&7Kill &fone &7baby cow'
  lore: '&7Kill &fone &7baby cow: &f%completed%'
  data:
    entitytype: cow
    age: 'baby'
 
kill_charged_creeper:
  clueType: kill
  amount: 1
  clueName: 'Storm Chaser'
  objective: '&7Kill &fone &ccharged creeper'
  lore: '&7Kill &fone &ccharged creeper: &f%completed%'
  data:
    entitytype: creeper
    charged: true
5.2.3 Jul 30, 2025
Fixes 1.21.8

Fixes 1.21.8

5.2.2 Jul 22, 2025
MC 1.21.8 support

MC 1.21.8 support

5.2.1 Jun 21, 2025
1.21.6

1.21.6

5.2.0 Jun 7, 2025
New Brew Clue

Adds brew clue (potiontype, material, ingredient)


brew_splash_swiftness_ii:
lore: '&b&l* &fBrew a Splash Potion of Swiftness II'
clueType: brew
amount: 1
objective: Brew %amount% Splash Potion of Swiftness II
clueName: Splash Swiftness Master
data:
potiontype: strong_speed
material: SPLASH_POTION

brew_add_glowstone:
lore: '&b&l* &fAdd Glowstone Dust to any potion'
clueType: brew
amount: 1
objective: Add %amount% Glowstone Dust to a potion
clueName: Glowstone Booster
data:
ingredient: GLOWSTONE_DUST

brew_lingering_regeneration_ii:
lore: '&b&l* &fBrew a Lingering Potion of Regeneration II'
clueType: brew
amount: 1
objective: Brew %amount% Lingering Potion of Regeneration II
clueName: Lingering Regeneration Master
data:
potiontype: strong_regeneration
material: LINGERING_POTION

Supported in MC 1.8.3+


List of potion types: https://github.com/CryptoMorin/XSeries/blob/master/core/src/main/java/com/cryptomorin/xseries/XPotion.java
You may also specify AWKWARD, THICK or MUNDANE as the potion type.


A potiontype may be long or strong. For example, a swiftness II potion is STRONG_SPEED. An extended swiftness potion is LONG_SPEED.


You can also specify the material to distinguish between a regular potion, a spalsh potion, or a lingering potion. The material would be POTION, SPLASH_POTION or LINGERING_POTION.

Page 1 2 3 ... 6
Sign in
$20.00 USD
Sign in to purchase, save this product to your cart, and keep downloads tied to your account.
Stripe

quests

mechanics

scrolls

addon

pixelmon