offerings v1.4.3

this release adds multiblock ritual forge visual overhaul to the forge for all of your offering identification needs

add claim commands and aliases:

• /offerings claim (aliases in subcommand: draw, roll)(aliases: open-crates, openall, open-all)
• /offerings opencrates

Offerings — Premium Daily Kit Lottery​

Version 1.1.0 · Minecraft 26.2 · Paper/Spigot · Java 25​

Weighted rarity rolls. Physical reward crates. Full in-game admin. Optional misfortune — never death.​

What is Offerings?​

Offerings turns your daily stipend into a real loot experience. Players claim weighted draws through polished chest menus — rarity tiers, nested loot tables, streak milestones, lifetime achievements, and a full identify → unlock → open crate pipeline so rewards stay hidden until players earn them.

Server owners manage everything in-game: kits, tables, tier odds, permission gates, crate policy, and roll modes. Changes apply live for online players and save to YAML automatically.

What's New in 1.1.0​

• Penalty & curse rolls — separate misfortune draws per claim; toggle reward vs penalty rolls independently; debuff kits across all six tiers (mobility, combat, survival, visual, resource, curse). Health never drops below one heart.
• Physical crate pipeline — unidentified crates from daily draws → smelt in an Identification Forge → craft tier keys to unlock Rare+ crates → open with a reel animation for payout.
• Identification Forge — placeable smoker station, portable forge item, in-game crafting guides, and /offerings identify / /offerings guide.
• Configurable smelt timing — admin menu for base cook time, automatic tier curve (Common fast → Mythic ~30 min), or per-tier manual overrides; tier is rolled when smelting starts so each crate cooks at the right speed.
• Crate keys — Rare, Epic, Legendary, and Mythic locking; shapeless unlock recipes in the crafting guide; admin /offerings givekey.
• Personalized hub odds — spyglass tooltip shows your renormalized tier percentages based on what you can actually roll (gated tiers excluded).
• Player directory — browse any player's streak, milestones, and achievements (/offerings players, offerings.lookup).
• Unified menu controls — consistent close, back, and page buttons across every player and admin chest menu.
• Expanded admin — Roll Modes, Crate Policy, Smelt Timing, Give Items, Player Cooldowns, Hub Aliases, Content Health, broadcast reminders.
• Bundled curse catalog — per-tier curse kits, penalty loot tables, and expanded loot tables across the split loot/ catalog.

Spoiler: Core daily draw — how it works

1. Player claims when cooldown is clear (/offerings, /daily, /stipend, or custom hub aliases).
2. Tier roll — weighted pick from Common → Uncommon → Rare → Epic → Legendary → Mythic (10,000-point pool; Legendary ≈ 0.04% per roll by default).
3. Pool roll — weighted kit or loot table at that tier.
4. Payout — console commands + custom items; nested loot-table: refs can delegate to sub-pools.
5. Optional penalty rolls — separate curse draws when enabled.
6. Stats update: streak, milestones, achievements, lifetime counters — saved to YAML or SQLite.

Spoiler: Crate pipeline — unidentified → identify → unlock → open

1. Unidentified — earned from draws; lore scrambled; cannot be opened.
2. Identify — smelt in an Identification Forge; fuel + cook time reveals tier and kit.
3. Unlock — Rare+ tiers (when locking is on): craft crate key + identified crate.
4. Open — right-click reel UI, shift+right-click a stack, or hub Open All Crates for every ready crate.

Identification can be toggled off (instant identified crates on claim). Per-tier key locking is configurable per tier. Full walkthrough in the in-game Crafting Guide.

Spoiler: Player features

• Daily hub — claim draw, cooldown timer, personalized tier odds, stats summary
• Reward catalog — browse kits and loot tables you are allowed to see
• Streak milestones — 1,095 days of attendance rewards (3-year bundled catalog)
• Achievements — 13 default lifetime trophies (claims, kits, streaks, unique kits, tier rolls); hidden mythic achievement included
• Crafting guide — visual recipes for forge, keys, unlock crafts, and crate flow
• Open All Crates — batch-open every identified / unlocked crate in inventory
• Player directory — paginated head index with read-only profiles

Spoiler: Admin & configuration — no restart required

