# 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., `[Top1]`) - `%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 Plugin de **venda automática** com metas de bônus, torneio de vendas, VIP-bonus por permissão, menus e mensagens multi-idioma. Suporte a **PlaceholderAPI**, ranking configurável e integração com bancos de dados. --- ## 🚀 Instalação 1. Coloque o jar em `plugins/` (Spigot/Paper 1.8–1.20+). 2. Inicie o servidor para gerar configs. 3. Edite `config.yml`, `messages.yml` e (opcional) `goals.yml`, `torneio.yml`, `menu.yml`, `database.yml`. 4. Reinicie ou use `/autovender recarregar`. --- ## ⚡ Comandos & Permissões | Comando | Descrição | Permissão | Aliases | |-----------------------------|------------------------------------|----------------------------------|------------------------------| | `/autovender` | Abre menu principal | `autovender.menu` | `/av`, `/vender`, `/sell` | | `/autovender vender` | Vende item na mão ou todos itens | `autovender.sell`, `autovender.sellall` | `sell`, `s` | | `/autovender ativar` | Liga auto-venda | `autovender.autosell` | `on`, `enable` | | `/autovender desativar` | Desliga auto-venda | `autovender.autosell` | `off`, `disable` | | `/autovender menu` | Abre menu de configurações | `autovender.menu` | `m`, `gui` | | `/autovender top` | Mostra Top 3 no chat | — | `ranking`, `leaderboard` | | `/autovender topjogadores` | GUI de Top Vendedores | `autovender.topjogadores` | — | | `/autovender bonusstatus` | Status de metas/bônus | `autovender.bonusstatus` | `status`, `bonus` | | `/autovender reivindicar` | Recompensas do torneio | `autovender.rewards` | — | | `/autovender recarregar` | Recarrega configs | `autovender.reload` | `reload`, `r` | | `/autovender resetbonus` | Reseta progresso/metas globais | `autovender.resetbonus` | `reset` | --- <details> <summary>🔑 Permissões Extras</summary> - `autovender.sell.nodelay` → Remove delay entre vendas manuais - `bonus.vip`, `bonus.vip2`, … → Concede bônus adicionais (config. no `config.yml`) - `autovender.top1`, `autovender.top2`, `autovender.top3` → Tags especiais para top vendedores </details> --- ## ⚙️ Arquivos de Configuração - **config.yml** — itens vendáveis, preços, idioma, VIP-bonus, tags Top1..Top10 - **messages.yml** — mensagens multi-idioma (Pt_br, En_us) - **goals.yml** — metas globais de vendas com bônus (% e duração) - **torneio.yml** — torneio de vendas e recompensas - **menu.yml** — estrutura do menu - **database.yml** — MySQL ou SQLite - **commands.yml** — aliases de comandos --- ## 🌟 Recursos Principais - Venda manual (`/autovender vender`) ou automática - Metas globais com bônus temporário - Torneio de vendas com recompensas configuráveis - Ranking de top vendedores (chat + GUI) - Bônus por permissão (VIP) - Menus configuráveis - API pública para integração (`AutoVenderAPI`) - Integração com **PlaceholderAPI** - Suporte a MySQL/SQLite --- <details> <summary>📊 Placeholders (PlaceholderAPI)</summary> ### 🔧 Status - `%autovender_auto_sell_status%` → Ativado/Desativado - `%autovender_sell_all_status%` → Venda total on/off - `%autovender_title_status%`, `%autovender_actionbar_status%`, `%autovender_chat_status%` → Notificações on/off ### 👤 Jogador - `%autovender_tag%` → Tag atual (ex.: `[Top1]`) - `%autovender_position%` → Posição no ranking - `%autovender_player_sales%` → Total de vendas do jogador ### 🌍 Servidor - `%autovender_server_sales%` → Total de vendas do servidor - `%autovender_bonus_percentage%` → Bônus global ativo - `%autovender_next_goal%` → Próxima meta ou "Todas metas atingidas" - `%autovender_goal_progress%` → Progresso (%) - `%autovender_remaining_sales%` → Restante para próxima meta ### 🏆 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%` ### 🛠️ Itens - `%autovender_item_name_<MATERIAL>%` → Nome configurado do item (ex.: `%autovender_item_name_DIAMOND%` → "Diamante") </details> --- ## 👨‍💻 Créditos Desenvolvido por **Pedro** — suporte avançado a servidores Minecraft.