CorporationMines Enterprise Edition v1.4.2.0

v1.4.1.2 — Bug Fix Patch
May 2026​

---

Three bugs. All fixed. Ship it.
A targeted hotfix patch addressing a HUD crash, voucher spam, and economy routing inconsistencies.​

---

✦ FIXED — HUD Action Bar Crash

• Root Cause — Paper 1.21 removed the legacy sendActionBar(String) method entirely. The HUD task was throwing a NoSuchMethodError every tick for every online player
• Fix Applied — Now uses the Adventure Component API via LegacyComponentSerializer — the correct method for all Paper 1.21+ servers

✦ FIXED — Voucher Redemption Spam

• Root Cause — Paper fires PlayerInteractEvent twice per click (once per hand). Without a hand guard, every voucher redemption dispatched its reward commands twice — producing duplicate payment messages in chat
• Fix Applied — Added a EquipmentSlot.HAND check at the top of the interact handler. Redemption now fires exactly once per click

✦ FIXED — Economy Routing Inconsistencies

• balance(UUID) — Was always reading from the internal economy even when a Vault provider was hooked. Now correctly routes through Vault for offline player balance lookups
• setBalance() — Was always writing to the internal economy, ignoring Vault entirely. Now diffs the current vs target balance and uses Vault's deposit/withdraw to set it cleanly
• Startup Clarity — The server console now logs exactly which economy mode is active on boot: Vault provider name if hooked, or a clear fallback notice if using the built-in prison economy

⛏ CorporationMines — Patch Notes​

---

⚔ v1.4.1 — Cell Riot Event
May 2026​

---

The streets are about to run red.
We've added the most chaotic event CorporationMines has ever seen.​

---

✦ NEW — Cell Riot Event

Every 20 minutes, the server selects a random online player's cell and throws open the gates. For 5 minutes, every rule inside that cell is off the table.

• Warning System — The cell owner receives a 5-minute advance warning with a screen title, sound effect, and a server-wide chat broadcast so they can prepare — or run
• PvP Override — All PvP protection inside the riot cell is suspended for the duration. Anyone can fight anyone, no exceptions
• Ban Override — Cell bans mean nothing during a riot. Banned players can freely enter the cell while the event is active
• /riot Command — Any player on the server can type /riot to instantly teleport into the chaos
• Boss Bar Countdown — A live countdown boss bar is shown to all online players for the full duration, overriding mine-reset bars
• Live Kill Scoreboard — Players inside the riot cell see a real-time kill leaderboard showing the top fighters. Players outside see their normal scoreboard unaffected
• Respawn System — Participants who die during the riot are sent back to the riot cell spawn to keep the fight going
• Winner Reward — The player with the most kills when time expires receives 50,000 tokens + 5,000 tokens per kill as a reward, delivered instantly
• Champion Announcement — The winner and their reward are broadcast to the entire server in chat

✦ Full Cleanup on End

• Boss bar is removed from all players immediately
• Scoreboards revert to the normal mine scoreboard
• PvP protection and cell bans are fully restored to their original settings
• Next riot is automatically scheduled

---

✦ Technical Changes

• New RiotEvent class — encapsulates all riot state (cell, kills, boss bar, timers)
• New RiotManager — handles full lifecycle: scheduling, warnings, launch, countdown, scoreboard updates, end, and reward distribution
• New RiotListener — tracks kills, manages respawns, and handles player join/quit during active riots
• New /riot command registered in plugin.yml
• BossBarManager — added suppress/release logic so riot bar takes priority without permanently overriding other bars
• ScoreboardManager — added suppress/release per player so the riot scoreboard only shows to in-cell participants
• CellSettingsListener — patched to respect riot overrides for both PvP damage and banned player movement

---

CorporationMines v1.4.1 — Paper 1.21.1 — Java 21​

v1.4.0.5 — Anticheat IP Censor & /view Command
Earlier 2026​

---

