English

surassyusell — GUI Sell Plugin

A lightweight yet powerful GUI-based item selling plugin for Paper/Spigot 1.20+. Sell any item with a single command. When items are placed into the sell GUI, their sell price is automatically displayed in the lore — no guessing required. The plugin automatically detects your server version and supports all items, with full admin control over pricing, currency display, sell blacklisting, and multi-language support.

✨ Features

📦 GUI Sell System

• Use /sell to open a clean, intuitive sell GUI.
• Drag and drop items into the top slots, then click the Sell button.
• A confirmation screen appears before any sale is finalized — no accidental sells!
• If you close the sell GUI with items still inside, the confirmation screen will automatically appear.
• Items placed in the sell GUI automatically display their sell price in the lore for easy reference.

🔊 Sound Effects

• A satisfying level-up chime plays when a sale is completed.
• A click sound plays when a sale is cancelled.
• A villager "no" sound plays when blacklisted items are blocked.

🔍 Price Lookup

• Use /sell <item> to check the sell price of any item — available to all players.
• Supports tab completion for item names.

💰 Configurable Prices (prices.yml)

• Every item in the game is automatically assigned a smart default price on first launch.
• Prices are fully customizable via prices.yml or with in-game commands.
• Rarity-based default pricing: Dragon Egg ($50,000), Elytra ($5,000), Nether Star ($10,000), Diamond ($100), common blocks $0.5–$1, and more.

⚡ Version Auto-Detection

• Automatically detects your server's Minecraft version.
• New items added in updates are auto-detected and added to prices.yml on reload — zero manual work.
• Works seamlessly across 1.20.x, 1.21.x, and beyond.

💲 Full Currency Customization

• Customize the currency symbol ($, ¥, €, £, or any custom symbol).
• Customize the currency name (ᴅᴏʟʟᴀʀꜱ, dollars, coins, 円, etc.).
• Choose symbol position: left ($100) or right (100$).
• All configurable via config.yml or live commands.

🚫 Sell Blacklist

• Block specific items from being sold by adding them to the blacklist.
• Manage via config.yml or in-game commands: /selladmin blacklist add/remove/list.
• Blacklisted items placed in the sell GUI are automatically returned to the player with a warning sound.
• Sellable items in the same transaction still proceed normally.
• Full tab completion support (add shows available items, remove shows only blacklisted items).

🏷️ Smart Price Display

• Items inside the sell GUI automatically show their sell price in the lore.
• Price lore is never added to items in the player's inventory — this completely prevents item stacking issues.
• Can be toggled on/off via show-price-in-sell-gui in config.yml.

✏️ Customizable Prefix

• The chat message prefix features a beautiful purple → cyan → blue gradient by default.
• Fully customizable via config.yml or /selladmin prefix <text>.
• Supports Minecraft color codes (&0–&f, &l, &o, etc.).
• Set to empty ("") to disable the prefix entirely.

🌐 Multi-Language Support

• Built-in support for English (en_US) and Japanese (ja_JP).
• Change live with /selladmin setlang <locale>.
• All messages are stored in editable YAML files under messages/ — easily add your own translations!

🛡️ Granular Permissions

• Every command has its own permission node for fine-grained access control.
• Admin permissions use a parent-child hierarchy — grant surassyusell.admin to enable all admin commands, or assign individual permissions.

🔒 Safe Transactions

• If the sell GUI is closed without confirming, a confirmation screen automatically appears — items are never silently lost.
• If the confirmation screen is also closed, all items are safely returned to the player.
• If inventory is full, items are dropped at the player's feet — nothing is ever lost.
• Formatted currency display with K/M suffixes for large amounts.

ℹ️ Plugin Info

• /surassyusell creator — View creator information (bilingual EN/JP).
• /surassyusell support — View support contact info (bilingual EN/JP).

📋 Commands

Player Commands

Command	Permission	Description
/sell	surassyusell.sell	Opens the sell GUI
/sell <item>	surassyusell.sell.check	Check the sell price of any item
/surassyusell creator	—	View creator info
/surassyusell support	—	View support contact

Admin Commands

