Enerji, yetenek ve güvenli ekonomi
SunshineGems gem sistemi
SunshineGems’in sekiz standart gemini, enerji state’lerini, Energy Bottle ekonomisini, atölye tariflerini, trust kararlarını ve canlı yayın kapılarını baştan sona açıklar.
Bu sayfada
ADMIN_ONLY modudur. Blood Moon, Dragon Games, pedestal ritüelleri ve PUBLIC oyuncu akışı canlı yayın kapıları geçmeden açılmaz. Bu sayfa “kodda ne var?” ile “şu an herkes kullanabilir mi?” sorularını özellikle birbirinden ayırır.SunshineGems tam olarak nedir?
SunshineGems, tek bir “güçlü item” değil; oyuncunun seçtiği bir gem türünü, 0–10 enerji kaynağını, iki seviye yeteneğini, pasif bonuslarını, enerji ekonomisini ve bunların güvenli teslimini tek bir oyun sistemi altında birleştiren özel Paper eklentisidir. Amaç, gemi bir eşya gibi görünürken gerçek karar kaynağının güvenilir ve denetlenebilir bir oyuncu kaydı olmasıdır.
Gem eşyası
Envanterdeki model ve lore, oyuncuya hangi gemi taşıdığını gösterir. PDC kimliği ve tip/tier eşleşmesi doğrulanır; kopyalanmış veya yabancı item geçerli sayılmaz.
Oyuncu kaydı
Tip, T1/T2, enerji, cooldown, trust, pocket, progression ve ritüel durumları SQLite’ta tutulur. Lore yalnızca görüntüdür; yetki değildir.
Yetenek motoru
Sağ tık, eğilerek sağ tık, pasif tick’leri ve hasar kapıları tek bir pipeline’dan geçer: dünya, state, cooldown, trust/koruma ve kaynak kontrolleri başarısızsa etki uygulanmaz.
Gem item → oyuncu kaydı → enerji/state → ability gate → görsel/audit. Bu zincirin herhangi bir halkası güvenilir değilse sistem fail-closed davranır.İlk beş dakikada ne yaparsın?
Menüyü aç
/gemana hub ile Sunshine Gem menüsünü açarsın. İlk seçim hakkı bir kez kullanılır ve kalıcıdır.
Bir standart gem seç
/gem secücretsiz ilk seçim ekranından Astra, Fire, Flux, Life, Puff, Speed, Strength veya Wealth seçersin. İlk seçim ikinci bir gem vermez; tip değiştirmek için ileride Gem Değiştirici gerekir.
Bilgini kontrol et
/gem bilgitip · tier · enerji · state geminin gerçek durum özetini gösterir. Başlangıç enerjisi config’te 5’tir ve görüntüde Saf görünür.
Yetenek kontrollerini öğren
Gem ana elindeyken normal sağ tık ana yetenektir. T2 gemde eğilerek sağ tık ikincil yeteneği çağırır. Etkileşimli sandık, kapı veya butona bakarken önceliği /gem tiklama ile değiştirirsin.
Enerjiyi koru
Enerji 0’a düşerse gem Kırık olur. En az 2 enerji varsa /gem cek1 Energy Bottle ile bir birim çekebilir, 1–9 enerjide şişeyi sağ tıkla tüketebilirsin.
ADMIN_ONLY iken normal oyuncu komutları erişim kapısından reddedilir. Bu, kodun yok olduğu anlamına gelmez; canlı PUBLIC açılışının iki gerçek oyuncu, pack ve event kanıtları tamamlanana kadar bilerek ertelendiği anlamına gelir.Kontroller ve T1/T2 farkı
| Kontrol | Ne yapar? | Şart / not |
|---|---|---|
| Ana el + sağ tık | Standart gemin primary yeteneğini çalıştırır. | T1 ve T2’de vardır; cooldown ve enerji/state kapıları uygulanır. |
| Ana el + eğil + sağ tık | Secondary yeteneği çalıştırır. | Yalnızca T2’de açılır; T1 item’ı secondary kilitli görünür. |
| Off-hand / pasif | Hız, direnç, temizlik, düşme koruması gibi sürekli etkiler değerlendirilir. | Enerji state’i pasif çarpanını belirler; Kırık’ta pasif bonus yoktur. |
/gem tiklama | Blok etkileşimi mi, yetenek mi önce gelsin seçer. | Kapalıyken kapı/sandık/buton gibi etkileşimler yetenekten önce korunur. |
/gem otomatikerit | Fire otomatik eritmesini açıp kapatır. | Yalnız Fire gemi kullanabilir; ham demir, altın ve bakır içindir. |
Cooldown’lar oyuncu hesabına bağlıdır ve yeniden girişte korunur. Aynı tıklamayı iki kez göndermek iki etki üretmez; ability pipeline’ı cooldown, state, dünya ve event kapılarını tekrar kontrol eder.
Enerji: 0’dan 10’a bütün durumlar
Enerji, gemin canlılığının sayısal kaynağıdır. 0–5 aralığı gerçek performans state’ini değiştirir; 6–10 aralığı ise yetenek gücünü artırmayan bir tampon görevi görür. Bu yüzden “10 enerji = iki kat güçlü gem” değildir.
| Enerji | Görünen state | Aktif çarpanı | Cooldown çarpanı | Pasif çarpanı | Oyuncu açısından anlamı |
|---|---|---|---|---|---|
| 0 | Kırık | Yetenek yok | — | 0× | Yalnız SunshineGems kaynaklı hasarın 2× kırık hedef kuralı vardır; vanilla veya dış plugin hasarı bu kurala girmez. |
| 1 | Harabe | 0,60× | 1,75× | 0× | Aktif yetenekler zayıf ve daha yavaş hazır olur; pasifler kapalıdır. |
| 2 | Parçalanmış | 0,70× | 1,50× | 0,50× | Binary yardımcı pasifler açılır, sayısal bonuslar yarım güçtedir. |
| 3 | Çatlak | 0,80× | 1,35× | 0,70× | Pasifler kısmi güçte devam eder. |
| 4 | Çizilmiş | 0,90× | 1,15× | 0,85× | Tam güce yaklaşır, cooldown hâlâ biraz uzundur. |
| 5 | Saf | 1,00× | 1,00× | 1,00× | Normal referans gücü. |
| 6–10 | Saf +1 … Saf +5 | 1,00× | 1,00× | 1,00× | 5’in üstü ekstra hasar vermez; ölüm/şişe/ritüel tamponu olarak korunur. |
Enerji nereden gelir, nereye gider?
Enerji sistemi bir “sonsuz farm” değil, kapalı bir ekonomi olarak tasarlandı. Toplam değer her işlemde oyuncu enerjisi + ACTIVE/RESERVED şişe birimleri + global havuz üzerinden izlenir. Bir işlem başarısızsa ya hiç değişiklik olmaz ya da aynı birim güvenli teslim/pool yoluyla korunur.
Oyuncu ölümü
Uygun bir PVP/ölüm kararı victim’dan 1 enerji düşürür. Killer uygunsa 0–9 aralığında +1 alır; killer 10’daysa kayıtlı Energy Bottle oluşur. Uygun olmayan, korunan veya anti-farm’a takılan öldürme enerji aktarmadan audit’e yazılır.
Havuz
Çevresel kayıplar veya geçerli killer olmayan kararlar havuza gider. /gem havuz oyuncuya yalnız havuz toplamı ve son hareketleri gösterir; havuzun yönetici değişiklikleri ayrıca audit’lenir.
Anti-farm
PVP enerji aktarımı için minimum oyun süresi 120 dakika, minimum seviye 5, son oyuncu hasarı 15 saniye ve combat tag 10 saniyedir. Aynı çift için varsayılan cooldown 30 dakikadır; aynı IP yalnız uyarı üretir, tek başına karar vermez.
Güvenli karar sırası
- Önce victim/killer gerçekten gem katılımcısı mı ve dünya/event güvenli mi bakılır.
- Son oyuncu hasarı, savaş etiketi, aynı çift cooldown’u ve anti-farm eşikleri kontrol edilir.
- Towny/WorldGuard/trust kararı fail-closed alınır; provider belirsizse enerji aktarılmaz.
- Tek DB transaction içinde oyuncu, bottle/pool ve audit satırları birlikte yazılır.
Sekiz standart gem
Her standart gem aynı omurgayı paylaşır: bir rol, iki pasif ailesi, T1 ana yetenek ve T2 ikincil yetenek. Aşağıdaki cooldown’lar shipped gems.yml başlangıç değerleridir; enerji 1–4 ise cooldown state çarpanı ile uzar.
| Gem | Rol | Pasif özeti | T1 ana yetenek | T2 ikincil yetenek |
|---|---|---|---|---|
| Astra | Keşif ve boyut kontrolü | Ruh Şifası, Ruh Yakalama, Faz | astral_daggers · 15 sn | astral_projection · 60 sn |
| Fire | Alan baskısı | Ateş/lav bağışıklığı, ham cevheri külçeye eritme | charged_fireball · 10 sn | cozy_campfire · 60 sn |
| Flux | Zırh kırma ve kontrol | Zayıflık/Yavaşlık/Açlık temizliği, şok okları | flux_beam · 60 sn | ground · 20 sn |
| Life | Dayanıklılık ve iyileşme | Savaş dışı yenilenme, undead bonusu, yavaş acıkma | heart_drainer · 30 sn | circle_of_life · 60 sn |
| Puff | Hareket | Düşme bağışıklığı, çift zıplama, T2 çevre güvenliği | dash · 5 sn | breezy_bash · 10 sn |
| Speed | Tempo ve alan kontrolü | Kalıcı hareket hızı, T2 yüzme hızı | sloths_sedative · 35 sn | speed_storm · 45 sn |
| Strength | Yakın dövüş | Yakın dövüş çarpanı, periyodik kritik | bloodthorns · 20 sn | frailer · 25 sn |
| Wealth | Kaynak ve dayanıklılık | Luck/Hero, Talihsizlik ve 9 slot cep | durability_chip · 30 sn | rich_rush · 540 sn |
Astra — ruh ve faz
Pasifler
Canavar öldürünce ruh şifası; yakın dövüşte öldürülen yaratığın ruhunu en fazla 2 slotta saklama; T1’de %10, T2’de %15 faz şansı ile doğrudan hasarı savuşturma.
Astral Daggers
Üç hançer, 15 blok menzil, hançer başına 4 HP ve aynı hedefte 8 HP tavanı. Cooldown 15 saniyedir.
Astral Projection
T2 ikincil yetenektir; 5 saniyelik projection, en fazla 15 blok mesafe. Ruh komutları /gem ruhlar ve /gem ruhlaribirak 1|2 ile yönetilir.
Fire — ısı ve alan baskısı
Pasifler
Ateş ve lav hasarına bağışıklık. /gem otomatikerit açıkken ham demir, ham altın ve ham bakır blok kırıldığında külçe olarak düşer; başka cevherlere uygulanmaz.
Charged Fireball
0–15 saniye şarjla 6–18 HP arası hasar, 50 blok menzil ve 3 blok etki yarıçapı. Kenar hedefler yarım falloff alır. Cooldown 10 saniyedir.
Cozy Campfire
T2 ikincil; 15 saniye, 5 blok yarıçap, müttefiklere Regen IV benzeri iyileştirme pulse’u ve düşmanlara 2 HP/yanma etkisi. Cooldown 60 saniyedir.
Flux — temizleme ve kontrol
Pasifler
Her 10 tick kontrolünde Zayıflık, Yavaşlık ve Açlık etkilerini temizlemeyi dener; aynı etki için 20 saniye iç cooldown vardır. Ok isabeti başına 2,5 HP şok ek hasarı 8 saniye cooldown ile uygulanır.
Flux Beam
0,5–15 saniye şarj, 30 blok menzil ve 5–15 HP hasar. Beam dayanıklılığı 50–150 aralığında tutulur, floor 1’in altına inmez. Cooldown 60 saniyedir.
Ground
T2 ikincil; 15 blok yarıçapta 3 saniyelik alan kontrolü. Pozitif ilk hasar kilidi kırar; çevreyi veya hedefi sonsuza kadar kilitlemez. Cooldown 20 saniyedir.
Life — sürdürülebilirlik
Pasifler
10 saniye savaş dışı kalınca her 2 saniyede T1’de 1,2 HP, T2’de 2 HP yenilenme; undead hedeflere T1 2×, T2 2,5× hasar (boss tavanı 1,5×); exhaustion T1 0,75×, T2 0,60×; elma ve büyülü elma emilimi 30 saniye.
Heart Drainer
15 blok menzil içinde hedefe Wither penceresi verir; normal hedef ve boss için ayrı süre/amplifier kapıları vardır. Cooldown 30 saniyedir.
Circle of Life
T2 ikincil; 8 blok yarıçapta 12 saniye, 2 saniyede bir pulse. Müttefik iyileşir, düşmana Wither uygulanır. Cooldown 60 saniyedir.
Puff — hareket ve güvenli iniş
Pasifler
Düşme hasarı bağışıklığı ve havada ikinci zıplama. İkinci zıplama hızı T1’de 0,6, T2’de 0,8’dir. T2’de ekin ezme ve sculk shrieker tetikleme gibi çevre etkileri de engellenir.
Dash
T1 ana yetenek, menzil adımı ve raycast güvenlik kontrolü kullanır; başlangıç config’inde dash-enabled: false olduğu için canlı PUBLIC davranışında açılmış kabul edilmez. Cooldown 5 saniyedir.
Breezy Bash
T2 ikincil; 10 blok menzil, en fazla 6 blok lift, 8 HP hasar ve 10 saniyelik düşme bağışıklığı penceresi. Cooldown 10 saniyedir.
Speed — tempo ve alan yönetimi
Pasifler
Kalıcı hareket bonusu T1’de 0,20, T2’de 0,40 scalar ile uygulanır; final hız cap’i 0,16’dır. T2 yüzme bonusu 0,15’tir. Eklenti kendi namespaced attribute kaydından başka plugin hızını ezmez.
Sloth’s Sedative
10 blok yarıçapta 10 saniye düşmana Slowness/Fatigue etkisi. Cooldown 35 saniyedir.
Speed Storm
T2 ikincil; 10 blok yarıçapta 10 saniye, 2 saniyede bir pulse; müttefike Speed, düşmana Slowness. Cooldown 45 saniyedir.
Strength — yakın dövüş
Pasifler
Yakın dövüş çarpanı T1’de 1,15×, T2’de 1,25×. Güçlendirilmiş kritik T1’de her 8, T2’de her 3 uygun saldırıda sayacı tetikler; kritik bonus çarpanı 1,5×’tir.
Bloodthorns
5 blok yarıçapta, eksik cana göre ölçeklenen diken hasarı; taban 5 HP, eksik can katkısı 7 HP ve tavan 12 HP. Cooldown 20 saniyedir.
Frailer
T2 ikincil; 15 blok menzilde 10 saniye Weakness ve 5 saniye Wither. Cooldown 25 saniyedir.
Wealth — kaynak ve dayanıklılık
Pasifler
Luck/Hero etkileri, hedefe kısa Talihsizlik ve 9 slotluk kişisel pocket. Pocket’a shulker, bundle, nested container ve SunshineGems item’ı konulamaz; böylece sınırsız iç içe depolama oluşmaz.
Durability Chip
30 saniyelik dayanıklılık penceresi, uygun kırılma işlemini %50 iptal etme şansı ve XP ile mending dönüşümünü namespaced kurallarla yönetir. Cooldown 30 saniyedir.
Rich Rush
T2 ikincil; 540 saniye cooldown, 120 saniye süre, Haste III/Luck IV benzeri kaynak etkileri ve 1,25 verim çarpanı. Cooldown’un uzun olması ekonomi etkisini sınırlayan bilinçli bir tasarımdır.
Güven, Towny ve koruma kararları
Trust, “bu oyuncu her şeyi yapabilir” listesi değildir. Yalnız gem yeteneklerinin hedef koruma kararında açık bir istisna oluşturur. Liste en fazla 50 kayıt tutar; kendine trust eklenemez.
| Sıra | Kontrol | Sonuç |
|---|---|---|
| 1 | Kendin misin? | Kendi gem yeteneğinin hedefi geçerli kabul edilir. |
| 2 | Açık trust var mı? | /gem guven <oyuncu> ile açıkça eklenen oyuncu korumadan geçer. |
| 3 | Towny aynı kasaba mı? | towny-auto-trust: true ise aynı Towny kasabası otomatik güven sayılabilir. |
| 4 | WorldGuard/PVP bayrağı | Alan koruması izin vermiyorsa etki uygulanmaz; provider hata verirse fail-closed koruma seçilir. |
| 5 | Dünya/event güvenliği | Disabled world, safe zone veya event-managed özel kural varsa yetenek ve enerji kararı reddedilir. |
Nation/ally olmak tek başına explicit trust değildir. Trust komutları: /gem guven, /gem guvensil, /gem guvenliler, /gem guventemizle. İsim çözümlemesi yalnız çevrimiçi veya daha önce bilinen offline kayıtlardan yapılır.
Energy Bottle: enerji nasıl taşınır?
/gem cek oyuncunun enerjisinden 1 birim çıkarıp bir adet kayıtlı şişe üretir. Çekim için enerji 2–10 arasında olmalıdır; 1 enerji kalırken şişe çekilemez. Şişe fiziksel bir item gibi görünse de gerçek durum bottles kaydında tutulur.
| Durum | Ne demek? | Oyuncu davranışı |
|---|---|---|
| ACTIVE | Geçerli, kullanılabilir ve süresi dolmamış şişe. | Sağ tıkla yalnız gem enerjin 1–9 arasındaysa +1 enerji verir. |
| RESERVED | Restoration ritüeline katkı için geçici ayrılmış şişe. | Tüketilemez veya süresi dolmuş gibi tekrar havuza alınamaz; ritüel iptalinde iade edilir. |
| CONSUMED | Bir kez kullanılmış şişe. | Aynı fiziksel kopya veya PDC kopyası tekrar çalışmaz. |
| EXPIRED | 60 dakikalık wall-clock ömrü dolmuş şişe. | Birim tam olarak global havuza iade edilir. |
| REFUNDED | Ritüel/craft teslimi bozulduğunda exact iade edilmiş kayıt. | Yeni item pending kuyruğundan teslim edilir. |
| QUARANTINED | Bozuk, duplicate veya yabancı payload. | Sunucu bunu kullanmaz; yönetici audit/recovery incelemesine bırakır. |
- Ömür varsayılan olarak 60 dakika; son 5 dakika ve son 1 dakikada uyarı vardır.
- Üreticisi için ilk 30 saniye korumalıdır; başka oyuncu veya hopper alamaz.
- Envanter doluysa şişe yere atılmaz: pending delivery kuyruğunda kalır.
- Delivery akışı önce durable claim açar, sonra fiziksel item’ı gerçekten envantere ekler; çökme sonrası PDC delivery marker’ı görülürse ikinci kopya verilmez.
- Drop pickup olayı fiziksel alımı aynı transaction’da tamamlar; sonradan despawn/restart dönüşümü aynı şişeyi tekrar üretemez.
İlerleme aşamaları: P0’dan P4’e
Progression global singleton’dır. Mevcut item’lar geri aşamada silinmez; grandfather-existing-items: true olduğu için yalnızca yeni üretim ve ritüel kapıları etkilenir.
| Aşama | Ne açılır? | Tetik / not |
|---|---|---|
| P0 | Temel seçim, enerji, pasifler ve T1 yüzeyi. | Başlangıç aşaması; config initial-stage: P0. |
| P1 | Fragment ve Repair Kit yolu. | İlk gerçek oyuncunun world_nether progression-observe-only dünyasına girişiyle açılır. |
| P2 | Upgrader ve Trader tarifleri. | İzinli dünyada gerçek oyuncu kaynaklı vanilla Wither ölümü; NPC, Mythic veya dungeon marker’ı geçerli değildir. |
| P3 | Restoration Core ve Restoration Item/Diriliş yolu. | Otomatik gerçek oyuncu tetikleyicisi yok; yönetici/etkinlik akışıyla kontrollü açılır. |
| P4 | Son kapı ve event/ritüel final yüzeyi. | Advance P4’te no-op olur; End varsayılan tetik değildir. |
Atölye ve altı tarif
/gem atölye veya ASCII alias’ı /gem atolye güvenli craft GUI’sini açar. Her işlem önce receipt journal’ına hazırlanır; provider/SQLite/teslim hatasında exact item, essence, para ve XP iade edilir veya pending teslim kuyruğuna alınır. Ücretsiz “başarısız oldu ama girdiler gitti” yolu tasarım gereği yoktur.
| Tarif | Aşama | Essence | Para | XP seviyesi | Temel girdiler |
|---|---|---|---|---|---|
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 + kırmızı, turuncu, sarı, limon, açık mavi, mavi, mor, pembe mum |
Sunak, Repair ve Restoration
pedestal.yml içinde enabled: false varsayılandır. Sunak otomatik kurulmaz ve production’da konum/structural kanıt tamamlanmadan açılmaz. Bu nedenle aşağıdaki ritüeller kodlanmış olsa da şu an herkese açık kullanım sözü değildir.Repair Kit
P1’den sonra açılır. Enerji havuzundan 1–4 arası uygun standart gem sahibine pulse’larla enerji onarımı yapar. En düşük enerji/UUID deterministik seçilir; havuz boşsa veya hedef yoksa kit tüketilmez.
Restoration Core + Item
P3’te, enerjisi 0 olan standart gemi yeniden doğar. Owner veya explicit trusted oyuncular beş farklı ACTIVE Energy Bottle katkısı verebilir. Bottle’lar RESERVED olur; duplicate/expired/başkasının katkısı reddedilir.
Lease ve recovery
Tek pedestal lease’i aynı anda tek ritüele izin verir. İptal, çıkış, restart veya commit öncesi hata exact reservation/pending delivery yoluyla geri döner; commit sonrasında sessiz geri alma yapılmaz.
Yetkili akışı /gem admin sunak ayarla ile bakılan doğru beacon origin/facing kaydını, sunak aç|kapat|durum ile geçici pencereyi ve ritual durum|iptal ile audit’i yönetir.
Mythic artifact’lar: Auratus ve Heretic
Auratus ve Heretic, sekiz standart gemden ayrı “mythic artifact” registry kayıtlarıdır. Aynı tipte yalnızca bir ACTIVE kayıt bulunur; PDC artifact UUID, tip ve holder ile doğrulanır. Mythic taşıyan oyuncuda standart gem yetenekleri/pasifleri askıya alınır. Ölüm, chunk unload, despawn veya restart durumları pending teslim/recovery yolu kullanır.
| Artifact | Ana yetenek | İkincil | Sınırlar |
|---|---|---|---|
| Auratus | Chain Grapple · 2 charge, 48 blok, charge başına 10 sn yenileme, entity’ye 4 HP | Echoing Aegis · 1,25 sn parry, geçerli living-source hasarı yansıtır | Ground Slam uçuş başına 1 kez, yarıçap 6, merkez 14 HP/kenar 6 HP; Aegis 5 HP iyileşme + 3 sn Speed. |
| Heretic | Bloodsaws · 2 charge, 50 blok, 5 HP, en fazla 2 bounce | Bloodlinking · 10 sn aktivasyon, 3 slam, iki oyunculu link | Spore/Bleed hedef dedupe; link hasar transferi %35, yansıma 8 HP cap, Hemorrhage 2×/16 HP cap, Auto-Crit 6 sn. |
Kanlı Ay ve Dragon Games
Kanlı Ay
Vanilla doğal hostile yaratıklarla 30 dakika süren event; zaman 13.000–23.000 bandında tutulur, hava snapshot’ı geri alınır. Health 1,40×, damage 1,20×, speed 1,10×; 25 kill’de bir bottle, kişi başı en fazla 2 ödül. Varsayılan enabled: false.
Dragon Games
Yalnız dragon_games event-managed dünyasında; 8–32 oyuncu, 2 kişilik takımlar, REGISTRATION → GRACE → MAIN → FINAL → SUDDEN_DEATH. Border 2.000’den 100’e, finalde 25’e iner. Varsayılan enabled: false.
Oyuncu komutları /gem event dragongames join, leave ve tracker’dır. Admin start/status/stop komutları event permission’ı ister. Dragon Games oyuncusunun envanter/world border snapshot’ı taze alınır; kit uygulama state’i DB’de NOT_PREPARED → SNAPSHOT_SAVED → KIT_APPLIED olarak exactly-once izlenir. Restart/reconnect durumunda aynı kit yeniden güvenli biçimde hazırlanır ve ana survival world border’ı değiştirilmez.
Oyuncu komutları
| Komut | Ne görürsün / yaparsın? |
|---|---|
/gem | 54 slot ana hub: Gem Bilgisi, Enerji, cooldown, Atölye, Trust, Ayarlar, Progression. |
/gem sec | Kalıcı ilk gem seçimi. |
/gem bilgi | Tip, tier, enerji, state ve cooldown özeti. |
/gem cek | 2–10 enerjiden 1 Energy Bottle çekme. |
/gem tiklama | Blok etkileşimi/yetenek önceliği. |
/gem otomatikerit | Fire otomatik eritme ayarı. |
/gem guven <oyuncu>, guvensil, guvenliler, guventemizle | Trust listesini yönetme. |
/gem ruhlar, ruhlaribirak 1|2 | Astra soul slotlarını görüntüleme/çağırma. |
/gem cep | Wealth pocket’ını açma. |
/gem atölye / /gem atolye | Altı tarifli craft GUI’si. |
/gem havuz | Enerji havuzu toplamı ve son hareketler. |
Yönetici yüzeyi ve canlı güvenliği
Admin komutları oyuncu komutlarından ayrı tutulur ve sunshinegems.admin ister. /gem admin reload güvenli mesaj/HUD ve sayısal ability cache’ini yeniler; DB, registry ve session state’ini yeniden yazmaz. Bukkit /reload bu sistem için kullanılmaz.
| Komut | Kapsam |
|---|---|
/gem admin ver | Çalışan plugin sürümü ve build kimliği. |
/gem admin reload | Güvenli görsel/mesaj cache yenilemesi; persistence/session değişmez. |
/gem admin enerji ... | Get/set/add; 0–10 clamp, audit ve conservation. |
/gem admin pool ... | Global havuz get/set/add ve son hareketler. |
/gem admin progression ... | P0–P4 get/set/advance; grandfather kuralı. |
/gem admin denetim enerji|item|performans|storage|artifact | Enerji farkı, çevrimiçi canonical item audit’i, DB/ability p95, receipt ve artifact registry teşhisi. |
/gem admin sunak ..., ritual ... | Pedestal origin/window ve ritual durum/iptal. |
/gem admin event ... | Blood Moon/Dragon Games start/status/stop; event permission’ı. |
Kayıt, teslim ve recovery mimarisi
SunshineGems’in en önemli özelliği yetenek animasyonu değil, hata olduğunda item/enerji kaybetmemesidir. SQLite V6 migration sırası V1 core → V2 Astra → V3 ritual → V4 events → V5 Dragon Games → V6 reliability şeklindedir.
Tek DB yazarı
SQLite tek writer thread ve WAL ile kullanılır. Queue bounded 1024’tür; saturation yeni işi reddeder, heap’i sınırsız büyütmez. Admin performans teşhisi queue depth/max/dropped/failed ve DB/ability p95 değerlerini gösterir.
Pending delivery
Envantere sığmayan gem, bottle, artifact veya refund PENDING kalır. Claim lease, fiziksel envanter ekleme ve DELIVERED geçişi ayrıdır; fiziksel add olmadan kayıt tamamlandı sayılmaz.
Item doğrulama
Canonical item audit çevrimiçi gemlerin valid/duplicate/foreign/missing token sayılarını özetler. Karantina log’u payload’ı yazmaz; tür, miktar, boyut ve fingerprint kullanır.
Dragon recovery
Oyuncu snapshot’ı fresh main-thread alınır; kit state DB’de exactly-once tutulur. Reconnect/restart, eski snapshot’ın yanlışlıkla üstüne yazmak yerine belirlenmiş restore akışını kullanır.
Şema V6 şu anda RC kaynakta doğrulanmıştır; production JAR/schema değişimi ayrı yayın onayı ve backup sonrasında yapılır. Bu sayfanın “V6” anlatımı, canlı veritabanının zaten V6 olduğu anlamına gelmez.
HUD, resource pack ve fallback
Gem HUD’u enerji değerini ◆/◇ fallback’iyle resource pack olmadan da okunabilir tutar. Vanilla Bukkit sound mapping kullanılır; parçacık budget’ı viewer başına saniyede 200, sunucu genelinde 4.000 ve 64 blok aralığıdır. Pack geldiğinde özel model/texture/VFX görünümü zenginleşir, fakat oyun kararı pack’e bağlı değildir.
Sık sorunlar ve doğru teşhis
| Belirti | Muhtemel anlam | Ne yapmalı? |
|---|---|---|
| “Gem sistemi yalnız yetkililere açık.” | Runtime mode ADMIN_ONLY. | Bu hata değil, PUBLIC kapısının bilinçli güvenlik duruşudur. Yönetici SG-39 gate’lerini tamamlamalıdır. |
| Yetenek çalışmıyor, item normal tıklıyor. | /gem tiklama blok önceliğinde, world disabled, T1 secondary veya cooldown olabilir. | /gem bilgi, state, tier ve settings kontrol edilir; korumalı blokta zorla yetenek çalıştırılmaz. |
| Enerji değişmedi. | Anti-farm, trust/WorldGuard/Towny kararı veya combat window reddetti. | Admin audit enerji ve event/world durumunu kontrol eder; aynı IP’yi tek başına kanıt saymaz. |
| Şişe envanterde görünmüyor. | Envanter dolu veya pending delivery bekliyor. | Slot açınca tekrar login delivery tetiklenir; item yere saçılmaz. |
| Şişe kullanılamıyor. | EXPIRED, RESERVED, CONSUMED, duplicate veya enerji 0/10 sınırı. | Yeni kopya deneme; status/audit kontrolü gerekir. |
| Craft iptal oldu. | Hareket, hasar, ölüm, çıkış, dünya değişimi veya provider hatası. | Receipt/pending kuyruğu exact iade içindir; aynı işlemi spamlamak yerine recovery tamamlanmasını bekle. |
| Dragon Games kit/restore garip görünüyor. | Event world veya snapshot gate’i geçmedi. | Oyuncu yeniden bağlanmadan admin event status ve kit state’i kontrol etmeli; survival world border’ına dokunulmaz. |
Bu wiki nasıl okunmalı?
Bu sayfa SG-40 source audit’i ve shipped config sözleşmesi üzerinden hazırlanmıştır. Sayısal ability değerleri config başlangıç değeridir; ekonomi, pack, event ve PUBLIC erişimi canlı doğrulama kapılarına bağlıdır. Oyuncu UUID’si, kişisel enerji/cooldown/trust, receipt payload’ı, IP veya chat içeriği wiki’ye yazılmaz.