Staff tools sharpened. Chat leaks sealed.
Two quality-of-life improvements to moderation and the market system.​

---

✦ UPDATED — IP & Domain Censor

• Smarter IP Detection — IP addresses and domains sent in chat are now replaced with *** instead of cancelling the entire message. Players get a warning, chat still flows
• Staff Alerts Preserved — Staff members with the correct permission still receive a private alert containing the original uncensored content so moderation context is never lost

✦ NEW — /view Command

• Command Conflict Resolved — Staff spectate has been moved from /watch to /view <player> to eliminate the conflict with the market price alert system
• /view stop — Exit spectate mode cleanly at any time
• Updated Docs — EN-US.yml, plugin.yml, and COMMANDS_AND_FEATURES.md all updated to reflect the rename

---

v1.4.0.4 — Chat Filter & Minion Fix
Earlier 2026​

---

Smarter chat. Honest minions.
Two longstanding issues finally put to rest.​

---

✦ FIXED — Chat Filter

• Word Boundary Detection — The swear word filter has been fully reworked to use proper word boundary checks. Words like "pass" no longer trigger a false positive
• Censor Instead of Block — Detected words are now replaced character-by-character with * asterisks rather than blocking the entire message from being sent. Chat flows naturally

✦ FIXED — Minion Inventory

• Root Cause Identified — Tier 8+ minions have auto-sell enabled, which silently converts collected drops directly into money. This is why the inventory appeared empty — it was working correctly
• Transparency Added — Minions now send their owner a periodic chat notification when auto-sell fires: "Your minion auto-sold 47 items for $12.35." No more mystery

---

CorporationMines — Paper 1.21.1 — Java 21​

v1.4.0.4 — Minion Feed System & Inventory Fix
May 2026​

---

Your minions were starving. Not anymore.
A broken inventory and a missing care system — both handled.​

---

✦ FIXED — Minion Inventory

• Inventory Desync Resolved — Minion inventories were not displaying or updating correctly for the owning player. The internal storage state is now properly synced on every interaction and GUI open
• No Data Loss — All previously stored items in affected minion inventories are fully intact

✦ NEW — Minion Feed System

• Care Book — A new consumable item used to feed your minions and keep them productive. Obtained through gameplay and the token shop
• Feeding Mechanic — Right-click your minion with a Care Book to feed it. A well-fed minion operates at full efficiency
• Starvation Consequences — Minions that go unfed will slow down and eventually halt production until fed again, adding a new layer of active management to the minion system

v1.4.0.3 — Minion Pathfinding Hotfix
May 2026​

---

Your miner was not mining. Now it is.
A quick but critical fix pushed to production.​

---

✦ FIXED — Minion Stuck at Mine Bottom

• Root Cause — Minions were reaching the bottom layer of the mine, running out of valid blocks to target, and entering an idle loop with no recovery logic to reposition themselves
• Fix Applied — Minions now detect when no minable blocks are reachable from their current position and automatically relocate to a valid area within the mine region
• No More Frozen Minions — Affected minions will resume normal mining behavior without requiring the owner to manually pick up and replace them

[/LIST]

---

⚙ v1.4.0.2 — Mining Minion System Overhaul
May 2026​

---

10 tiers. Infinite grind. Your mine never sleeps.
The full Mining Minion system has been completely overhauled and rebuilt from the ground up.​

---

✦ BlackMarket Exclusive

• No Free Handouts — Minions cannot be obtained through commands. Players attempting /minion give are redirected to /blackmarket
• 5 Rotating Offers — Tiers 1, 3, 5, 7, and 10 rotate in the BlackMarket, priced in tokens via config.yml
• Auto-Deploy — On purchase, the minion spawns directly inside the buyer's private mine — no setup required

✦ 10 Unique Tier Effects

Each tier unlocks a permanent, stackable effect on top of all previous tiers:

