# ⚡ ShardPulse **Dynamic Supply-Demand Market • Unsealed Timed Amethyst Tools • Seismic Raid Radar vs. Jammers • Anti-Abuse PvP Loot-Guard** > **One Universal JAR (`153 KB`)** — Runs natively on **Paper**, **Purpur**, and **Folia** (`folia-supported: true`) across **Minecraft `1.21.1` – `1.21.11`** (Java 21) and **`26.1.x` – `26.3`** (Java 25). > **Zero Required Dependencies** — Works completely standalone out-of-the-box, or automatically hooks into **Vault**, **PlaceholderAPI**, and **Discord Webhooks**! --- ## ✦ At a Glance | Module | Commands | What It Solves | | :--- | :--- | :--- | | **🔮 Amethyst Timed Arsenal** | `/amethyst`, `/shardshop` | Keeps top-tier gear circulating with **Unsealed** self-destructing power tools featuring a **live hotbar durability bar** & **1s ActionBar countdown**. | | **📈 Live Market Pulse** | `/market`, `/quicksell`, `/appraise` | Eliminates single-farm hyperinflation via smooth hyperbolic supply/demand pricing, **2.0x Flash Market Rushes**, Shulker-safe Quick-Selling, and Chunk Stash Appraisal. | | **📡 Raid Radar vs. Jammer** | `/radar`, `/jammer` | Replaces unfair ESP/X-Ray raiding with a balanced **Seismic Resonator** (`11x11` chunk heat + compass bearing) vs. **Sculk Signal Jammer** (`7x7` stealth cloak + raid alarm). | | **🎯 Blood Bounties & Loot-Guard** | `/bounty` | Locks PvP & **End Crystal** drops exclusively to the killer for `15s` (blocking scavengers & hoppers), plus anti-alt Escrow Bounties & Engraved Trophy Skulls. | | **🔌 Network Integrations** | `/shardpulse admin` | Built-in `%shardpulse_*%` **PlaceholderAPI** expansion, non-blocking **Discord Rich Embed Webhooks**, full **`messages.yml`** MiniMessage localization, & live module hot-toggles. | --- ## Why Server Owners Choose ShardPulse Most hardcore & DonutSMP-inspired servers already run `/ah`, `/shop`, `/tpa`, and `/home` plugins—yet still suffer from **runaway Cactus/Bamboo inflation**, **ESP stash hunting**, and **Crystal PvP loot theft**. Unlike monolithic core plugins that force hard dependencies or overwrite `/home` and `/ah`, **ShardPulse is 100% modular and conflict-free**: - **Drop-In Compatible:** Runs cleanly alongside `EssentialsX`, `CMI`, `EconomyShopGUI`, `zAuctionHouse`, `WorldGuard`, `GriefPrevention`, `Lands`, and `LuckPerms`. - **Standalone or Vault-Backed:** Automatically hooks into **Vault** if installed, or seamlessly falls back to its built-in persistent **Money + Shards** engine. - **True Folia Region Safety:** Built from scratch on Paper's `GlobalRegionScheduler`, `RegionScheduler`, `EntityScheduler`, and `AsyncScheduler`—zero legacy `BukkitRunnable` calls and zero forced chunk loading. --- ## Core Systems Deep-Dive ### 1. 🔮 Unsealed Amethyst Timed Arsenal (`/amethyst`, `/shardshop`) High-tier artifacts purchased with **✦ Shards** (earned passively from active playtime, PvP eliminations, or crates/grants): - **🔒 Dormant Seal Technology:** Every tool arrives **UNSEALED**. Its real-time countdown (default `24h`) and durability bar **only activate on first actual use**—making tools 100% safe to store inside Crates, Kits, or Player Auctions without losing a single second! - **📊 Live Hotbar Durability Bar & 1s ActionBar HUD:** Syncs the item's native green-to-red hotbar bar dynamically to both **remaining durability uses** and **remaining self-destruct time**, ticking down live every second (`23h 59m 58s → 23h 59m 57s`) until shattering into Amethyst Shards! - **🛡 Anti-Bypass Container Sweep:** Blocks Anvil/Grindstone/Crafting exploits and shatters expired tools even if stashed inside Chests, Shulker Boxes, or Ender Chests. - **5 Signature Artifacts:** - **Amethyst Sell Axe:** Right-click any Chest, Trapped Chest, or Barrel to instant-sell all market commodities inside (**+15% Bonus Multiplier**)—including **items inside nested Shulker Boxes while keeping the Shulker Boxes intact**! Built with deposit-first atomic safety. - **Amethyst 3x3 Drill (Pickaxe):** Mines a `3x3` plane aligned to the block face hit (`Sneak` = `1x1` precision). Respects Fortune & claim plugins while skipping Bedrock, Spawners, and Containers. - **Amethyst 3x3 Excavator (Shovel):** Instant `3x3` Silk-Touch excavation for sand, gravel, dirt, clay, and mud (`Sneak` = `1x1`). - **Amethyst Tree Chopper:** Fells entire connected tree trunks in one swing via live vanilla block tags (automatically supports `1.21.4` Pale Oak through `26.3` Poplar logs). - **Amethyst Drain Bucket:** Vaporizes a `3x3x3` cube (**27 blocks**) of Water, Lava, Kelp, or Waterlogged states instantly. --- ### 2. 📈 Live Market Pulse & Stash Appraiser (`/market`, `/appraise`) - **Dynamic Supply-Demand Pricing:** Mass-sold commodities curve smoothly toward a configurable floor (`0.60x`), while scarce items climb toward `1.65x` with live ticker badges (`▲ +18.5% High Demand` / `▼ -12.0% Oversupplied`) and automatic volume recovery every 15 minutes. - **⚡ 2.0x Flash Market Rush:** Periodically selects 2 random commodities for a server-wide `2.0x` sell surge (with optional Discord Webhook alerts!). - **📦 Shulker-Safe Quick-Sell Dropbox (`/market sell` | `/quicksell`):** Drop loose items or **entire filled Shulker Boxes** into the GUI and close it to auto-sell at live rates—emptied Shulker Boxes and unsellable gear are safely returned to your inventory! - **💎 Chunk Stash Appraiser (`/appraise` | `/stashworth`):** Scans all Containers, nested Shulker Boxes, and Spawners in your `16x16` chunk to build an interactive **Stash Net Worth Report**, complete with a coordinate-safe **Verified Stash Flex** broadcast button. --- ### 3. 📡 Echo Seismic Radar vs. Sculk Signal Jammer (`/radar`) - **Echo Seismic Resonator (For Raiders):** Dispatches non-blocking region tasks across an `11x11` **loaded** chunk grid (never force-loading chunks!). Reports underground container & spawner density as **Heat Tiers** (`Cold`, `Faint Echo`, `Warm Signal`, `Critical Anomaly`) + an **8-Wind Compass Bearing**—never exposing raw XYZ coordinates. - **Sculk Signal Jammer Core (For Base Builders):** Place inside your base (includes `2h` free starter fuel) and refuel with **Shards** via its right-click GUI. Cloaks a `7x7` chunk area from enemy radars AND sends a throttled **Silent Raid Alert** to the online owner whenever an enemy scans nearby! --- ### 4. 🎯 Anti-Abuse Blood Bounties & 15s Killer Loot-Guard (`/bounty`) - **🔒 15s Killer Loot-Guard (Crystal PvP Ready!):** Tracks melee, projectile, AND **End Crystal** detonations! Locks dropped `Item` entities via entity-level PDC (preserving clean vanilla item stacking!) so scavengers and enemy hoppers cannot steal loot for 15 seconds. - **🎯 Escrow Blood Bounties (`/bounty`):** Protected by an `8%` escrow listing tax, **Same-IP Anti-Alt blocking**, and a **30-minute pair claim cooldown**. - **💀 Engraved PvP Trophy Skulls:** Eliminations drop the victim's genuine Player Head stamped with Killer, Weapon / End Crystal cause, Bounty Claimed, and Timestamp. --- ## Commands & Permissions | Command | Aliases | Description | Permission | | :--- | :--- | :--- | :--- | | `/shardpulse` | `/spulse` | View Money & Shards balances and plugin overview | `shardpulse.use` *(default)* | | `/amethyst` | `/shards` | View all Amethyst commands & Shards balance | `shardpulse.use` | | `/amethyst shop` | `/shardshop` | Open the Amethyst Shard Shop GUI | `shardpulse.use` | | `/amethyst status` | `/amethyst timer` | Inspect held Amethyst tool countdown, uses, & integrity bar | `shardpulse.use` | | `/market` | `/pulse`, `/priceindex` | Open the paginated Live Market Pulse Stock-Ticker GUI | `shardpulse.use` | | `/market sell` | `/quicksell` | Open the Shulker-Safe Quick-Sell Dropbox | `shardpulse.use` | | `/appraise` | `/stashworth`, `/chunkworth` | Appraise total container & spawner net worth in current chunk | `shardpulse.use` | | `/radar` | `/jammer`, `/seismic` | Open Seismic Radar & Sculk Signal Jammer guide/shop | `shardpulse.use` | | `/bounty [add

