ShardPulse
专为 Paper、Purpur 和 Folia 打造的硬核生存多人联机(SMP)经济、突袭战争与 PvP 套件,支持 Minecraft 1.21.1 – 26.3(Java 21 & Java 25)。
开箱即用,独立运行;自带双货币账本系统(Money + ✦ Shards),也可自动对接 Vault 和 PlaceholderAPI。支持 YAML、SQLite 以及跨服务器的 MySQL 存储,并具备自动数据迁移功能。
为何选择 ShardPulse?
硬核经济与突袭玩法的 SMP 服务器通常面临三大游戏性问题:
- 单一农场恶性通胀: 固定的
/sell 售价允许一个巨大的仙人掌或竹子农场永远无限印钞。
- 透视(ESP)与 X-Ray 基地侦查: 合法的突袭者缺乏基于技巧的游戏内机制来定位地下基地,而防守方则没有反制手段或陷阱机制。
- PvP 战利品拾荒与赏金刷取: 无甲路人会在战斗中偷窃装备,且小号可以刷取自己的赏金。
ShardPulse 在一个模块化、兼容 Folia 的 JAR 文件中解决了上述所有问题,无需替换你现有的 /ah、/shop、/tpa 或 /home 插件。每个模块均可通过游戏中的 /shardpulse admin 热切换开关。
核心功能
1. Market Pulse & Buy-Orders(市场脉冲与购买订单)
命令:/market, /orders, /appraise
- 动态供需定价: 大量出售的商品价格会逐渐下降至可配置的底价(
0.60x),而稀缺商品的价格则会上升至封顶价(1.65x),并随时间自然恢复。
- 2.0x 闪购市场热潮: 定期将 2 种随机商品的价格提升至全服范围的
2.0x 出售倍率。
- 安全快速出售投递箱(
/market sell | /quicksell): 将散落的物品或装满物品的潜影盒投入其中并关闭菜单,即可自动出售内容物——空的潜影盒和非出售物品会安全返回你的背包。
- 托管购买订单合约(
/orders | /market orders): 锁定现金作为托管资金以批量求购物品(/orders create <material> <amount> <priceEach>)。其他玩家可直接从库存中完成订单以获得即时 payout,买家可随时从**个人配送保险箱(/orders collect)**收取交付的物品,或按住 Shift + 右键 取消订单并退款剩余托管资金。
- 区块藏匿处估价器(
/appraise | /stashworth): 扫描当前 16x16 区块内的容器、嵌套潜影盒和刷怪笼以计算净资产,并可选择性地广播已验证的藏匿处炫耀聊天信息,绝不泄露坐标。
2. Amethyst Arsenal & Boosters(紫水晶军火库与增益道具)
命令:/amethyst, /amethyst shop, /shardpulse tip
使用 ✦ Shards 购买的高级实用工具和增益道具,在使用前保持未封印、可交易、可被突袭的状态:
- 零悬浮实时计时器与耐久引擎: 在 Minecraft
1.21.1–26.3 版本上平滑追踪实时 HH:MM:SS 过期时间和耐久条,不会触发手持物品的摇摆动画。
- 5 种紫水晶强力工具:
- 紫水晶出售斧: 左键点击或与箱子/木桶交互即可快速出售其中的市场商品(1.15x 加成),包括嵌套潜影盒内的物品,同时保留潜影盒本身。
- 紫水晶 3x3 钻头(镐子): 挖掘与目标方块面平齐的
3x3 平面(潜行模式为 1x1 精准挖掘),同时尊重领地插件、基岩、刷怪笼和容器。
- 紫水晶 3x3 挖掘机(铲子): 挖掘
3x3 的泥土/沙子/砾石平面(潜行模式为 1x1)。
- 紫水晶伐木斧(斧头): 一次挥砍砍倒相连的树木原木,最多可达 64 格。
- 紫水晶海绵桶: 可重复使用的
5x5x5 水和 lava 清理虹吸管,具有可配置的冷却时间。
- 未密封的个人(
1.5x)与全局(2.0x)出售增益道具: 可在 /amethyst shop 中交易的增益水晶。全局增益道具会显示实时的全服 BossBar,并允许玩家运行 /shardpulse tip 来奖励赞助商并赚取免费的 Shards(100% 符合 Mojang EULA 规定)。
3. Raid Radar & Amethyst Rifts(突袭雷达与紫水晶裂隙)
命令:/radar, /rift
- 回声地震共振器(突袭者用): 扫描附近已加载的区块(绝不会在 Paper/Folia 上强制加载区块),报告藏匿处的热度等级及指南针方向,而不透露确切的 XYZ 坐标。
- 景深信号干扰器(防守者用): 在 Shards 燃料的支持下,使可配置的区块半径(默认
3-chunk 半径)免受敌方共振器扫描的影响,并在扫描被阻止时通知在线的所有者。
- 诱饵回声信标(陷阱建造者用): 部署灵魂灯笼诱饵(
75✦),发出虚假的关键巨型藏匿处雷达信号,引诱突袭者进入陷阱。
- 紫水晶裂隙补给空投(
/rift): 定时世界 PvP 事件,生成带有天光和 BossBar 倒计时锁定的 Respawn Anchor 缓存,奖励 Shards、未封印的紫水晶工具和个人出售增益道具。
4. Bounties, Loot-Guard & Leaderboards(赏金、战利品守卫与排行榜)
命令:/bounty, /shardpulse top
- 15 秒击杀战利品守卫: 保护 PvP 击杀掉落物(包括近战、投射物和末影水晶击杀)免受第三方拾荒者和漏斗盗窃长达 15 秒,且不破坏物品堆叠。
- 反滥用血洗赏金(
/bounty): 强制执行 listing 税(8%)、同 IP 小号屏蔽以及配对领地冷却时间(30m),在 PvP 击杀时掉落盖有印章的玩家奖杯头颅。
- Top 10 玩家头颅排行榜(
/shardpulse top): 交互式 4 标签 GUI(Top Shards、Market Tycoons、Bounty Hunters、Biggest Stashes)以及全息图 PlaceholderAPI 标签。
Commands & Permissions
| 命令 |
别名 |
权限 |
描述 |
/shardpulse [top|tip|admin|...] |
/spulse |
shardpulse.use / shardpulse.admin |
概览、前 10 排行榜(top)、加速提示(tip)及管理控制面板 GUI |
/amethyst [shop|status|...] |
/shards, /shardshop |
shardpulse.use |
查看紫水晶子命令、打开碎片商店(/amethyst shop)及检查工具 |
/market [sell|orders] |
/pulse, /priceindex, /quicksell |
shardpulse.use |
打开实时市场行情牌、快速出售框(sell)或买入订单(orders) |
/orders [create|collect] |
/buyorders |
shardpulse.use |
托管买入订单合约板及个人配送保险箱 |
/appraise |
/stashworth, /chunkworth |
shardpulse.use |
评估当前区块中容器、嵌套潜影盒及刷怪笼的净资产价值 |
/radar |
/jammer, /seismic |
shardpulse.use |
打开回声共振器、诱饵回声信标及潜地信号干扰器菜单 |
/bounty [add <player> <amount>] |
/bounties, /headhunt |
shardpulse.use |
打开血腥悬赏板或发布悬赏 |
| /rift [status\|here\|random\|stop] | /supplydrop, /amethystrift | shardpulse.use / shardpulse.admin | 查看当前紫水晶裂隙的坐标/计时器,或生成/停止裂隙 |
管理员子命令 (shardpulse.admin)
-
/shardpulse admin — 打开游戏内的管理员控制面板 GUI(实时模块开关、一键测试工具包、Flash Rush 触发器、裂隙生成、Webhook 测试、配置重载)
-
/shardpulse give <玩家> <SELL_AXE|DRILL|EXCAVATOR|TREE_CHOPPER|SPONGE_BUCKET|RESONATOR|JAMMER|DECOY_BEACON|PERSONAL_BOOSTER|GLOBAL_BOOSTER>
-
/shardpulse shards <give|take|set> <玩家> <数量> — 修改玩家的 Shards 余额
-
/shardpulse eco <give|take|set> <player> <amount> — 修改玩家金钱余额
-
/shardpulse rush — 手动触发 2.0x 闪购市场抢购
-
/shardpulse rift <here|random|stop> — 生成或清除紫水晶裂隙补给投放点
-
/shardpulse webhooktest — 向已配置的 Discord Webhook 发送测试嵌入消息
-
/shardpulse reload — 重新加载 config.yml 和 messages.yml,并刷新持久化数据
PlaceholderAPI 标识符
点击展开所有 PlaceholderAPI 占位符
%shardpulse_shards% / %shardpulse_shards_formatted% / %shardpulse_shards_compact%
%shardpulse_money% / %shardpulse_money_formatted%
%shardpulse_economy_mode% / %shardpulse_storage_mode%
%shardpulse_active_booster% — 玩家的综合活跃出售乘数(1.00x – 3.50x)
%shardpulse_bounty% / %shardpulse_bounty_formatted% / %shardpulse_has_bounty%
%shardpulse_rush_active% / %shardpulse_rush_items%
%shardpulse_price_<MATERIAL>% / %shardpulse_trend_<MATERIAL>%
%shardpulse_top_<shards|market|bounty|stash>_<1-10>_<name|value>% — 前 10 名全息图排行榜
需求与网络披露
- 服务器软件: Paper、Purpur(或 Paper 分支版本)以及 Folia(支持
1.21.1 至 26.3)。注意:由于 ShardPulse 使用了 Paper 的 Adventure MiniMessage 和 RegionScheduler API,因此不支持原版 CraftBukkit 和 Spigot。
- 可选依赖:
Vault(需搭配任意经济插件如 EssentialsX)和 PlaceholderAPI。
- 存储后端: 在
config.yml -> storage.type 中可选择 YAML(默认,无需设置)、SQLITE(本地 SQL 文件)或 MYSQL(用于跨服务器的 Velocity 同步)。从 YAML 切换到 SQLITE 或 MYSQL 时,会自动迁移现有的玩家余额和统计数据。
- 审计日志: 高价值市场交易、买入订单托管、赏金、裂隙认领和管理员发放记录将以异步方式记录到
plugins/ShardPulse/logs/economy-audit.log。
- 外部网络连接披露: ShardPulse 收集 零 遥测数据或分析信息。它仅在两个由管理员控制的功能中进行外部 HTTP 请求:
- Discord Webhook 警报 (
discord-webhook.enabled: false,默认关闭): 仅将游戏事件嵌入消息发送至服务器管理员在 config.yml 中明确配置的 Discord Webhook URL。
- Hangar 更新检查器 (
update-checker.enabled: true,hangar-project: "" 默认为空): 如果配置了项目标识符(project slug),则会对公共 Hangar API (hangar.papermc.io) 执行只读版本检查;也可随时通过设置 update-checker.enabled: false 来禁用此功能。
ShardPulse
Hardcore SMP economy, raid warfare, and PvP suite built for Paper, Purpur, and Folia across Minecraft 1.21.1 – 26.3 (Java 21 & Java 25).
Works standalone out of the box with its own dual-currency ledger (Money + ✦ Shards) or hooks automatically into Vault and PlaceholderAPI. Supports YAML, SQLite, and cross-server MySQL storage with automatic data migration.
Why Use ShardPulse?
Hardcore economy and raiding SMPs frequently run into three gameplay problems:
- Single-Farm Hyperinflation: Fixed
/sell prices allow one giant Cactus or Bamboo farm to print unlimited money forever.
- ESP & X-Ray Base Hunting: Legitimate raiders lack a skill-based in-game mechanic to locate underground bases, while defenders have no counter-play or trap mechanics.
- PvP Loot Scavenging & Bounty Farming: Unarmored bystanders steal gear mid-fight, and alternate accounts farm their own bounties.
ShardPulse solves all three in one modular, Folia-safe JAR without replacing your existing /ah, /shop, /tpa, or /home plugins. Every module can be hot-toggled in-game via /shardpulse admin.
Core Features
1. Market Pulse & Buy-Orders
Commands: /market, /orders, /appraise
- Dynamic Supply & Demand Pricing: Mass-sold commodities gradually drop toward a configurable floor (
0.60x), while scarce items climb toward a ceiling (1.65x) and recover organically over time.
- 2.0x Flash Market Rush: Periodically boosts 2 random commodities to a server-wide
2.0x sell multiplier.
- Shulker-Safe Quick-Sell Dropbox (
/market sell | /quicksell): Drop loose items or filled Shulker Boxes inside and close the menu to sell contents automatically—emptied Shulker Boxes and non-sellable items return safely to your inventory.
- Escrow Buy-Order Contracts (
/orders | /market orders): Lock cash in escrow to request bulk items (/orders create <material> <amount> <priceEach>). Other players fill orders directly from their inventory for instant payouts, while buyers collect delivered items anytime from their Personal Delivery Vault (/orders collect) or Shift + Right-Click to cancel and refund remaining escrow.
- Chunk Stash Appraiser (
/appraise | /stashworth): Scans containers, nested Shulker Boxes, and spawners in the current 16x16 chunk to calculate net worth, with an optional Verified Stash Flex chat broadcast that never leaks coordinates.
2. Amethyst Arsenal & Boosters
Commands: /amethyst, /amethyst shop, /shardpulse tip
High-tier utility tools and boosters purchased with ✦ Shards that remain unsealed, tradeable, and raidable until used:
- Zero-Bobbing Live Timer & Durability Engine: Tracks real-time
HH:MM:SS expiration and durability bars smoothly on Minecraft 1.21.1–26.3 without triggering held-item equip-bobbing animations.
- 5 Amethyst Power Tools:
- Amethyst Sell Axe: Left-click or interact with a Chest/Barrel to quick-sell market commodities inside (1.15x bonus), including items inside nested Shulker Boxes while leaving the Shulker Boxes intact.
- Amethyst 3x3 Drill (Pickaxe): Mines a
3x3 plane aligned to the targeted block face (Sneak for 1x1 precision) while respecting claim plugins, Bedrock, Spawners, and Containers.
- Amethyst 3x3 Excavator (Shovel): Excavates
3x3 earth/sand/gravel planes (Sneak for 1x1).
- Amethyst Timber Chopper (Axe): Fells connected tree logs up to 64 blocks in one swing.
- Amethyst Sponge Bucket: Reusable
5x5x5 water and lava clearing siphon with configurable cooldown.
- Unsealed Personal (
1.5x) & Global (2.0x) Sell Boosters: Tradeable booster crystals sold in /amethyst shop. Global Boosters display a live server-wide BossBar and allow players to run /shardpulse tip to reward the sponsor and earn free Shards (100% Mojang EULA compliant).
3. Raid Radar & Amethyst Rifts
Commands: /radar, /rift
- Echo Seismic Resonator (Raiders): Scans nearby loaded chunks (never force-loading chunks on Paper/Folia) and reports stash heat tiers plus compass direction without revealing exact XYZ coordinates.
- Sculk Signal Jammer (Defenders): Cloaks a configurable chunk radius (
3-chunk radius default) against enemy Resonator scans while fueled with Shards, alerting the online owner when a scan is blocked.
- Decoy Echo Beacon (Trap Builders): Deploys a Soul Lantern decoy (
75✦) that emits a fake Critical Mega-Stash radar signature to lure raiders into traps.
- Amethyst Rift Supply Drops (
/rift): Scheduled world PvP event spawning a locked Respawn Anchor cache with a sky beam and BossBar lock countdown, rewarding Shards, an Unsealed Amethyst Tool, and a Personal Sell Booster.
4. Bounties, Loot-Guard & Leaderboards
Commands: /bounty, /shardpulse top
- 15s Killer Loot-Guard: Protects PvP kill drops (including melee, projectile, and End Crystal kills) from third-party scavengers and hopper theft for 15 seconds without breaking item stacking.
- Anti-Abuse Blood Bounties (
/bounty): Enforces listing tax (8%), same-IP alt-account blocking, and pair claim cooldowns (30m), dropping stamped Player Trophy Skulls on PvP kills.
- Top 10 Player Skull Leaderboards (
/shardpulse top): Interactive 4-tab GUI (Top Shards, Market Tycoons, Bounty Hunters, Biggest Stashes) plus hologram PlaceholderAPI tags.
Commands & Permissions
| Command |
Aliases |
Permission |
Description |
/shardpulse [top|tip|admin|...] |
/spulse |
shardpulse.use / shardpulse.admin |
Overview, Top 10 Leaderboards (top), Booster Tip (tip), & Admin Control GUI |
/amethyst [shop|status|...] |
/shards, /shardshop |
shardpulse.use |
View Amethyst subcommands, open the Shard Shop (/amethyst shop), & inspect tools |
/market [sell|orders] |
/pulse, /priceindex, /quicksell |
shardpulse.use |
Open Live Market Ticker, Quick-Sell Box (sell), or Buy-Orders (orders) |
/orders [create|collect] |
/buyorders |
shardpulse.use |
Escrow Buy-Order Contract Board & Personal Delivery Vault |
/appraise |
/stashworth, /chunkworth |
shardpulse.use |
Appraise container, nested Shulker, and spawner net worth in current chunk |
/radar |
/jammer, /seismic |
shardpulse.use |
Open Echo Resonator, Decoy Echo Beacon, & Sculk Signal Jammer menu |
/bounty [add <player> <amount>] |
/bounties, /headhunt |
shardpulse.use |
Open Blood Bounty Board or place a bounty |
/rift [status|here|random|stop] |
/supplydrop, /amethystrift |
shardpulse.use / shardpulse.admin |
Check active Amethyst Rift coordinates/timer or spawn/stop a Rift |
Admin Subcommands (shardpulse.admin)
/shardpulse admin — Open the in-game Admin Control Panel GUI (live module toggles, 1-click test kit, Flash Rush trigger, Rift spawn, webhook test, config reload)
/shardpulse give <player> <SELL_AXE|DRILL|EXCAVATOR|TREE_CHOPPER|SPONGE_BUCKET|RESONATOR|JAMMER|DECOY_BEACON|PERSONAL_BOOSTER|GLOBAL_BOOSTER>
/shardpulse shards <give|take|set> <player> <amount> — Modify player Shards balance
/shardpulse eco <give|take|set> <player> <amount> — Modify player Money balance
/shardpulse rush — Manually trigger a 2.0x Flash Market Rush
/shardpulse rift <here|random|stop> — Spawn or clear an Amethyst Rift supply drop
/shardpulse webhooktest — Send a test embed to your configured Discord webhook
/shardpulse reload — Reload config.yml and messages.yml and flush persistent data
PlaceholderAPI Identifiers
Click to expand all PlaceholderAPI placeholders
%shardpulse_shards% / %shardpulse_shards_formatted% / %shardpulse_shards_compact%
%shardpulse_money% / %shardpulse_money_formatted%
%shardpulse_economy_mode% / %shardpulse_storage_mode%
%shardpulse_active_booster% — Player's combined active sell multiplier (1.00x – 3.50x)
%shardpulse_bounty% / %shardpulse_bounty_formatted% / %shardpulse_has_bounty%
%shardpulse_rush_active% / %shardpulse_rush_items%
%shardpulse_price_<MATERIAL>% / %shardpulse_trend_<MATERIAL>%
%shardpulse_top_<shards|market|bounty|stash>_<1-10>_<name|value>% — Top 10 hologram leaderboards
Requirements & Network Disclosure
- Server Software: Paper, Purpur (or Paper forks), and Folia (
1.21.1 through 26.3). Note: Vanilla CraftBukkit and Spigot are not supported because ShardPulse uses Paper's Adventure MiniMessage and RegionScheduler APIs.
- Optional Dependencies:
Vault (plus any economy provider such as EssentialsX) and PlaceholderAPI.
- Storage Backends:
YAML (default, zero setup), SQLITE (local SQL file), or MYSQL (cross-server Velocity sync) in config.yml -> storage.type. Switching from YAML to SQLITE or MYSQL automatically migrates existing player balances and stats.
- Audit Logging: High-value market sales, Buy-Order escrows, bounties, Rift claims, and admin grants are logged asynchronously to
plugins/ShardPulse/logs/economy-audit.log.
- External Network Connections Disclosure: ShardPulse collects zero telemetry or analytics. It makes external HTTP requests only in two administrator-controlled features:
- Discord Webhook Alerts (
discord-webhook.enabled: false by default): Sends game event embeds solely to the Discord Webhook URL explicitly configured by the server administrator in config.yml.
- Hangar Update Checker (
update-checker.enabled: true, hangar-project: "" blank by default): Performs a read-only version check against the public Hangar API (hangar.papermc.io) only if a project slug is configured, and can be disabled anytime by setting update-checker.enabled: false.
评论 0
登录后参与评分
还没有评论,来抢沙发吧