P_AutoVender

# P_AutoVender — Automatic Selling for Spigot/Paper A **fully automatic selling** plugin with bonus goals, sales tournament, permission-based VIP bonuses, multi-language menus and messages. Supports **PlaceholderAPI**, configurable ranking, and database integration. --- ## 🚀 Installation 1. Place the jar inside `plugins/` (Spigot/Paper 1.8–1.20+). 2. Start the server to generate configs. 3. Edit `config.yml`, `messages.yml`, and optionally `goals.yml`, `torneio.yml`, `menu.yml`, `database.yml`. 4. Restart or use `/autovender reload`. --- ## ⚡ Commands & Permissions | Command | Description | Permission | Aliases | |-----------------------------|----------------------------------------------|--------------------------------------|-------------------------------| | `/autovender` | Opens the main menu | `autovender.menu` | `/av`, `/sell`, `/vender` | | `/autovender sell` | Sells item in hand or all items | `autovender.sell`, `autovender.sellall` | `sell`, `s` | | `/autovender enable` | Turns auto-sell on | `autovender.autosell` | `on`, `enable` | | `/autovender disable` | Turns auto-sell off | `autovender.autosell` | `off`, `disable` | | `/autovender menu` | Opens the configuration menu | `autovender.menu` | `m`, `gui` | | `/autovender top` | Shows Top 3 in chat | — | `ranking`, `leaderboard` | | `/autovender topsellers` | GUI with Top Sellers | `autovender.topjogadores` | — | | `/autovender bonusstatus` | Shows goal/bonus status | `autovender.bonusstatus` | `status`, `bonus` | | `/autovender claim` | Claims tournament rewards | `autovender.rewards` | — | | `/autovender reload` | Reloads configs | `autovender.reload` | `reload`, `r` | | `/autovender resetbonus` | Resets global progress/goals | `autovender.resetbonus` | `reset` | --- <details> <summary>🔑 Extra Permissions</summary> - `autovender.sell.nodelay` → Removes delay between manual sales - `bonus.vip`, `bonus.vip2`, … → Grants additional bonuses (configured in `config.yml`) - `autovender.top1`, `autovender.top2`, `autovender.top3` → Special tags for top sellers </details> --- ## ⚙️ Configuration Files - **config.yml** — sellable items, prices, language, VIP bonuses, Top1..Top10 tags - **messages.yml** — multi-language messages (Pt_br, En_us) - **goals.yml** — global sales goals with bonuses (% and duration) - **torneio.yml** — sales tournament and rewards - **menu.yml** — menu structure - **database.yml** — MySQL or SQLite - **commands.yml** — command aliases --- ## 🌟 Main Features - Manual selling (`/autovender sell`) or automatic selling - Global goals with temporary bonuses - Sales tournament with configurable rewards - Top seller ranking (chat + GUI) - Permission-based (VIP) bonus - Fully configurable menus - Public API for integration (`AutoVenderAPI`) - **PlaceholderAPI** support - MySQL/SQLite support --- <details> <summary>📊 Placeholders (PlaceholderAPI)</summary> ### 🔧 Status - `%autovender_auto_sell_status%` → Enabled/Disabled - `%autovender_sell_all_status%` → Sell-all on/off - `%autovender_title_status%`, `%autovender_actionbar_status%`, `%autovender_chat_status%` → Notification modes on/off ### 👤 Player - `%autovender_tag%` → Current tag (e.g., ``) - `%autovender_position%` → Ranking position - `%autovender_player_sales%` → Player total sales ### 🌍 Server - `%autovender_server_sales%` → Server total sales - `%autovender_bonus_percentage%` → Active global bonus - `%autovender_next_goal%` → Next goal or "All goals achieved" - `%autovender_goal_progress%` → Progress (%) - `%autovender_remaining_sales%` → Remaining to next goal ### 🏆 Ranking - `%autovender_top1_player%`, `%autovender_top1_amount%` - `%autovender_top2_player%`, `%autovender_top2_amount%` - `%autovender_top3_player%`, `%autovender_top3_amount%` - `%autovender_top1_prefix%`, `%autovender_top2_prefix%`, `%autovender_top3_prefix%` ### 🛠️ Items - `%autovender_item_name_<MATERIAL>%` → Configured item name - Example: `%autovender_item_name_DIAMOND%` → "Diamond" </details> --- ## 👨‍💻 Credits Developed by **Pedro** — advanced support for Minecraft servers. # P_AutoVender — Venda automática para Spigot/Paper