• Admin hub — /offerings admin
• Reward kits — unlimited; tier, weight, commands, lore, custom items, loot-table refs, view/roll permissions; filter rewards vs penalties
• Loot tables — weighted sub-pools; reward or penalty pool type
• Custom items — enchants, lore, /give import (chat or loot/items/)
• Tier rarity — live weight editing with odds display
• Tier permission gates — LuckPerms view vs roll per tier
• Claim cadence — rolls per claim, cooldown hours, streak grace
• Roll modes — enable/disable reward rolls and penalty rolls; penalty roll count
• Crate policy — identification on/off, per-tier key locking, smelt timing entry
• Smelt timing — base ms, automatic curve, mythic anchor (~30 min), per-tier manual overrides
• Give items — grant forges, keys, unidentified crates to players
• Player cooldowns — lookup, per-player reset, server-wide reset
• Hub aliases — extra commands that open the player hub (e.g. gamble, slots)
• Chat reminder — recurring clickable broadcast when draws are ready
• Content health — validates materials, refs, PlaceholderAPI tokens, broken commands; faulty kits excluded from rolls
• Live persist — every GUI edit saves YAML immediately; /offerings reload only after hand-editing files on disk

Spoiler: Permission gating — three layers

• Tier gates — control who sees and who can roll each rarity band
• Kit gates — per-kit view-permission and roll-permission
• Table gates — same for loot tables
• offerings.bypass — ops see and roll everything

Ungated content stays visible; only restricted entries are hidden. Gates stack: a kit still needs its tier gate even without a kit-level node.

Spoiler: Data & catalog

• Split YAML under loot/kits/, loot/items/, loot/tables/ — tier-scoped files, unlimited entries
• loot/kits/custom.yml — your server kits (custom_ prefix, never overwritten on upgrade)
• milestones/days-*.yml — 3-year attendance catalog
• achievements.yml — lifetime trophy definitions
• config.yml — odds, cooldowns, crate policy, roll modes, storage, messages
• Player progress: players.yml (default) or SQLite data.db with auto-import

Spoiler: Commands

Players

• /offerings — daily hub (/offer, /rewards, /daily via aliases)
• /stipend — hub (/pay, /salary)
• /offerings catalog — reward catalog
• /offerings milestones — streak board
• /offerings achievements — lifetime stats
• /offerings players — player directory
• /offerings identify — open nearest forge
• /offerings guide — crafting & crate flow guides

Admin

• /offerings admin — management hub
• /offerings rollmodes — reward vs penalty toggles
• /offerings givekey <player> <tier> [amount]
• /offerings giveforge [player]
• /offerings identify <player> — instant identify inventory
• /offerings reset <player> · /offerings resetall
• /offerings reload

Spoiler: Permissions

• offerings.use — hub, claim, catalog, achievements, guides (default: true)
• offerings.lookup — player directory (default: true)
• offerings.admin — admin hub & tools (default: op)
• offerings.bypass — bypass all gates (default: op)

Spoiler: PlaceholderAPI (optional)

Expansion offerings — works when PlaceholderAPI is installed; safe fallback when absent.

• %offerings_streak% · %offerings_best_streak%
• %offerings_total_claims% · %offerings_total_kits% · %offerings_total_penalties%
• %offerings_unique_kits% · %offerings_rolls_<tier>%
• %offerings_pending_rewards% · %offerings_pending_penalties%
• %offerings_can_claim% · %offerings_cooldown_formatted% · %offerings_cooldown_seconds%
• %offerings_milestones_claimed% · %offerings_milestones_total%
• %offerings_achievements_earned% · %offerings_achievements_total%
• %offerings_rolls_per_claim% · %offerings_kits_total% · %offerings_tables_total% · %offerings_items_total%

Use in kit lore, messages, and scoreboards.

Spoiler: Requirements & integrations

Required

• Paper or Spigot
• Minecraft 26.2
• Java 25

Soft dependency

• PlaceholderAPI (optional)
• LuckPerms (optional — for permission gates)

Integrations

• Console commands: on kits, milestones, achievements (%player%)
• Economy and other plugins via command hooks
• Essentials-style /give import for custom items

Why server owners choose Offerings​

• Data-driven — unlimited kits and tables; no hard caps
• In-game first — rarely touch YAML unless you want to
• Deep gates — VIP preview without roll access, per-kit secrets, tier bands for ranks
• Risk without grief — optional curse rolls that sting but never kill
• Anticipation — unidentified crates and forge smelting add ceremony to payouts
• Production-ready catalog — supplies, gear, curses, keys, and curated tables ship bundled

Daily draws worth showing up for — configured in minutes, tuned for months.​