Türkçe · English · Wiki · İndir / Download
VibeCraft, Minecraft sunucuları için kendi hostinginizde çalışan topluluk sitesi, mağaza ve oyun içi teslimat platformudur. Türkçe ve İngilizce hazır gelir.
- Web sitesi: PHP 8.4+, Laravel 13, Blade ve sade CSS/JavaScript. Node derlemesi, Redis veya sürekli çalışan bir kuyruk işçisi gerekmez. Zamanlanmış işler tek bir cron satırıyla çalışır; paylaşımlı cPanel hostinge uygundur.
- Oyun eklentisi: Paper 26.3 / Java 25 için VibeCraft Paper Bridge (Velocity modern forwarding ve Floodgate desteklenir). İmzalı teslimatları siteden çeker ve kalıcı bir yerel kayıt tutar; aynı komut iki kez çalışmaz.
Ekran görüntülerinde örnek verili hayali bir demo sunucu ("Emberfall") ve pakette gelen görseller kullanılmıştır.
On hazır tema gelir; hepsi yönetim panelinden tek tıkla değişir, içerik ve siparişler yerinde kalır.
Tema ayrıntıları: Wiki → Görünüm ve Temalar.
- On hazır tema: Atlas, Forge, Volt, Nomad, Mono ve yeni Prism (sıvı cam), Arcade (retro piksel), Terminal (komut konsolu), Brick (cesur bloklar), Dusk (neon gün batımı). Tema renk düzenleyici, ana sayfa bölüm sırası, üst/alt menü düzenleyici ve denetlenen özel CSS. Her temaya özgü, yönetimden ayarlanan canlı imleç ve dokunma efektleri.
- Mağaza: kategoriler, kuponlar, kredi kodları, bonuslu kredi paketleri, başka oyuncuya hediye, hesap bakiyesinden otomatik yenilenen süreli rütbeler ve teslimat sandığı.
- Her hareketin bir kez işlendiği cüzdan defteri; imzalı webhook'larla Stripe ve PayTR ödemeleri.
- Doğrulanmış Minecraft (Java ve Bedrock) hesap bağlama, Discord bağlama, oyuncu profilleri ve rozetler.
- Haberler, sayfalar, sürüm geçmişli ve okuyucu erişim kurallı sunucu rehberi (wiki), forum, destek talepleri, yetkili başvuruları, oy siteleri, sıralamalar ve cezalar sayfası.
- Yükleme destekli görsel seçici ve pakette gelen özgün piksel sanat ikon kütüphanesi.
- Site sahibinin yönettiği hukuki belgeler ve sipariş anı kayıtları, personel rolleri ve yetkileri, TOTP iki aşamalı doğrulama ve denetim günlüğü.
- Son sürümden
vibecraft-<sürüm>.zipdosyasını indirin veSHA256SUMSile doğrulayın. - Alan adı için PHP 8.4+ seçin, boş bir MySQL/MariaDB veritabanı ve kullanıcı oluşturun.
- Zip'i yükleyip açın; alan adının kök klasörünü
public/klasörüne yönlendirin (ya da içeriği doğrudanpublic_htmliçine koyun; pakette gelen.htaccesspublic/dışındaki her şeyi erişilemez tutar). - Sitenizi açın: tarayıcıdaki kurulum sihirbazı
storage/app/setup-token.txtdosyasındaki kurulum kodunu, veritabanı bilgilerini ve sahip hesabını ister. Terminal gerekmez. - Sihirbazın gösterdiği cron satırını ekleyin.
Ekran ekran anlatım: Wiki → Kurulum.
Her sürümle hazır VibeCraftBridge-<sürüm>.jar gelir. Sunucunun plugins/ klasörüne koyun ve
Wiki → Paper Eklentisi adımlarını izleyin. Kaynaktan derlemek için
Wiki → Geliştirme sayfasına bakın.
| Wiki (Türkçe) | Kurulum, mağaza, ödemeler, eklenti, temalar, güvenlik, bakım ve sorun giderme |
| Kurulum ve işletim | Ayrıntılı kurulum, cron, güncelleme ve kurtarma (İngilizce) |
| Güvenlik | Dağıtım sınırları, Cloudflare profili ve yedekler (İngilizce) |
| Kabul kontrol listesi | Gerçek ödeme almadan önce hostingde yapılacak kontroller |
Güvenlik açıklarını herkese açık issue yerine SECURITY.md dosyasında anlatıldığı gibi gizli olarak bildirin.
VibeCraft'ı ve eklentisini kendi sunucularınız ve topluluğunuz için (kendi mağazasıyla gelir elde eden sunucular dahil) kurabilir, değiştirebilir ve kullanabilirsiniz. VibeCraft'ı, eklentiyi, bir fork'u veya adı değiştirilmiş bir kopyasını satmak, kiralamak, yeniden satmak ya da ücretli ürün veya barındırma hizmeti olarak sunmak yasaktır. Kopyalanan kod VibeCraft'a atıf vermelidir. Ayrıntılar LICENSE ve NOTICE dosyalarındadır.
VibeCraft resmi bir Minecraft ürünü değildir; Mojang veya Microsoft tarafından onaylanmamıştır ve onlarla bağlantılı değildir.
A self-hosted community website, store and in-game delivery platform for Minecraft servers. Turkish and English out of the box.
- Website: PHP 8.4+, Laravel 13, Blade and plain CSS/JavaScript. No Node build step, no Redis and no long-running queue worker are required. Scheduled work runs from a single cron line, so it fits shared cPanel hosting.
- Game plugin: the VibeCraft Paper Bridge for Paper 26.3 / Java 25 (Velocity modern forwarding and Floodgate supported). It pulls signed deliveries from the website and keeps a durable local journal so a command is never run twice.
| Forge | Volt |
|---|---|
![]() |
![]() |
| Nomad | Mono |
![]() |
![]() |
| Prism — liquid glass | Arcade — retro pixel |
![]() |
![]() |
| Terminal — command console | Brick — bold blocks |
![]() |
![]() |
| Dusk — neon sunset | Atlas — network |
![]() |
![]() |
Theme details: Wiki → Appearance and Themes.
| Store | Product |
|---|---|
![]() |
![]() |
| Servers | Credit packages |
![]() |
![]() |
| Image picker with the bundled icon library | Mobile |
|---|---|
![]() |
![]() |
- Ten built-in themes: Atlas, Forge, Volt, Nomad, Mono and the new Prism (liquid glass), Arcade (retro pixel), Terminal (command console), Brick (bold blocks) and Dusk (neon sunset), with a theme editor, home-section ordering, header/footer menu editor and checked custom CSS. Each theme has its own live mouse and tap effect, adjustable or switched off in the admin panel.
- Store with categories, coupons, gift codes, credit packages with bonus credit, gifts to other players, timed ranks with automatic renewal from the account balance and a delivery chest.
- Wallet ledger with idempotent postings; Stripe and PayTR payments with signed webhooks.
- Verified Minecraft (Java and Bedrock) account linking, Discord linking, player profiles and badges.
- News, pages, a server guide / wiki with revision history and reader access rules, forum, tickets, staff applications, vote sites, leaderboards and a punishments page.
- Image picker with uploads and a bundled library of original pixel-art icons.
- Owner-managed legal documents with order-time evidence, staff roles and permissions, TOTP two-factor authentication and an audit log.
- PHP 8.4 or newer with the extensions listed in docs/INSTALL.md (including PDO MySQL, GD, intl, mbstring and OpenSSL)
- MySQL 8 or MariaDB with InnoDB (SQLite is used for tests)
- HTTPS for production
- For the plugin: Paper 26.3 with Java 25
- Download
vibecraft-<version>.zipfrom the latest release and verify it withSHA256SUMS. - Select PHP 8.4+ for the domain, create an empty MySQL/MariaDB database and user.
- Upload and extract the zip, point the domain to its
public/folder (or put the contents inpublic_html; the bundled.htaccesskeeps everything exceptpublic/unreachable). - Open your site: the browser installer asks for the setup token from
storage/app/setup-token.txt, the database details and the owner account. No terminal needed. - Add the cron line shown by the installer.
Step-by-step guide with the cPanel menu names: Wiki → Installation.
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan vibecraft:setup-token
php artisan serve --host=127.0.0.1Set APP_ENV=local, APP_URL=http://localhost:8000 and SESSION_SECURE_COOKIE=false for local use and
point the database settings at a local MySQL/MariaDB. Open /install and use the setup token to create the
owner account. There is no default user or password. Composer 2 is needed for a source checkout.
Each release ships a ready VibeCraftBridge-<version>.jar: drop it into the server's plugins/ folder and
follow Wiki → Paper Plugin. To build it yourself without Gradle, Maven or
downloads, put the six pinned API jars listed in bridge/paper/dependencies.sha256 in a directory, then:
cd bridge/paper
sh build.sh /absolute/path/to/provided-api-jarsThe jar is written to bridge/paper/target/. The wire protocol is in docs/BRIDGE.md.
php artisan test
php -d opcache.enable_cli=0 vendor/bin/phpstan analyse --memory-limit=256M --no-progress| Wiki (English) | Installation, store, payments, plugin, themes, security, maintenance and troubleshooting |
| Installation and operations | Detailed install, cron, updates and recovery |
| Security | Deployment boundaries, Cloudflare profile and backups |
| Release checklist | Checks on the real host before taking real payments |
Deployment hardening is described in docs/SECURITY.md. Please report vulnerabilities privately as described in SECURITY.md, not in public issues.
VibeCraft is licensed under the VibeCraft License: the PolyForm Noncommercial License 1.0.0 with additional terms. You may build, change and run VibeCraft and its plugin for your own servers and community, including servers that earn money through their own store. You may not sell, rent or resell VibeCraft, the plugin, a fork or a renamed copy, or offer it as a paid product or hosted service. Copied code must credit VibeCraft. See NOTICE for a summary and third-party licenses.
VibeCraft is not an official Minecraft product and is not approved by or associated with Mojang or Microsoft.
















