# TebexClaimSystem<\/p>\n
TebexClaimSystem is a Minecraft 1.8 Bukkit\/Spigot plugin that lets players claim Tebex purchases in-game through a custom GUI and allows players to collect their purchases the next time they are online.<\/p>\n
## What it does<\/p>\n
– Accepts Tebex-delivery style commands from console: `tebexclaimsystem add ## Installation<\/p>\n 1. Build the plugin jar. ## Commands<\/p>\n – `\/tebexclaimsystem` – Opens the claim GUI for players. ### Tebex example<\/p>\n “`text ## Configuration<\/p>\n Main config file: `plugins\/TebexClaimSystem\/config.yml`<\/p>\n ### `products`<\/p>\n Define each claimable product by ID. The ID must match what Tebex sends as ` – `displayName` – Name shown in GUI Example:<\/p>\n “`yaml ### `gui`<\/p>\n – `title` – Inventory title ### `messages`<\/p>\n All player-facing and feedback messages are configurable.<\/p>\n – Prefix token: `{prefix}` ## Runtime data files<\/p>\n Created in `plugins\/TebexClaimSystem\/`:<\/p>\n – `pending-claims.yml` – Current pending claims per player\/product `pending-claims.yml` is updated immediately whenever claims are added or removed.<\/p>\n ## Claim System<\/p>\n 1. Tebex (or console) runs `tebexclaimsystem add …` ## Troubleshooting<\/p>\n – `unknown product` message: ensure Tebex product ID exactly matches a key under `products`. ClaimSystem is a Minecraft 1.8 Bukkit\/Spigot plugin that lets server administrators manage an item claiming system for players, allowing them to claim items that can be distributed when the player is either online or offline.<\/p>\n","protected":false},"featured_media":40531,"template":"","meta":{"_minecraft_slug":"claimsystem","_minecraft_project_id":"3m04LfGa","_minecraft_author":"avaliberty","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":9,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"claimsystem.zip","_minecraft_size_bytes":26310,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:14:18.022449Z","_minecraft_date_created":"2026-03-22T03:05:22.275320Z","_minecraft_date_modified":"2026-03-22T00:34:45.544186Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/claimsystem","_minecraft_icon_attachment_id":40531,"_minecraft_imported_at":"2026-06-01T21:50:33+00:00","_minecraft_import_hash":"a0595ce9622953c9df5453665e4f0c54","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,129,91,92],"mod_loader":[130,134],"minecraft_version":[22],"class_list":["post-40530","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-spigot","mod_category-storage","mod_category-utility","mod_loader-bukkit","mod_loader-spigot","minecraft_version-1-8"],"yoast_head":"\n
\n– Stores pending claims in a flat YAML file so claims survive restarts
\n– Notifies players on join when they have pending items
\n– Sends online reminder messages every 30 minutes to players with pending claims
\n– Opens a GUI with one entry per pending product plus a **Claim All** button
\n– Checks free inventory space before claiming
\n– Executes configurable product commands with `{player}` placeholders
\n– Logs each claim with timestamp, player, product, and quantity<\/p>\n
\n2. Put the jar in your server’s `plugins\/` folder.
\n3. Start\/restart the server.
\n4. Edit `plugins\/TebexClaimSystem\/config.yml` to match your products\/commands.
\n5. Reload\/restart after config changes.<\/p>\n
\n– Aliases: `\/tcs`, `\/claimstore`, `\/claims`, `\/webstoreclaim`, `\/wsc`.
\n– `tebexclaimsystem add
\n– `\/tebexclaimsystem reload` – Reloads `config.yml` without restarting the server (`tebexclaimsystem.reload`, default `op`).<\/p>\n
\ntebexclaimsystem add Notch vip_rank 1
\ntebexclaimsystem add Notch starter_kit 2
\n“`<\/p>\n
\n– `itemMaterial` – GUI icon material
\n– `requiredSlotsPerUnit` – Space check amount per purchased unit
\n– `commands` – Commands run on claim (supports `{player}` and `{quantity}`)<\/p>\n
\nproducts:
\n vip_rank:
\n\tdisplayName: “&6VIP Rank”
\n\titemMaterial: “EMERALD”
\n\trequiredSlotsPerUnit: 1
\n\tcommands:
\n\t – “lp user {player} parent set vip”
\n starter_kit:
\n\tdisplayName: “&bStarter Kit”
\n\titemMaterial: “CHEST”
\n\trequiredSlotsPerUnit: 2
\n\tcommands:
\n\t – “give {player} diamond_sword 1”
\n\t – “give {player} bread 16”
\n“`<\/p>\n
\n– `size` – Inventory size (9-54, rounded to a multiple of 9)
\n– `claimAllSlot` – Slot index for Claim All button
\n– `claimAllName` \/ `claimAllMaterial` – Claim All button display
\n– `quantityLore` – Lore line for quantity text<\/p>\n
\n– Color support: `&` color codes<\/p>\n
\n– `claim-log.txt` – Claim audit log entries<\/p>\n
\n2. TebexClaimSystem stores pending quantity for that player\/product
\n3. Player joins and gets a notification if pending claims exist
\n4. Player opens `\/tebexclaimsystem` (or any configured alias)
\n5. Player clicks one item or **Claim All**
\n6. Plugin validates available inventory slots
\n7. If valid, product commands are dispatched and pending entry is removed
\n8. Claim is written to `claim-log.txt`<\/p>\n
\n– Player cannot claim due to space: increase empty inventory slots or tune `requiredSlotsPerUnit`.
\n– Console command denied in-game: `add` is intentionally restricted to console senders.
\n– No GUI items: verify `pending-claims.yml` has entries and product IDs exist in `config.yml`.<\/p>\n","protected":false},"excerpt":{"rendered":"