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