ClaimSystem

# TebexClaimSystem 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. ## What it does - Accepts Tebex-delivery style commands from console: `tebexclaimsystem add <username> <productName> <quantity>` - Stores pending claims in a flat YAML file so claims survive restarts - Notifies players on join when they have pending items - Sends online reminder messages every 30 minutes to players with pending claims - Opens a GUI with one entry per pending product plus a **Claim All** button - Checks free inventory space before claiming - Executes configurable product commands with `{player}` placeholders - Logs each claim with timestamp, player, product, and quantity ## Installation 1. Build the plugin jar. 2. Put the jar in your server's `plugins/` folder. 3. Start/restart the server. 4. Edit `plugins/TebexClaimSystem/config.yml` to match your products/commands. 5. Reload/restart after config changes. ## Commands - `/tebexclaimsystem` - Opens the claim GUI for players. - Aliases: `/tcs`, `/claimstore`, `/claims`, `/webstoreclaim`, `/wsc`. - `tebexclaimsystem add <username> <productName> <quantity>` - Console-only command (intended for Tebex delivery). - `/tebexclaimsystem reload` - Reloads `config.yml` without restarting the server (`tebexclaimsystem.reload`, default `op`). ### Tebex example ```text tebexclaimsystem add Notch vip_rank 1 tebexclaimsystem add Notch starter_kit 2 ``` ## Configuration Main config file: `plugins/TebexClaimSystem/config.yml` ### `products` Define each claimable product by ID. The ID must match what Tebex sends as `<productName>`. - `displayName` - Name shown in GUI - `itemMaterial` - GUI icon material - `requiredSlotsPerUnit` - Space check amount per purchased unit - `commands` - Commands run on claim (supports `{player}` and `{quantity}`) Example: ```yaml products: vip_rank: displayName: "&6VIP Rank" itemMaterial: "EMERALD" requiredSlotsPerUnit: 1 commands: - "lp user {player} parent set vip" starter_kit: displayName: "&bStarter Kit" itemMaterial: "CHEST" requiredSlotsPerUnit: 2 commands: - "give {player} diamond_sword 1" - "give {player} bread 16" ``` ### `gui` - `title` - Inventory title - `size` - Inventory size (9-54, rounded to a multiple of 9) - `claimAllSlot` - Slot index for Claim All button - `claimAllName` / `claimAllMaterial` - Claim All button display - `quantityLore` - Lore line for quantity text ### `messages` All player-facing and feedback messages are configurable. - Prefix token: `{prefix}` - Color support: `&` color codes ## Runtime data files Created in `plugins/TebexClaimSystem/`: - `pending-claims.yml` - Current pending claims per player/product - `claim-log.txt` - Claim audit log entries `pending-claims.yml` is updated immediately whenever claims are added or removed. ## Claim System 1. Tebex (or console) runs `tebexclaimsystem add ...` 2. TebexClaimSystem stores pending quantity for that player/product 3. Player joins and gets a notification if pending claims exist 4. Player opens `/tebexclaimsystem` (or any configured alias) 5. Player clicks one item or **Claim All** 6. Plugin validates available inventory slots 7. If valid, product commands are dispatched and pending entry is removed 8. Claim is written to `claim-log.txt` ## Troubleshooting - `unknown product` message: ensure Tebex product ID exactly matches a key under `products`. - Player cannot claim due to space: increase empty inventory slots or tune `requiredSlotsPerUnit`. - Console command denied in-game: `add` is intentionally restricted to console senders. - No GUI items: verify `pending-claims.yml` has entries and product IDs exist in `config.yml`.