Artillex-Studios Documentation Help

Configuration

config.yml

  • # DOCUMENTATION: https://docs.artillex-studios.com/axhoes.html prefix: "<gradient:#FF7700:#FFAA00><b>AxHoes</b></gradient> &7» " database: # currently only h2 is supported type: "h2" # don't touch these unless you know what they mean pool: maximum-pool-size: 10 minimum-idle: 10 maximum-lifetime: 1800000 keepalive-time: 0 connection-timeout: 5000 # should jumping on farmlands turn them into dirt? farmland-trample: disallow: true # if disabled, farmlands will only be protected in the crop worlds (see worlds setting in the crops.yml) only-in-crop-world: false # how should crops be reset? regenerator-mode: # if enabled, crops will be replaced using packets, which is more efficient # if packet mode is enabled, the blocks won't actually be changed serverside # enabling this will improve performance, however note that if enabled, crops will regrow after a server restart # and also crops with a high respawn time (above 30 seconds) might desync if players teleport away and back quickly packet: false # only works if packet mode is enabled # if enabled, if players break a crop, it will only show for them and others can still break it # this can be great if you have small farming zones with a lot of players per-player: false drops: # should drops be put right in the player's inventory? to-inventory: true # if the player's inventory is full, should extra items be dropped on the ground? allow-overflow: false # when broken, what should replace crops? # if false, ageable crops will be visually set back to growth stage 1 # if true, ageable crops will be set to air # doesn't actually change the crop regeneration method/time, this is purely for cosmetic reasons fully-remove-crops: false # if false, all drops are normal items # if true, the plugin will add an NBT to crop drops and prevents them from being crafted/placed # note that this isn't applied to previously generated drops, only to ones generated after this is changed prevent-drop-usage: false # should the block break event be cancelled when a player interacts with a crop managed by axhoes? # for other plugins this will seem like the player didn't even break the block, this is useful to stop protection plugins from sending messages # without having to set up a zone for every crop on the map, however it can also stop useful plugins from working (like stat trackers) # disabling this will enable the "fully-remove-blocks" and the "override-drops" settings cancel-break-event: true # how often should statistics be saved? (like crops broken) # it will also be automatically saved when the player leaves auto-save-minutes: 3 # used for auto sell # even if an enabled shop plugin in the hooks.yml would allow selling an item # if this is enabled, only drops from crops will be sold (this is to prevent the players' items being sold) only-sell-drops: true # if enabled, the plugins will not allow players to break blocks outside their vision # every attempt at breaking an unreachable block will block breaking for 100 miliseconds (stacks up to 3 seconds) # this detection is not perfect, so there is a few blocks of leeway to prevent legit players from being delayed # some crazy mouse movements can make this falsely detect, however it shouldn't affect normal gameplay enable-anti-nuker: true # when prestiging a tool, should its statistics (blocks broken, essence gained, etc.) be also reset? # if disabled, only enchants, level and xp will be reset prestige-reset-tool-stats: false # if enabled, a level 1 harvester hoe will be give to the player when they first join give-tool-on-first-join: true # if enabled, only the tool owner will be able to use the tool enforce-tool-ownership: false # if enabled, it won't be possible to throw/put away or lose your harvester hoe # note that other plugins (for example auction house plugins) can still allow you to lose it bound-tool-to-inventory: true # should there be a confirmation message if somebody attempts to throw their tool out? drop-confirmation: true # the cooldown (in milliseconds) between successful /essence pay commands # note that this doesn't save between server restarts # set to -1 to disable pay-cooldown-millis: 10000 # every how many milliseconds should we check to regenerate crops? # this is not the regeneration time, decreasing this value will make regeneration smoother regeneration-check-millis: 500 # by default the plugin collects farmed money/essence/xp, and it only gives it to players every X seconds to improve performance # this is how often does this collected money is actually given to the player # this setting can save a lot of performance with some economy plugins currency-give-seconds: 1 # how often should the tool item lores update? # setting this value too low could cause high ping lore-cache-milliseconds: 1000 # how should the action bar work? # modes: # 0 - shows the amount of currencies you have collected in a row without stopping # 1 - shows the currencies which you have collected in the previous second action-bar-mode: 0 disenchanting: # should the ability to remove custom tool enchantments be enabled? enabled: true # if enabled, how much of the enchant cost should be refunded in percentages? (0-100) refund-percent: 70.0 # command aliases for the /axhoes command main-command-aliases: - axhoes - axhoe - hoes - hoe # command aliases for the /axhoes essence command essence-commands: - essence # command aliases for the /axhoes xp command player-xp-commands: - level # command aliases for the /axhoes shop command shop-commands: - essenceshop # how much xp is required to level up? # note: this is only used when the "player-xp-plugin" is set to "builtin" in the hooks.yml player-levelling: # TYPES # - formula (uses the given formula) # - manual (set every level manually) # note: levels start from 1 type: "formula" formula: "%level% ^ 2 * 1000" manual: 1: "100" 2: "500" 3: "1500" 4: "5000" # level up rewards rewards: # there is no level 1 reward as it is the default level # this is just an example of what can be done for other levels 1: # the message to send to the user (can be multiline) message: - "&#AAFFAAYour rewards are: &#FFFFFF1500 essence and 1 Fancy Iron" # you can add multiple commands, use %player% instead of the player's name commands: - "essence give %player% 1500" # you can add multiple items, all ItemBuilder (https://docs.artillex-studios.com/item-builder.html) options are supported items: - material: IRON_INGOT amount: 1 glow: true name: "&#DDDDDDFancy Iron" leaderboard: # how often should leaderboards be updated? refresh-minutes: 3 # how many placements should be kept in ram? for example with 30 only the first 30 placement placeholders will work loaded-placements: 30 number-formatting: # modes: # 0 - formatted (customizable, look at the formatted part) # 1 - short (1K) # 2 - raw (1000.4242421412) mode: 0 # https://docs.oracle.com/javase/tutorial/i18n/format/decimalFormat.html formatted: "#,###.##" # format: language_COUNTRY short: "en_US" # can be used in spawner gui, hologram: %xp-bar%, %slots-bar% bar-placeholders: length: 10 empty: "<color:#DDDDDD>■</color>" full: "■" # should be plugin notify you if there is a new update? update-notifier: # if enabled, it will display the message in the console enabled: true # if enabled, it will broadcast the update message to all players who have the <plugin-name>.update-notify permission on-join: true # do not change this version: 1

