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