Command	Permission	Description
/selladmin reload	surassyusell.admin.reload	Reloads all configuration files
/selladmin setlang <locale>	surassyusell.admin.setlang	Changes the plugin language
/selladmin all <price>	surassyusell.admin.setprice	Sets ALL item prices to one value
/selladmin setprice <item> <price>	surassyusell.admin.setprice	Sets a specific item's price
/selladmin reset	surassyusell.admin.reset	Resets all prices to defaults
/selladmin currency <symbol>	surassyusell.admin.currency	Changes the currency symbol
/selladmin currencypos <left|right>	surassyusell.admin.currency	Changes currency symbol position
/selladmin currencyname <name>	surassyusell.admin.currency	Changes the currency name
/selladmin prefix <text>	surassyusell.admin	Changes the chat message prefix
/selladmin blacklist add <item>	surassyusell.admin.blacklist	Add an item to the sell blacklist
/selladmin blacklist remove <item>	surassyusell.admin.blacklist	Remove an item from the blacklist
/selladmin blacklist list	surassyusell.admin.blacklist	View all blacklisted items

All commands include tab completion.

🔑 Permissions

Permission	Default	Description
surassyusell.sell	Everyone	Use /sell to open the sell GUI
surassyusell.sell.check	Everyone	Use /sell <item> to check prices
surassyusell.admin	OP	All admin commands (inherits all below)
surassyusell.admin.reload	OP	Reload configuration
surassyusell.admin.setlang	OP	Change language
surassyusell.admin.setprice	OP	Set item prices
surassyusell.admin.reset	OP	Reset prices to defaults
surassyusell.admin.currency	OP	Change currency settings
surassyusell.admin.blacklist	OP	Manage sell blacklist

📌 Dependencies

Plugin	Required
Vault	✅ Yes
Economy Plugin (e.g. EssentialsX)	✅ Yes

🔧 Compatibility

• Minecraft Version: 1.20+ (auto-adapts to server version)
• Server Software: Paper / Spigot
• Java Version: 17+

日本語

surassyusell — GUI売却プラグイン

Paper/Spigot 1.20+ 対応の軽量かつ高機能なGUIベースのアイテム売却プラグインです。 コマンド一つでアイテムを売却でき、売却GUIにアイテムを配置すると売却価格が自動表示されます。 サーバーバージョンのアイテムを自動サポートし、価格・通貨表示・ブラックリスト・多言語を完全にカスタマイズできます。

✨ 機能一覧

📦 GUI売却システム

• /sell コマンドで直感的な売却GUIを開きます。
• 上段スロットにアイテムをドラッグ＆ドロップし、売却ボタンをクリックするだけ。
• 確認画面が表示されるため、誤って売却してしまう心配はありません！
• 売却GUIにアイテムを入れたまま閉じても、自動的に確認画面が表示されます。
• 売却GUIに配置されたアイテムには売却価格が自動的にLore表示されます。

🔊 サウンドエフェクト

• 売却完了時にレベルアップ音が鳴ります。
• キャンセル時にクリック音が鳴ります。
• ブラックリストのアイテムがブロックされた時に村人の拒否音が鳴ります。

🔍 価格確認

• /sell <アイテム名> でアイテムの売却価格を確認できます — 誰でも使用可能。
• アイテム名のタブ補完に対応。

💰 価格設定ファイル (prices.yml)

• 初回起動時にゲーム内の全アイテムにスマートなデフォルト価格が自動設定されます。
• prices.yml の編集またはゲーム内コマンドで自由にカスタマイズ可能。
• レアリティに応じたデフォルト価格設定：ドラゴンの卵 ($50,000)、エリトラ ($5,000)、ネザースター ($10,000)、ダイヤモンド ($100)、一般ブロック $0.5〜$1 など。

⚡ バージョン自動検出

• サーバーのMinecraftバージョンを自動検出。
• アップデートで追加された新アイテムはリロード時に自動追加 — 手動設定不要。
• 1.20.x、1.21.x 以降のすべてのバージョンにシームレスに対応。

💲 通貨フルカスタマイズ

• 通貨記号を自由に設定（$、¥、€、£、その他任意の記号）。
• 通貨名称を自由に設定（ᴅᴏʟʟᴀʀꜱ、dollars、coins、円 など）。
• 記号の表示位置を選択: 左 ($100) または 右 (100$)。
• config.yml またはコマンドですべてリアルタイム変更可能。

🚫 売却ブラックリスト

• 特定のアイテムをブラックリストに追加して売却を禁止できます。
• config.yml またはゲーム内コマンドで管理: /selladmin blacklist add/remove/list。
• ブラックリストのアイテムは警告音と共に自動的にプレイヤーに返却されます。
• 同じ取引内の売却可能なアイテムは通常通り処理されます。
• タブ補完完全対応（addは全アイテム、removeはブラックリスト内のみ表示）。

