Energy and gems economy
Complete guide to the eight standard gems of SunshineGems: energy states, Energy Bottle mechanics, workshop recipes, and secure trading rules.
On this page
ADMIN_ONLY mode. Blood Moon, Dragon Games, pedestal rituals and the PUBLIC player flow do not open until the live release gates pass. This page deliberately separates the questions “what exists in the code?” and “can everyone use it right now?”What exactly is SunshineGems?
SunshineGems is not a single “powerful item”; it is a custom Paper plugin that unites the gem type a player picks, a 0–10 energy pool, two tiers of abilities, passive bonuses, the energy economy and their safe delivery under one game system. The goal is that while the gem looks like an item, the real source of truth is a reliable, auditable player record.
Gem item
The model and lore in the inventory show the player which gem they carry. The PDC id and type/tier match are verified; copied or foreign items are not considered valid.
Player record
Type, T1/T2, energy, cooldowns, trust, pocket, progression and ritual states are kept in SQLite. Lore is display only; it is not authority.
Ability engine
Right-click, sneak right-click, passive ticks and damage gates all pass through a single pipeline: if the world, state, cooldown, trust/protection or resource checks fail, no effect is applied.
Gem item → player record → energy/state → ability gate → visual/audit. If any link in this chain is unreliable, the system fails closed.What do you do in the first five minutes?
Open the menu
/gemmain hub opens the Sunshine Gem menu. Your first choice can be used once and is permanent.
Pick a standard gem
/gem secfree first choice opens a screen where you choose Astra, Fire, Flux, Life, Puff, Speed, Strength or Wealth. The first choice does not grant a second gem; you will need a Gem Changer later to switch type.
Check your info
/gem bilgitype · tier · energy · state shows the real status summary of your gem. Starting energy is 5 in the config and it displays as Pristine.
Learn the ability controls
With the gem in your main hand, a normal right-click is the primary ability. On a T2 gem, sneak right-click triggers the secondary ability. When looking at an interactive chest, door or button, change the priority with /gem tiklama.
Protect your energy
If energy drops to 0, the gem becomes Broken. If you have at least 2 energy, you can draw one unit with /gem cek1 Energy Bottle and consume the bottle with a right-click while at 1–9 energy.
ADMIN_ONLY means normal player commands are refused at the access gate. This does not mean the code is gone; it means the live PUBLIC opening is deliberately postponed until the two real-player, pack and event proofs are complete.Controls and the T1/T2 difference
| Control | What does it do? | Requirement / note |
|---|---|---|
| Main hand + right-click | Runs your standard gem's primary ability. | Available on T1 and T2; cooldown and energy/state gates apply. |
| Main hand + sneak + right-click | Runs the secondary ability. | Only unlocked on T2; a T1 item shows the secondary as locked. |
| Off-hand / passive | Continuous effects such as speed, resistance, cleansing and fall protection are evaluated. | The energy state sets the passive multiplier; a Broken gem gets no passive bonus. |
/gem tiklama | Chooses whether block interaction or the ability comes first. | When off, interactions like doors, chests and buttons are protected ahead of the ability. |
/gem otomatikerit | Toggles Fire auto-smelting. | Only the Fire gem can use it; it works on raw iron, gold and copper. |
Cooldowns are bound to the player account and survive relogging. Sending the same click twice does not produce two effects; the ability pipeline re-checks the cooldown, state, world and event gates.
Energy: every state from 0 to 10
Energy is the numeric source of the gem's liveness. The 0–5 range changes the actual performance state; the 6–10 range acts as a buffer that does not increase ability power. So “10 energy = a twice as strong gem” is not true.
| Energy | Displayed state | Active multiplier | Cooldown multiplier | Passive multiplier | What it means for the player |
|---|---|---|---|---|---|
| 0 | Broken | No abilities | — | 0× | Only SunshineGems-sourced damage is subject to the 2× broken-target rule; vanilla or third-party plugin damage does not fall under it. |
| 1 | Ruined | 0,60× | 1,75× | 0× | Active abilities are weak and recharge more slowly; passives are off. |
| 2 | Fractured | 0,70× | 1,50× | 0,50× | Binary helper passives turn on, numeric bonuses are at half strength. |
| 3 | Cracked | 0,80× | 1,35× | 0,70× | Passives continue at partial strength. |
| 4 | Scratched | 0,90× | 1,15× | 0,85× | Close to full power, cooldowns are still a bit long. |
| 5 | Pristine | 1,00× | 1,00× | 1,00× | Normal reference power. |
| 6–10 | Pristine +1 … Pristine +5 | 1,00× | 1,00× | 1,00× | Above 5 grants no extra damage; it is kept as a buffer for deaths, bottles and rituals. |
Where does energy come from and go?
The energy system is designed as a closed economy, not an “infinite farm”. Total value is tracked on every transaction across player energy + ACTIVE/RESERVED bottle units + the global pool. If a transaction fails, either nothing changes or the same unit is preserved through safe delivery/pool paths.
Player death
An eligible PVP/death decision removes 1 energy from the victim. If the killer is eligible, they gain +1 while in the 0–9 range; if the killer is at 10, a registered Energy Bottle is created. Kills that are ineligible, protected or caught by anti-farm are written to the audit without transferring energy.
Pool
Environmental losses or decisions without a valid killer go to the pool. /gem havuz shows the player only the pool total and recent activity; admin changes to the pool are audited separately.
Anti-farm
For PVP energy transfer the minimum playtime is 120 minutes, minimum level 5, last player damage 15 seconds and combat tag 10 seconds. The default cooldown for the same pair is 30 minutes; the same IP only produces a warning and does not decide on its own.
Safe decision order
- First it checks whether the victim/killer are really gem participants and whether the world/event is safe.
- Last player damage, combat tag, same-pair cooldown and anti-farm thresholds are checked.
- The Towny/WorldGuard/trust decision is taken fail-closed; if a provider is uncertain, no energy is transferred.
- Player, bottle/pool and audit rows are written together in a single DB transaction.
The eight standard gems
Every standard gem shares the same backbone: one role, two passive families, a T1 primary ability and a T2 secondary ability. The cooldowns below are the shipped gems.yml starting values; at 1–4 energy they lengthen with the cooldown state multiplier.
| Gem | Role | Passive summary | T1 primary | T2 secondary |
|---|---|---|---|---|
| Astra | Exploration and dimension control | Soul Healing, Soul Capture, Phase | astral_daggers · 15 sec | astral_projection · 60 sec |
| Fire | Area pressure | Fire/lava immunity, smelting raw ore into ingots | charged_fireball · 10 sec | cozy_campfire · 60 sec |
| Flux | Armor breaking and control | Weakness/Slowness/Hunger cleansing, shock arrows | flux_beam · 60 sec | ground · 20 sec |
| Life | Endurance and healing | Out-of-combat regeneration, undead bonus, slower hunger | heart_drainer · 30 sec | circle_of_life · 60 sec |
| Puff | Movement | Fall immunity, double jump, T2 environment safety | dash · 5 sec | breezy_bash · 10 sec |
| Speed | Tempo and area control | Permanent movement speed, T2 swim speed | sloths_sedative · 35 sec | speed_storm · 45 sec |
| Strength | Melee | Melee multiplier, periodic critical | bloodthorns · 20 sec | frailer · 25 sec |
| Wealth | Resources and durability | Luck/Hero, Unluck and a 9-slot pocket | durability_chip · 30 sec | rich_rush · 540 sec |
Astra — souls and phase
Passives
Soul healing when you kill a monster; storing the soul of a creature killed in melee in up to 2 slots; dodging direct damage with a 10% phase chance on T1 and 15% on T2.
Astral Daggers
Three daggers, 15 block range, 4 HP per dagger and an 8 HP cap on the same target. Cooldown is 15 seconds.
Astral Projection
A T2 secondary ability; a 5-second projection, up to 15 blocks away. Soul commands are managed with /gem ruhlar and /gem ruhlaribirak 1|2.
Fire — heat and area pressure
Passives
Immunity to fire and lava damage. /gem otomatikerit toggles whether breaking raw iron, raw gold and raw copper blocks drops them as ingots; it does not apply to other ores.
Charged Fireball
With a 0–15 second charge, 6–18 HP damage, 50 block range and a 3 block effect radius. Edge targets take half falloff. Cooldown is 10 seconds.
Cozy Campfire
T2 secondary; 15 seconds, 5 block radius, a Regen IV-like healing pulse for allies and a 2 HP/burning effect on enemies. Cooldown is 60 seconds.
Flux — cleansing and control
Passives
Every 10 tick check it tries to cleanse Weakness, Slowness and Hunger effects; there is a 20 second internal cooldown for the same effect. Each arrow hit applies 2,5 HP shock bonus damage with an 8 second cooldown.
Flux Beam
0,5–15 second charge, 30 block range and 5–15 HP damage. Beam durability is kept in the 50–150 range and never drops below a floor of 1. Cooldown is 60 seconds.
Ground
T2 secondary; 3 seconds of area control in a 15 block radius. Positive first damage breaks the lock; it does not lock the environment or a target forever. Cooldown is 20 seconds.
Life — sustainability
Passives
After 10 seconds out of combat, regeneration every 2 seconds of 1,2 HP on T1 and 2 HP on T2; T1 2×, T2 2,5× damage to undead targets (boss cap 1,5×); exhaustion T1 0,75×, T2 0,60×; apple and enchanted apple absorption 30 seconds.
Heart Drainer
Gives the target a Wither window within 15 blocks; there are separate duration/amplifier gates for normal targets and bosses. Cooldown is 30 seconds.
Circle of Life
T2 secondary; 12 seconds in an 8 block radius, a pulse every 2 seconds. Allies heal, enemies get Wither. Cooldown is 60 seconds.
Puff — movement and safe landings
Passives
Fall damage immunity and a second jump in mid-air. The second jump velocity is 0,6 on T1 and 0,8 on T2. On T2, environmental effects like trampling crops and triggering sculk shriekers are also prevented.
Dash
A T1 primary ability, it uses a range step and a raycast safety check; the starting config has dash-enabled: false so it is not considered enabled in live PUBLIC behaviour. Cooldown is 5 seconds.
Breezy Bash
T2 secondary; 10 block range, up to 6 blocks of lift, 8 HP damage and a 10 second fall immunity window. Cooldown is 10 seconds.
Speed — tempo and area management
Passives
The permanent movement bonus is applied with a 0,20 scalar on T1 and 0,40 on T2; the final speed cap is 0,16. The T2 swim bonus is 0,15. The plugin does not override another plugin's speed from its own namespaced attribute record.
Sloth’s Sedative
Applies Slowness/Fatigue to enemies for 10 seconds in a 10 block radius. Cooldown is 35 seconds.
Speed Storm
T2 secondary; 10 seconds in a 10 block radius, a pulse every 2 seconds; Speed for allies, Slowness for enemies. Cooldown is 45 seconds.
Strength — melee
Passives
Melee multiplier 1,15× on T1 and 1,25× on T2. The boosted critical triggers its counter every 8 valid attacks on T1 and every 3 on T2; the critical bonus multiplier is 1,5×.
Bloodthorns
Thorns damage in a 5 block radius that scales with missing health; base 5 HP, missing health contribution 7 HP and a cap of 12 HP. Cooldown is 20 seconds.
Frailer
T2 secondary; 10 seconds of Weakness and 5 seconds of Wither within 15 blocks. Cooldown is 25 seconds.
Wealth — resources and durability
Passives
Luck/Hero effects, brief Unluck on the target and a 9-slot personal pocket. Shulkers, bundles, nested containers and SunshineGems items cannot be placed in the pocket, so unlimited nested storage cannot form.
Durability Chip
Manages a 30 second durability window, a 50% chance to cancel a valid break and XP-to-mending conversion with namespaced rules. Cooldown is 30 seconds.
Rich Rush
T2 secondary; 540 second cooldown, 120 second duration, Haste III/Luck IV-like gathering effects and a 1,25 yield multiplier. The long cooldown is a deliberate design choice that limits its economic impact.
Trust, Towny and protection decisions
Trust is not a “this player can do anything” list. It only creates an explicit exception in gem abilities' target protection decision. The list holds at most 50 records; you cannot add trust for yourself.
| Order | Control | Result |
|---|---|---|
| 1 | Is it you? | The target of your own gem ability is accepted as valid. |
| 2 | Is there explicit trust? | /gem guven <oyuncu> — a player added explicitly this way passes protection. |
| 3 | Same Towny town? | towny-auto-trust: true — the same Towny town can then count as automatic trust. |
| 4 | WorldGuard/PVP flag | If area protection does not allow it, no effect is applied; if the provider errors, fail-closed protection is chosen. |
| 5 | World/event safety | If there is a disabled world, safe zone or event-managed rule, the ability and energy decision is refused. |
Being a nation/ally alone is not explicit trust. Trust commands: /gem guven, /gem guvensil, /gem guvenliler, /gem guventemizle. Name resolution is only done from online players or previously known offline records.
Energy Bottle: how is energy carried?
/gem cek removes 1 unit from the player's energy and creates one registered bottle. Energy must be between 2–10 to draw; you cannot draw a bottle while 1 energy remains. While the bottle looks like a physical item, the real state is kept in the bottles record.
| State | What does it mean? | Player behaviour |
|---|---|---|
| ACTIVE | A valid, usable bottle that has not expired. | A right-click gives +1 energy only while your gem energy is between 1–9. |
| RESERVED | A bottle temporarily reserved as a contribution to the Restoration ritual. | It cannot be consumed or returned to the pool as if expired; it is refunded if the ritual is cancelled. |
| CONSUMED | A bottle that has been used once. | The same physical copy or a PDC copy does not work again. |
| EXPIRED | A bottle whose 60 minute wall-clock lifetime has run out. | The unit is refunded exactly to the global pool. |
| REFUNDED | A record refunded exactly when a ritual/craft delivery broke down. | The new item is delivered from the pending queue. |
| QUARANTINED | A corrupt, duplicate or foreign payload. | The server does not use it; it is left to admin audit/recovery review. |
- The lifetime is by default 60 minutes; there are warnings in the last 5 minutes and the last minute.
- For its creator the first 30 seconds are protected; another player or a hopper cannot take it.
- If the inventory is full the bottle is not dropped: it stays in the pending delivery queue.
- The delivery flow first opens a durable claim, then actually adds the physical item to the inventory; if a PDC delivery marker is seen after a crash, a second copy is not given.
- The drop pickup event completes the physical pickup in the same transaction; a later despawn/restart transition cannot produce the same bottle again.
Progression stages: P0 to P4
Progression is a global singleton. Existing items are not deleted on a rollback stage; grandfather-existing-items: true means only new production and ritual gates are affected.
| Stage | What opens? | Trigger / note |
|---|---|---|
| P0 | Basic selection, energy, passives and the T1 surface. | Starting stage; config initial-stage: P0. |
| P1 | The Fragment and Repair Kit path. | It opens when the first real player enters the world_nether progression-observe-only world. |
| P2 | Upgrader and Trader recipes. | A vanilla Wither death caused by a real player in an allowed world; an NPC, Mythic or dungeon marker does not count. |
| P3 | The Restoration Core and Restoration Item/Revival path. | There is no automatic real-player trigger; it opens in a controlled way through the admin/event flow. |
| P4 | The final gate and the event/ritual endgame surface. | Advance is a no-op at P4; the End is not a default trigger. |
Workshop and six recipes
/gem atolye opens the safe craft GUI. Every transaction is first prepared into the receipt journal; on a provider/SQLite/delivery error, the exact item, essence, money and XP are refunded or placed in the pending delivery queue. A free “it failed but the inputs are gone” path does not exist by design.
| Recipe | Stage | Essence | Money | XP level | Base inputs |
|---|---|---|---|---|---|
fragment | P1 | Earth 8 · Life 4 · Void 2 | 500 | 5 | 4 diamond, 2 amethyst cluster, 2 emerald, 1 iron block |
upgrader | P2 | Earth 24 · Life 16 · Flame 12 · Void 8 | 5.000 | 25 | 4 fragment, wither skeleton skull, 4 dragon breath |
trader | P2 | Void 16 · Life 12 · Flame 8 | 3.000 | 15 | 4 diamond block, 4 dragon breath, sculk catalyst |
repair_kit | P1 | Life 24 · Earth 16 · Flame 16 · Void 8 | 7.500 | 30 | 4 fragment, 2 anvil, 2 netherite ingot, smithing template |
restoration_core | P3 | Life 48 · Void 32 · Earth 24 | 15.000 | 40 | 4 fragment, 2 dragon head, 2 repair kit, recovery compass |
restoration_item | P3 | Life 16 · Void 8 | 2.500 | 10 | Restoration Core + red, orange, yellow, lime, light blue, blue, purple, pink candles |
Pedestal, Repair and Restoration
pedestal.yml has enabled: false as the default. The pedestal is not set up automatically and does not open in production before the location/structural proof is complete. So even though the rituals below are coded, this is not a promise of public use right now.Repair Kit
Unlocks after P1. It repairs energy with pulses from the energy pool to the owner of 1–4 suitable standard gems. The lowest energy/UUID is chosen deterministically; if the pool is empty or there is no target, the kit is not consumed.
Restoration Core + Item
At P3, a standard gem with 0 energy is reborn. The owner or explicitly trusted players can contribute five different ACTIVE Energy Bottles. The bottles become RESERVED; a duplicate, expired or someone else's contribution is refused.
Lease and recovery
A single pedestal lease allows one ritual at a time. Cancellation, logout, restart or a pre-commit error comes back through exact reservation/pending delivery; after commit there is no silent rollback.
The authorised flow manages the correct beacon origin/facing record with /gem admin sunak ayarla, the temporary window with sunak ac|kapat|durum and the audit with ritual durum|iptal.
Mythic artifacts: Auratus and Heretic
Auratus and Heretic are “mythic artifact” registry records separate from the eight standard gems. Only one ACTIVE record exists per type; it is verified by PDC artifact UUID, type and holder. On a player carrying a mythic, standard gem abilities/passives are suspended. Death, chunk unload, despawn or restart states use the pending delivery/recovery path.
| Artifact | Primary | Secondary | Limits |
|---|---|---|---|
| Auratus | Chain Grapple · 2 charges, 48 blocks, 10 sec recharge per charge, 4 HP to an entity | Echoing Aegis · 1,25 sec parry, reflects valid living-source damage | Ground Slam once per flight, radius 6, 14 HP at the centre/6 HP at the edge; Aegis 5 HP healing + 3 sec Speed. |
| Heretic | Bloodsaws · 2 charges, 50 blocks, 5 HP, at most 2 bounces | Bloodlinking · 10 sec activation, 3 slams, two-player link | Spore/Bleed target dedupe; link damage transfer 35%, reflection 8 HP cap, Hemorrhage 2×/16 HP cap, Auto-Crit 6 sec. |
Blood Moon and Dragon Games
Blood Moon
A 30 minute event with vanilla natural hostile creatures; time is held in the 13.000–23.000 band and the weather snapshot is restored. Health 1,40×, damage 1,20×, speed 1,10×; one bottle per 25 kills, at most 2 rewards per player. The default is enabled: false.
Dragon Games
Only in the dragon_games event-managed world; 8–32 players, 2-player teams, REGISTRATION → GRACE → MAIN → FINAL → SUDDEN_DEATH. The border shrinks from 2.000 to 100 and to 25 in the final. The default is enabled: false.
The player commands are /gem event dragongames join, leave and tracker. Admin start/status/stop commands require the event permission. A Dragon Games player's inventory/world border snapshot is taken fresh; the kit application state is tracked exactly-once in the DB as NOT_PREPARED → SNAPSHOT_SAVED → KIT_APPLIED. On restart/reconnect the same kit is safely prepared again and the main survival world border is not changed.
Player commands
| Command | What do you see / do? |
|---|---|
/gem | 54-slot main hub: Gem Info, Energy, cooldowns, Workshop, Trust, Settings, Progression. |
/gem sec | Permanent first gem selection. |
/gem bilgi | Type, tier, energy, state and cooldown summary. |
/gem cek | Draw 1 Energy Bottle from 2–10 energy. |
/gem tiklama | Block interaction/ability priority. |
/gem otomatikerit | Fire auto-smelting setting. |
/gem guven <oyuncu>, guvensil, guvenliler, guventemizle | Managing the trust list. |
/gem ruhlar, ruhlaribirak 1|2 | Viewing/summoning Astra soul slots. |
/gem cep | Opening the Wealth pocket. |
/gem atolye | The six-recipe craft GUI. |
/gem havuz | Energy pool total and recent activity. |
Single-player admin test mode
/gem admin test yardim opens a screen built to quickly try the eight standard gems and recipe items solo. Every subcommand requires sunshinegems.admin and logs changes with the admin-test audit reason; it does not make the system PUBLIC.
| Command | Result |
|---|---|
ver <oyuncu> <gem> [1|2] | Gives a canonical T1/T2 gem to a player without a gem by using their selection. |
tip <oyuncu> <gem> | The type changes while energy and tier are kept; the old token goes to quarantine. |
tier <oyuncu> <1|2> | The tier changes; T2 unlocks the secondary ability. |
sifirla <oyuncu> | The gem, energy and token are removed; /gem sec returns. |
cooldown <oyuncu> | All persistent and live ability cooldowns are cleared. |
dunya <ac|kapat> | A session-only world test exception for the admin who ran the command. |
esya <tur> [adet] | Delivery of 1–64 canonical recipe items or registered test bottles. |
hepsi <oyuncu> | T2, energy 5, cooldown clearing and world permission for the sender. |
world; in the lobby, use /gem admin test dunya ac first. The exception does not extend to other players/admins and does not remove Towny, WorldGuard, trust or event safe-zone protections.Controls: right-click in the main hand for primary, sneak + right-click for the T2 secondary; related passives are evaluated through the main hand/off-hand. For mythic testing use /gem admin artifact spawn <auratus|heretic> <oyuncu>; for events use /gem admin event <bloodmoon|dragongames> <start|status|stop>. events.yml contains enabled:false the test command does not bypass this. At the end of the test, the item audit must show no duplicates and the energy audit a difference of 0.
Admin surface and live safety
Admin commands are kept separate from player commands and require sunshinegems.admin. /gem admin reload refreshes the safe message/HUD and numeric ability cache; it does not rewrite the DB, registry or session state. Bukkit /reload is not used for this system.
| Command | Scope |
|---|---|
/gem admin ver | The running plugin version and build id. |
/gem admin reload | A safe visual/message cache refresh; persistence/session do not change. |
/gem admin enerji ... | Get/set/add; 0–10 clamp, audit and conservation. |
/gem admin pool ... | Global pool get/set/add and recent activity. |
/gem admin progression ... | P0–P4 get/set/advance; the grandfather rule. |
/gem admin denetim enerji|item|performans|storage|artifact | Energy difference, online canonical item audit, DB/ability p95, receipt and artifact registry diagnostics. |
/gem admin sunak ..., ritual ... | Pedestal origin/window and ritual status/cancel. |
/gem admin event ... | Blood Moon/Dragon Games start/status/stop; the event permission. |
Persistence, delivery and recovery architecture
SunshineGems' most important feature is not ability animation but that it loses no items/energy when something goes wrong. The SQLite V6 migration order is V1 core → V2 Astra → V3 ritual → V4 events → V5 Dragon Games → V6 reliability.
Single DB writer
SQLite is used with a single writer thread and WAL. The queue is bounded at 1024; saturation rejects new work instead of growing the heap without limit. The admin performance diagnostic shows queue depth/max/dropped/failed and DB/ability p95 values.
Pending delivery
A gem, bottle, artifact or refund that does not fit in the inventory stays PENDING. The claim lease, the physical inventory add and the DELIVERED transition are separate; without the physical add the record is not considered complete.
Item verification
The canonical item audit summarises valid/duplicate/foreign/missing token counts of online gems. The quarantine log does not write payloads; it uses type, amount, size and fingerprint.
Dragon recovery
The player snapshot is taken fresh on the main thread; the kit state is held exactly-once in the DB. Reconnect/restart uses the designated restore flow instead of accidentally overwriting the old snapshot.
Schema V6 is currently verified in the RC source; the production JAR/schema change happens after a separate release approval and backup. This page's “V6” wording does not mean the live database is already V6.
HUD, resource pack and fallback
The gem HUD keeps the energy value readable without the resource pack using the ◆/◇ fallback. Vanilla Bukkit sound mapping is used; the particle budget is 200 per second per viewer, 4.000 server-wide and 64 blocks of range. When the pack is present, custom model/texture/VFX visuals get richer, but the game decisions do not depend on the pack.
Common issues and correct diagnosis
| Symptom | Likely meaning | What to do? |
|---|---|---|
| “The gem system is only open to staff.” | Runtime mode is ADMIN_ONLY. | This is not a bug but the PUBLIC gate's deliberate security stance. An admin must complete the SG-39 gates. |
| The ability doesn't fire and the item clicks normally. | /gem tiklama may be in block-priority mode; the world may be disabled; it may be T1 secondary or on cooldown. | /gem bilgi to check the state, tier and settings; an ability is never forced on a protected block. |
| Energy didn't change. | Anti-farm, a trust/WorldGuard/Towny decision or the combat window refused it. | An admin audit checks the energy and event/world state; the same IP alone is not treated as proof. |
| The bottle doesn't show up in the inventory. | The inventory is full or it is waiting in pending delivery. | Opening a slot triggers login delivery again; the item is not scattered on the ground. |
| The bottle can't be used. | EXPIRED, RESERVED, CONSUMED, a duplicate, or the 0/10 energy limit. | Don't try a new copy; a status/audit check is needed. |
| The craft was cancelled. | Movement, damage, death, logout, a world change or a provider error. | The receipt/pending queue exists for exact refunds; instead of spamming the same action, wait for the recovery to complete. |
| The Dragon Games kit/restore looks odd. | The event world or snapshot gate did not pass. | An admin should check the event status and kit state before the player reconnects; the survival world border is not touched. |
How should this wiki be read?
This page was prepared from the SG-40 source audit and the shipped config contract. Numeric ability values are config starting values; the economy, pack, events and PUBLIC access depend on live verification gates. Player UUIDs, personal energy/cooldown/trust, receipt payloads, IPs or chat content are not written to the wiki.