Hi, this is igniss, developer of this plugin. Due to my lack of motivation for fixing the current state of the plugin, there is a plan to rewrite it as a whole. Any problems like bugs or glitches will not be solved unless someone creates a pull request on Github repository. Sorry for this inconvenience and I hope to bring back better and more stable version of this plugin soon. Love, igniss.
Thanks to this plugin, you can add discoverable areas to your server. Using WorldGuard regions you can create different areas with various reward commands, reward experience etc. Once a player enters this region, it will be marked as discovered and he will receive all rewards.
This plugin uses bStats to monitor statistics. Here you can view plugin's statistics.
Warning! Snapshot versions are not final and may not be stable, but are less buggy than betas.
Warning! Support for plugin version older than 1.7.0-SNAPSHOT was fully dropped. The newest version now only supports servers with 1.14 or newer version.
Spoiler: Media
Spoiler: Unsupported versions of plugin
1.2.0-B1
1.4.0-B1
1.4.0-B2
1.4.0-B3
1.5.0-B1
1.5.0-B2
1.6.0-SNAPSHOT
1.6.1-SNAPSHOT
1.6.2-SNAPSHOT
1.6.3-SNAPSHOT
Code (Text):
1.2.0-B1
1.4.0-B1
1.4.0-B2
1.4.0-B3
1.5.0-B1
1.5.0-B2
1.6.0-SNAPSHOT
1.6.1-SNAPSHOT
1.6.2-SNAPSHOT
1.6.3-SNAPSHOT
Spoiler: Default config.yml
Areas without descriptions will not work!
Code (YAML):
# I strongly recommend keeping this enabled, because I often release beta and snapshot versions
# so you would get notified when the stable version is released
general:
update-notify : true
# y = year (yy or yyyy)
#M = month (MM)
#d = day in month (dd)
#h = hour (0-12) (hh)
#H = hour (0-23) (HH)
#m = minute in hour (mm)
#s = seconds (ss)
#S = milliseconds (SSS)
#z = time zone text (e.g. Pacific Standard Time...)
#Z = time zone, time offset (e.g. -0800)
date-format : "dd.MM.yy HH:mm:ss"
title:
on_discover:
enabled : true
title : "&a&[email protected]"
subtitle : "&[email protected]"
# Values are in seconds
fadein : 1
stay : 3
fadeout : 1
on_enter:
enabled : true
title : "&a&[email protected]"
subtitle : "&[email protected]"
# Values are in seconds
fadein : 1
stay : 3
fadeout : 1
messages:
help :
- "&6&lDiscoverAreas Help"
- "&e/area &8- &7shows this help"
- "&e/area create <region> <name> &8- &7create new discoverable area"
- "&e/area delete <name> &8- &7remove a discoverable area"
- "&e/area setexp <name> &8- &7set xp reward for area"
- "&e/area reset [player] &8- &7remove yours/player's progress"
- "&e/area setdesc <name> &8- &7set area's new description"
- "&e/area setsound <name> &8- &7set area's discovery sound"
- "&e/area command list <area> &8- &7shows all area's reward commands"
- "&e/area command add <name> &8- &7add new reward command to area"
- "&e/area command remove <cmd_id> <area> &8- &7remove reward command"
- "&e/area command edit <cmd_id> <area> &8- &7edit reward command"
on_discover:
enabled : true
messages :
- "&a&lYou have discovered @area"
- "&f"
- "&[email protected]"
on_enter:
enabled : false
messages :
- "&aYou are entering @area"
# Leave blank if you want to disable this message
disabled_menu : "You cannot access this menu, because it is disabled."
no_permission : "You don't have permission to do this."
no_areas : "There are no areas to view."
sounds:
info : "BLOCK_LADDER_HIT"
success : "ENTITY_VILLAGER_YES"
error : "ENTITY_VILLAGER_NO"
warning : "ENTITY_VILLAGER_NO"
menus:
user:
enabled : true
titles:
nopage : "User menu"
page : "User menu #@page"
admin:
enabled : true
titles:
nopage : "Admin menu"
page : "Admin menu #@page"
gui:
list:
admin:
material : BOOK
glowing : false
displayname : "&[email protected]"
lore:
- "&fWorld : &[email protected]"
- "&fRegion : &[email protected]"
- "&fDescription:"
- "&[email protected]"
- "&6Click to open."
discovered:
material : BOOK
glowing : true
displayname : "&[email protected]"
lore:
- "&fDiscovered : § [email protected] "
- "&fDescription: "
- "& [email protected] "
notdiscovered:
material: WRITABLE_BOOK
glowing: false
displayname: "& [email protected] "
lore:
- "&cNot Discovered "
- "&fDescription: "
- "& [email protected] "
previous:
material: ARROW
displayname: "&7Previous page "
lore: []
next:
material: ARROW
displayname: "&7Next page "
lore: []
stats:
enabled: true
material: PAPER
displayname: "&aStatistics "
lore:
- "&7Total areas : &[email protected]"
# List of areas and their settings
areas : { }
# so you would get notified when the stable version is released
general:
update-notify : true
# y = year (yy or yyyy)
#M = month (MM)
#d = day in month (dd)
#h = hour (0-12) (hh)
#H = hour (0-23) (HH)
#m = minute in hour (mm)
#s = seconds (ss)
#S = milliseconds (SSS)
#z = time zone text (e.g. Pacific Standard Time...)
#Z = time zone, time offset (e.g. -0800)
date-format : "dd.MM.yy HH:mm:ss"
title:
on_discover:
enabled : true
title : "&a&[email protected]"
subtitle : "&[email protected]"
# Values are in seconds
fadein : 1
stay : 3
fadeout : 1
on_enter:
enabled : true
title : "&a&[email protected]"
subtitle : "&[email protected]"
# Values are in seconds
fadein : 1
stay : 3
fadeout : 1
messages:
help :
- "&6&lDiscoverAreas Help"
- "&e/area &8- &7shows this help"
- "&e/area create <region> <name> &8- &7create new discoverable area"
- "&e/area delete <name> &8- &7remove a discoverable area"
- "&e/area setexp <name> &8- &7set xp reward for area"
- "&e/area reset [player] &8- &7remove yours/player's progress"
- "&e/area setdesc <name> &8- &7set area's new description"
- "&e/area setsound <name> &8- &7set area's discovery sound"
- "&e/area command list <area> &8- &7shows all area's reward commands"
- "&e/area command add <name> &8- &7add new reward command to area"
- "&e/area command remove <cmd_id> <area> &8- &7remove reward command"
- "&e/area command edit <cmd_id> <area> &8- &7edit reward command"
on_discover:
enabled : true
messages :
- "&a&lYou have discovered @area"
- "&f"
- "&[email protected]"
on_enter:
enabled : false
messages :
- "&aYou are entering @area"
# Leave blank if you want to disable this message
disabled_menu : "You cannot access this menu, because it is disabled."
no_permission : "You don't have permission to do this."
no_areas : "There are no areas to view."
sounds:
info : "BLOCK_LADDER_HIT"
success : "ENTITY_VILLAGER_YES"
error : "ENTITY_VILLAGER_NO"
warning : "ENTITY_VILLAGER_NO"
menus:
user:
enabled : true
titles:
nopage : "User menu"
page : "User menu #@page"
admin:
enabled : true
titles:
nopage : "Admin menu"
page : "Admin menu #@page"
gui:
list:
admin:
material : BOOK
glowing : false
displayname : "&[email protected]"
lore:
- "&fWorld : &[email protected]"
- "&fRegion : &[email protected]"
- "&fDescription:"
- "&[email protected]"
- "&6Click to open."
discovered:
material : BOOK
glowing : true
displayname : "&[email protected]"
lore:
- "&fDiscovered : § [email protected] "
- "&fDescription: "
- "& [email protected] "
notdiscovered:
material: WRITABLE_BOOK
glowing: false
displayname: "& [email protected] "
lore:
- "&cNot Discovered "
- "&fDescription: "
- "& [email protected] "
previous:
material: ARROW
displayname: "&7Previous page "
lore: []
next:
material: ARROW
displayname: "&7Next page "
lore: []
stats:
enabled: true
material: PAPER
displayname: "&aStatistics "
lore:
- "&7Total areas : &[email protected]"
# List of areas and their settings
areas : { }
- Unlimited amount of customizable areas.
- Simple commands with auto-complete & clickable actions.
- Custom titles and custom messages on the discovery of a new area & when re-entering the discovered area.
- Custom events for developers (see below).
- Admin menu for managing areas.
- User menu.
- Configurability - custom reward commands, custom reward experience, option to disable menus/titles/messages.
- Update notifier.
WorldEdit - a version that supports 1.14+
WorldGuard - version 7.0.3 or newer
Older than 1.14:
Versions older than 1.14 are no longer supported. Latest snapshot supporting versions from 1.9 to ~1.13 was 1.6.4-SNAPSHOT. Bugs on older versions will not be resolved.
- /area create <region> <name> - create a new area in certain region
- /area delete <name> - remove certain area
- /area setxp <name> - set amount of xp player will get for discovery
- /area reset [player] - reset yours/player's discovery progress
- /area setdesc <name> - set area's description
- /area setsound <name> - set area's discovery sound
- /area command list <name> - shows all area's reward commands
- /area command add <name> - add new reward command for area
- /area command remove <name> - remove reward command
- /area command edit <cmd_id> <area> - edit reward command
- /.areas - admin menu
Group permission: discoverareas.user
- /areas - user menu (discoverareas.user.areas node)
This plugin has several custom events that you can implement into your plugins.
Spoiler: Custom events
To get DiscoverPlayer instance you can use
DiscoverMain.getInstance().getDiscoverPlayer(Player). The player must be online.
PlayerDiscoverEvent - fires when the player discovers a new area
AreaEnterEvent - fires when the player enters an area
AreaLeaveEvent - fires when the player leaves an area
AreaEnterEvent - fires when the player enters an area
AreaLeaveEvent - fires when the player leaves an area
Classes DiscoverPlayer and Area are documented, but the main class is not yet.
When you find a bug, please report it on Github page, in discussion or on my discord server (link is below).
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.14, 1.15, 1.16
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
DiscoverAreas - 1.14+ is a free Minecraft Java mod. Compatible with Minecraft 1.14, 1.15, 1.16. Downloaded 2,799 times (via Spigot). Download it and open it directly in the game.