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 <material> — Change the required submission item in-game
• /itemsubmit clear <player> — 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