> For the complete documentation index, see [llms.txt](https://docs.theroomssol.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.theroomssol.fun/readme.md).

# Introduction

<div align="center"><img src="https://4258377446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP0cxGjV3Zz5TxuYzrWjm%2Fuploads%2Fgit-blob-8ad43ddc7089c32f2ff38af2575cc37c750ff41f%2Ftheroomslogo.png?alt=media" alt="TheRooms Logo" width="400"></div>

## TheRooms

Welcome to **TheRooms** - a social metaverse building game inspired by Habbo Hotel, built with cutting-edge web technologies.

### 🎮 What is TheRooms?

TheRooms is a browser-based 3D social space where players can:

* Explore and build in customizable rooms
* Interact with other players in real-time
* Place and arrange furniture
* Customize their character from 45+ models
* Socialize and chat with the community

Think Habbo Hotel meets modern web3 gaming - accessible directly in your browser with no downloads required.

![TheRooms Gameplay](https://4258377446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP0cxGjV3Zz5TxuYzrWjm%2Fuploads%2Fgit-blob-db05fcafdca419e60a4c7cd60dd1378075cec59c%2FScreenshot%202025-11-17%20043335.png?alt=media)

*Explore unique room layouts with your customized character*

### 🚀 Current State

We're in **active development** and building this project live! Here's what's working now:

#### ✅ Implemented Features

* **8 Unique Room Types**: Small, Medium, Large, Studio, L-Shape, Penthouse, Loft, and Suite - each with unique layouts (L-shapes, T-shapes, Plus configurations)
* **Character System**: 45+ character models with smooth animations
* **Realistic Movement**: Natural collision detection and player movement
* **Furniture Placement**: Easy drag-and-drop system for arranging furniture
* **Isometric Camera**: Smooth camera controls optimized for each room type
* **Chat System**: Real-time communication between players
* **State Persistence**: Your room settings and furniture arrangements save automatically
* **NPC System**: Interactive NPCs that wander around rooms

### 📺 Live Development

We're **livestreaming the entire development process** on [Pump](https://pump.fun)!

Join us to:

* Watch features being built in real-time
* Suggest ideas and provide feedback
* See bugs getting fixed live
* Be part of the development journey

### 🗺️ Roadmap

#### Short Term (Next Weeks)

* [ ] Deploy a basic demo
* [ ] Multiplayer synchronization
* [ ] More furniture items and categories
* [ ] Enhanced NPC interactions and dialogue
* [ ] Room customization (colors, textures)
* [ ] Player inventory system

#### Medium Term

* [ ] Room ownership and permissions
* [ ] Trading system for furniture and items
* [ ] Mini-games and activities
* [ ] Social features (friends, private messages)
* [ ] Mobile optimization

#### Long Term

* [ ] Token-based economy (room yielding)
* [ ] User-generated content
* [ ] Cross-room portals
* [ ] Events and competitions
* [ ] DAO governance

### 💡 Ideas & Future Concepts

We're exploring several exciting directions:

* **Room Yielding**: Tokenize rooms so owners can earn from visitor activity
* **Creator Economy**: Let players design and sell custom furniture
* **Social Events**: Concerts, parties, and community gatherings
* **Quest System**: Daily challenges and achievements
* **Seasonal Content**: Special items and rooms for events
* **VIP Spaces**: Premium rooms with unique features

### 🤝 We Want Your Feedback!

This is a community-driven project, and your input matters! We're looking for feedback on:

* What features excite you most?
* What room types or furniture would you like to see?
* Ideas for social interactions and activities
* Technical suggestions and improvements
* UI/UX feedback

#### How to Contribute Feedback

* Watch our livestreams and comment in real-time
* Join discussions in our telegram
* Test the game and report bugs

### 🎯 Our Vision

We're building TheRooms to be:

* **Accessible**: No downloads, no wallet required to start
* **Social**: Real connections and community-first
* **Creative**: Express yourself through building and customization
* **Fair**: Transparent development with community input
* **Fun**: Engaging gameplay that keeps you coming back

### 📚 Documentation

* [Getting Started](/getting-started/getting-started.md) - Set up and play the game
* [Features Guide](/getting-started/features.md) - Detailed overview of all features
* [What's Next?](/getting-started/whats-next.md) - Upcoming tasks and priorities
* [Links and Social](/community/community.md) - Join our community and stay connected

### 🌐 Community & Links

* **Website**: [theroomssol.fun](https://theroomssol.fun)
* **Documentation**: [docs.theroomssol.fun](https://docs.theroomssol.fun/)
* **Twitter/X**: [x.com/theroomsfun](https://x.com/theroomsfun) ⚠️ **Official Source**
* **Telegram**: TBA
* **Livestream**: TBA
* **Contract Address** (Pump): TBA

> **⚠️ IMPORTANT**: For official confirmation of contract addresses and other details, **ALWAYS check our Twitter**: [x.com/theroomsfun](https://x.com/theroomsfun). Any contract address (CA) NOT shared on our official Twitter does NOT belong to us. Beware of scams!

> **Note**: Some links and the contract address will only be available after we deploy. If you're seeing this right after launch, please check back soon - we update these manually and it may take a little time!

***

**Status**: 🟢 Active Development\
**Version**: Alpha\
**Last Updated**: November 2025

Join us on this journey to build something special! 🚀
