Sarcina (In-Depth)

The Three Upgrade Paths — At a Glance

All three are independent — your Capacity level has no effect on your Autosell or Multiplier level, and each has its own cost curve. You can spend tokens on any of the three at any time, in any order.

Capacity — The Doubling Curve

Formula

capacity(level) = capacityBase × 2^level
where capacityBase = 100 (config: pouches.default_capacity) and the level is bounded to [0, 60] (config: pouches.max_capacity_level).

cost(level) = capacityCostBase × 2^(costExponent × (level-1))
where capacityCostBase = 10,000 (config: pouches.upgrade_cost_base), costExponent = 2 (config: pouches.upgrade_cost_exponent), and the (level-1) exponent is capped at 22 in code so costs plateau rather than overflow.

Level-by-Level

Autosell — Halving Intervals to Instant

Formula

autosellTicks(level) = 6000 ticks >> (level-1) — equivalent to 6000 / 2^(level-1). At 20 ticks/second, that's 300 s / 2^(level-1).

If the resulting interval drops below 20 ticks (1 second), the value is replaced with -1, which the autosell scheduler treats as "instant" (sells on every block insert, no timer).

cost(level) = autosellCostBase × 2^(level-1)
where autosellCostBase = 50,000 (config: pouches.autosell_cost_base) and the (level-1) exponent is capped at 40.

Level-by-Level

How the Timer Fires

A repeating task runs every 1 second (20 ticks) server-wide. For each online player, it reads the player's autosell level, computes the interval in ms, and triggers a sell if now - lastAutosell ≥ intervalMs. The instant path (level ≥ 10) skips the timer entirely and sells on block insert.

For manual mode (level 0), the Sarcina still auto-sells for you — but on a 2-second cooldown per player to avoid spamming the economy deposit pipeline on fast-mining hot loops. This is what makes /sellall largely optional even without autosell purchased.

Multiplier — Linear Sell Bonus

Formula

multiplier(level) = 1 + level × 0.01
So level 1 = 1.01×, level 10 = 1.10×, level 100 = 2.00×. The bonus is a flat add to the gross sell value, applied before tax.

cost(level) = multiplierCostBase × 2^(level-1)
where multiplierCostBase = 10,000 (config: pouches.multiplier_cost_base) and the exponent is capped at 40.

Level Breakpoints

The Full Sell Calculation — Step by Step

When the Sarcina sells (whether manual /sellall or autosell), the manager runs the following pipeline. Each step is applied in order:

1. Sum block values. For each (material, count) in the backpack snapshot, multiply the block's unit value (from MineManager.getBlockValue) by the count and sum everything to get total. If total ≤ 0, the sell is a no-op.
2. Apply Sarcina multiplier. multiplier = 1 + (multiplierLevel × 0.01).
3. Apply mine-fortune upgrade. If you have a public-mine fortune upgrade stored, multiply the running multiplier by fortuneMultiplier().
4. Apply the EconomyModifierPipeline. This folds in your rank, prestige, pet, crystal, booster, donor, and event multipliers — the entire economy stack. Call pipeline.getMultiplier(player, DENARIUS) and multiply it in.
5. Compute gross. gross = max(0.01, total × multiplier). The floor prevents zero-value sells from creating dead ledger entries.
6. Compute tax. tax = round(gross × 0.05 × 100.0) / 100.0 — 5% of gross, rounded to the cent (two decimal places).
7. Contribute tax to the seasonal pool. serverTaxPoolService.contribute(tax) — the tax vault pays out during festivals.
8. Net deposit. net = gross − tax, deposited as Denarius with reason backpack:sell (auto) or backpack:sell_explicit (manual).
9. On success only — clear the backpack. The snapshot is held until the deposit confirms. If the deposit fails, blocks are not lost — the backpack keeps its contents and you can retry.
10. Update player stats. The net amount is added to your totalEarned stat (used by leaderboards and stats).

Worked Example — A Mid-Game Sell

