Overview​

ShyamStrikeCore is a highly advanced, fully customizable add-on for StrikePractice designed to exponentially enhance the player experience. It introduces highly interactive GUIs, custom combat mechanics, robust competitive dueling systems, and unprecedented configurability.

Every single feature, menu, and message is fully translatable. Best of all, all configurations update live using the /ssc reload command, meaning no frustrating server restarts to apply changes!

Installation & Setup​

Prerequisites​

1. A server running Paper/Spigot 1.21.x.
2. The core StrikePractice plugin installed.
3. PlaceholderAPI (Soft-Dependency, recommended for variables).
4. A valid License Key. After purchasing, join our Discord at https://discord.gg/r6XJyfzhdT and open a license ticket to retrieve your key!

Installation Steps​

1. Download the ShyamStrikeCore.jar file.
2. Place the Jar file into your server's plugins/ folder.
3. Start the server to generate the default configuration files.
4. Open plugins/ShyamStrikeCore/config.yml and paste your License Key into the License: "" field.
5. Restart your server.

Commands & Permissions​

Commands​

Additional Permissions​

---

Core Configuration (config.yml)​

1. Feature Toggles​

Enable or disable any core module individually. Set any feature to false to completely disable it:

2. Kit Editor World Whitelist​

Restrict Kit Editor access to specific worlds to prevent item duplication in arenas:

3. Enabled Worlds​

ShyamStrikeCore features (like right-click duel) are only active in these worlds:

4. Right-Click Player Duel​

Right-click another player to send a duel request instantly. Compatible with NPC plugins (Citizens, ZNPCsPlus, FancyNPCs) — NPCs will never accidentally trigger duel requests.

5. Auto GG Messages​

Automatically send a random GG message when a match ends. Players can toggle this personally with /autogg. You can add unlimited custom messages:

6. Death Messages System​

Fully customizable death messages with kill-on-command rewards and ranked reward tiers:

7. Join Titles​

Welcome title shown when players join the server:

8. Join/Leave Messages​

Customize or disable join and leave broadcast messages:
Set any message to "" (empty string) to disable it individually.

---

Translating The Plugin (messages.yml)​

