compiled using 1.21.11 API and BlueMap 5-22
:: BlueGeo ::
It is a bluemap map markers manager. Player can easily add and remove markers. Markers are sorted by categories.
Players can create geocaching markers and caches.
Markers size may vary from 48px, 64px, 80px, 96px; depending on its category.
To change Categories labels, and/or translate, edit values in bluegeo.config file.
When removing marker(s), it will need a bluemap reload to be effective.
Bluegeo will reload bluemap automatically (reload light) on markers removals.
Markers have digit indexes, and caches have letters.
---
Map with markers overview
---
Markers categories
---
On marker mouse hover
---
:: Dependencies::
:: Installation ::
1. copy paste the .jar file in plugins folder.
2. edit BlueGeo/config.yml.
3. add permissions using your favorite method
:: Permissions ::
Use your favorite method/plugin to add permissions.
:: Commands::
Categories will also appear while the command is typed.
Digit [marker-index] are visible in front of each marker name on bluemap webpage and shown on mouse hover the marker. As for letters index corresponding to a cache.
After removal, the marker(s) will disappear only once BlueMap plugin has been reloaded.
Bluegeo will automatically reload bluemap (reload light) and its markers data. Add and remove should be both quick.
:: Geocaching ::
---
Cache chest item in player inventory
---
On cache marker mouse hover
---
On cache marker click (hints text)
---
:: Geocache creators::
This text you have to type can be turned in some many ways, but try to use <br> in your text or any html tag to make it short and clear or enigmatic, crazy to find, but within a short text.
---
Logbook view - page 1
---
:: Geocache players::
Geocacher experience and Travel Bugs will be implemented later. Depending on this script success.
Start a conversation with me for any issue or else
:: Notes ::
:: Configuration ::
messages:
MESSAGE_NO_PERMISSION : "You do &Bnot&r have permission."
BLUEGEO_CHAT_PREFIX : "&B&k000&r[&BBlue&AGeo&r] "
MESSAGE_USAGE : "/bluegeo help to see instructions."
MESSAGE_GEOCACHE_NOT_OWNER : "You are not the owner of this cache. Remove cancelled."
MESSAGE_GEOCACHE_CHEST_REMOVED : "Chest for cache %s removed from world."
MESSAGE_GEOCACHE_DATA_NOT_FOUND : "Data to remove for this cache %s not found."
MESSAGE_GEOCACHE_ID_NOT_FOUND : "Cache id %s does not exist or is not placed."
MESSAGE_GEOCACHE_MARKER_ADDED : "Cache marker %s added to the map."
MESSAGE_GEOCACHE_INVENTORY_NOT_FREE : "You need at least one free inventory slot to create a cache chest."
MESSAGE_GEOCACHE_PLACE_BEFORE_ADD : "Place all your caches before adding a new cache."
MESSAGE_GEOCACHE_ID_ALREADY_USED : "This cache ID is already in data. You can not place a clone."
MESSAGE_GEOCACHE_MOVE_AWAY : "Move away from the cache and type command:\n/bluegeo cache hints %s <YOUR HINTS TEXT>."
MESSAGE_PLAYER_WORLD_NOT_FOUND : "Error on getting your world data."
MESSAGE_CACHE_CATEGORY_MARKER : "You can not create a cache this way. Check /bluegeo help."
MESSAGE_PLAYER_MARKER_ADDED : "Your marker has been added and saved."
MESSAGE_PLAYER_MARKER_ADD_ERROR : "Error on adding your marker."
MESSAGE_PLAYER_CACHE_ADD_ERROR : "Error on adding your cache."
MESSAGE_PLAYER_NO_MARKER_DATA : "No markers data found for this world."
MESSAGE_TITLE_CACHE_COMPLETED : "completed"
MESSAGE_SUBTITLE_CACHE_COMPLETED : "your cache is now fully active"
MESSAGE_PLAYER_COMMAND_NOT_FOUND : "Category not found, non existing command, or something is missing."
MESSAGE_BLUEMAP_IS_RELOADING : "BlueGeo is reloading data."
categories:
CATEGORY_BIGBLACK_LABEL : "Events Black"
CATEGORY_BIGBLUE_LABEL : "Events Blue"
CATEGORY_BIGGREEN_LABEL : "Events Green"
CATEGORY_BIGPURPLE_LABEL : "Events Purple"
CATEGORY_BIGRED_LABEL : "Events Red"
CATEGORY_BIGWHITE_LABEL : "Events White"
CATEGORY_BIGYELLOW_LABEL : "Events Yellow"
CATEGORY_BLACK_LABEL : "Black Marker"
CATEGORY_BLUE_LABEL : "Blue Marker"
CATEGORY_BLUECUBE_LABEL : "Blue Object"
CATEGORY_REDCUBE_LABEL : "Red Object"
CATEGORY_BIGCRAFT_LABEL : "Crafting Factories"
CATEGORY_BLUEMINE_LABEL : "Diamond Ressources"
CATEGORY_BOAT_LABEL : "Boats"
CATEGORY_BUILD_LABEL : "Build Here"
CATEGORY_CAT_LABEL : "Cats here"
CATEGORY_CAVE_LABEL : "Caves"
CATEGORY_CHEST_LABEL : "Chests"
CATEGORY_CHICKEN_LABEL : "Chicken Here"
CATEGORY_CITY_LABEL : "Cities"
CATEGORY_CRAFT_LABEL : "Crafting Tables"
CATEGORY_DOOR_LABEL : "Entrances"
CATEGORY_EMERALD_LABEL : "Emeralds"
CATEGORY_EXPLORE_LABEL : "Areas to explore"
CATEGORY_FIREWORK_LABEL : "Fireworks"
CATEGORY_FISH_LABEL : "Fishing Spots"
CATEGORY_FURNACE_LABEL : "Furnace Here"
CATEGORY_GREEN_LABEL : "Green marker"
CATEGORY_GROW_LABEL : "Growing Plants"
CATEGORY_HONEYBEES_LABEL : "Honeyhives and Honeynests"
CATEGORY_HOUSE_LABEL : "Homes houses"
CATEGORY_JUKEBOX_LABEL : "Jukeboxes"
CATEGORY_JUNGLECAVE_LABEL : "Caves with water and plants"
CATEGORY_LAVA_LABEL : "Lava area"
CATEGORY_MINE_LABEL : "Mining Ressources"
CATEGORY_MONUMENT_LABEL : "Monuments"
CATEGORY_MUSHROOM_LABEL : "Mushrooms here"
CATEGORY_NETHER_LABEL : "Nether Portals"
CATEGORY_OTHER_LABEL : "Miscellaneaous"
CATEGORY_PARK_LABEL : "Green Parks"
CATEGORY_PIG_LABEL : "Pigs"
CATEGORY_PILLAGERS_LABEL : "Pillagers"
CATEGORY_POI_LABEL : "POI"
CATEGORY_PURPLE_LABEL : "Purple Marker"
CATEGORY_PURPLEBOX_LABEL : "Purple Shulker Box"
CATEGORY_REDMINE_LABEL : "Redstone Ressources"
CATEGORY_RED_LABEL : "Red marker"
CATEGORY_REDSTONE_LABEL : "Redstone Mechanism"
CATEGORY_SHEEP_LABEL : "Sheeps Here"
CATEGORY_SMALLHOUSE_LABEL : "Tiny Houses"
CATEGORY_SMALLVILLAGE_LABEL : "Small Villages"
CATEGORY_SWORD_LABEL : "Weapons"
CATEGORY_TELEPORT_LABEL : "Teleporters"
CATEGORY_TRAIN_LABEL : "Train Stations"
CATEGORY_UNDERWATERCAVE_LABEL : "Underwater caves"
CATEGORY_VILLAGE_LABEL : "Players Villages"
CATEGORY_VILLAGERS_LABEL : "Villagers community"
CATEGORY_WATERFALL_LABEL : "Waterfalls"
CATEGORY_WHITE_LABEL : "White marker"
CATEGORY_YELLOW_LABEL : "Yellow marker"
CATEGORY_CACHE_LABEL : "Caches to find and log"
options:
MARKER_HTML_VIEWDISTANCE : 3000
DATA_MARKERS_FILEPATH : "bluegeo.markers"
LOAD_TEMPO_SECONDS : 5
BACKUP_MODE : true
BACKUP_EVERY_X_MARKERS : 10
BACKUP_PREFIX : "bluegeo_backup"
BACKUP_FOLDER : "bluegeo_backups/"
BACKUP_KEEP_FILES : 5
MARKER_BACKGROUND_COLOR : "rgba(52,52,52,0.85)"
MARKER_INDEX_COLOR : "#3ECE6A"
MARKER_TEXT_COLOR : "#ffffff"
MARKER_INDEX_SYMBOL : "☰"
MARKER_CATEGORY_COLOR : "#54DBFF"
MARKER_CATEGORY_SYMBOL : "✜"
profiles:
DATA_PROFILES_FILEPATH : "bluegeo.profiles"
XP_GAIN_LOG : 40
XP_GAIN_CREATE : 20
XP_GAIN_PLACE : 80
XP_LOSE_REMOVE : 120
geocache:
DATA_CACHES_FILEPATH : "bluegeo.caches"
CATEGORY_CACHE_LABEL : "Caches to find and log"
CACHE_GENERAL_INFO : "<b>Click to reveal the hints.</b>"
CACHE_GENERAL_INFO_OWNER : "owner: %s"
CACHE_GENERAL_INFO_DATE : "since: %s"
HINTS_TO_CACHE_MINDISTANCE : 20
HINTS_TO_CACHE_MAXDISTANCE : 100
LOGBOOK_MAX_ENTRIES : 60
CACHEMARKER_BACKGROUND_COLOR : "rgba(252,252,252,0.85)"
CACHEMARKER_INDEX_COLOR : "#00718F"
CACHEMARKER_TEXT_COLOR : "#154000"
CACHEMARKER_INDEX_SYMBOL : "☰"
CACHEMARKER_CATEGORY_SYMBOL : "❖"
CACHEMARKER_CATEGORY_COLOR : "#E26A23"
CACHEMARKER_HINT_SYMBOL : "☄"
CACHEMARKER_POPUP_TEXT_COLOR : "#ffffff"
CACHEMARKER_POPUP_BACKGROUND_COLOR : "rgba(28, 64, 0, 0.95)"
CACHE_INVENTORY_PREFIX : "GEOCACHE"
FADEIN_SECONDS : 3
SHOW_FOR_SECONDS : 6
FADEOUT_SECONDS : 3
permissions:
PERMISSION_ADD : "bluegeo.add"
PERMISSION_REMOVE : "bluegeo.remove"
PERMISSION_RELOAD : "bluegeo.reload"
PERMISSION_CACHE_ADD : "bluegeo.cache.add"
PERMISSION_CACHE_REMOVE : "bluegeo.cache.remove"
:: BlueGeo ::
It is a bluemap map markers manager. Player can easily add and remove markers. Markers are sorted by categories.
Players can create geocaching markers and caches.
Markers size may vary from 48px, 64px, 80px, 96px; depending on its category.
To change Categories labels, and/or translate, edit values in bluegeo.config file.
When removing marker(s), it will need a bluemap reload to be effective.
Bluegeo will reload bluemap automatically (reload light) on markers removals.
Markers have digit indexes, and caches have letters.
---
Map with markers overview
---
Markers categories
---
On marker mouse hover
---
:: Dependencies::
- BlueMap
:: Installation ::
1. copy paste the .jar file in plugins folder.
2. edit BlueGeo/config.yml.
3. add permissions using your favorite method
:: Permissions ::
Use your favorite method/plugin to add permissions.
- bluegeo.add -- can add markers
- bluegeo.remove -- can remove markers
- bluegeo.cache.add -- can add geocache
- bluegeo.cache.remove -- can remove geocache
- bluegeo.admin -- to display players info
:: Commands::
- /bluegeo -- to open player profile
- /bluegeo admin <player> -- to open other players profiles
- /bluegeo help -- to open the help book and view categories.
- /bluegeo <category> <marker-label> -- to add a marker
- /bluegeo remove [marker-index] -- to remove a marker
- /bluegeo cache craft-- to craft a new cache_id chest item
- /bluegeo cache hints <cache_id> <hints text> -- to place the cache marker, and make it fully active.
- /bluegeo house framboise treehouse
- /bluegeo grow a little farm in the desert
- /bluegeo door a secret entrance
- /bluegeo remove 409
- /bluegeo remove TTTM remove a geocache, chest and marker
- /bluegeo cache craft craft a cache to player's inventory
- /bluegeo cache hints <CACHE_ID> <HINTS TEXT> finalize the geocache by placing a marker with hints to find the geocache.
Categories will also appear while the command is typed.
Digit [marker-index] are visible in front of each marker name on bluemap webpage and shown on mouse hover the marker. As for letters index corresponding to a cache.
After removal, the marker(s) will disappear only once BlueMap plugin has been reloaded.
Bluegeo will automatically reload bluemap (reload light) and its markers data. Add and remove should be both quick.
:: Geocaching ::
---
Cache chest item in player inventory
---
On cache marker mouse hover
---
On cache marker click (hints text)
---
:: Geocache creators::
- /bluegeo cache craft to craft a cache. Note the letters index (shown in chat and title message to player, and in chest metadata visible in inventory.)
- move away from the geocache, to place a marker. It should be on a path or a nice point of view. (There are minimal and maximal distance. It can be set in blugeo.config. The value is in blocks)
- /bluegeo cache hints <INDEX> <HINTS TEXT>
- Eventually you can log its logbook.
- open the chest
- open the book
- on mouse left click over the cache Chest, it will set a different type of Chest.
This text you have to type can be turned in some many ways, but try to use <br> in your text or any html tag to make it short and clear or enigmatic, crazy to find, but within a short text.
---
Logbook view - page 1
---
:: Geocache players::
- Find a geocache marker on the map
- hover it to check the cache informations
- click it to reveal the hints
- move to the marker location
- resolve the cache location
- open the chest
- open the logbook (it will ad your log)
- read the log
Geocacher experience and Travel Bugs will be implemented later. Depending on this script success.
Start a conversation with me for any issue or else
:: Notes ::
- Geocaches chests are protected from destruction
- there is an auto backup function for makers files (configurable)
- Player can not create a new cache if there is a cache left to place
- Sounds played on interactions
- when left click over a cache chest, if Player is owner it will change/random the chest type. To adjust camouflage
- the cache chest can be placed in a 1x1 hole, as it does not need to opened wide
:: Configuration ::
Code (YAML):
messages:
MESSAGE_NO_PERMISSION : "You do &Bnot&r have permission."
BLUEGEO_CHAT_PREFIX : "&B&k000&r[&BBlue&AGeo&r] "
MESSAGE_USAGE : "/bluegeo help to see instructions."
MESSAGE_GEOCACHE_NOT_OWNER : "You are not the owner of this cache. Remove cancelled."
MESSAGE_GEOCACHE_CHEST_REMOVED : "Chest for cache %s removed from world."
MESSAGE_GEOCACHE_DATA_NOT_FOUND : "Data to remove for this cache %s not found."
MESSAGE_GEOCACHE_ID_NOT_FOUND : "Cache id %s does not exist or is not placed."
MESSAGE_GEOCACHE_MARKER_ADDED : "Cache marker %s added to the map."
MESSAGE_GEOCACHE_INVENTORY_NOT_FREE : "You need at least one free inventory slot to create a cache chest."
MESSAGE_GEOCACHE_PLACE_BEFORE_ADD : "Place all your caches before adding a new cache."
MESSAGE_GEOCACHE_ID_ALREADY_USED : "This cache ID is already in data. You can not place a clone."
MESSAGE_GEOCACHE_MOVE_AWAY : "Move away from the cache and type command:\n/bluegeo cache hints %s <YOUR HINTS TEXT>."
MESSAGE_PLAYER_WORLD_NOT_FOUND : "Error on getting your world data."
MESSAGE_CACHE_CATEGORY_MARKER : "You can not create a cache this way. Check /bluegeo help."
MESSAGE_PLAYER_MARKER_ADDED : "Your marker has been added and saved."
MESSAGE_PLAYER_MARKER_ADD_ERROR : "Error on adding your marker."
MESSAGE_PLAYER_CACHE_ADD_ERROR : "Error on adding your cache."
MESSAGE_PLAYER_NO_MARKER_DATA : "No markers data found for this world."
MESSAGE_TITLE_CACHE_COMPLETED : "completed"
MESSAGE_SUBTITLE_CACHE_COMPLETED : "your cache is now fully active"
MESSAGE_PLAYER_COMMAND_NOT_FOUND : "Category not found, non existing command, or something is missing."
MESSAGE_BLUEMAP_IS_RELOADING : "BlueGeo is reloading data."
categories:
CATEGORY_BIGBLACK_LABEL : "Events Black"
CATEGORY_BIGBLUE_LABEL : "Events Blue"
CATEGORY_BIGGREEN_LABEL : "Events Green"
CATEGORY_BIGPURPLE_LABEL : "Events Purple"
CATEGORY_BIGRED_LABEL : "Events Red"
CATEGORY_BIGWHITE_LABEL : "Events White"
CATEGORY_BIGYELLOW_LABEL : "Events Yellow"
CATEGORY_BLACK_LABEL : "Black Marker"
CATEGORY_BLUE_LABEL : "Blue Marker"
CATEGORY_BLUECUBE_LABEL : "Blue Object"
CATEGORY_REDCUBE_LABEL : "Red Object"
CATEGORY_BIGCRAFT_LABEL : "Crafting Factories"
CATEGORY_BLUEMINE_LABEL : "Diamond Ressources"
CATEGORY_BOAT_LABEL : "Boats"
CATEGORY_BUILD_LABEL : "Build Here"
CATEGORY_CAT_LABEL : "Cats here"
CATEGORY_CAVE_LABEL : "Caves"
CATEGORY_CHEST_LABEL : "Chests"
CATEGORY_CHICKEN_LABEL : "Chicken Here"
CATEGORY_CITY_LABEL : "Cities"
CATEGORY_CRAFT_LABEL : "Crafting Tables"
CATEGORY_DOOR_LABEL : "Entrances"
CATEGORY_EMERALD_LABEL : "Emeralds"
CATEGORY_EXPLORE_LABEL : "Areas to explore"
CATEGORY_FIREWORK_LABEL : "Fireworks"
CATEGORY_FISH_LABEL : "Fishing Spots"
CATEGORY_FURNACE_LABEL : "Furnace Here"
CATEGORY_GREEN_LABEL : "Green marker"
CATEGORY_GROW_LABEL : "Growing Plants"
CATEGORY_HONEYBEES_LABEL : "Honeyhives and Honeynests"
CATEGORY_HOUSE_LABEL : "Homes houses"
CATEGORY_JUKEBOX_LABEL : "Jukeboxes"
CATEGORY_JUNGLECAVE_LABEL : "Caves with water and plants"
CATEGORY_LAVA_LABEL : "Lava area"
CATEGORY_MINE_LABEL : "Mining Ressources"
CATEGORY_MONUMENT_LABEL : "Monuments"
CATEGORY_MUSHROOM_LABEL : "Mushrooms here"
CATEGORY_NETHER_LABEL : "Nether Portals"
CATEGORY_OTHER_LABEL : "Miscellaneaous"
CATEGORY_PARK_LABEL : "Green Parks"
CATEGORY_PIG_LABEL : "Pigs"
CATEGORY_PILLAGERS_LABEL : "Pillagers"
CATEGORY_POI_LABEL : "POI"
CATEGORY_PURPLE_LABEL : "Purple Marker"
CATEGORY_PURPLEBOX_LABEL : "Purple Shulker Box"
CATEGORY_REDMINE_LABEL : "Redstone Ressources"
CATEGORY_RED_LABEL : "Red marker"
CATEGORY_REDSTONE_LABEL : "Redstone Mechanism"
CATEGORY_SHEEP_LABEL : "Sheeps Here"
CATEGORY_SMALLHOUSE_LABEL : "Tiny Houses"
CATEGORY_SMALLVILLAGE_LABEL : "Small Villages"
CATEGORY_SWORD_LABEL : "Weapons"
CATEGORY_TELEPORT_LABEL : "Teleporters"
CATEGORY_TRAIN_LABEL : "Train Stations"
CATEGORY_UNDERWATERCAVE_LABEL : "Underwater caves"
CATEGORY_VILLAGE_LABEL : "Players Villages"
CATEGORY_VILLAGERS_LABEL : "Villagers community"
CATEGORY_WATERFALL_LABEL : "Waterfalls"
CATEGORY_WHITE_LABEL : "White marker"
CATEGORY_YELLOW_LABEL : "Yellow marker"
CATEGORY_CACHE_LABEL : "Caches to find and log"
options:
MARKER_HTML_VIEWDISTANCE : 3000
DATA_MARKERS_FILEPATH : "bluegeo.markers"
LOAD_TEMPO_SECONDS : 5
BACKUP_MODE : true
BACKUP_EVERY_X_MARKERS : 10
BACKUP_PREFIX : "bluegeo_backup"
BACKUP_FOLDER : "bluegeo_backups/"
BACKUP_KEEP_FILES : 5
MARKER_BACKGROUND_COLOR : "rgba(52,52,52,0.85)"
MARKER_INDEX_COLOR : "#3ECE6A"
MARKER_TEXT_COLOR : "#ffffff"
MARKER_INDEX_SYMBOL : "☰"
MARKER_CATEGORY_COLOR : "#54DBFF"
MARKER_CATEGORY_SYMBOL : "✜"
profiles:
DATA_PROFILES_FILEPATH : "bluegeo.profiles"
XP_GAIN_LOG : 40
XP_GAIN_CREATE : 20
XP_GAIN_PLACE : 80
XP_LOSE_REMOVE : 120
geocache:
DATA_CACHES_FILEPATH : "bluegeo.caches"
CATEGORY_CACHE_LABEL : "Caches to find and log"
CACHE_GENERAL_INFO : "<b>Click to reveal the hints.</b>"
CACHE_GENERAL_INFO_OWNER : "owner: %s"
CACHE_GENERAL_INFO_DATE : "since: %s"
HINTS_TO_CACHE_MINDISTANCE : 20
HINTS_TO_CACHE_MAXDISTANCE : 100
LOGBOOK_MAX_ENTRIES : 60
CACHEMARKER_BACKGROUND_COLOR : "rgba(252,252,252,0.85)"
CACHEMARKER_INDEX_COLOR : "#00718F"
CACHEMARKER_TEXT_COLOR : "#154000"
CACHEMARKER_INDEX_SYMBOL : "☰"
CACHEMARKER_CATEGORY_SYMBOL : "❖"
CACHEMARKER_CATEGORY_COLOR : "#E26A23"
CACHEMARKER_HINT_SYMBOL : "☄"
CACHEMARKER_POPUP_TEXT_COLOR : "#ffffff"
CACHEMARKER_POPUP_BACKGROUND_COLOR : "rgba(28, 64, 0, 0.95)"
CACHE_INVENTORY_PREFIX : "GEOCACHE"
FADEIN_SECONDS : 3
SHOW_FOR_SECONDS : 6
FADEOUT_SECONDS : 3
permissions:
PERMISSION_ADD : "bluegeo.add"
PERMISSION_REMOVE : "bluegeo.remove"
PERMISSION_RELOAD : "bluegeo.reload"
PERMISSION_CACHE_ADD : "bluegeo.cache.add"
PERMISSION_CACHE_REMOVE : "bluegeo.cache.remove"
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 26.1
- 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.
BlueGeo - BLUEMAP MARKERS MANAGER + GEOCACHING is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1. Downloaded 133 times (via Spigot). Download it and open it directly in the game.