Derived Sell Documentation

Derived Sell

Calculate the worth of items based on the worth of the items used to craft them. Set a price on your raw materials and every craftable item on the server prices itself — no thousand-line shop config to maintain, and no accidental infinite-money crafting loops.

Download Derived Sell on SpigotMC

Installation

  1. Add the Derived Sell jar into your plugins folder.
  2. Restart your server.

Commands

  • /derivedsell help — Show the help message.
  • /derivedsell reload — Reload the plugin.
  • /derivedsell migrate <plugin> — Migrate worths from another plugin.
  • /setworth <worth> — Set the worth of the item you are holding. The plugin must be reloaded in order for worth changes to take effect.
  • /setworth <material> <worth> — Set the worth of a specific material. The plugin must be reloaded in order for worth changes to take effect.
  • /worth hand [quantity] — Check the worth of the item in your hand.
  • /worth <material> [quantity] — Check the worth of a specific material.
  • /worth all — Check the worth of all items in your inventory.
  • /worth container — Check the worth of all items in the container you are looking at.
  • /sell hand [quantity] — Sell the item in your hand. If no quantity is provided it will sell all of that item.
  • /sell <material> [quantity] — Sell a specific material. If no quantity is provided it will sell all of that item.
  • /sell all — Sell all items in your inventory.
  • /sell container [material] [quantity] — Sell items in the container you are looking at. With no material it sells everything; with a material it sells only that item (optionally up to the given quantity).

Permissions

  • derivedsell.user.sell (default) — Allows the player to sell an item.
  • derivedsell.user.worth (default) — Allows the player to check the worth of an item.
  • derivedsell.user.autosell (default) — Allows the player to create and use auto-sell chests.
  • derivedsell.admin.reload — Allows the player to reload the plugin configuration.
  • derivedsell.admin.setworth — Allows the player to set the worth of an item.
  • derivedsell.admin.autosell — Allows the player to manage auto-sell chests owned by others.

Auto-Sell Chests

Turn any container (chest, barrel, etc.) into an auto-selling container by placing a configuration sign on it.

  1. Place a sign on the side of a container, or a standing sign directly on top of one.
  2. Write [AutoSell] on the first line.
  3. (Optional) Write a material name on the second line to sell only that item; leave it blank to sell everything sellable.

The container is owned by whoever created the sign. Its sellable contents are sold automatically every interval-seconds (see Config) and the money is deposited to the owner — even while they are offline. The owner (or a player with derivedsell.admin.autosell) can right-click the sign to sell immediately. Break the sign or the container to remove it.

Notes: Only standing and wall signs are supported (not hanging signs). Containers removed by pistons or explosions are cleaned up the next time they would be swept.

Config

round-worth-to: 2 # Number of decimal places to round worth to.
cooking-recipe-multiplier: 2.0 # Multiplier for cooking recipe worth calculations.
log-worth-calculations: true # Whether to log worth calculations to the console.
autosell:
  enabled: true # Whether auto-sell chests are active.
  interval-seconds: 60 # How often (in seconds) auto-sell chests are swept and sold.
  sign-keyword: "[AutoSell]" # Line 1 keyword (case-insensitive) that creates an auto-sell chest.
blocked-materials: # List of materials that should not be considered for worth calculations.
  - wooden-sword
  - stone-sword
  - iron-sword
  - golden-sword
  - diamond-sword
  - netherite-sword
  - wooden-pickaxe
  - stone-pickaxe
  - iron-pickaxe
  - golden-pickaxe
  - diamond-pickaxe
  - netherite-pickaxe
  - wooden-shovel
  - stone-shovel
  - iron-shovel
  - golden-shovel
  - diamond-shovel
  - netherite-shovel
  - wooden-axe
  - stone-axe
  - iron-axe
  - golden-axe
  - diamond-axe
  - netherite-axe
  - wooden-hoe
  - stone-hoe
  - iron-hoe
  - golden-hoe
  - diamond-hoe
  - netherite-hoe
  - leather-helmet
  - chainmail-helmet
  - iron-helmet
  - golden-helmet
  - diamond-helmet
  - netherite-helmet
  - leather-chestplate
  - chainmail-chestplate
  - iron-chestplate
  - golden-chestplate
  - diamond-chestplate
  - netherite-chestplate
  - leather-leggings
  - chainmail-leggings
  - iron-leggings
  - golden-leggings
  - diamond-leggings
  - netherite-leggings
  - leather-boots
  - chainmail-boots
  - iron-boots
  - golden-boots
  - diamond-boots
  - netherite-boots
  - bow
  - crossbow
  - trident
  - fishing-rod
  - shield
  - elytra
  - mace
  - shulker-box
  - spawner
  - enchanted-book

Worth Calculation

  • If an item has a worth set manually it will use that worth.

  • If an item does not have a worth set but the items used to craft it have a worth, the worth is calculated as:

    (TotalWorthOfItemsInRecipe / NumberOfResultingItems) * RecipeTypeMultiplier
    
  • Standard recipes use a RecipeTypeMultiplier of 1. Cooking recipes (recipes in a furnace or other cooking block) can have their multiplier configured in config.yml — it defaults to 2.