SkullShop 🎭

A Paper plugin for buying player heads with multiple economy options — GUI-driven, lightweight, and fully customizable.

一款支持多种经济系统的 Paper 玩家头颅商店插件 — GUI 交互、轻量级、完全可定制。

Features / 功能

Requirements / 环境要求

Installation / 安装

1. Download SkullShop-1.0.0.jar from Releases. 从 Releases 下载最新版本。
2. Place it in your server's plugins/ folder. 放入服务器的 plugins/ 文件夹。
3. Restart the server (or run /reload confirm). 重启服务器（或执行 /reload confirm）。
4. Edit plugins/SkullShop/config.yml to configure prices and currencies. 编辑 plugins/SkullShop/config.yml 配置价格和货币。

Commands / 命令

All commands use /hs (alias: /skullshop). 所有命令使用 /hs（别名：/skullshop）。

Player Commands / 玩家命令 — skullshop.use

Admin Commands / 管理员命令 — skullshop.admin

Permissions / 权限

Economy Systems / 经济系统

1. Vault (金币)

Uses the server's Vault-compatible economy plugin (e.g., EssentialsX). Players pay in-game coins.

economy:
  vault:
    enabled: true
    price: 100.0
    display_name: "金币"

2. PlayerPoints (点券)

Uses the PlayerPoints plugin. Players pay with points.

economy:
  player_points:
    enabled: false
    price: 150
    display_name: "点券"

3. Custom Item (物品货币)

Any NBT item can serve as currency. Hold the item and run /hs setitem to configure. All NBT tags are recorded for exact matching.

economy:
  item:
    enabled: false
    price: 1
    display_name: "货币物品"
    reference_item: {}  # Set automatically by /hs setitem

Configuration / 配置

Config file: plugins/SkullShop/config.yml

# Whether players can buy other players' heads
allow_other_players: true

# Language: "zh" for Chinese, "en" for English
language: "zh"

# Economy systems — each independently toggleable
economy:
  vault:
    enabled: true
    price: 100.0
    display_name: "金币"
  player_points:
    enabled: false
    price: 150
    display_name: "点券"
  item:
    enabled: false
    price: 1
    display_name: "货币物品"
    reference_item: {}

Adding a New Language / 添加新语言

1. Copy plugins/SkullShop/messages_en.yml to messages_<lang>.yml
2. Translate all values (keep the YAML keys and & color codes)
3. Set language: "<lang>" in config.yml
4. Run /hs reload

GUI Preview / GUI 预览

┌──────────────────────────────┐
│    Select Payment Method      │
│                              │
│   [Player Head Preview]       │
│                              │
│  [💰 Vault]   Price: 100     │
│  [💎 Points]  Price: 150     │
│  [📦 Item]    Price: 1       │
│                              │
└──────────────────────────────┘

┌──────────────────────────────┐
│    Buy <Player>'s Head       │
│                              │
│   [Player Head Preview]       │
│                              │
│  [x1]  Total: 100  Balance   │
│  [x8]  Total: 800  Balance   │
│  [x64] Total: 6400 Balance   │
│                              │
│        [← Back]              │
└──────────────────────────────┘

FAQ / 常见问题

Q: Can players buy heads of offline players? A: Yes! The plugin uses Mojang API as fallback for players who have never joined the server.

Q: 能购买离线玩家的头颅吗？ A: 可以！插件会通过 Mojang API 异步获取从未上过线的玩家皮肤。

Q: How do I add more languages? A: Copy messages_en.yml, rename to messages_<lang>.yml, translate, and set language in config.

Q: 如何添加更多语言？ A: 复制 messages_en.yml，重命名为 messages_<语言>.yml，翻译后在配置中修改 language。

Q: Does it work on Spigot/Bukkit? A: It's built for Paper 1.20.6+. May work on Spigot but is untested.

Q: 支持 Spigot/Bukkit 吗？ A: 基于 Paper 1.20.6+ 构建，可能兼容 Spigot 但未测试。

Links / 链接

• Source Code / 源码: GitHub
• Issues / 问题反馈: GitHub Issues
• Releases / 下载: GitHub Releases

License / 许可证

MIT License — see LICENSE for details. 详见 LICENSE。