# 🎮 CubicHome – Начална страница на премиум сървър за Minecraft

Модерен шаблон от висок клас за начална страница на сървъри за Minecraft. Създаден с TailwindCSS, с функции за показване на състоянието на сървъра в реално време, плавни анимации и защита срещу кражба.


---

## ✨ Характеристики

### 🎯 Основни функции

- **Статус на сървъра в** реално време – брой играчи в реално време и статус на сървъра чрез API-то на mcstatus.io
- **Копиране на IP адреса с едно кликване** – копирайте IP адреса на сървъра с атрактивни изскачащи уведомления
- **Автоматично определяне на местоположението на сървъра** – автоматично открива и показва местоположението на сървъра с флага на съответната държава
- **Раздел „Екип“** – Представете своя екип с аватари от Minecraft на mc-heads.net
- **Адаптивен за мобилни устройства** – изцяло адаптивен дизайн за всички устройства

### 🎨 Дизайн от най-високо качество

- **Съвременен потребителски интерфейс** – „Glassmorphism“, градиенти и плавни анимации
- **3D мишка с паралакс** – фонът на героя следва движението на мишката
- **Анимирани елементи** – плаващи частици, пулсиращи индикатори за състояние, ефекти при навеждане с мишката
- **Ефект „Premium Glow“** – Привличащи погледа анимации със сияние върху ключови елементи
- **Тъмна тема** – Красива тъмна естетика за игри

### 🔒 Защита срещу кражба

- **Откриване на DevTools** – блокира съдържанието на страницата, когато DevTools е отворен
- **Деактивирано кликване с десния бутон** – предотвратява достъпа до контекстното меню
- **Блокирани клавишни комбинации** – блокира Ctrl+U, Ctrl+S, F12, Ctrl+Shift+I
- **Настройваемо** — може да бъде деактивирано при разработката

### ⚡ Бързи връзки

- Интеграция с магазини (Tebex, CraftingStore и др.)
- Бутон за покана в Discord
- Връзки за гласуване

---

## 📦 Инсталиране

1. **Изтеглете** файловете с шаблоните
2. **Качи** на своя уеб хостинг
3. **Редактирай,** `assets/js/config.js`за да персонализираш
4. **Готово!** Вашата целева страница е готова

---

## ⚙️ Конфигурация

Всички настройки се намират в`assets/js/config.js`:

### Брандиране на шаблони

```javascript
template: {
name: "CubicHome", // Your brand name
year: "2025", // Copyright year
copyright: "© {year} {name} Template",
templateProtect: true // Anti-theft protection (true/false)
}
```

### Настройки на сървъра

```javascript
server: {
name: "Your Server Name", // Displayed in hero section
ip: "play.yourserver.com", // Server IP for players
port: 25565, // Server port
isBedrock: false, // true for Bedrock servers
}
```

### Бързи връзки

```javascript
links: {
store: {
enabled: true,
url: "https://store.yourserver.com",
label: "Store",
description: "Get ranks & items"
},
discord: {
enabled: true,
url: "https://discord.gg/YOUR_INVITE"
},
vote: {
enabled: true,
url: "https://minecraft-server.net/vote/yourserver"
}
}
```

### Екипът

```javascript
staff: [
{
username: "Notch", // Minecraft username (auto-fetches avatar)
role: "Owner", // Their role
color: "amber", // Tailwind color: amber, red, blue, green, purple
},
// Add more staff members...
];
```

### Раздел „Характеристики“

```javascript
features: [
{
icon: "bi-gem", // Bootstrap icon
title: "Custom Items",
description: "Unique weapons and tools.",
gradient: "from-purple-500 to-pink-500",
},
// Add up to 4 features...
];
```

### Настройки на темата

```javascript
theme: {
enableSmoothScroll: true, // Smooth scroll on anchor clicks
enableAnimations: true, // Enable scroll animations
enableParallax: true // Enable mouse parallax effect
}
```

---

## 🎨 Персонализиране

### Промяна на цветовете

Редактирайте конфигурацията на TailwindCSS в`index.html`:

```javascript
tailwind.config = {
theme: {
extend: {
colors: {
primary: "#4ade80", // Main green
"primary-dark": "#22c55e",
accent: "#fbbf24", // Gold accent
surface: "#1e293b",
dark: "#0f172a",
},
},
},
};
```

### Промяна на фона на героя

Заменете `assets/img/hero.jpg`със собствена картинка.

### Промяна на фавикона

Заменете `assets/img/favicon.png`с вашата собствена икона за фавикон.

---

## 📁 Структура на файловете

```
CubicHome/
├── index.html # Main HTML file
├── README.md # This file
├── assets/
│ ├── css/
│ │ └── style.css # All custom styles
│ ├── js/
│ │ ├── config.js # Configuration file
│ │ └── main.js # Main JavaScript
│ └── img/
│ ├── hero.jpg # Hero background
│ └── favicon.png # Site favicon
```

---

## 🔧 Използвани технологии

- **HTML5** – Семантично маркиране
- **TailwindCSS** – CSS с приоритет на функционалността (чрез CDN)
- **Bootstrap Icons** – Библиотека с икони (чрез CDN)
- **Vanilla JavaScript** – не се изисква jQuery
- **API на mcstatus.io** – Състояние на сървъра
- **mc-heads.net** - Аватари за Minecraft
- **flagcdn.com** - Знамена на държави
- **ipwho.is** – Геолокация по IP адрес

---

## 🛡️ Защита срещу кражба

Шаблонът включва вградена защита срещу неразрешено копиране:

| Характеристика | Описание |
| ------------------ | --------------------------------------------- |
| Откриване чрез DevTools | Заменя съдържанието на страницата при отваряне на DevTools |
| Блок „Клик с десния бутон“ | Деактивира контекстното меню |
| Ctrl+U Блок | Предотвратява бързия достъп до „Преглед на изходния код“ |
| Блок F12 | Предотвратява използването на бързите клавиши на DevTools |
| Откриване на дебъгера | Открива, когато изпълнението на JavaScript е в пауза |

**За да го деактивирате за целите на разработката:**

```javascript
template: {
templateProtect: false; // Disable protection
}
```

---

## 📄 Лиценз и благодарности

**Шаблон от:** illusion @ [CodeStrike.STORE](https://codestrike.store)

**Условия за ползване:**

- ✅ Използвайте за лични проекти или проекти на клиенти
- ✅ Променяйте и персонализирайте според нуждите си
- ❌ Да препродавате или разпространявате шаблона
- ❌ Премахване на кредити без разрешение

---

## 🆘 Поддръжка

За поддръжка посетете [CodeStrike.STORE](https://codestrike.store) или се присъединете към нашия Discord.

---

**Създадено с ❤️ от illusion @ CodeStrike.STORE**