• Tier 1 — Basic Mining
• Tier 2 — Lucky Miner — passive Fortune bonus on every break
• Tier 3 — Auto-Smelt — iron/gold smelted to ingots, logs to charcoal, automatically
• Tier 4 — Swift Digger — +25% movement speed while working
• Tier 5 — Silk Touch — blocks drop in their original form
• Tier 6 — Area Mining — 15% chance to break in a 2×2 pattern per swing
• Tier 7 — Deep Diver — +3 block detection radius
• Tier 8 — Auto-Sell — drops are sold instantly for money, bypassing storage entirely
• Tier 9 — Explosive Mining — 10% chance for a full 3×3×3 blast per break
• Tier 10 — Master Miner — all effects active simultaneously, glowing aura, 50% faster mining speed

✦ OmniTool Scaling

• Passive Scaling — Minions inherit the owner's held OmniTool enchantments passively
• 1/50th Formula — Fortune and Efficiency scale at 1/50th the OmniTool level. A Fortune 50 pickaxe gives the minion +1 effective Fortune
• Upgrade to Power Your Minion — Every OmniTool upgrade directly benefits your deployed minions

✦ Storage System

• Dedicated Inventory — Each minion has its own internal slot-based storage, items auto-stack up to 64 per slot
• Scales with Level — Tier 1 starts with 9 slots, Tier 10 reaches 99 slots
• Color-Coded Fullness — Storage display shifts green → yellow → red as the minion fills up
• Auto-Deliver — When storage is full and the owner is online, the minion delivers items directly to their inventory
• Auto-Sell Bypass — Tier 8+ minions skip storage entirely, selling all drops for money the moment they're collected

✦ Collection

• /minion collect — Instantly pulls items from all your minions into your inventory in one command
• Collect All Button — "Collect All Items" button added to the Minion Upgrade GUI for one-click collection
• Overflow Handling — Items that don't fit in your inventory are dropped at your feet, never lost

✦ Mine-Only Enforcement

• Hard Boundaries — Block scanning is clamped to the owner's private mine region (minX/Y/Z → maxX/Y/Z). Minions physically cannot walk or target blocks outside the mine
• Auto-Snap — If a minion somehow ends up outside the mine, its position snaps to the mine center on the next tick
• Mine Reset Sync — When the mine resets, all deployed minions immediately clear their current target, reset their arm animation, and pick a fresh block from the newly regenerated mine

✦ Upgrade GUI Integration

• OmniTool GUI Button — A new Minion Upgrades button (slot 1) has been added to the OmniTool Upgrade GUI
• 36-Slot Minion Panel — Opens a dedicated GUI showing all owned minions with live storage stats per minion
• Click to Upgrade — Click any minion to upgrade it. Cost: level × $5,000. Max level: 10

✦ Commands

• /minion list — View all your minions with live storage percentages
• /minion upgrade — Open the Minion Upgrade GUI
• /minion collect — Collect items from all minions at once
• /minion give <player> <level> — Admin only
• /minion remove <player> — Admin only

🛡 v1.4 — WARDEN Anticheat
May 2026​

---

Cheaters don't belong here. WARDEN makes sure of it.
A fully configurable, lightweight anticheat system built from scratch — designed to catch exploiters without punishing legitimate players.​

---

✦ Movement & Flight Detection

• Fly Detection — Catches illegal flight, hover, and vertical climb exploits. Automatically exempts creative mode, elytra, levitation, vehicles, and players with the corporationmines.fly permission
• NoFall — Flags players taking zero fall damage from significant drops
• Jesus / WaterWalk — Detects players walking on water surfaces without a boat
• ElytraFly — Monitors glide speed and altitude gain for abnormal exploit patterns
• Velocity / AntiKB — Detects players cancelling or ignoring knockback after taking damage

✦ Combat Detection

• AutoClicker — Tracks CPS with consistency analysis to distinguish auto-clickers from fast legitimate players
• Reach — Measures attack distance on every hit with built-in lag tolerance to avoid false flags on high-ping players
• KillAura — Detects unrealistic angle snapping between successive hits — a clear KillAura fingerprint

