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