` | — | Grant `SELL_AXE`, `DRILL`, `EXCAVATOR`, `TREE_CHOPPER`, `SPONGE_BUCKET`, `RESONATOR`, `JAMMER` | `shardpulse.admin` | | `/amethyst settime ` | `/amethyst setuses ` | Set remaining seconds or durability uses on held Amethyst tool | `shardpulse.admin` | | `/shardpulse shards\|eco ...` | — | `give`, `take`, or `set` player Shards or Money balances | `shardpulse.admin` | | `/shardpulse rush` | — | Manually trigger a server-wide 2.0x Flash Market Rush | `shardpulse.admin` | | `/shardpulse webhooktest` | — | Send an async test Rich Embed to your Discord Webhook | `shardpulse.admin` | | `/shardpulse reload` | — | Reload `config.yml` & `messages.yml` and flush persistent data | `shardpulse.admin` | --- ## PlaceholderAPI Expansion (`%shardpulse_*%`) When **PlaceholderAPI** is installed, ShardPulse registers its built-in expansion automatically on startup (no eCloud download required): | Placeholder | Example Output | Description | | :--- | :--- | :--- | | `%shardpulse_shards%` | `1250` | Raw player Shards balance | | `%shardpulse_shards_formatted%` | `1,250 ✦` | Grouped Shards balance with symbol | | `%shardpulse_shards_compact%` | `✦1.25K` | Compact Shards balance for Scoreboards/TAB | | `%shardpulse_money%` / `%shardpulse_money_formatted%` | `$25.5K` | Raw or compact Vault / Built-in Money balance | | `%shardpulse_bounty%` / `%shardpulse_bounty_formatted%` | `$50K` | Active bounty placed on the player | | `%shardpulse_has_bounty%` | `yes` / `no` | Whether the player currently has an active bounty | | `%shardpulse_rush_active%` / `%shardpulse_rush_items%` | `Cactus, Blaze Rod` | Current 2.0x Flash Market Rush status & items | | `%shardpulse_price_%` | `$6.45` | Live unit sell price for any commodity (e.g. `CACTUS`, `DIAMOND`) | | `%shardpulse_trend_%` | `1.43x` | Live supply/demand multiplier for any commodity | --- ## Requirements & Quick Setup | Requirement | Supported | | :--- | :--- | | **Server Platform** | **Paper**, **Purpur**, Leaf, Pufferfish, & **Folia** *(CraftBukkit / plain Spigot without Paper API is not supported)* | | **Minecraft Versions** | **`1.21.1` – `1.21.11`** and **`26.1.x`, `26.2`, `26.3`** | | **Java Runtime** | Java **21+** (`1.21.x`) or Java **25+** (`26.x`) | | **Optional Plugins** | **Vault** *(economy hook)*, **PlaceholderAPI** *(`%shardpulse_*%` placeholders)* — both auto-detected if present! |

📄 Click to View Default config.yml

```yaml general: prefix: "ꜱʜᴀʀᴅᴘᴜʟꜱᴇ » " use-small-caps: true currency-symbol: "$" shard-symbol: "✦" starting-fallback-money: 1000.0 starting-shards: 25 passive-shards-interval-minutes: 10 passive-shards-amount: 5 pvp-kill-shards-reward: 10 modules: amethyst-arsenal: true market-pulse: true stash-radar: true pvp-lootguard: true amethyst-arsenal: default-duration-seconds: 86400 warn-under-seconds: 300 hold-actionbar-hud: true sell-axe-nested-shulkers: true sell-axe-multiplier: 1.15 tree-chopper-max-logs: 64 sponge-bucket-cooldown-seconds: 4 max-uses: SELL_AXE: 500 DRILL: 1500 EXCAVATOR: 1500 TREE_CHOPPER: 1200 SPONGE_BUCKET: 400 shop-prices-shards: SELL_AXE: 150 DRILL: 120 EXCAVATOR: 90 TREE_CHOPPER: 90 SPONGE_BUCKET: 110 discord-webhook: enabled: false url: "https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN" bot-username: "ShardPulse Live Feed" server-label: "SMP Network" events: flash-market-rush: true bounty-placed: true bounty-placed-min-amount: 5000.0 bounty-claimed: true verified-stash-flex: true stash-flex-min-worth: 50000.0 ```

--- *Disclaimer: ShardPulse is an independent plugin inspired by hardcore economy & raid SMP gameplay loops and is not affiliated with or endorsed by DonutSMP or Mojang Studios.*

ShardPulse

1.2.0

1.1.1