Every chat-based message is fully customizable inside plugins/ShyamStrikeCore/messages.yml. This includes error messages, reload confirmations, Kit Room warnings, Kit Editor messages, and duel-related text. All messages support HEX color codes (e.g., &#FF0000) and standard Minecraft color codes.

---

The Kit Room System​

The Kit Room is the central hub for players to view their kits, edit items, manage shulkers, and customize armor.

1. Visual Layout & Setup (menus/kitroom.yml)​

Navigate to plugins/ShyamStrikeCore/menus/kitroom.yml to design the Kit Room menu.

• Title & Size: Edit title and size (must be a multiple of 9, max 54).
• Target Kit: Set target_kit to the StrikePractice kit name the Kit Room operates on (e.g., crystal).
• Filler Material: Set filler.material and filler.name for the background glass panes.
• Item Slots Range: Define item_slots.start and item_slots.end to control where kit items appear in the GUI grid.

2. Armor Slots & Unlocking​

Define exactly which slot numbers hold the Helmet, Chestplate, Leggings, and Boots in the armor_slots section.

Armor Locked/Unlocked Mode:
Set armor_slots_locked: true (default) to permanently lock armor from being swapped or removed. When set to false, players can:

• Left-Click an armor slot to remove the armor piece to their cursor.
• Click with an armor piece on their cursor to place it into the matching slot (type-validated: helmets only go in helmet slot, etc.).

The lore displayed automatically adjusts based on 4 states:
All 4 lore types (empty_lore, filled_lore, unlocked_lore, locked_lore) are fully customizable per slot in kitroom.yml.

3. Categories​

Under the categories section, define tabs like swords, crystals, potions, etc. Each category has:

• slot - Position in the GUI
• material - Icon material
• name & lore - Display text

4. Defining Kit Items (menus/kitroom_items.yml)​

This file controls the actual item layout inside the Kit Room grid. Items are organized by category, and each item is assigned to a specific slot. Use /ssc edit-kitroom to visually edit items in-game.

5. Shulker Editor Toggle​

Set shulker_editor_enabled: true or false to enable/disable the Shulker Box editor. When enabled, players can Right-Click any shulker box in the Kit Room to open an interactive editor for its contents.

6. Action Buttons​

Customize save, reset, and cancel buttons — their slot positions, materials, names, and lore are all configurable. The reset button includes a configurable cooldown.

---

The Kit Editor Integration​

The Kit Editor allows players to re-arrange their actual hotbar layout before entering a match, fully integrated with DeluxeMenus.

Configuration (kiteditor.yml)​

Navigate to plugins/ShyamStrikeCore/kiteditor.yml:

• Opening Command: Set kiteditor_open_command to the DeluxeMenus command that returns the player to the Kit Editor menu (default: dm open kiteditor).
• Armor Trimmer Integration: Set armor_trimmer_slots_enabled: true to inject armor slots (Helmet, Chestplate, Leggings, Boots) at the bottom row of the Kit Editor. Players with the shyamstrikecore.armortrimmer.use permission can Right-Click these slots to open the Armor Trimmer.
• Action Buttons: Customize save, reset, and leave buttons — each has configurable material, name, lore, slot, and command. The save button executes kiteditor save, reset executes kiteditor reset (with configurable cooldown), and leave executes kiteditor leave.
• Filler Panes: Set filler.enabled, filler.material, and filler.name for background glass panes.

---

The Armor Trimmer System​

Allow your VIPs or competitive players to stand out by visually trimming their armor sets dynamically inside the Kit Room or Kit Editor GUI!

1. Configuration (menus/armor_trimmer.yml)​

Enabling the Feature:
Set enabled: true at the top of the file to activate the Armor Trimmer.
Important: Even when enabled, players must have the shyamstrikecore.armortrimmer.use permission to access it. Without it, they'll see a locked/upgrade prompt in the armor slot lore.

Customizing Patterns & Materials:
You can rename every vanilla trim pattern and material in the GUI:

Result Preview:
The result slot (slot 16) dynamically shows a live preview of the trimmed armor piece. Customize the lore text with result.lore_line_1 and result.lore_line_2.

2. Clear Trim Button​

The Armor Trimmer GUI includes a configurable Clear Trim button that removes any applied armor trim and returns the armor piece to its original, untrimmed state.
When clicked, the trim is stripped, the untrimmed armor is saved back to the session (Kit Room or Kit Editor), and the GUI closes automatically.

3. Messages & Sounds​

All text feedback (messages.success, messages.no_permission, messages.not_armor) and sounds (gui_open, ui_cycle, trim_success, clear_trim, error, gui_close) are fully configurable.

---

The Custom Enchantment Table System​

A completely custom enchantment mechanism that allows players to enchant their combat gear dynamically inside the Kit Room GUI.

Configuration (menus/enchant_table.yml)​

Enchantment Limits & Compatibility:
Inside tool_enchantments, you define exactly what items can receive what enchants:

• Item Restrictions: Use applies_to: ["SWORD", "AXE"] to limit enchantments to specific weapon types.
• Level Limits: Use max_level: to cap enchantment levels. The GUI automatically cycles through Roman Numerals (I → II → III → None) when clicked.
• Conflict Rules: Use conflicts_with: to declare mutually exclusive enchantments (e.g., Sharpness vs Smite vs Bane of Arthropods).

Mace & Crossbow Support:
ShyamStrikeCore explicitly supports 1.21.x weapons:

• Mace: Density, Breach, and Wind Burst with proper max levels and conflict rules.
• Crossbow: Quick Charge, Multishot, and Piercing with mutual exclusion enforced between Multishot and Piercing.

GUI Customization:
All text is translatable: current enchantments header, "None" placeholder, "Click to pick up" text, lore format, and enchantment display names.

---

The Shulker Editor System​

An advanced, anti-dupe visual editor allowing players to manipulate the contents of their Shulker Boxes inside the Kit Room.

Configuration (menus/shulker_editor.yml)​

• Security Logic: ShyamStrikeCore actively blocks players from using Hotbar Number Keys (1-9) or offhand swap to extract filler panes, and prevents placing shulkers inside shulkers.
• Layout: Customize title, size, and the filter pane material/name surrounding the storage area.
• Back Button: Customize the material, name, and lore of the back button that returns to the Kit Room. Configurable via messages.yml.

---

The Duels & Rounds System​

ShyamStrikeCore overcomes standard bare-bones duels to offer a highly robust multi-round competitive experience!

1. Configuration (rounds-config.yml)​

Navigate to plugins/ShyamStrikeCore/rounds-config.yml to customize the entire duel flow.

Self-Duel Settings:

Kit Selection Menu (kit_menu):
Set the title and size of the GUI that appears when a player runs /duel <player>.

Adding Selectable Kits (kits:):
Under the kits: section, add kit definitions that map to your StrikePractice kit names. For each kit, define:

• name — Display name with color codes
• material — GUI icon material
• slot — Position in the GUI grid
• lore — Description lore lines

2. Skip Round Selection Per Kit​

Some kits (like Stick PvP, The Bridge, etc.) always use a fixed number of rounds. You can bypass the round selection GUI entirely on a per-kit basis!

Add skip_rounds: true and default_round to any kit:
When a player clicks this kit, the duel request is sent instantly with the configured default round — no round selection popup! Kits without skip_rounds will show the round selection GUI as normal.

3. Round Selection Menu​

Customize the round_menu.title and round_menu.size, then define round options under rounds::

4. Command Mappings​

Under commands:, map each kit + round combination to a StrikePractice command:
The <playername> placeholder is automatically replaced with the target player's name.

5. Right-Click to Duel​

The Right-Click to Duel feature allows players to right-click another player to instantly initiate a duel. This feature is fully compatible with NPC plugins such as Citizens, ZNPCsPlus, and FancyNPCs — right-clicking an NPC will never accidentally trigger a duel request.

---

The Golden Head System​

A fully custom consumable item with configurable effects, cooldowns, particles, and an action bar countdown.

Configuration (golden-head.yml)​

• Enable/Disable: Set enabled: true at the top.
• Cooldown: Set cooldown: 3 (in seconds) between uses.
• Custom Texture: Uses a custom player head texture via item.texture-value.
• Display Name & Lore: Fully customizable item appearance.

Potion Effects:
Define unlimited effects in the format EFFECT:duration:amplifier:ambient:particles:

Particles:
Configure particles spawned on consumption (type, count, offset, speed).

Advanced Options:

• drop-if-full: true — Drops the item if the player's inventory is full.
• remove-existing-effects: true — Clears existing potion effects before applying new ones.
• action-bar-countdown: true — Shows an action bar countdown during cooldown.
• prevent-stacking: false — Controls whether Golden Heads can stack.

---

The Totem Practice System​

A minigame that helps players practice their totem-clicking reflexes.

Configuration (totempractice.yml)​

• Command: /totempractice (permission: shyamstrikecore.totempractice).
• GUI: Customize title and size of the practice GUI.
• Score Reset: score_reset_duration: 2 — Seconds before the totem repositions.
• Max Misses: max_misses: 3 — Number of misses before the practice session ends.
• Messages & Titles: All feedback messages (start, score, miss, exit, wrong_click) and exit titles are customizable.
• Sounds: Individual sounds for gui_open, gui_close, totem_click, miss, and wrong_click.

---

Sound Configuration (sounds.yml)​

Global sounds for Golden Head events:

---

Support & Contact​

Running into an issue or need advanced configuration help? Join our Discord for support!

Join our Discord Server
Download on BuiltByBit