Skip to content
This repository has been archived by the owner on Sep 29, 2024. It is now read-only.
/ findshop Public archive

A SC3 chatbox service to find ShopSync compatible shops

License

Notifications You must be signed in to change notification settings

Erb3/findshop

Important

With the shutdown of SwitchCraft3, FindShop has been archived.

FindShop

Powerful SwitchCraft service to find shops and items!

GitHub top language GitHub Repo stars GitHub contributors GitHub Created At


FindShop is a SwitchCraft service providing an easy way to search for compatible shops implementing the ShopSync protocol. Valid command aliases are \fs or \findshop.

FAQ

Why are shops or items missing?

There are a few reasons why your search results may not be what you expected, such as the following.

The search term may be too specific or misspelled

FindShop matches results based on exact matches to an item name (display name and item id). So, for example, if you were searching for slime blocks (minecraft:slime_block):

  • slime would be matched to both the display name ("Slime Block") and the item ID (minecraft:slime_block)
  • slime_block would be matched to the item ID (minecraft:slime_block) between "slime" and "block" and the item ID replaces this space with an
  • slimeblock would return NOTHING because the display name has a space in underscore.

FindShop doesn't have the shop

FindShop fetches shop information, including location, pricing & stock, from shops implementing the ShopSync standard. Shops might not appear if:

  • their software doesn't support ShopSync
  • their software implemented ShopSync incorrectly
  • their shop hasn't been configured to use ShopSync
  • their shop hasn't been loaded recently

What softwares support ShopSync?

Note

If there are others, feel free to submit a PR.

Software Version ShopSync Standard (in latest version) Note
Kristify >=1.3.0 1.1 Earlier versions may use an older ShopSync standard
Radon >=1.3.30 1.1 Most common shop software

Subcommands

Buy

\fs buy <item>

Finds shops with <item> and returns the shop name, location, item price & quantity in stock. The buy keyword is optional: if no subcommand is specified, buy is inferred.

Sell

\fs sell <item>

Finds shops buying <item> and returns the shop name, location and item price.

Shop Details

\fs shop <name> [page]

Finds shops with <name> and returns the owner, location, and other statistics. If multiple results are found, a list of results with page numbers will be shown.

Stats

\fs stats

Returns some statistics.

List

\fs list [page]

Lists all available shops.

Deployment

You must use a reverse-proxy like NginX or Casket to rate-limit, log and protect the API. The IP of the user must be set to the X-Forwarded-For header. The proxy must not accept any pre-existing value in the header, and should always overwrite it.

Contributing

FindShop is developed using the Bun toolkit and runtime.

About

A SC3 chatbox service to find ShopSync compatible shops

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published