MCLabs Staff Docs

    🛒 Player Shop Management

    Root commands: /arm, /displayshops, /shopadmin
    Worlds: Spawn
    Access Level: Admin

    Introduction

    Player Shops rely on three main plugins to operate:

    1. Advanced Region Market: Works with regions to create shops and offer ownership/renting
    2. Display Shops: Provides shop slabs for selling items
    3. Shop Admin: A custom plugin to make administrating player shops easier

    Advanced Region Market

    Advanced Region Market, or ARM, provides all of the necessary tools to actually create player shops on the server.

    Creating New Player Shop Regions

    To create a new player shop, first make a selection using WorldEdit. This can be done a variety of ways, the easiest being with a FAWE wand (/wand). For more information on making a selection, see the WorldEdit Wiki Page on Selections.

    Next, turn the selection into a region with /region define <some region name>. This should create a new region with WorldGuard. For more information on regions, see the WorldGuard Wiki Page on Regions.

    Next up, we can begin registering the shop with ARM. The easiest way to do this is with sign linking mode, which automatically creates shops using a preset. Since player shops are rent-based, we have a pre-defined rent preset called "shops" that has all of the correct configurations. Load this preset with the command:
    /arm rentpreset load shops

    Then, enter sign linking mode:
    /arm signlinkmode rentregion

    Following this, left click any block in the region you defined earlier, and then right click on a sign. This should register the region within ARM and auto-fill the sign with all of the information. The sign can then be used by players to rent the regions.

    Making A New Player Shop Sign

    Say, for instance, that you accidentally broke a player shop sign. No biggie! Adding the sign back is extremely similar to the above section (🛒 Player Shop Management > Creating New Player Shop Regions), except that the region should already be defined.

    Start by loading the present (even though it already exists with the shop):
    /arm rentpreset load shops

    Then, enter sign linking mode:
    /arm signlinkmode rentregion

    Following this, left click any block in the region you defined earlier, and then right click on a sign. This should update the new sign to display information and be usable by players.

    Setting The Owner Of A Player Shop

    Setting the owner of a player shop is extremely simple. Just use the command:
    /arm setowner <shop number> <player name>

    Display Shops

    When players rent shops that still have shop slabs from a previous owner, you will need to change ownership of each shop slab. To do this, simply look at the shop slab and use the command:
    /displayshops owner <newowner>

    Shop Admin

    We have a custom system, referred to as Shop Admin, for checking player shops for rule compliance. Use the following commands to help you as you check player shops. For more information on how to properly check player shops, see 🛒 Checking Player Shops.

    Shop Admin View: /sa

    The Shop Admin View gives you an overlook over all player shops. It is displayed as a map of the standings of each player shop. While in the Shop Admin View, you can do three main actions:

    • Hover over a player shop to view the player shop's owner and any outstanding warnings they have
    • Left Click on a player shop to teleport to it
    • Right Click on a player shop to send a notice to the shop owner

    Shop Patrol: /sa check

    The shop patrol command assists you as you check through shops. This works very similar to /cmi patrol, except instead of teleporting you through players, it teleports you through the player shops. To teleport to the next shop to check, use the command:
    /sa check

    Shop Raffle: /sa raffle

    The shop raffle commands helps you when you need to raffle off a player's shop. To raffle off a shop, use the command:
    /sa raffle <shopID> <time until draw in hours>

    To check the time remaining on a raffle, use the command:
    /sa raffleinfo <shopID>

    More Information

    For more information, please see the following resources:

    Advanced Region Market

    Plugin Wiki: https://github.com/alex9849/advanced-region-market/wiki
    Spigot Plugin Page: https://www.spigotmc.org/resources/advancedregionmarket.58732/
    GitHub Repo: https://github.com/alex9849/advanced-region-market
    Discord: https://discord.gg/v3HsVrf

    Display Shops

    Modrinth Plugin Page: https://modrinth.com/plugin/displayshops
    GitHub Repo: https://github.com/AureusDevelopment/DisplayShops
    Discord: https://discord.gg/PwcFv4tYX8