ChestShopFinder tracks ChestShops and lets players search for nearby shops to sell/buy items.

Be sure to subscribe to file updates.


  • Search command to show all shops nearby trading a item.
  • Buy command listing nearby shops selling an item, sorted cheapest first.
    • Only shops with stock included.
  • Sell command listing nearby shops buying an item, sorted highest first.
  • Look command pointing the player in the direction of a shop.


  • Java 6+
  • A permissions plugin.
  • ChestShop 3.5+


  • MySQL
  • iConomy, in MySQL mode, for balance check in the sell command.


  • Add the ChestShopFinder.jar to your server.
  • Start server
  • Add CSF's permissions to your permission handler.
  • Create/open ChestShops to register them.
  • Enjoy


  • /csf: Menu
  • /csf buy: Show nearby shops selling a item.
  • /csf sell: Show nearby shops buying an item.
  • /csf search: Show nearby shops trading an item.
  • /csf look: Point player in the direction of a shop.
  • /csf reload: Reload the plugin.
  • /csf version: Get the version running.
  • /csf arbitrage: Tells you if a shop is selling cheaper than another who's buying it.
  • /csf transactions: Gives various stats based on past transactions.


  • csf.user: General user commands.
    • csf.look
    • csf.sell
    • csf.arbitrage
    • csf.transactions.*
      • csf.transactions.mine
      • csf.transactions.owner
      • csf.transactions.client
      • csf.transactions.item
      • csf.transactions.overview
  • csf.admin
    • csf.version
    • csf.reload


  • properties
    • chat-prefix: Chat prefix
    • db-type: sqlite or mysql.
    • permission-default: Default permission access, set to 'false' if you don't want ops access.
    • check-new-version: Check if there's a new version on startup.
    • use-metrics: Send anonymous statistics to, so your server's counted in the server/player graph above.
    • debug-messages: Show debug messages in console.
    • auto-register: Auto register chests upon creation/chest opening/transaction. (no other way to register atm)
    • price-rounding: Decimal places to round prices.
    • verify-chunk-shops: Check chunks for phantom shops, in case any were destroyed while the plugin was off.
    • search-results: Number of queries to show the player.
    • one-owner-per-results: Limit owner to one result per query, so one owner can't monopolize the results.
    • admin-shop: Name of your admin shop account, we skip supply/balance check.
    • exclude-full-chests-from-sell: Try to exclude full shops from sell command.
    • show-nicknames: If a shop owner's online, show their nickname instead of their account name.
    • hopper-detection: Update shop stock amounts when hoppers interact with them.
    • log-transactions: Log transactions to DB.
    • white-space-results: Add whitespaces to result lists so they look more even.
    • transaction-age-include: How old, in seconds, to include transactions in our transaction commands.
  • mysql: General MySQL info.
    • iConomy_table: Your iConomy table, set to false if unused.



This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to

  • A unique identifier
  • The server's version of Java
  • Whether the server is in offline or online mode
  • The plugin's version
  • The server's version
  • The OS version/name and architecture
  • The core count for the CPU
  • The number of players online
  • The Metrics version

Read more here. This functionality can be disabled in the NPR config file.


  • Localize strings.

Source code available here.
Bitcoin donate.

Have an issue or suggestion? Post a ticket.

About This Project



Recent Files