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