surassyusell

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

Admin Commands

All commands include tab completion.

🔑 Permissions

📌 Dependencies

🔧 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 — サポート連絡先を表示（英語・日本語の両方で表示）。

📋 コマンド

プレイヤーコマンド

管理者コマンド

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

🔑 権限一覧

📌 前提プラグイン

🔧 対応環境

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