crops.yml

  • # DOCUMENTATION: https://docs.artillex-studios.com/axhoes.html # ITEM BUILDER: https://docs.artillex-studios.com/item-builder.html # list of worlds where the plugin should regenerate crops # some supported regex: (optional) # - 'name' # only 'name' is disallowed # - 'name*' # disallows text starting with 'name' # - '*name' # disallows text ending with 'name' # - '*name*' # disallows text containing 'name' worlds: - "*" # how many drops should each fortune enchantment level give? # this is only used when the override-drops setting is enabled fortune: # TYPES # - formula (uses the given formula) # - manual (set every level manually) type: "formula" formula: "0.2 + %level% * 0.8" manual: 1: "1" 2: "2" 3: "3" # list of crops which are currently supported by the plugin # note: adding extra blocks to this is possible, however you must restart the server to prevent errors crops: WHEAT: # the tool level required to break this block minimum-tool-level: 1 # tool xp to give (can be a range like: 1-5) tool-xp: 3-7 # player xp to give (can be a range like: 1-5) player-xp: 3-7 # essence to give (can be a range like: 1-5) essence: 1-5 # money to give (can be a range like: 1-5) # note: money is given when crops are broken, to give money when selling, change the money in the drops section money: 0 # how many milliseconds for the crop to regrow? regenerate-millis: 10000 # should the drops be handled by the plugin? if yes, the drops section below will be used # note that if you set this to false, you will also have to keep the cancel-break-event setting enabled in the config override-drops: true # one of these drops will be picked, chances don't have to add up to 100% drops: - chance: 90 # sell price (can be a range like: 1-5) # this is only used when the "builtin" price plugin is enabled in the hooks.yml! sell-price: 5-10 item: amount: 1 material: WHEAT name: "<#FFFF00>Wheat" lore: - "&#DDDDDDᴍᴀᴛᴇʀɪᴀʟ" - chance: 10 sell-price: 10 item: amount: 1 material: HAY_BLOCK name: "<#FFFF00>Hay Block" lore: - "&#DDDDDDᴍᴀᴛᴇʀɪᴀʟ" CARROTS: minimum-tool-level: 5 tool-xp: 7-13 player-xp: 7-13 essence: 3-8 money: 0 regenerate-millis: 10000 override-drops: true drops: - chance: 100 sell-price: 10-15 item: amount: 1 material: CARROT name: "<#FF6600>Carrot" lore: - "&#DDDDDDᴍᴀᴛᴇʀɪᴀʟ" POTATOES: minimum-tool-level: 10 tool-xp: 16-24 player-xp: 16-24 essence: 5-12 money: 0 regenerate-millis: 10000 override-drops: true drops: - chance: 100 sell-price: 25-35 item: amount: 1 material: POTATO name: "<#FFAABB>Potato" lore: - "&#DDDDDDᴍᴀᴛᴇʀɪᴀʟ" BEETROOTS: minimum-tool-level: 15 tool-xp: 40-50 player-xp: 40-50 essence: 10-18 money: 0 regenerate-millis: 10000 override-drops: true drops: - chance: 100 sell-price: 40-55 item: amount: 1 material: BEETROOT name: "<#DD4444>Beetroot" lore: - "&#DDDDDDᴍᴀᴛᴇʀɪᴀʟ" MELON: minimum-tool-level: 20 tool-xp: 72-88 player-xp: 72-88 essence: 15-25 money: 0 regenerate-millis: 10000 override-drops: true drops: - chance: 100 sell-price: 70-85 item: amount: 1 material: MELON_SLICE name: "<#FF2222>Melon Slice" lore: - "&#DDDDDDᴍᴀᴛᴇʀɪᴀʟ" PUMPKIN: minimum-tool-level: 25 tool-xp: 110-140 player-xp: 110-140 essence: 20-30 money: 0 regenerate-millis: 10000 override-drops: true drops: - chance: 100 sell-price: 100-120 item: amount: 1 material: PUMPKIN name: "<#FF7700>Pumpkin" lore: - "&#DDDDDDᴍᴀᴛᴇʀɪᴀʟ" COCOA: minimum-tool-level: 30 tool-xp: 180-220 player-xp: 180-220 essence: 25-35 money: 0 regenerate-millis: 10000 override-drops: true drops: - chance: 100 sell-price: 130-175 item: amount: 1 material: COCOA_BEANS name: "<#976746>Cocoa Beans" lore: - "&#DDDDDDᴍᴀᴛᴇʀɪᴀʟ" SUGAR_CANE: minimum-tool-level: 35 tool-xp: 290-340 player-xp: 290-340 essence: 30-40 money: 0 regenerate-millis: 10000 override-drops: true drops: - chance: 100 sell-price: 200-250 item: amount: 1 material: SUGAR_CANE name: "<#44FF44>Sugar Cane" lore: - "&#DDDDDDᴍᴀᴛᴇʀɪᴀʟ" CACTUS: minimum-tool-level: 40 tool-xp: 450-550 player-xp: 450-550 essence: 35-45 money: 0 regenerate-millis: 10000 override-drops: true drops: - chance: 100 sell-price: 300-400 item: amount: 1 material: CACTUS name: "<#22AA00>Cactus" lore: - "&#DDDDDDᴍᴀᴛᴇʀɪᴀʟ" BAMBOO: minimum-tool-level: 45 tool-xp: 700-1000 player-xp: 700-1000 essence: 40-55 money: 0 regenerate-millis: 10000 override-drops: true drops: - chance: 100 sell-price: 500-700 item: amount: 1 material: BAMBOO name: "<#88FF00>Bamboo" lore: - "&#DDDDDDᴍᴀᴛᴇʀɪᴀʟ" NETHER_WART: minimum-tool-level: 50 tool-xp: 1200-1800 player-xp: 1200-1800 essence: 50-65 money: 0 regenerate-millis: 10000 override-drops: true drops: - chance: 100 sell-price: 750-1000 item: amount: 1 material: NETHER_WART name: "<#AA0055>Nether Wart" lore: - "&#DDDDDDᴍᴀᴛᴇʀɪᴀʟ" # do not change this version: 1

