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

ItemSubmit