## Simple, lightweight item submission plugin for Paper servers.
\nItemSubmit 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.<\/p>\n
– \ud83d\udce6 Players use \/submit to hand in all configured items from their inventory
\n– \ud83c\udfc6 Tracks personal totals and server-wide totals
\n– \ud83d\udcca Built-in top leaderboard placeholders (Top 1, Top 2, etc.)
\n– \ud83e\udde9 PlaceholderAPI support included
\n– \u26a1 Lightweight & optimized for performance (Paper 1.21.11 ready)
\n– \ud83d\udd04 Open\/close submission events instantly with commands
\n– \ud83d\udee0\ufe0f Change the required item in-game with \/itemsubmit set
\n– \ud83d\udcac Perfect for server competitions, seasonal events, and donation systems
\n– \ud83e\uddf9 Clear player data or reset all submissions easily
\n– \u2699\ufe0f Clean and minimal configuration<\/p>\n
## \u2699\ufe0f Config File<\/p>\n
“`
\n# Item that players are allowed to submit.
\n# Use a valid Bukkit\/Paper material name.
\nitem: GRASS_BLOCK<\/p>\n
placeholders:
\n enabled: true<\/p>\n
# Formatted dynamic leaderboard placeholders:
\n # %itemsubmit_formatted_1%, %itemsubmit_formatted_2%, etc.
\n # Tokens you can use: %position%, %name%, %amount%
\n formatted:
\n format: ‘Top %position% user: %name% with score %amount%’
\n empty-format: ‘-‘
\n“`
\n## \ud83d\udee0\ufe0f Commands<\/p>\n
– \/submit \u2014 Submit all configured items from your inventory ## \ud83e\udde9 Placeholders (Requires PlaceholderAPI)<\/p>\n – %itemsubmit_isopen% \u2192 Whether submissions are currently open Example output of **%itemsubmit_formatted_7%**:<\/p>\n “` “`<\/p>\n Perfect for scoreboard, tablist, and hologram plugins.<\/p>\n ## \ud83d\udd11 Permissions<\/p>\n – itemsubmit.submit \u2014 Allows using \/submit ## \ud83d\udce6 Compatibility<\/p>\n \u2705 Paper 1.21.11<\/p>\n","protected":false},"excerpt":{"rendered":" Let players submit items to the server, with placeholder support to track top players.<\/p>\n","protected":false},"featured_media":87112,"template":"","meta":{"_minecraft_slug":"itemsubmit","_minecraft_project_id":"RtkGzhQg","_minecraft_author":"u4x3s3a","_minecraft_license":"MIT","_minecraft_downloads":2,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"itemsubmit.zip","_minecraft_size_bytes":10071,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:21:57.791564Z","_minecraft_date_created":"2026-05-03T04:25:35.589528Z","_minecraft_date_modified":"2026-04-25T00:22:15.909405Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/itemsubmit","_minecraft_icon_attachment_id":87112,"_minecraft_imported_at":"2026-06-04T23:26:42+00:00","_minecraft_import_hash":"a88c9e8b9b017d089025dde4d168f88e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,866,127,92],"mod_loader":[132],"minecraft_version":[41],"class_list":["post-87111","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-minigame","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21-11"],"yoast_head":"\n
\n– \/itemsubmit reload \u2014 Reload the plugin config
\n– \/itemsubmit open \u2014 Open item submissions for players
\n– \/itemsubmit close \u2014 Close item submissions
\n– \/itemsubmit set
\n– \/itemsubmit clear
\n– \/itemsubmit clearall \u2014 Clear all player submission data across the server<\/p>\n
\n– %itemsubmit_total% \u2192 Player’s personal submitted total
\n– %itemsubmit_servertotal% \u2192 Total submitted by the entire server
\n– %itemsubmit_top_1_name% \u2192 Top 1 player’s name
\n– %itemsubmit_top_1_amount% \u2192 Top 1 player’s amount submitted
\n– %itemsubmit_formatted_1% \u2192 A formatted message for top 1 player<\/p>\n
\nTop 7 user: Steve with score 420<\/p>\n
\n– itemsubmit.reload \u2014 Allows reloading the config
\n– itemsubmit.open \u2014 Allows opening submissions
\n– itemsubmit.close \u2014 Allows closing submissions
\n– itemsubmit.set \u2014 Allows changing the submitted item
\n– itemsubmit.clear \u2014 Allows clearing a specific player’s submitted amount
\n– itemsubmit.clearall \u2014 Allows clearing all submitted amounts<\/p>\n