hooks.yml

  • # DOCUMENTATION: https://docs.artillex-studios.com/axhoes.html # what plugin to use? # used for calculating spawner drop value # if multiple is enabled, the highest sell value will be used price-plugins: # builtin is for using sell prices from the crops.yml builtin: true # external plugins ShopGUIPlus: false Essentials: false EconomyShopGUI: false CMI: false # list of supported plugins: https://docs.artillex-studios.com/axhoes-supported-plugins.html#currency # what plugin should handle the money currency? money-plugin: plugin: Vault # this value is only used when the plugin supports multiple currencies currency: "" # list of supported plugins: https://docs.artillex-studios.com/axhoes-supported-plugins.html#currency # what plugin should handle the essence currency? # axhoes comes with a builtin essence system essence-plugin: plugin: builtin # this value is only used when the plugin supports multiple currencies currency: "" # list of supported plugins: https://docs.artillex-studios.com/axhoes-supported-plugins.html#player-xp # what plugin should handle the player xp? # axhoes comes with a builtin player xp system player-xp-plugin: builtin # do not change this version: 1

lang.yml

  • # DOCUMENTATION: https://docs.artillex-studios.com/axhoes.html help: - " " - "<gradient:#FF7700:#FFAA00><b>AxHoes</b></gradient> <#FFDD00>Help" - " <#FFDD00>➤ <white>/axhoes reload <#DDDDDD>| <#FFFFAA>Reload plugin" - " <#FFDD00>➤ <white>/axhoes give <player> [level] <#DDDDDD>| <#FFFFAA>Give tool to player" - " <#FFDD00>➤ <white>/axhoes tool setlevel <amount> <#DDDDDD>| <#FFFFAA>Set hoe level" - " <#FFDD00>➤ <white>/axhoes tool setxp <amount> <#DDDDDD>| <#FFFFAA>Set hoe XP" - " <#FFDD00>➤ <white>/axhoes tool setprestige <amount> <#DDDDDD>| <#FFFFAA>Set hoe prestiges" - " <#FFDD00>➤ <white>/axhoes tool setowner <player> <#DDDDDD>| <#44DDFF>Set hoe owner" - " <#FFDD00>➤ <white>/axhoes leaderboard [player] <#DDDDDD>| <#FFFFAA>Open leaderboard menu" - " <#FFDD00>➤ <white>/axhoes shop [player] <#DDDDDD>| <#FFFFAA>Open essence shop" - " <#FFDD00>➤ <white>/axhoes reload <#DDDDDD>| <#FFFFAA>Reload configuration" - " <#FFDD00>➤ <white>/axhoes essence view [player] <#DDDDDD>| <#FFFFAA>View essence" - " <#FFDD00>➤ <white>/axhoes essence give/take/set/pay <player> <amount> <#DDDDDD>| <#FFFFAA>Modify essence" - " <#FFDD00>➤ <white>/axhoes essence reset <player> <#DDDDDD>| <#FFFFAA>Reset essence" - " <#FFDD00>➤ <white>/axhoes xp view [player] <#DDDDDD>| <#FFFFAA>View player XP" - " <#FFDD00>➤ <white>/axhoes xp givexp <player> <amount or X%> <#DDDDDD>| <#FFFFAA>Give player XP" - " <#FFDD00>➤ <white>/axhoes xp takexp/setlevel <player> <amount> <#DDDDDD>| <#FFFFAA>Modify player XP" - " <#FFDD00>➤ <white>/axhoes xp reset <player> <#DDDDDD>| <#FFFFAA>Reset player XP" - " " action-bar: "&#FFAA00%last_money_gained% &#FFFFAAmoney &#FF7700| &#FFAA00%last_essence_gained% &#FFFFAAessence &#FF7700| &#FFAA00%last_tool_xp_gained% &#FFFFAAtool XP &#FF7700| &#FFAA00%last_player_xp_gained% &#FFFFAAplayer XP" inventory-full: title: "&#FF4400&l⚠ &#FF0000Inventory Full &#FF4400&l⚠" subtitle: "&#FFAAAASell drops to clear space!" tool: level-up: "&#00FF00Level Up! Your tool has reached level &#FFFFFF%level%&#00FF00!" low-level: "&#FF0000A level &#FFFFFF%required-level% &#FF0000tool is required for this crop! Your tool is only level &#FFFFFF%tool-level%&#FF0000." not-tool: "&#FF0000You must hold a harvester hoe in your hand!" not-your-tool: "&#FF0000You can't use this harvester hoe, because it is not yours!" set-level: "&#00FF00You have successfully set the hoe's level to &#FFFFFF%level%&#00FF00!" set-xp: "&#00FF00You have successfully set the hoe's XP to &#FFFFFF%amount%&#00FF00!" set-prestiges: "&#00FF00You have successfully set the hoe's prestiges to &#FFFFFF%amount%&#00FF00!" set-owner: "&#00FF00You have successfully made &#FFFFFF%player% &#00FF00the new owner of this tool!" keep-in-inventory: "&#FF0000You must always keep the tool in your inventory." drop-confirm: "&#FF0000Please press the drop button again if you want to throw your tool out." essence: balance: "&#00FF00You have &#FFFFFF%amount% &#00FF00essence!" balance-other: "&#FFFFFF%player% &#00FF00has &#FFFFFF%amount% &#00FF00essence!" give: "&#00FF00You have given &#FFFFFF%amount% &#00FF00essence to &#FFFFFF%player%&#00FF00!" take: "&#00FF00You have taken &#FFFFFF%amount% &#00FF00essence from &#FFFFFF%player%&#00FF00!" set: "&#00FF00You have set the essences of &#FFFFFF%player% &#00FF00to &#FFFFFF%amount%&#00FF00!" disabled: "&#FF0000The builtin essence system is disabled!" pay-not-enough: "&#FF0000You don't have &#FFFFFF%amount% &#FF0000essence!" pay-success: "&#00FF00You have successfully paid &#FFFFFF%amount% &#00FF00essence to &#FFFFFF%player%&#00FF00!" pay-received: "&#00FF00You have received &#FFFFFF%amount% &#00FF00essence from &#FFFFFF%player%&#00FF00!" pay-self: "&#FF0000You can't send essence to yourself!" pay-cooldown: "&#FF0000You must wait another &#FFFFFF%time% &#FF0000seconds before sending essence again!" player-xp: balance: "&#00FF00You are level &#FFFFFF%level% &#00FF00and you need &#FFFFFF%amount% &#00FF00xp to level up!" balance-other: "&#FFFFFF%player% &#00FF00is level &#FFFFFF%level% &#00FF00and needs &#FFFFFF%amount% &#00FF00xp to level up!" give: "&#00FF00You have given &#FFFFFF%amount% &#00FF00player XP to &#FFFFFF%player%&#00FF00!" take: "&#00FF00You have taken &#FFFFFF%amount% &#00FF00player XP from &#FFFFFF%player%&#00FF00!" set: "&#00FF00You have set the player level of &#FFFFFF%player% &#00FF00to &#FFFFFF%amount%&#00FF00!" disabled: "&#FF0000The builtin XP system is disabled!" level-up: "&#00FF00Level Up! Your player level has reached level &#FFFFFF%level%&#00FF00!" shop: purchased: "&#00FF00You have purchased &#FFFFFF%name% &#00FF00for &#FFFFFF%amount% &#00FF00essence!" no-essence: "&#FF0000You can't purchase this item because you don't have enough essence. You need &#FFFFFF%amount%&#FF0000!" enchant: no-essence: "&#FF0000You can't purchase this enchant because you don't have enough essence. You need &#FFFFFF%amount%&#FF0000!" no-permission: "&#FF0000You don't have permission to purchase this enchant!" maxed: "&#FF0000You have reached the maximum level of the &#FFFFFF%enchant% &#FF0000enchant!" success: "&#00FF00The %enchant% &#00FF00enchant has been successfully purchased!" disenchant: "&#00FF00You have successfully refunded &#FFFFFF%levels% &#00FF00enchant levels and got &#FFFFFF%amount% &#00FF00essence!" no-enchant: "&#FF0000You can't refund this enchant, because the level is too low!" low-player-level: "&#FF0000Your player level must be at least &#FFFFFF%level% &#FF0000to purchase the &#FFFFFF%enchant% &#FF0000enchant!" low-tool-level: "&#FF0000Your tool level must be at least &#FFFFFF%level% &#FF0000to purchase the &#FFFFFF%enchant% &#FF0000enchant!" # this will be used for the %enchants% placeholder, repeated for all enchants lore: enchant: " <#555555>❙ <#FFFFFF>%enchant-name%<br>" none: " <#555555>❙ <#FFFFFF>No enchantments" placeholder: enabled: "&#00FF00enabled" disabled: "&#FF0000disabled" enabled: "&#00FF00The %enchant% &#00FF00enchant has been enabled!" disabled: "&#FF0000The %enchant% &#FF0000enchant has been disabled!" prestige: no-essence: "&#FF0000You can't prestige, because you don't have enough essence. You need &#FFFFFF%amount%&#FF0000!" no-money: "&#FF0000You can't prestige, because you don't have enough money. You need &#FFFFFF%amount%&#FF0000!" no-level: "&#FF0000You can't prestige, because you don't have enough tool levels. You need &#FFFFFF%amount%&#FF0000!" maxed: "&#FF0000You have reached the maximum prestige level!" success: "&#00FF00You have successfully prestiged your tool to level &#FFFFFF%prestige%&#00FF00!" reload: success: "&#33FF33Plugin successfully reloaded!" failed: "&#FF3333Failed to reload the plugin! Something is wrong in the &f%file%&#FF3333 file, look in the console or use a yaml validator to fix the errors!" commands: invalid-value: "&#FF0000Invalid parameter: &#BB0000%value%" invalid-command: "&#FF0000Invalid command or subcommand!" missing-argument: "&#FF0000Missing argument! You must specify a value for &#BB0000%value%&#FF0000." no-permission: "&#FF0000You don't have permission to access this command!" out-of-range: "&#FF0000The &#BB0000%number% &#FF0000must be between &#BB0000%min% &#FF0000and &#BB0000%max%&#FF0000!" player-only: "&#FF0000You must be a player to use this command!" invalid-player: "&#FF0000The player &#BB0000%player% &#FF0000can not be found!" invalid-selector: "&#FF0000You can not use this selector in this command!" update-notifier: "&#FFCC00There is a new version of AxHoes available! &#DDDDDD(&#FFFFFFcurrent: &#FF0000%current% &#DDDDDD| &#FFFFFFlatest: &#00FF00%latest%&#DDDDDD)" # do not change this version: 1

