🎮 Minecraft x RuneScape Unity Game

A multiplayer voxel game combining Minecraft's building mechanics with RuneScape's OSRS skill progression system.

🎯 Features

⚡ Core Systems

• Voxel World Engine: Dynamic chunk loading with 17 different block types
• Perlin Noise Terrain: Procedural world generation
• 4-Player Multiplayer: Photon PUN 2 networking (WebGL compatible)
• WebGL Deployment: Play in browser with friends

📈 OSRS Skill System (Level 1-99)

• Mining: Extract ores and resources
• Woodcutting: Chop trees for wood
• Fishing: Catch fish for food
• Smithing: Craft weapons and armor
• Crafting: Create items from materials
• Combat: Fight monsters and players

💾 Save System

• Auto-Save: 120-second intervals
• WebGL Compatible: Uses PlayerPrefs for browser storage
• Chunk Persistence: Save/load entire worlds
• Player Data: Skills, inventory, and progression

🎨 Complete UI

• HUD System: Health, inventory, hotbar
• Skill Menus: XP tracking and level-ups
• Crafting Interface: Recipe system with level gating
• Notifications: Level-up toasts and alerts

🚀 Quick Start

Prerequisites

• Unity 2022.3 LTS or newer
• Photon PUN 2 plugin
• 4 players maximum per world

Setup

1. Clone: git clone https://github.com/RobinGase/minecrafty-OSRS.git
2. Open Unity: Import project in Unity Hub
3. Install Photon: Package Manager → Photon PUN 2
4. Build Settings: Switch to WebGL platform
5. Play: Host a room and invite friends!

Documentation

• Setup Guide: Documentation/SETUP_GUIDE.md
• Multiplayer: Documentation/MULTIPLAYER_GUIDE.md
• Build Instructions: Documentation/BUILD_INSTRUCTIONS.md

🎮 Gameplay

Building & Exploration

• Place and break blocks in real-time
• Explore procedurally generated worlds
• Dynamic chunk loading for large worlds

Skills & Progression

• Gain XP by performing actions (Mining, Woodcutting, etc.)
• Level 1-99 progression system
• Unlock new recipes and abilities as you level

Multiplayer

• Host private rooms for up to 4 players
• Real-time world synchronization
• Player state replication

🛠️ Technical Details

37+ Unity C# Scripts

• Core Systems: World generation, chunk management, game loop
• Networking: Photon integration with 8 scripts
• Skills: 10 scripts implementing OSRS progression
• Persistence: 9 save/load scripts
• UI: 17 interface scripts
• Audio/Visual: 4 asset management scripts

Performance

• Run-Length Encoding (RLE) for chunk compression
• Dynamic chunk loading/unloading
• Efficient voxel rendering

Compatibility

• Platforms: Windows, Mac, WebGL
• Unity Version: 2022.3 LTS
• Networking: Photon PUN 2

🎯 Ready to Play!

This is a complete, production-ready voxel game. All systems are implemented and tested. Perfect for playing with friends right away!

Next Steps

1. Follow the setup guide (~20 minutes)
2. Build for WebGL or desktop
3. Host a room and invite friends
4. Start your OSRS journey in 3D!

---

Author: RG
Repository: https://github.com/RobinGase/minecrafty-OSRS
Status: Complete and ready to play! 🎉