🏷️ スマート価格表示

• 売却GUIの中にあるアイテムのみ、Loreに売却価格が自動表示されます。
• プレイヤーのインベントリ内のアイテムには一切Loreを追加しないため、アイテムのスタックが崩れる問題を完全に防止。
• config.yml の show-price-in-sell-gui でON/OFF切り替え可能。

✏️ カスタマイズ可能なプレフィックス

• デフォルトで紫 → 水色 → 青のグラデーションが適用された美しいプレフィックス。
• config.yml または /selladmin prefix <テキスト> で自由にカスタマイズ可能。
• Minecraftカラーコード対応（&0〜&f、&l、&o など）。
• 空文字（""）に設定するとプレフィックスを非表示にできます。

🌐 多言語対応

• 英語 (en_US) と 日本語 (ja_JP) をビルトインでサポート。
• /selladmin setlang <言語コード> でゲーム内から即変更。
• messages/ フォルダのYAMLファイルを編集・追加するだけで独自翻訳も簡単に対応！

🛡️ 細かい権限設定

• すべてのコマンドに個別の権限ノードを設定可能。
• 管理者権限は親子階層構造 — surassyusell.admin を付与すれば全管理コマンドが使えるほか、個別権限の割り当ても可能。

🔒 安全な取引システム

• 売却GUIをアイテムを入れたまま閉じても、自動的に確認画面が表示されます — アイテムが知らないうちに消えることはありません。
• 確認画面も閉じた場合は、すべてのアイテムがプレイヤーに返却されます。
• インベントリが満杯の場合はプレイヤーの足元にドロップ — アイテムが消えることはありません。
• 大きな金額は K/M 表記で見やすくフォーマットされます。

ℹ️ プラグイン情報

• /surassyusell creator — 制作者情報を表示（英語・日本語の両方で表示）。
• /surassyusell support — サポート連絡先を表示（英語・日本語の両方で表示）。

📋 コマンド

プレイヤーコマンド

コマンド	権限	説明
/sell	surassyusell.sell	売却GUIを開く
/sell <アイテム名>	surassyusell.sell.check	アイテムの売却価格を確認
/surassyusell creator	—	制作者情報を表示
/surassyusell support	—	サポート連絡先を表示

管理者コマンド

コマンド	権限	説明
/selladmin reload	surassyusell.admin.reload	全設定ファイルをリロード
/selladmin setlang <言語コード>	surassyusell.admin.setlang	プラグインの言語を変更
/selladmin all <価格>	surassyusell.admin.setprice	すべてのアイテム価格を一括設定
/selladmin setprice <アイテム> <価格>	surassyusell.admin.setprice	特定アイテムの価格を設定
/selladmin reset	surassyusell.admin.reset	全価格をデフォルトにリセット
/selladmin currency <記号>	surassyusell.admin.currency	通貨記号を変更
/selladmin currencypos <left|right>	surassyusell.admin.currency	通貨記号の表示位置を変更
/selladmin currencyname <名前>	surassyusell.admin.currency	通貨名を変更
/selladmin prefix <テキスト>	surassyusell.admin	チャットメッセージのプレフィックスを変更
/selladmin blacklist add <アイテム>	surassyusell.admin.blacklist	アイテムを売却ブラックリストに追加
/selladmin blacklist remove <アイテム>	surassyusell.admin.blacklist	アイテムをブラックリストから削除
/selladmin blacklist list	surassyusell.admin.blacklist	ブラックリスト一覧を表示

すべてのコマンドにタブ補完対応。

🔑 権限一覧

権限ノード	デフォルト	説明
surassyusell.sell	全員	/sell で売却GUIを開く
surassyusell.sell.check	全員	/sell <item> で価格確認
surassyusell.admin	OP	全管理コマンド（以下すべてを継承）
surassyusell.admin.reload	OP	設定リロード
surassyusell.admin.setlang	OP	言語変更
surassyusell.admin.setprice	OP	価格設定
surassyusell.admin.reset	OP	価格リセット
surassyusell.admin.currency	OP	通貨設定
surassyusell.admin.blacklist	OP	ブラックリスト管理

📌 前提プラグイン

プラグイン	必須
Vault	✅ 必須
経済プラグイン（例: EssentialsX）	✅ 必須

🔧 対応環境

• Minecraftバージョン: 1.20以上（サーバーバージョンに自動適応）
• サーバーソフトウェア: Paper / Spigot
• Javaバージョン: 17以上