shop.yml

  • # DOCUMENTATION: https://docs.artillex-studios.com/axhoes.html # ITEM BUILDER: https://docs.artillex-studios.com/item-builder.html # format: # | pages: # | 1: - page number (starts at 1) # | 10: - slot in gui (starts at 0) pages: 1: # ITEM EXAMPLE 10: # the cost of the item price: 1000 # the items to give when purchased items: - material: DIAMOND amount: 1 name: "&#00FFFFShiny diamond" glow: true # the item to display display: amount: 1 material: DIAMOND glow: true name: "&#00FFFFShiny diamond" lore: - "" - "&#FF7700&lClick &l> &#FFCC00Purchase for &#FFFFFF%price% &#FFCC00essence!" # COMMAND EXAMPLE 11: # the cost of the item price: 1000 # these commands will be run when somebody purchases this commands: - "say Welcome %player%!" # the item to display display: amount: 1 material: BOOK name: "&#FFFF00A warm welcome message" lore: - "" - "&#FF7700&lClick &l> &#FFCC00Purchase for &#FFFFFF%price% &#FFCC00essence!" # do not change this version: 1

tool.yml

  • # DOCUMENTATION: https://docs.artillex-studios.com/axhoes.html # ITEM BUILDER: https://docs.artillex-studios.com/item-builder.html # note: upgrades are currently is only for customizing the hoe item (+ to unlock new crops) xp-calculation: # TYPES # - formula (uses the given formula to calculate xp needed for a level) # - manual (you can configure the xp needed for levels yourself one-by-one) # note: levels start from 1 type: "formula" formula: "%level% ^ 2 * 1000" manual: 1: "100" 2: "500" 3: "1500" 4: "5000" # the list of levels (you can configure any amount of levels) # make sure that you set a price for all levels if you are using manual price-calculation # note: the higher levels will override the lower ones, so for example if you want the level 50 tool # to have a custom model data, you only need to set that value and the rest will be used from the lower levels upgrades: # level 1 (DEFAULT LEVEL) 1: material: WOODEN_HOE name: "&#FF7700&lʜᴀʀᴠᴇꜱᴛᴇʀ ʜᴏᴇ" glow: true lore: - "" - "<#FF7700><b>></b> <#FFAA55>Level: <#FF7700>%tool-level%" - "<#FF7700><b>></b> <#FFAA55>Progress: <#FF7700>%tool-progress-bar% &#DDDDDD(%tool-progress-percentage%%)" - "" - "<#FF7700>ɪɴꜰᴏʀᴍᴀᴛɪᴏɴ" - " <#555555>❙ <#FFFFFF>Owner: <#FF7700>%owner%" - " <#555555>❙ <#FFFFFF>Prestiges: <#FF7700>%prestiges%" - "" - "<#FF7700>ꜱᴛᴀᴛꜱ" - " <#555555>❙ <#FFFFFF>Crops: <#FF7700>%broken-blocks% <#FFAA55>broken" - " <#555555>❙ <#FFFFFF>Money: <#FF7700>$%collected-money% <#FFAA55>collected" - " <#555555>❙ <#FFFFFF>Essence: <#FF7700>%collected-essence% <#FFAA55>collected" - "" - "<#FF7700>ᴇɴᴄʜᴀɴᴛꜱ" - "%enchants%" # go to the lang.yml -> enchant -> lore to customize this - "" - "<#FF7700><b>></b> <#FFAA55>Break crops to level up." # level 2 3: material: STONE_HOE 5: material: IRON_HOE 10: material: GOLDEN_HOE 15: material: DIAMOND_HOE 20: material: NETHERITE_HOE # after reaching a certain tool level, tools can be prestiged, permanently increasing the gained resources # prestige resets tool XP, level, enchants prestige: # the maximum possible prestige level max-prestige: 100 # minimum level/money/essence required to prestige required: level: # TYPES # - formula (uses the given formula) # - manual (set every level manually) # note: by default the player has 0 prestiges type: "formula" formula: "%prestige% * 5 + 30" manual: 1: "30" 2: "35" 3: "40" 4: "45" 5: "50" money: type: "manual" manual: 1: "0" essence: type: "formula" formula: "%prestige% ^ 2 * 1000000" # the statistics which will be boosted when prestiging essence-boost: type: "formula" formula: "%prestige% * 0.1 + 1" money-boost: type: "formula" formula: "%prestige% * 0.1 + 1" tool-xp-boost: type: "formula" formula: "%prestige% * 0.1 + 1" player-xp-boost: type: "formula" formula: "%prestige% * 0.1 + 1" drop-boost: type: "formula" formula: "%prestige% * 0.1 + 1" # do not change this version: 1

