iteshop
管理员商店 + 玩家拍卖行 + 安全的玩家间交易 — 一个服务端插件,无需依赖项,强化防物品复制。
? /shop — 服务器商店(分类、经验值或货币)
一个按分类组织的商店(图标选择菜单)。对于每种物品,管理员可选择其货币类型:经验等级或货币(Vault)。
- 可在
config.yml 中配置,也可完全在游戏中设置。
- 分类图标可以是特殊物品(自定义模型数据、指定类型的药水、发光效果等)—— 将你想用作图标的物品拿在手中,执行
/shop admin icon 即可设置。
- 反漏洞黑名单:可再生经验的物品不能用于兑换经验,从而避免无限刷取货币的漏洞。
? /ah · /hdv — 玩家拍卖行
玩家可以上架自己的物品,并选择希望获得的报酬方式:经验等级、货币(Vault)、其他物品(例如以钻石支付),或免费赠送。
- 引导式售卖:
/ah sell 显示可点击的聊天按钮,Tab 键在每一步都提供建议值——无需记忆语法。
- 内置搜索、排序和筛选功能:支持按名称搜索(
/ah search <word>)、排序(最新、价格 ↑/↓、名称)以及按支付方式筛选。所有选项均可见;当前激活项以绿色高亮显示。
- 每个商品列表显示卖家、颜色编码的价格、商品上架时间,以及一个 ✔ / ✘ 指示器,告知你是否买得起该物品。
- 离线卖家的收益将在重新连接时发放(资金即时到账)。
? /trade — 安全的玩家交易
/trade <player> 会在聊天中发送一个可点击的请求。一旦接受,双方将打开一个交易窗口。
- 拖放物品到你的区域,就像使用合成台一样。
- 顶部的羊毛指示器:左侧的(你的)是你的确认按钮,右侧的(对方的)显示对方是否已确认——红色表示未准备好,绿色表示已准备好。
- 数量选择器:Shift+点击一组物品以精确选择放入的数量(
-32 / -8 / -1 / +1 / +8 / +32、单个、全部)。
- 当双方都确认后,将开始5秒倒计时——可随时取消。更改报价会重置双方的确认状态(防骗机制)。
/trade settings — 自动拒绝交易请求,或仅接受来自白名单的玩家(/trade allow / /trade disallow)。
/trade watch <player> (管理员) — 实时旁观某笔交易,或回放上一笔交易的内容(谁给出了什么)。
? 多语言支持
默认使用英文,并包含法语。每位玩家都可以选择自己的语言(/iteshop language fr),而管理员可以设置服务器默认语言(/iteshop language default <code>)。通过放入 lang/<code>.yml 文件即可添加自定义语言——任何缺失的键都会回退到英文。
? 防复制强化
这是开发过程中的一项硬性要求:
- 购买和下架操作是幂等的——快速双击不会导致重复购买或退款。
- 交易采用严格的托管模型:物品要么在你的背包中,要么在交易中,绝不会同时存在。每件物品都只会被返还或交换一次——包括关闭菜单、取消、断开连接或服务器关闭时。
- 所有菜单点击和拖拽都在服务端进行验证;锁定区域会拒绝Shift点击、拖拽、双击拾取以及创造模式下的鼠标中键点击。
? 兼容性
- Paper(或其分支)26.x 分支(26.1 / 26.2),运行于 Java 25。
- Vault 是可选的——没有它,经验值(XP)/ 物品 / 免费模式仍然可用;仅禁用金钱选项。
⌨️ 命令
| 命令 |
权限角色 |
/shop |
打开服务器商店(分类) |
/shop admin add <category> <xp\|money> <price> |
(OP) 添加手中持有的物品 |
/shop admin icon <category> [MATERIAL] |
(OP) 设置分类图标 |
/shop admin delete <category> <number> |
(OP) 移除一个物品 |
/shop admin list · reload |
(OP) 列出物品 / 重载配置 |
/ah · /hdv |
浏览和购买挂牌 |
/ah search <word> |
按名称搜索挂牌 |
/ah sell |
出售手中持有的物品(引导式) |
/ah sell myshop · collect |
管理挂牌 / 收取收益 |
/ah admin |
(OP) 审核所有挂牌 |
/trade <player> |
发送交易请求 |
/trade settings |
交易隐私设置 |
/trade watch <player> |
(OP) 观战 / 回放交易 |
/iteshop language |
更改语言(你的语言,或服务器默认语言) |
? 权限节点
| 节点 |
默认权限 |
授予功能 |
shop.use |
所有人 |
打开 /shop |
shop.admin |
OP |
管理管理员商店 |
playershop.use |
所有人 |
浏览 / 购买 |
playershop.sell |
所有人 |
创建挂牌 |
playershop.admin |
OP |
审核挂牌 |
trade.use |
所有人 |
与其他玩家交易 |
trade.admin |
OP |
观战 / 回放交易 |
iteshop.admin |
OP |
服务器语言设置、重载配置 |
MIT 许可证 — © 2026 Bicode_DEV.
iteshop
Admin shop + player auction house + secure player-to-player trading — one
server-side plugin, no required dependency, hardened against item duplication.
? /shop — server shop (categories, XP or money)
A shop organised into categories (icon selection menu). For each item the
admin picks the currency: XP levels or money (Vault).
- Configure it in
config.yml, or entirely in game.
- Category icons can be special items (custom model data, typed potions,
glowing) — set one with the item in your hand via
/shop admin icon.
- Anti-exploit blacklist: items that regenerate XP can't be sold for XP,
so there's no infinite currency loop.
? /ah · /hdv — player auction house
Players list their own items and choose how they want to be paid:
XP levels, money (Vault), another item (e.g. pay in diamonds), or
free.
- Guided selling:
/ah sell shows clickable chat buttons, and Tab suggests
values at every step — no syntax to memorise.
- Search, sort and filter built into the menu: search by name
(
/ah search <word>), sort (newest, price ↑/↓, name) and filter by payment
type. Every option stays visible; the active one is highlighted in green.
- Each listing shows the seller, a colour-coded price, its age, and a
✔ / ✘ indicator telling you whether you can afford it.
- Offline sellers receive their earnings on reconnect (money is paid instantly).
? /trade — secure player trading
/trade <player> sends a clickable request in chat. Once accepted, a trade
window opens for both players.
- Drag and drop your items into your side, just like a crafting table.
- Wool indicators at the top: yours (left) is your confirm button, the
partner's (right) shows whether they confirmed — red means not ready, green
means ready.
- Quantity picker: shift-click a stack to choose exactly how many to put in
(
-32 / -8 / -1 / +1 / +8 / +32, one, all).
- When both players confirm, a 5-second countdown starts — cancellable
at any time. Changing an offer resets both confirmations (anti-scam).
/trade settings — auto-decline requests, or only accept players from your
whitelist (/trade allow / /trade disallow).
/trade watch <player> (admin) — spectate a trade live, or replay the last
one (who gave what).
? Multi-language
English by default, with French included. Every player can pick their
own language (/iteshop language fr), while admins set the server default
(/iteshop language default <code>). Add your own by dropping a
lang/<code>.yml file — any missing key falls back to English.
? Duplication-hardened
This was a hard requirement throughout development:
- Purchases and listing removals are idempotent — a fast double-click can't
buy or refund twice.
- Trading uses a strict escrow model: an item is either in your inventory
or in the trade, never both. Every item is returned or exchanged
exactly once — including on menu close, cancel, disconnect, or server
shutdown.
- All menu clicks and drags are validated server-side; locked areas reject
shift-clicks, drags, double-click collect and creative middle-click.
? Compatibility
- Paper (or forks) branch 26.x (26.1 / 26.2), running on Java 25.
- Vault is optional — without it, XP / item / free modes still work; only
the money option is disabled.
⌨️ Commands
| Command |
Role |
/shop |
Open the server shop (categories) |
/shop admin add <category> <xp\|money> <price> |
(OP) add the held item |
/shop admin icon <category> [MATERIAL] |
(OP) set a category icon |
/shop admin delete <category> <number> |
(OP) remove an item |
/shop admin list · reload |
(OP) list items / reload config |
/ah · /hdv |
Browse and buy listings |
/ah search <word> |
Search listings by name |
/ah sell |
Sell the held item (guided) |
/ah sell myshop · collect |
Manage listings / collect earnings |
/ah admin |
(OP) moderate every listing |
/trade <player> |
Send a trade request |
/trade settings |
Trade privacy settings |
/trade watch <player> |
(OP) spectate / replay a trade |
/iteshop language |
Change language (yours, or the server default) |
? Permissions
| Node |
Default |
Grants |
shop.use |
everyone |
open /shop |
shop.admin |
OP |
manage the admin shop |
playershop.use |
everyone |
browse / buy |
playershop.sell |
everyone |
create listings |
playershop.admin |
OP |
moderate listings |
trade.use |
everyone |
trade with other players |
trade.admin |
OP |
spectate / replay trades |
iteshop.admin |
OP |
server language, reload |
MIT licence — © 2026 Bicode_DEV.
评论 0
登录后参与评分
还没有评论,来抢沙发吧