ItemSubmit

## Simple, lightweight item submission plugin for Paper servers. ItemSubmit lets you run server events where players submit a specific item (like Grass Blocks, Diamonds, or any material you choose) and automatically tracks totals, top contributors, and more.

• 📦 Players use /submit to hand in all configured items from their inventory
• 🏆 Tracks personal totals and server-wide totals
• 📊 Built-in top leaderboard placeholders (Top 1, Top 2, etc.)
• 🧩 PlaceholderAPI support included
• ⚡ Lightweight & optimized for performance (Paper 1. 21. 11 ready)
• 🔄 Open/close submission events instantly with commands
• 🛠️ Change the required item in-game with /itemsubmit set
• 💬 Perfect for server competitions, seasonal events, and donation systems
• 🧹 Clear player data or reset all submissions easily
• ⚙️ Clean and minimal configuration

## ⚙️ Config File

``` # Item that players are allowed to submit. # Use a valid Bukkit/Paper material name. item: GRASS_BLOCK

placeholders: enabled: true

# Formatted dynamic leaderboard placeholders: # %itemsubmit_formatted_1%, %itemsubmit_formatted_2%, etc. # Tokens you can use: %position%, %name%, %amount% formatted: format: 'Top %position% user: %name% with score %amount%' empty-format: '-' ``` ## 🛠️ Commands

• /submit — Submit all configured items from your inventory
• /itemsubmit reload — Reload the plugin config
• /itemsubmit open — Open item submissions for players
• /itemsubmit close — Close item submissions
• /itemsubmit set — Change the required submission item in-game
• /itemsubmit clear — Clear a specific player’s submitted total
• /itemsubmit clearall — Clear all player submission data across the server

## 🧩 Placeholders (Requires PlaceholderAPI)

• %itemsubmit_isopen% → Whether submissions are currently open
• %itemsubmit_total% → Player's personal submitted total
• %itemsubmit_servertotal% → Total submitted by the entire server
• %itemsubmit_top_1_name% → Top 1 player's name
• %itemsubmit_top_1_amount% → Top 1 player's amount submitted
• %itemsubmit_formatted_1% → A formatted message for top 1 player

Example output of %itemsubmit_formatted_7%:

``` Top 7 user: Steve with score 420

Perfect for scoreboard, tablist, and hologram plugins.

## 🔑 Permissions

• itemsubmit.submit — Allows using /submit
• itemsubmit.reload — Allows reloading the config
• itemsubmit.open — Allows opening submissions
• itemsubmit.close — Allows closing submissions
• itemsubmit.set — Allows changing the submitted item
• itemsubmit.clear — Allows clearing a specific player's submitted amount
• itemsubmit.clearall — Allows clearing all submitted amounts

## 📦 Compatibility

✅ Paper 1. 21. 11

Created with the help of AI