Example gui configuration: (there are 7 gui files that come with the plugin)

guis/main-gui.yml

  • # DOCUMENTATION: https://docs.artillex-studios.com/axhoes.html # ITEM BUILDER: https://docs.artillex-studios.com/item-builder.html title: "&0ʜᴀʀᴠᴇꜱᴛᴇʀ ʜᴏᴇ" # a gui can have 1-6 rows rows: 5 # ----- ITEMS ----- border-decoration: material: "ORANGE_STAINED_GLASS_PANE" slot: "border" name: " " stats: slot: 20 material: "BOOK" name: "&#FF7700&lᴛᴏᴏʟ ꜱᴛᴀᴛɪꜱᴛɪᴄꜱ" lore: - " " - "<#FF7700>ɢᴇɴᴇʀᴀʟ" - " <#555555>❙ <#FFFFFF>Level: <#FF7700>%tool-level%" - " <#555555>❙ <#FFFFFF>Progress: <#FF7700>%tool-progress-bar% &#DDDDDD(%tool-progress-percentage%%)" - " <#555555>❙ <#FFFFFF>Prestiges: <#FF7700>%prestiges%" - " <#555555>❙ <#FFFFFF>Crops: <#FF7700>%broken-blocks% <#FFAA55>broken" - " <#555555>❙ <#FFFFFF>Money: <#FF7700>$%collected-money% <#FFAA55>collected" - " <#555555>❙ <#FFFFFF>Essence: <#FF7700>%collected-essence% <#FFAA55>collected" - " " - "<#FF7700>ᴄʀᴏᴘꜱ" - " <#555555>❙ <#FFFF00>Wheat: <#FF7700>%broken-wheat% <#FFAA55>broken" - " <#555555>❙ <#FF6600>Carrot: <#FF7700>%broken-carrots% <#FFAA55>broken" - " <#555555>❙ <#FFAABB>Potato: <#FF7700>%broken-potatoes% <#FFAA55>broken" - " <#555555>❙ <#DD4444>Beetroot: <#FF7700>%broken-beetroots% <#FFAA55>broken" - " <#555555>❙ <#FF2222>Melon: <#FF7700>%broken-melon% <#FFAA55>broken" - " <#555555>❙ <#FF7700>Pumpkin: <#FF7700>%broken-pumpkin% <#FFAA55>broken" - " <#555555>❙ <#976746>Cocoa Beans: <#FF7700>%broken-cocoa% <#FFAA55>broken" - " <#555555>❙ <#44FF44>Sugar Cane: <#FF7700>%broken-sugarcane% <#FFAA55>broken" - " <#555555>❙ <#22AA00>Cactus: <#FF7700>%broken-cactus% <#FFAA55>broken" - " <#555555>❙ <#88FF00>Bamboo: <#FF7700>%broken-bamboo% <#FFAA55>broken" - " <#555555>❙ <#AA0055>Nether Wart: <#FF7700>%broken-netherwart% <#FFAA55>broken" - " " enchants: slot: 13 material: "ENCHANTED_BOOK" name: "&#FF7700&lᴛᴏᴏʟ ᴇɴᴄʜᴀɴᴛᴍᴇɴᴛꜱ" lore: - " " - "<#FF7700>ᴇɴᴄʜᴀɴᴛꜱ" - "%enchants%" # go to the lang.yml -> enchant -> lore to customize this - "" - "&#FF7700&lClick &l> &#FFCC00View enchantments" actions: - "[MENU] enchant" - "[SOUND] ui.button.click|1|1" leaderboards: slot: 24 material: "GOLD_INGOT" name: "&#FF7700&lʟᴇᴀᴅᴇʀʙᴏᴀʀᴅꜱ" lore: - " " - "&#FF7700&lClick &l> &#FFCC00View leaderboards" actions: - "[MENU] leaderboards" - "[SOUND] ui.button.click|1|1" prestige: slot: 31 material: "BEACON" name: "&#FF7700&lᴘʀᴇꜱᴛɪɢᴇ" lore: - " " - "<#FF7700><b>></b> <#FFAA55>Prestiges: <#FF7700>%prestiges%" - " " - "&#FF7700&lClick &l> &#FFCC00Go to prestige menu" actions: - "[MENU] prestige" - "[SOUND] ui.button.click|1|1"

