CustomSets 1.5.2

CustomSets is a Spigot 1.8.8 armor-set plugin. A bonus activates only when all four armor pieces have the same internal CustomSets ID. The readable lore also shows the set name, so staff and players can tell the sets apart.

The generated OptiFine/CIT pack places the transparent EmberPvP emblem on the back of every default and admin-created set chestplate.

Players can open /customsets or /sets for a protected, paginated set browser. Clicking a set opens an armor and ability preview. The browser marks the active set; admins can shift-click a set or use the preview action to give it to themselves.

Included sets

• Damage: +20% outgoing damage and a configurable 15% chance to Blind.
• Patch: +2 hearts, 10% less incoming damage, or 20% less incoming damage while in water.
• Farmer: configurable bonus sugar cane and exactly 5% extra tokens from sugar-cane rewards. Fractional token bonuses carry forward until they total one.
• Bard: diamond armor with a gold CIT texture, energy, passive held-item effects, and right-click active effects for nearby faction/clan allies. The give command includes its five ability items.

Installation

1. Put CustomSets-1.5.2.jar in the Spigot 1.8.8 server's plugins folder.
2. Restart the server.
3. Edit plugins/CustomSets/sets.yml for set values and plugins/CustomSets/config.yml for messages/integration settings.
4. Run /customsets reload.

All four sets use real diamond armor. CustomSets stores the set and piece identity in invisible NBT instead of a visible lore marker. Set tracking is read-only: CustomSets never replaces inventory or armor contents while another plugin is handling a transaction.

The generated plugins/CustomSets/CustomSets-ResourcePack.zip gives each set its configured color. The authoritative invisible set ID selects the texture; display names are not used because other plugins may rewrite them. Minecraft 1.8 has no vanilla per-item model IDs, so the distinct per-set textures require OptiFine CIT or a compatible client feature. Without it, the armor remains fully functional and displays as normal diamond.

The Farmer integration auto-detects the server's ScorgeTokens or ProgressionTools plugin. ScorgeTokens is preferred when both are installed. The plugin measures the real sugar-cane token award and adds 5%; it does not assume a hard-coded base reward.

Bard ally targeting supports MassiveCraft Factions variants, HCFCore, and scoreboard teams as a final fallback. Players without a faction/team do not buff unrelated players.

Commands

• /customsets list
• /customsets or /sets (open the set browser)
• /customsets give <set> [player]
• /customsets identify [player]
• /customsets debug [player] (shows each slot's hidden identity and likely armor hooks)
• /customsets editor [set]
• /customsets create (guided creator)
• /customsets create <id> [display name]
• /customsets pack (rebuild the generated CIT resource pack)
• /customsets reload

Admin commands require customsets.admin (OP by default). New sets are written to sets.yml with safe neutral defaults; all supported bonus keys can be copied from the four bundled examples.

Visual set creator and editor

Run /customsets editor, or select Manage Sets from the player set browser. The editor provides:

• A guided create flow for ID and display name; armor is always Diamond.
• Live controls for resource-pack color, Protection, Unbreaking, item names, lore, and activation particles.
• Combat controls for hearts, outgoing damage, general/water reduction, Blindness chance, and Blindness duration.
• Farmer controls for bonus-cane chance and amounts plus token percentage.
• Bard mode with an automatic HCF ability preset, radius, energy, regeneration, cooldown, potion type, passive/active levels, durations, and per-ability costs.
• Immediate safe persistence to sets.yml and silent recalculation for anyone currently wearing the edited set.
• Right-click cloning for quickly building a new set from an existing template.

Left/right-click changes values in opposite directions; shift-click uses larger steps. Free-form names and lore use a short chat prompt and support & color codes. Type cancel during any prompt to return safely.

Editor saves use a temporary file and atomic replacement where supported. sets-backup.yml always contains the configuration from immediately before the latest successful edit.

Feedback and presentation

config.yml controls every menu title/button, message, sound name, volume, pitch, and animation setting. Set-specific activation particles are configured with activation-effect in sets.yml. Defaults use only legacy Spigot 1.8.8 sounds and effects. Feedback is included for menu navigation, successful and failed actions, set activation/deactivation, Damage Blindness, Farmer rewards, and Bard actives.

Building

The source package includes the Spigot 1.8.8 API at work/spigot-api-1.8.8.jar, allowing:

mvn clean package

The compiled plugin targets Java 8 bytecode.