# 🎮 CubicHome – strona główna serwera Minecraft klasy premium

Nowoczesny, wysokiej jakości szablon strony docelowej dla serwerów Minecraft. Stworzony przy użyciu TailwindCSS, wyposażony w funkcję wyświetlania aktualnego stanu serwera, płynne animacje oraz zabezpieczenie przed kradzieżą.


---

## ✨ Funkcje

### 🎯 Najważniejsze funkcje

- **Aktualny stan serwera** – liczba graczy w czasie rzeczywistym oraz stan serwera za pośrednictwem interfejsu API mcstatus.io
- **Kopiowanie adresu IP jednym kliknięciem** — skopiuj adres IP serwera z eleganckimi powiadomieniami typu „toast”
- **Automatyczne wykrywanie lokalizacji serwera** — automatycznie wykrywa i wyświetla lokalizację serwera wraz z flagą kraju
- **Sekcja „Zespół”** – zaprezentuj swój zespół za pomocą awatarów z gry Minecraft z serwisu mc-heads.net
- **Dostosowanie do urządzeń mobilnych** – w pełni responsywny projekt dostosowany do wszystkich urządzeń

### 🎨 Wysokiej jakości projekt

- **Nowoczesny interfejs użytkownika** – glassmorfizm, gradienty i płynne animacje
- **Efekt paralaksy w myszy 3D** – tło z bohaterem podąża za ruchem myszy
- **Elementy animowane** – unoszące się cząsteczki, pulsujące kropki stanu, efekty po najechaniu kursorem
- **Efekt „Premium Glow”** – przyciągające wzrok animacje świecące na kluczowych elementach
- **Ciemny motyw** – piękna, mroczna estetyka gier

### 🔒 Zabezpieczenie przed kradzieżą

- **Wykrywanie DevTools** – blokuje zawartość strony po otwarciu DevTools
- **Wyłączono kliknięcie prawym przyciskiem myszy** – uniemożliwia dostęp do menu kontekstowego
- **Zablokowane skróty klawiaturowe** — blokuje skróty Ctrl+U, Ctrl+S, F12, Ctrl+Shift+I
- **Konfigurowalne** — można wyłączyć na potrzeby prac programistycznych

### ⚡ Szybkie linki

- Integracja ze sklepami (Tebex, CraftingStore itp.)
- Przycisk zaproszenia do Discorda
- Linki do głosowania

---

## 📦 Instalacja

1. **Pobierz** pliki szablonów
2. **Prześlij pliki** na swój serwer hostingowy
3. **Edytuj,** `assets/js/config.js`aby dostosować
4. **Gotowe!** Twoja strona docelowa jest gotowa

---

## ⚙️ Konfiguracja

Wszystkie ustawienia znajdują się w`assets/js/config.js`:

### Branding szablonów

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

### Ustawienia serwera

```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
}
```

### Szybkie linki

```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"
}
}
```

### Zespół pracowników

```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...
];
```

### Sekcja „Cechy”

```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...
];
```

### Ustawienia motywu

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

---

## 🎨 Personalizacja

### Zmiana kolorów

Edytuj konfigurację TailwindCSS w pliku`index.html`:

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

### Zmiana tła bohatera

Zastąp`assets/img/hero.jpg` własnym obrazkiem.

### Zmiana ikony strony

Zastąp `assets/img/favicon.png`to swoim własnym favikonem.

---

## 📁 Struktura plików

```
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
```

---

## 🔧 Zastosowane technologie

- **HTML5** – znacznikowanie semantyczne
- **TailwindCSS** – CSS oparty na funkcjach (przez CDN)
- **Ikony Bootstrap** – biblioteka ikon (przez CDN)
- **Vanilla JavaScript** – nie wymaga użycia jQuery
- **API mcstatus.io** – Stan serwera
- **mc-heads.net** – awatary do gry Minecraft
- **flagcdn.com** – Flagi państw
- **ipwho.is** – geolokalizacja adresów IP

---

## 🛡️ Zabezpieczenie przed kradzieżą

Szablon zawiera wbudowane zabezpieczenie przed nieautoryzowanym kopiowaniem:

| Funkcja | Opis |
| ------------------ | --------------------------------------------- |
| Wykrywanie za pomocą DevTools | Zastępuje zawartość strony po otwarciu DevTools |
| Blokowanie kliknięcia prawym przyciskiem myszy | Wyłącza menu kontekstowe |
| Ctrl+U – Blok | Blokuje skrót „Wyświetl źródło” |
| Blok F12 | Blokuje skrót klawiszowy DevTools |
| Wykrywanie debuggera | Wykrywa wstrzymanie wykonywania kodu JavaScript |

**Aby wyłączyć tę funkcję na potrzeby programowania:**

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

---

## 📄 Licencja i podziękowania

**Szablon autorstwa:** illusion @ [CodeStrike.STORE](https://codestrike.store)

**Warunki korzystania:**

- ✅ Do wykorzystania w projektach osobistych lub realizowanych dla klientów
- ✅ Modyfikuj i dostosowuj według potrzeb
- ❌ Odsprzedaż lub dalsze rozpowszechnianie szablonu
- ❌ Usuwanie napisów końcowych bez zgody

---

## 🆘 Pomoc techniczna

Aby uzyskać pomoc, odwiedź [stronę CodeStrike.STORE](https://codestrike.store) lub dołącz do naszego serwera na Discordzie.

---

**Stworzone z ❤️ przez illusion @ CodeStrike.STORE**