MyShop

MyShop — A server-authoritative shop system for Minecraft 1.20.1 Forge

One shop terminal for the admin shop, recycling, player market, warehouse, limits, VIP discounts and a weighted lottery.

FEATURES

Admin shop

• Categories and an item grid, 45 items per page.
• Live search by display name, item id or mod name.
• Five sort modes and a mod filter.
• +1 / +10 / +100 purchase buttons; the server validates price, limits and inventory space.

Item recycling

• Click an inventory stack, choose an amount, and receive the configured currency.
• Items that cannot be recycled are marked; the currency item itself cannot be recycled.

Daily and weekly limits

• Per-entry limits counted in individual items; 0 means unlimited.
• Reset at local midnight and on Monday (ISO week).

VIP discounts

• Vanilla scoreboard teams act as permission groups.
• 0–100% discount per team, applied to admin-shop purchases only.
• The discounted price never drops below the recycle value.

Player market

• List one inventory stack for a total price; listing fee and sale tax are destroyed by the server.
• Up to 16 active listings per player; offline sellers receive payment when they return.
• Buyer inventory space is checked before a sale; listings require the actual items in the seller's inventory.

Private warehouse

• Opened from the terminal and stored per player UUID.
• Dynamic capacity, 999 items per slot, grouped by mod.
• Stack/single deposit, withdrawal and deposit-all.

Weighted lottery

• Single pull and ten-pull, independent rolls, no pity system.
• Prize pool, weights and cost are configured by operators; the server rolls and grants prizes.
• Prizes drop at the player's feet if the inventory is full.

In-game editor

• Run /myshop edit to unlock and open it (permission level 2).
• Four pages: Items / Discounts & VIP / Lottery / Fees.
• Every action is saved immediately.
• Global item picker: search every registered item and add it to the admin shop without owning it. Player market listings remain inventory-only.

SERVER-AUTHORITATIVE

• The client only sends intents. Prices, limits, discounts, inventory space and item delivery are checked on the server.

REQUIREMENTS

• Minecraft 1.20.1
• Forge 47.x (built against 47.4.22)
• Java 17

INSTALLATION

• Put myshop-0.7.0.jar into the server's mods folder.
• Put the same jar into every player's mods folder.
• The server and all clients must use the same jar. Network protocol: 6.

LICENSE

• MIT.

MyShop —— Minecraft 1.20.1 Forge 服务端权威商店系统

一个商店终端，包含：

• 管理商店：分类、搜索、排序、模组筛选、+1/+10/+100 购买
• 物品回收：背包物品按配置价格换成货币
• 玩家市场：玩家挂单、上架费、成交税、离线货款
• 私有仓库：按玩家存储，整组/单个存取
• 每日/每周限购、计分板队伍 VIP 折扣
• 加权抽奖：单抽/十连，无保底
• 游戏内编辑器：商品、折扣、抽奖、费用，支持全局物品添加

服务端和客户端都必须安装同一个 jar（网络协议 6）。

环境：Minecraft 1.20.1 / Forge 47.x / Java 17
安装：把 myshop-0.7.0.jar 放进服务端和每个客户端的 mods 文件夹。
许可证：MIT