How raghavtandonn/orcs-vs-elves works
Orcs vs Elves is a server-authoritative, single-player Roblox bubble-battle game. A player enters through the title screen, aims and launches bouncing bubbles, and the server simulation resolves hits, enemy fire, combos, waves, score, and lives; client rendering and HUD present the run. Score progression, revive/gamepass support, cosmetics and crates, saved data, and period-based leaderboards are distinct supporting capabilities. The README establishes the product structure and capabilities; runtime source excerpts were not provided, so implementation-level links are omitted or marked unverified rather than inferred.
Main entry points: ArenaRenderer.luau Arena Renderer · ShopService.luau Shop Service · ArenaServer.luau Arena Server · LeaderboardService.luau Leaderboard Service
Components 22
Client Experience
- Title Screen
src/Client/TitleScreen.luau - Aim Controls
src/Client/AimController.luau - Arena Renderer
src/Client/ArenaRenderer.luau - Unit Sprites
src/Client/UnitSprite.luau - Game HUD
src/Client/Hud.luau - Game Effects
src/Client/Effects.luau - Shop Interface
src/Client/ShopGui.luau - Crate Opener
src/Client/CrateOpener.luau - Leaderboard UI
src/Client/LeaderboardGui.luau
Server Game Services
- Arena Server
src/Server/ArenaServer.luau - Save Service
src/Server/SaveService.luau - Shop Service
src/Server/ShopService.luau - Gamepass Service
src/Server/GamepassService.luau - Leaderboard Service
src/Server/LeaderboardService.luau
Shared Game Logic
- Arena Simulation
src/Shared/ArenaSim.luau - Arena Tuning
src/Shared/ArenaConfig.luau - Network Definitions
src/Shared/Net.luau - Cosmetics Catalog
src/Shared/Cosmetics.luau - Crate Catalog
src/Shared/Crates.luau
Other components
- Player
- Roblox Services
- Ordered DataStores
Connections 19
- Player → Title Screen: enters
- Player → Aim Controls: aims and launches
- Aim Controls → Arena Server: sends launch
- Arena Server → Arena Simulation: resolves gameplay
- Arena Tuning → Arena Simulation: tunes
- Arena Server → Arena Renderer: replicates run state
- Arena Renderer → Unit Sprites: draws units
- Arena Renderer → Game Effects: presents impacts
- Arena Renderer → Game HUD: presents run status
- Shop Interface → Shop Service: requests purchases
- Crate Opener → Shop Service: requests crate actions
- Crate Catalog → Crate Opener: defines contents
- Cosmetics Catalog → Shop Service: catalogs items
- Shop Service → Save Service: persists purchases
- Leaderboard UI → Leaderboard Service: requests rankings
- Leaderboard Service → Ordered DataStores: stores rankings
- Save Service → Roblox Services: uses persistence
- Gamepass Service → Roblox Services: checks entitlement
- Leaderboard Service → Roblox Services: uses platform services