Clicker Legends: Multiverse - Základ Hry pro Roblox Studio

Struktura Projektu

ClickerLegends/
├── ServerScriptService/
│   └── ServerMain.lua              # Hlavní serverový skript (SSA)
├── ReplicatedStorage/
│   ├── Config/
│   │   └── GameConfig.lua          # Centralizovaná konfigurace hry
│   └── Modules/
│       ├── Server/
│       │   ├── PlayerDataService.lua   # Správa dat hráčů (DataStore)
│       │   ├── ClickService.lua        # Zpracování kliků + anti-cheat
│       │   ├── PetService.lua          # Systém mazlíčků
│       │   ├── UpgradeService.lua      # Upgrady a jejich ceny
│       │   ├── RebirthService.lua      # Rebirth/prestige systém
│       │   ├── StatsService.lua        # Synchronizace statistik
│       │   └── WorldService.lua        # Správa světů
│       ├── Client/
│       │   ├── ClickController.lua     # Klientská klikací logika
│       │   └── UIController.lua        # Uživatelské rozhraní
│       └── Shared/
│           └── NumberFormatter.lua     # Formátování velkých čísel
└── StarterPlayer/
    └── StarterPlayerScripts/
        └── ClientMain.lua              # Hlavní klientský skript

Jak Nasadit do Roblox Studia

Krok 1: Vytvoření Nového Projektu

1. Otevřete Roblox Studio
2. Vytvořte nový projekt (Baseplate nebo prázdný)

Krok 2: Struktura Složek

V Exploreru vytvořte tyto složky (pokud neexistují):

• ReplicatedStorage/Config
• ReplicatedStorage/Modules/Server
• ReplicatedStorage/Modules/Client
• ReplicatedStorage/Modules/Shared

Krok 3: Import Skriptů

Pro každý .lua soubor:

1. Klikněte pravým tlačítkem na cílovou složku
2. Insert Object → ModuleScript (pro moduly) nebo Script/LocalScript
3. Přejmenujte na správné jméno (bez .lua)
4. Zkopírujte obsah souboru

Typy skriptů:

• ServerMain.lua → Script v ServerScriptService
• ClientMain.lua → LocalScript v StarterPlayer/StarterPlayerScripts
• Všechny ostatní → ModuleScript v příslušných složkách

Krok 4: Vytvoření Světů

V Workspace vytvořte složku Worlds a podsložky pro každý svět:

Workspace/
└── Worlds/
    ├── StarterMeadow/
    │   └── SpawnPoint (Part s názvem "SpawnPoint")
    ├── MagmaCave/
    │   └── SpawnPoint
    ├── NeonCity/
    │   └── SpawnPoint
    ├── Atlantis/
    │   └── SpawnPoint
    └── VoidDimension/
        └── SpawnPoint

Krok 5: Klikací Zóna

Vytvořte Part pojmenovaný ClickZone ve Workspace - na tento objekt budou hráči klikat.

Krok 6: Konfigurace Gamepassů

V GameConfig.lua nahraďte ID = 0 skutečnými Gamepass ID z vašeho asset manageru.

Klíčové Systémy

Anti-Cheat "Click Capacitor"

• Maximálně 20 kliků za sekundu
• Buffer 2x pro toleranci lagu
• Server validuje všechny kliky

Ekonomika

• Ceny rostou koeficientem 1.15 (zdvojnásobení každých ~5 levelů)
• Rebirth tokeny: kubická odmocnina z lifetimeCP / 1M

Pet Systém

• Varianty: Normal (1x), Shiny (1.5x), Golden (3x), Rainbow (10x)
• XP za klik, level = sqrt(XP/50)
• Fúze: 5 Normal → 1 Golden, 5 Golden → 1 Rainbow

Combo Systém

• 3s timeout
• Multiplikátor 1.2x až 2.0x (při 100 combo)

Kritický Klik

• 5% šance
• 10x zisk

Datová Struktura Hráče

{
    CP = 0,                 -- Click Points
    Gems = 0,               -- Premium měna
    RebirthTokens = 0,      -- Prestige měna
    LifetimeCP = 0,         -- Celkové CP (pro rebirth výpočet)
    TotalClicks = 0,
    TotalRebirths = 0,
    HighestCombo = 0,
    PlayTime = 0,
    
    Upgrades = {},          -- {UpgradeID = level}
    Pets = {},              -- Pole pet objektů
    EquippedPets = {},      -- UUID vybavených petů
    PetSlots = 5,
    
    UnlockedSkills = {},    -- {SkillID = true}
    SkillPoints = 0,
    
    CurrentWorld = "StarterMeadow",
    UnlockedWorlds = { StarterMeadow = true },
    
    Gamepasses = {},        -- Zakoupené gamepassy
    FirstJoin = 0,
    LastJoin = 0,
    DataVersion = 1
}

Remote Events

Server automaticky vytváří tyto Remote Events:

• SendClicks - Odeslání batch kliků
• BuyUpgrade - Nákup upgradu
• HatchEgg - Otevření vajíčka
• EquipPet / UnequipPet - Správa petů
• DoRebirth - Provedení rebirthu
• UnlockSkill - Odemčení dovednosti
• TeleportToWorld - Teleport mezi světy

Testování

1. Spusťte hru v Roblox Studio (F5)
2. Otevřete Output okno pro debug zprávy
3. Ověřte, že se zobrazí:
   • [ServerMain] Initializing services...
   • [ClientMain] All controllers initialized successfully!

Další Vývoj

Co přidat:

• Boss Battle systém (spawn logic, damage tracking)
• UI assety (ikony měn, pet modely, egg modely)
• Sound effects (klik, kritický klik, level up)
• Particle effects
• Leaderboard
• Tutorial/onboarding
• Settings menu

Poznámky:

• Všechny rbxassetid://0 nahraďte skutečnými asset ID
• DataStore klíč: Player_{UserId}
• Auto-save interval: 60 sekund

---

Vytvořeno podle GDD dokumentu "Clicker Legends: Multiverse"