✅ BetterWaypoints [1.8-1.16] • A new way to save waypoints: Waypoint books! Custom recipe! 0.1-BETA

Let your players save waypoints easily.

  1. AlonsoAliaga
    Native Minecraft Version:
    1.13
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    • 1.15
    • 1.16
    Languages Supported:
    Customizable in config.yml
    This plugin requires NBT API installed!
    Tested on 1.8.8, 1.9.2, 1.10.2, 1.11.2, 1.12.2, 1.13.2, 1.14.4, 1.15.2, 1.16.2

    If you want to contribute with a translation in your native language, feel free to dm me the translation.

    [​IMG]
    [​IMG] [​IMG] [​IMG] [​IMG] [​IMG]

    [​IMG] [​IMG] [​IMG] [​IMG]

    [​IMG][​IMG]

    Looking for a new way to save locations?
    Looking for a way to charge your players for teleporting?

    Well, I created this plugin for that reason.

    This plugin adds two "new items" to the game, a book and a paper.
    What are they for?
    The paper saves the location.
    The book saves the paper for easy access.

    Ok, so?
    Well, players open waypoint book, and select the waypoint they want to teleport.
    They will be teleported inmediately if they can pay the price (if enabled)

    Note: Papers can be used once only.

    [​IMG]

    • Custom recipe for book.
      • Recipe configurable in config.yml
    • Custom recipe for paper.
      • Recipe configurable in config.yml
    • Recipe command.
      • Command to show book recipe.
      • Command to show paper recipe.
    • Custom model data support! ONLY 1.14+!
      • Option to set custom model data for custom texture for waypoint book.
      • Option to set custom model data for custom texture for waypoint paper.
    • Custom displayname and lore. BETA!
      • Displayname and lore when paper is new.
      • Displayname and lore when paper has location saved.
      • Displayname and lore when book is new.
      • Displayname and lore when book has papers inside.
    • Customizable permission.
      • Permission to craft paper.
      • Permission to craft book.
      • Permission to view paper recipe.
      • Permission to view book recipe.
      • Permission to use paper.
      • Permission to use book.
    • Give command.
      • To give waypoint paper to player. (works in console)
      • To give waypoint book to player. (works in console)
    • Recipe command.
      • Open waypoint paper recipe for player. (works in console)
      • Open waypoint book recipe for player. (works in console)
    • Blacklist worlds. BETA!
      • Disable book usage in certain worlds.
      • Disable paper usage in certain worlds.
    • Teleport cost. BETA!
      • Charge players using economy plugin. VAULT SUPPORT!
      • Charge players using level.
    • Reload command.
      • Reload messages and some variables.
      • Doesn't apply for items recipes, restart required!
    • Configuration auto update.
      • Configuration will be updated on plugin update.
      • Comments will be removed on config update.
    • Update checker.
      • Be notified when there is a new update.

    [/LIST]
    [​IMG]
    config.yml
    Code (YAML):
    #
    #     ___      _   _         __      __                   _     _
    #    | _ ) ___| |_| |_ ___ _ \ \    / /_ _ _  _ _ __  ___(_)_ _| |_ ___
    #   | _ \/ -_)  _|  _/ -_) '_\ \/\/ / _` | || | '_ \/ _ \ | ' \  _(_-<
    #  |___/\___|\__|\__\___|_|  \_/\_/\__,_|\_, | .__/\___/_|_||_\__/__/
    #                                       |__/|_|
    #                           by AlonsoAliaga
    #          https://www.spigotmc.org/resources/authors/281176/
    #

    Waypoints-paper
    :
      Recipe
    :
        Enabled
    : true
        Ingredients
    :
          E
    : "ENDER_PEARL"
          P
    : "PAPER"
        Shape
    :
       - "EEE"
        - "EPE"
        - "EEE"
        Amount
    : 2
      New-displayname
    : "&b&lWaypoint paper"
      New-lore
    :
       - "&eRight-click to save waypoint."
      #Using 1.14+? Want to add custom texture?
      #Use this to add custom model data so you can use it later in the resource pack.
      #If you don't plan to use a texture pack, set it to 0.
      New-custom-model-data
    : 0
      #Data for paper with waypoint saved.
      Used-displayname
    : "&4&lWaypoint paper"
      Used-lore
    :
       - "&7Saved waypoint."
      #Using 1.14+? Want to add custom texture?
      #Use this to add custom model data so you can use it later in the resource pack.
      #If you don't plan to use a texture pack, set it to 0.
      Used-custom-model-data
    : 0
      #Display recipe with command?
      Display
    : true
      Glow
    :
       #This option adds enchantment on craft.
        On-craft
    : false
        #This option adds enchantment on waypoint save.
        On-save
    : true

    Waypoints-book
    :
      Recipe
    :
        Enabled
    : true
        Ingredients
    :
          D
    : "DIAMOND"
          E
    : "ENDER_PEARL"
          B
    : "BOOK"
        Shape
    :
         - "DED"
          - "EBE"
          - "DED"
      Displayname
    : "&3&lWaypoints Book"
      New-lore
    :
       - "&7Brand new book!"
        - ""
        - "&eRight-click to open."
        - "&eShift + right-click to edit."
      Used-lore
    :
        - "&7Pages
    : {PAGES}/{MAXPAGES}"
        - "
    "
        - "
    &eRight-click to open."
        - "
    &eShift + right-click to edit."
      #Using 1.14+? Want to add custom texture?
      #Use this to add custom model data so you can use it later in the resource pack.
      #If you don't plan to use a texture pack, set it to 0.
      Custom-model-data: 0
      #Display recipe with command?
      Display: true
      #Adds enchantment and hide flags.
      Glow: true
      #From 1 to 6 (Default size for crafted/given waypoints books)
      Rows: 3

    #Permissions. Set to "
    none" if permission is not required.
    Permissions:
      #Permission required to be able to craft items.
      Craft:
        Paper: "
    none" # Example: "betterwaypoints.craft.paper"
        Book: "
    none" # Example: "betterwaypoints.craft.book"
      #Permission required to be able to access "
    /bwp recipe" command.
      Recipe:
        Paper: "
    none" # Example: "betterwaypoints.recipe.paper"
        Book: "
    none" # Example: "betterwaypoints.recipe.book"
      Usage:
        Paper: "
    none" # Example: "betterwaypoints.usage.paper"
        Book: "
    none" # Example: "betterwaypoints.usage.book"
      #Admin permission. Always required, even if "
    none".
      Admin: "
    betterwaypoints.admin"

    Messages:
      No-permission: "
    &cYou don't have permissions to execute this command."
      Only-main-hand-papers: "
    &cWaypoints Books can be used only in main hand!"
      Only-main-hand-books: "
    &cWaypoints Books can be used only in main hand!"
      Cannot-stacked-papers: "
    &cYou cannot use stacked waypoints papers.."
      Cannot-stacked-books: "
    &cYou cannot use stacked waypoints books.."
      Invalid-target: "
    &cTarget is not valid or is not online."
      #Remember you can give from 1 to 64 items.
      Invalid-amount: "
    &cAmount is not a valid number."
      Reloaded: "
    &aConfiguration and some checks have been reloaded. This doesn't include recipes updates."
      Give:
        Paper:
          Gave-target: "
    &aYou successfully gave {AMOUNT} Waypoint paper(s) to {TARGET}."
          Received: "
    &6You received {AMOUNT} Waypoint paper(s)."
          Received-extra: "
    &6You received {AMOUNT} Waypoint paper(s). Your inventory was full, some items were thrown in the floor."
        Book:
          Gave-target: "
    &aYou successfully gave {AMOUNT} Waypoints Book(s) to {TARGET}."
          Received: "
    &6You received {AMOUNT} Waypoints Book(s)."
          Received-extra: "
    &6You received {AMOUNT} Waypoints Book(s). Your inventory was full, some items were thrown in the floor."
      Usage:
        Paper:
          No-permission: "
    &cYou don't have permission to use waypoint papers!" #Useful if you want to make recipe view an acquirable perk
          Already-used: "
    &cThere is already a waypoint saved in this paper.."
          Waypoint-saved: "
    &aWaypoint saved! You can now rename this paper using an anvil."
          Disabled-world: "
    &cSaving waypoints in this world is not allowed!"
          Cannot-stacked: "
    &cCannot use stacked waypoint papers!"
          Corrupted-waypoint: "
    &cLooks like this waypoint is corrupted. I suggest you to remove it!"
          Teleported-to-waypoint: "
    &a&lYou have been teleported to you waypoint!"
          Teleported-to-waypoint-money: "
    &a&lYou have been teleported to you waypoint! You used ${COST}."
          Teleported-to-waypoint-level: "
    &a&lYou have been teleported to you waypoint! You used {COST} level(s)."
        Book:
          No-permission: "
    &cYou don't have permission to use waypoints books!" #Useful if you want to make recipe view an acquirable perk
          Disabled-world: "
    &cUsing waypoints books in this world is not allowed!"
          Cannot-stacked: "
    &cCannot use stacked waypoints books!"
          Brand-new: "
    &cThis book is brand new! Try to use it while sneaking.."
          Unexpected-error-save: "
    &cThere was an unexpected error while saving waypoints for this book.."
          Unexpected-error-open: "
    &cThere was an unexpected error while opening this book.."
          Not-enough-money: "
    &cYou need ${COST} to teleport to this waypoint!"
          Error-transaction: "
    &cThere was an error processing your payment. Please try again later!"
          Not-enough-level: "
    &cYou need {COST} level(s) to teleport to this waypoint!"
      Craft:
        Paper:
          No-permission: "
    &cYou cannot craft this item!" #Useful if you want to make paper crafting an acquirable perk
        Book:
          No-permission: "
    &cYou cannot craft this item!" #Useful if you want to make book crafting an acquirable perk
      Recipe:
        Recipe-disabled: "
    &cView for this recipe is not enabled or item is not craftable."
        Paper:
          Opened-other: "
    &aYou opened Waypoint Paper recipe for {TARGET}."
          No-permission: "
    &cYou cannot view this recipe!" #Useful if you want to make recipe view an acquirable perk
        Book:
          Opened-other: "
    &aYou opened Waypoints Book recipe for {TARGET}."
          No-permission: "
    &cYou cannot view this recipe!" #Useful if you want to make recipe view an acquirable perk
      Open-book-title: "
    &8Available waypoints"
      Edit-book-title: "
    &8Editing waypoints"
      Paper-recipe:
        Title: "
    &8Waypoint paper recipe"
      Book-recipe:
        Title: "
    &8Waypoint book recipe"
    Options:
      #Worlds in which saving waypoints using papers is not allowed.
      Paper-disabled-worlds:
        - "
    world_the_end"
      #Worlds in which using books is not allowed.
      Book-disabled-worlds:
        - "
    world_the_end"
      Teleport-cost:
        #If enabled, teleporting using waypoints will have a cost.
        Enabled: true
        Ignore-on-creative: true
        #If disabled, cost will take levels. YES, LEVELS, not experiences, LEVELS.
        #If enabled and Vault is available and hooked, cost will take money from balance, otherwise it will take LEVELS.
        #This is an experimental feature, please report bugs on discussion tab.
        Vault: false
        Cost: 1
    Updates:
      Check-updates: true
      Notify-updates: true
      Auto-update-configuration: true
      Permission: "
    betterwaypoints.update"
      Message: "
    &3[BetterWaypoints] &eA new update has been found! Download it here &c{LINK}"

    [​IMG]
    Waypoint book crafting recipe in gui.
    [​IMG]

    Waypoint paper crafting recipe in gui.
    [​IMG]

    Crafting wapoint book.
    [​IMG]
    Can't see the gif? Click here

    Crafting waypoint paper.
    [​IMG]
    Can't see the gif? Click here

    Waypoint selection using waypoint paper.
    [​IMG]
    Can't see the gif? Click here

    Renaming waypoint paper.
    [​IMG]
    Can't see the gif? Click here

    Saving papers in waypoint book. (Edit mode shift + right click)
    [​IMG]
    Can't see the gif? Click here

    Remove waypoints from book. (Edit mode shift + right click)
    [​IMG]
    Can't see the gif? Click here

    Ready to save your life.
    [​IMG]
    Can't see the gif? Click here

    [​IMG]
    Installing the plugin in your server:
    • Download the plugin from SpigotMC.org
    • Copy the jar file into you plugins folder.
    • Restart the server.
    • Edit what you want in configuration files.
    • Restart the server.
    [​IMG]
    Permissions are configurable in configuration files.

    /betterwaypoints recipe <paper/book> - Open recipe GUI (for a player)
    Permission:
    betterwaypoints.recipe

    /betterwaypoints give <paper/book> - Give paper/book to player.
    Permission:
    betterwaypoints.admin

    /betterwaypoints reload - Reload configuration and some checks.
    Permission:
    betterwaypoints.admin

    [​IMG]
    None yet. You can send me your reviews :D

    [​IMG]
    This is a simple plugin, i don't think it requires more features.
    However if you consider your suggestion should be added, let me know in discussion tab.

    [​IMG]
    Let us know if your server is using it! ;)

    [​IMG]
    1) Why is this BETA? That means it has bugs?
    Answer:
    No, plugin should not have bugs. I use BETA because I like the word, I guess.

    2) Will you add new features?
    Answer:
    Probably, if i receive any good suggestion.

    3) Can I post this in mcbbs.net?
    Answer:
    No.

    [​IMG]
    NBT API - This plugin works with NBT Tags.

    [​IMG]
    Access the API package:
    com.alonsoaliaga.betterwaypoints.api.BetterWaypointsAPI
    Code (Java):
    Available methods:
    @Nullable ItemStack createWaypointPaper(@Nonnull Location location)
    > Create waypoint with location saved. (Returns null if location or world is null)
    ItemStack createWaypointPaper()
    > Create a waypoint paper.
    ItemStack createWaypointPaper(int amount)
    > Create specific amount of waypoint papers.
    ItemStack createWaypointBook()
    > Create a waypoint book.
    List<ItemStack> createWaypointBook(int amount)
    > Create specific amount of waypoint books.

    Available events:
    WaypointBookOpenEvent
    > When player opens a waypoint book.
    WaypointSaveEvent
    > When player closes waypoint book inventory.
    WaypointTeleportEvent
    > When player uses waypoint book to teleport.
    WaypointBookCraftEvent
    > When player crafts a waypoint book.
    WaypointPaperCraftEvent
    > When player crafts a waypoint paper.

    If you find any bugs, errors or want to request a feature.
    Join my discord or use our issue tracker.

    Review section is not place to report errors.


    [​IMG]
    • None yet :)
    [​IMG]
    By downloading this resource you agree all following terms and conditions:
    • You are not permitted to redistribute the plugin in any form, including as a part of any software package.[/B]
    • You are not permitted to decompile or modify the plugin in any form.
    • You are not permitted to claim this resource as your own creation.

    [​IMG]

Recent Reviews

  1. savenx
    savenx
    5/5,
    Version: 0.1-BETA
    This is a very cool Waypoint plugin for Survival servers.... Instead of Setting alot of homes, players use this method! 10/10
    1. AlonsoAliaga
      Author's Response
      Yeah, it allow players to add/use as many waypoints they want just if they can afford it.

      Thanks for your review!