Suppose you have a Sarcina with multiplier level 5, a mine fortune upgrade of 1.20×, a rank+prestige+pet economy pipeline of 3.50×, and you sell a backpack containing:

• 1,500 stone @ $1 = $1,500
• 200 iron ore @ $8 = $1,600
• 40 diamond ore @ $50 = $2,000

Total block value: $5,100.

The boost summary line will read: Sell Boost: +375% (Sarcina +5% | Prestige +X% | Rank +Y%). Note that the Sarcina-only contribution is small here — the rank and prestige multipliers dominate. That's why Sarcina multiplier upgrades are not the highest-priority spend for most players.

How Blocks Enter the Backpack

addBlock(uuid, material, amount) is called by every block-break code path — the listener that suppresses normal drops, the enchant proc that breaks extra blocks, the pickaxe-skin ability, the mass-detonate ability, and the public-mine listener. The function:

1. Skips zero-value blocks — if MineManager.getBlockValue(material) ≤ 0, returns true (block is "accepted") but doesn't store it. This is why some blocks (like grass in a non-grass-valued mine) just vanish silently.
2. Checks capacity — if current + amount > capacity, returns false. The caller then drops the block normally into the world so it isn't destroyed.
3. Otherwise stores — merges into the per-material map and increments the cached totalBlocks counter (kept current for O(1) capacity checks).
4. If autosell is instant (level ≥ 10), schedules a synchronous sellAll(player) on the next tick. Otherwise, in manual mode, schedules a sell on a 2-second per-player cooldown so fast-mining loops don't spam deposits.

The 60-Second Mining Summary

Every 60 seconds (1,200 ticks) the Sarcina sends a chat summary of the previous minute's activity while you were mining. It tracks nine independent counters and resets them after sending:

The summary only fires if at least one counter is non-zero, so AFK players don't get spammed. Use it to compare mining spots, test build changes, and detect when an enchant proc rate is too low (Enchants line near zero means your build isn't firing).

The Sarcina Item

The Sarcina exists as a physical Ender Chest item in your inventory. It carries a NamespacedKey tag with your UUID, making it soulbound — another player who picks it up cannot use it to access your blocks. Right-click it to open the backpack view.

The giveBackpackItem(player) helper checks whether you already have one (by scanning for the PDC tag) before granting, and drops it on the ground at your location if your inventory is full — so you never end up with two Sarcinas and never lose one to a full inventory.

Persistence & Reload Safety

• The backpack is stored in backpack_data as JSON: levels for the three upgrade paths, plus a blocks_json map of material → count.
• Saves happen on quit, on every successful sell, and on every upgrade purchase. The save uses an UPSERT (UPDATE ... WHERE uuid=? with a fallback INSERT if 0 rows updated) so a missing row never corrupts state.
• On shutdown, all in-memory backpacks are flushed synchronously — even quit-during-save races don't lose blocks.
• The schema is created on enable with SchemaBuilder; no manual migration is needed.

Optimal Token-Allocation Strategy

The right answer depends on your goal — but for most players, the priority order is:

1. Capacity Lv 3 → 5. 160K–2.56M tokens total. Removes the "backpack full" interruption without breaking the bank.
2. Autosell Lv 3 → 5. 200K–800K additional. A 19–75 second sell interval is enough for any mining loop.
3. Multiplier Lv 5. 160K total for +5% on every sell. Pays back fast on high-value ores.
4. Autosell Lv 10 (instant). 25.6M total — the long-term quality-of-life breakpoint. This is the "mining becomes pure block-breaking" upgrade.
5. Multiplier Lv 10–20. 5M–5B total for +10–20%. Stack this once your pipeline multiplier is high enough that the +X% matters.
6. Capacity Lv 10+. Only if you're mining AFK with mass-detonate abilities — the excess capacity prevents overflow during burst windows.

Configurable Defaults

All four base costs and the capacity exponent are read from config.yml at plugin enable. If your server has tuned them, the numbers above change accordingly. The relevant keys:

Quick Reference