🎨 ChromaCore

Discord botlarınız için yeni nesil, modern ve tamamen özelleştirilebilir görsel oluşturma motoru.

ChromaCore, sıkıcı ve klasik Canvas tabanlı kartlardan sıkılan geliştiriciler için tasarlandı. Arka planda Puppeteer ve EJS gücünü kullanarak kusursuz Glassmorphism (Cam efekti) tasarımlarına sahip hoş geldin ve seviye (rank) kartları üretir.

✨ Özellikler

• 🚀 HTML/CSS Tabanlı: Sınırları ortadan kaldırır. Piksellerle boğuşmak yerine web teknolojileriyle derlenir.
• 🪟 Kusursuz Glassmorphism: Karanlık (Dark) ve Aydınlık (Light) tema destekli yarı saydam cam efektleri.
• 🎨 Tamamen Özelleştirilebilir: Kendi arka planınızı, vurgu renginizi (accent color), özel fontlarınızı ve hatta kendi CSS kodlarınızı enjekte edebilirsiniz.
• ⚡ Yüksek Performans: Özel Chromium Singleton mimarisi sayesinde saniyeler içinde görsel üretir, RAM'i yormaz.

📦 Kurulum

Projenize dahil etmek için terminalde şu komutu çalıştırın:

npm install chromacore

🚀 Hızlı Başlangıç

1. Hoş Geldin (Welcome) Kartı Oluşturma

Sunucunuza yeni katılan üyeler için estetik bir karşılama görseli oluşturun.

import { generateWelcomeCard, closeEngine } from 'chromacore';
import fs from 'fs';

async function createWelcome() {
    try {
        const buffer = await generateWelcomeCard({
            username: "Furkan",
            avatar: "https://i.imgur.com/V4RclNb.png", // Kullanıcının profil fotoğrafı URL'si
            title: "YENİ ÜYE",
            message: "Sunucumuza hoş geldin, umarız iyi vakit geçirirsin!",
            memberCount: 1542,
            theme: "dark", 
            backgroundImage: "https://images.unsplash.com/photo-1578632767115-351597cf2477?q=80&w=800&auto=format&fit=crop"
        });

        fs.writeFileSync('welcome.png', buffer);
        console.log("Hoş geldin kartı başarıyla oluşturuldu!");
    } finally {
        // İşlem bitince motoru kapatmayı unutmayın!
        await closeEngine();
    }
}

createWelcome();

2. Seviye / Rank Kartı Oluşturma

Kullanıcıların sunucudaki ilerlemelerini (XP/Level) neon detaylı bir çubukla gösterin.

import { generateRankCard, closeEngine } from 'chromacore';
import fs from 'fs';

async function createRank() {
    try {
        const buffer = await generateRankCard({
            username: "Geliştirici",
            avatar: "https://i.imgur.com/V4RclNb.png",
            currentXp: 850,
            requiredXp: 1000,
            level: 15,
            rank: 3,
            status: "online", // 'online', 'idle', 'dnd', 'offline'
            accentColor: "#6366f1", // XP barı ve Rank metni rengi (Örn: İndigo)
        });

        fs.writeFileSync('rank.png', buffer);
    } finally {
        await closeEngine();
    }
}

createRank();

🛠️ İleri Düzey Özelleştirme (Custom CSS)

ChromaCore'un sunduğu tasarımı kendi botunuzun ruhuna uydurmak çok kolaydır. `customCSS` parametresi ile sınırları aşabilirsiniz:

const buffer = await generateWelcomeCard({
    username: "Anime Sever",
    avatar: "https://...png",
    // Özel font yükleme
    customFontUrl: "https://fonts.googleapis.com/css2?family=Oswald:wght@700&display=swap",
    fontFamily: "'Oswald', sans-serif",
    // HTML üzerindeki elementlere doğrudan CSS müdahalesi
    customCSS: \`
        .avatar { 
            border: 5px solid #ff0055 !important; 
            box-shadow: 0 0 30px #ff0055 !important; 
        }
        .username { color: #ff0055 !important; }
    \`
});

⚙️ API Referansı

`WelcomeCardOptions`

| Parametre | Tip | Zorunlu mu? | Açıklama | | :--- | :--- | :---: | :--- | | `username` | string | Evet | Kullanıcının adı | | `avatar` | string | Evet | Avatar resmi URL'si | | `title` | string | Hayır | Üst başlık (Varsayılan: "HOŞ GELDİN") | | `message` | string | Hayır | Alt mesaj metni | | `memberCount` | number | Hayır | Sunucudaki toplam üye sayısı | | `theme` | 'dark' \| 'light' | Hayır | Kart teması (Varsayılan: 'dark') | | `backgroundImage`| string | Hayır | Arka plan resmi URL'si | | `customCSS` | string | Hayır | Özel CSS kodlarınız | | `customFontUrl` | string | Hayır | Google Fonts vb. dış bağlantı | | `fontFamily` | string | Hayır | Font ailesi ismi |

`RankCardOptions`

(Welcome opsiyonlarına ek olarak)

| Parametre | Tip | Zorunlu mu? | Açıklama | | :--- | :--- | :---: | :--- | | `currentXp` | number | Evet | Mevcut XP | | `requiredXp` | number | Evet | Sonraki seviye için gereken XP | | `level` | number | Evet | Kullanıcının seviyesi | | `rank` | number | Hayır | Sunucudaki sıralaması | | `status` | string | Hayır | Durum ikonu ('online', 'idle', vb.) | | `accentColor` | string | Hayır | Vurgu rengi HEX/RGB (Varsayılan: '#6366f1') |

🛑 Önemli Not (Motoru Kapatmak)

ChromaCore, maksimum performans için arka planda bir Chromium tarayıcısı barındırır (Singleton mimarisi). Botunuz komutları işledikçe aynı tarayıcı sekme açıp kapatarak çalışır. Botunuzu tamamen kapatırken veya işlem döngülerinizin sonunda `await closeEngine();` fonksiyonunu çağırmayı unutmayın, aksi takdirde arka planda açık bir süreç (process) kalabilir.

📜 Lisans

Bu proje MIT Lisansı ile lisanslanmıştır.

Crafted with 💖 by Furkan (Aiko Development)