ItemProgressions
\n=================<\/p>\n
A Minecraft Bukkit\/Paper plugin to “lock” items and dimensions until a condition is met (realtime, per-player playtime,
\nglobal\/server playtime). While locked, the plugin blocks using\/placing\/crafting\/consuming and can also block entering
\ndimensions. Locked items get a lock lore line; advancements can show progress.<\/p>\n
# Features<\/p>\n
– Lock items and dimensions until realtime, per-player playtime, or global\/server playtime criteria are met.
\n– Block use\/place\/craft\/consume of locked items; optionally allow breaking locked blocks via config.
\n– Block entering locked dimensions (same logic as items).
\n– Optional advancement tab with rule + per-item advancements; multiple layout modes (none, columns, square, auto) with
\n dummy nodes for visibility.
\n– Configurable icons\/names\/description templates for advancements; ability to disable advancement creation entirely.<\/p>\n
# How to use<\/p>\n
1. Download the jar file and place it in your `plugins\/` folder.
\n2. Restart the Server.
\n3. Edit `config.yml` (common keys):
\n – `locks`: list of rules; each has `items` and `unlock` (type=`realtime|perPlayer|global`; use `at` for timestamps
\n or `seconds` for playtime). Optional per-rule `icon` and `name` apply to the rule advancement.
\n – `allowBreaking`: true lets players break locked blocks.
\n – `disableAdvancementCreation`: true skips creating any custom advancements.
\n – `advancementGridMode`: layout for per-item advancements (`none`, `columns`, `square`, `auto`).
\n – `itemAdvancements.defaults`: description templates and default icon. Placeholders: `%name%`, `%time%`,
\n `%playtime%`, `%servertime%`.<\/p>\n
# Config keys (detailed)<\/p>\n
– `allowBreaking`: when true, players may break locked blocks; other lock checks still apply.
\n– `disableAdvancementCreation`: when true, the plugin does not register custom advancements.
\n– `advancementGridMode`: layout for per-item advancements; choose `none` (all under rule), `columns` (fixed-width
\n columns), `square` (square-ish grid with dummies), or `auto` (best-fit grid with dummies per row for visibility).
\n– `itemAdvancements.tab`: custom tab info; set `key`, `title`, `description`, `icon`, and `background`.
\n– `itemAdvancements.defaults`: description templates and a fallback icon; placeholders: `%name%`, `%time%`,
\n `%playtime%`, `%servertime%`.
\n– `locks`: list of lock rules:
\n – `items`: material names\/patterns (e.g., `”DIAMOND_*”`). Only item materials are used for per-item advancements;
\n block-only materials are skipped.
\n – `unlock.type`: `realtime`, `perPlayer`, or `global`.
\n – `unlock.at`: ISO-8601 timestamp for `realtime` locks.
\n – `unlock.seconds`: duration in seconds for `perPlayer` or `global` locks.
\n – `unlock.icon`: optional rule-advancement icon (namespaced item id). If empty, defaults to a matched item.
\n – `unlock.name`: optional rule-advancement title. If empty, the item\u2019s translated name is used.<\/p>\n
# Examples<\/p>\n
Minimal config with a realtime lock and a per-player lock:<\/p>\n
“`yaml
\nallowBreaking: false
\ndisableAdvancementCreation: false
\nadvancementGridMode: auto<\/p>\n
itemAdvancements:
\n tab:
\n key: “itemprogressions:locked_items”
\n title: “Locked Items”
\n description: “Items managed by ItemProgressions”
\n icon: “minecraft:barrier”
\n background: “minecraft:textures\/gui\/advancement\/backgrounds\/adventure.png”
\n defaults:
\n realtimeDescription: “%name% can be used at %time%”
\n perPlayerDescription: “%name% can be used after %playtime%”
\n globalDescription: “%name% can be used after %servertime%”
\n icon: “minecraft:barrier”<\/p>\n
dimensionLocks:
\n – dimension: NETHER
\n unlock:
\n type: realtime
\n at: “2026-01-01T15:00:00+01:00”
\n name: “The Nether”
\n icon: “minecraft:netherrack”
\n description: “The Nether unlocks on January 1st, 2026”
\n – dimension: THE_END
\n unlock:
\n type: realtime
\n at: “2027-01-01T00:00:00+01:00”
\n name: “The End”
\n icon: “minecraft:end_stone”
\n description: “The End unlocks on January 1st, 2027”<\/p>\n
locks:
\n – items: [ “DIAMOND_*” ]
\n unlock:
\n type: perPlayer
\n seconds: 3600
\n icon: “minecraft:diamond”
\n name: “Diamond Gear”<\/p>\n
– items: [ “NETHERITE_*” ]
\n unlock:
\n type: realtime
\n at: “2026-01-01T00:00:00Z”
\n icon: “minecraft:netherite_ingot”
\n name: “Netherite Items”
\n“`<\/p>\n
# Permissions<\/p>\n
– `itemprogressions.bypass. A customizable plugin to lock away \/ delay the use of specific items until a specific condition is met<\/p>\n","protected":false},"featured_media":87043,"template":"","meta":{"_minecraft_slug":"itemprogressions","_minecraft_project_id":"9UMPCB0c","_minecraft_author":"TheCoolcraft11","_minecraft_license":"Apache-2.0","_minecraft_downloads":47,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"itemprogressions.zip","_minecraft_size_bytes":100584,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T21:19:48.037334Z","_minecraft_date_created":"2025-12-21T05:24:11.925493Z","_minecraft_date_modified":"2026-01-03T22:58:26.535570Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/itemprogressions","_minecraft_icon_attachment_id":87043,"_minecraft_imported_at":"2026-06-04T23:21:59+00:00","_minecraft_import_hash":"58ae394d94fdb621b5a161327760b85e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,88,89,126,127,128,867,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-87042","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-equipment","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n `itemprogressions.bypass.DIAMOND_SWORD`).
\n– `itemprogressions.bypass.*`: allows bypassing all locks.<\/p>\n","protected":false},"excerpt":{"rendered":"