# Introduction

<div align="center"><img src="/files/EDBzBBCAoHBT5Nb3deLZ" 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](/files/3uJDMFJTmjtmHypmRFzC)

*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! 🚀


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.theroomssol.fun/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