Example enchant file, the default configuration comes with more than a dozen premade enchants. You can always create more.

enchants/speed-effect.yml

  • # DOCUMENTATION: https://docs.artillex-studios.com/axhoes.html # ITEM BUILDER: https://docs.artillex-studios.com/item-builder.html # should the enchantment be enabled? enabled: true name: "&#FFCC00Speed &#FFFF00%level%" # what type of enchantment is this? check the wiki for the list type: "give_effect" # the enchant's max possible level max-level: 100 # optional, required levels to be able to upgrade this enchant required-player-level: 0 required-tool-level: 0 # optional, what permission is required to upgrade this enchant? required-permission: "" # should the enchant get reset when the tool is prestiged? reset-on-prestige: true # the amount of essence required to upgrade the enchantment price: # TYPES # - formula (uses the given formula) # - manual (set every level manually) # note: levels start from 0 type: "formula" formula: "%level% ^ 2 * 10000" manual: 1: "100" 2: "500" 3: "1500" 4: "5000" # chance for this enchantment to trigger when a crop is broken (0-100%) chance: # TYPES # - formula (uses the given formula) # - manual (set every level manually) # note: levels start from 1 type: "formula" formula: "%level%" manual: 1: "200" 2: "500" 3: "800" 4: "1200" # levelling up changes the effects given # list of potion effect types: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html # format: <type>:<strength starting at 1>:<time in seconds> effect: 1: - "SPEED:1:5" 25: - "SPEED:2:5" 50: - "SPEED:3:5" 75: - "SPEED:4:5" 100: - "SPEED:5:5"
Last modified: 21 November 2025