✦ World & Block Detection

• FastBreak — Detects impossible mining speeds. Fully supports Efficiency enchantments up to level 10 and respects active Haste potion effects — zero false positives on legitimate miners
• X-Ray — Rolling window analysis of ore-to-stone break ratios to identify statistical impossibilities
• Scaffold / Tower — Detects auto-placing blocks beneath the player while moving horizontally or vertically
• Anti-Nuke — NEW — Tracks mass TNT placement, ignition spam, and explosion chain events within configurable time windows

✦ Smart Exemptions — Anti False-Positive

• Teleport & Warp Grace Period — Movement checks are automatically suspended after any teleport or warp to prevent instant false flags
• Purchased Fly Support — Players with the corporationmines.fly permission are silently exempt from all fly detection
• Potion Awareness — Haste (FastBreak), Speed (movement), and Jump Boost (Fly) are all factored in per-check before flagging
• Creative & Bypass — Creative mode exemption and a global corporationmines.anticheat.bypass permission, both configurable per-check

✦ Staff Tools

• Violation Logging — Every flag, kick, and tempban is written to anticheat-violations.log with player name, check name, violation level, location, and reason
• Live Staff Alerts — Real-time ⚔ WARDEN branded notifications pushed to all online staff the moment a player is flagged
• /watch Command — Staff can vanish, enter spectator mode, and teleport to any player for live monitoring. Other online staff are notified when a watch session begins

✦ Configuration

Every detector has its own section in anticheat.yml:

• enabled — toggle any check independently
• threshold — violation count before action is taken
• check-interval-ticks — CPU control per detector. Lower = more accurate, higher = lighter load
• Check-specific settings — max speeds, window sizes, grace periods, and more
• Global actions — notify-at, kick-at, tempban-at, tempban-duration, violation decay rate, and staff permission node

✦ Permissions

• corporationmines.anticheat.bypass — Global bypass for all anticheat checks
• corporationmines.fly — Fly command access and automatic fly detection exemption
• corporationmines.staff — Receive live alerts and access /watch

v1.3 — Shops, Skills & Quality of Life
Earlier 2026​

---

Smarter commands. Livelier shops. A skill tree worth clicking.
A wide-ranging quality of life update touching commands, the market, skills, player shops, and the in-world shopkeeper.​

---

✦ Commands & Aliases

• /kits — Added as a direct alias for /kit
• /money give — Now treated as a full alias for /money add
• /eco — Full alias for the entire /money command set

✦ Shop & Market

• Market Button — /shop now features a Market button with proper back navigation to return to the main shop
• Tip Cost in Lore — Market tip cost is now clearly displayed in the item lore so players know what they're spending before buying
• Placeholder Fix — Fixed a %s placeholder error causing a raw format string to appear in market tip messages

✦ Skills

• Rank & Prestige Tree — /skills now displays the full rank and prestige progression tree alongside upgrades
• Skill Tree Button — New dedicated Skill Tree button opens the point-buy upgrade panel directly from the skills menu

✦ Shopkeeper

• New Entity — The shopkeeper NPC has been changed to an Iron Golem with the custom name 【MINE SHOPKEEPER】
• Player Tracking — The shopkeeper now rotates to look at nearby players, making it feel alive in-world

✦ Player Shops

• Chest Shop Item — A placeable Chest Shop item has been added to the token shop for 15,000 tokens — place it anywhere to instantly open configuration
• Custom Item Names — Shop signs and holograms now correctly display custom item names, including NBT display names and named books
• Hologram Sway — Displayed hologram items now face the shop sign with a gentle idle sway animation

✦ Fixes

• Specialization Placeholder — Fixed a raw %s placeholder appearing in specialization-related messages — replaced with the correct %spec% token
• Chat Prefix — Server chat prefix updated from the old format to 【MINES】