Here is a complete, professional overview of the plugin including requirements, features, and commands. You can copy and paste this directly onto your SpigotMC or BuiltByBit (McMarket) project page:
🏬 PlayerShopAFK Turn idle players into profitable, interactive market stalls! PlayerShopAFK is a professional-grade economy plugin that allows players to set up dynamic shops and sell items seamlessly while being away from their computers (AFK).
📌 Requirements Spigot / Paper (1.20+)
Vault (Requires a compatible economy plugin like EssentialsX, EconomyShopGUI, etc.)
✨ Key Features NBT & Lore Persistence: Absolutely zero data loss. Keeps 100% of custom names, enchants, descriptions, and custom model data.
Anti-Duplication Safeguard: Advanced menu listeners securely clear inventory slots during pricing to prevent all item duplication glitches.
Rank-Based GUI Scaling: Dynamic chest layout sizes (from 3 to 6 rows) based on LuckPerms/donor ranks.
Automated Server Tax: Fully configurable built-in taxation system to balance your economy and prevent server inflation.
Crash & Persistence Proof: Holograms utilize scoreboard tags, automatically cleaning up ghost entities on startup even after abrupt server crashes.
💻 Commands & Permissions Command Description Permission /shop edit Opens the graphical interface to add/remove items and set prices. Default access /shop open Activates the shop overhead hologram and enters AFK shop mode. Default access /shop close Manually deactivates the shop and breaks down the hologram. Default access 👑 Rank Limits Configuration Permissions: playershop.limit.default — Grants a 3-row inventory shop (27 slots).
playershop.limit.vip — Grants a 4-row inventory shop (36 slots).
playershop.limit.vip_plus — Grants a 5-row inventory shop (45 slots).
playershop.limit.admin — Grants a maximum 6-row inventory shop (54 slots).
⚙️ How it Works Run /shop edit, click an item from your inventory to securely move it into the shop, then type your desired price in the chat.
Position your character in the market space and execute /shop open My Awesome Store.
An immersive custom hologram will spawn over your head. As long as you remain stationary, other players can right-click you to browse and instantly buy your stock! Any movement or disconnection safely packs up your shop.
