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

# Housing

**NI-KA Town** is a social sandbox mode. In this mode, you navigate custom avenues, claim plots of land, build your estate, and generate passive income.

## 🗺️ Exploring the Grid

* **The Hub:** A large central platform square branching out into avenues.
* **Plot Markers:** Special markers along the avenues indicate house plots.
* **Trigger Proximity:** Drive near a plot marker (within 75 units) to open the **Your Home** customization panel.

## 📈 Plot Upgrade Tiers & Yields

Upgrading your house increases the complexity of its 3D model in the world and generates passive **Galaxy Coins** over time.

### System Sell-Back Refund

If you want to move locations or recover capital, you can delete/abandon your plot. The system will instantly refund **40% of the total Galaxy Coins** you invested in that plot and all its upgrades.

| Plot Level              | Upgrade Cost (Galaxy Coins) | Cumulative Spent | Hourly Passive Yield    | 40% Refund Value     |
| ----------------------- | --------------------------- | ---------------- | ----------------------- | -------------------- |
| **Level 0 (Unclaimed)** | —                           | —                | 0 Galaxy Coins / Hour   | —                    |
| **Level 1 (Claimed)**   | 15,000                      | 15,000           | 10 Galaxy Coins / Hour  | 6,000 Galaxy Coins   |
| **Level 2**             | 35,000                      | 50,000           | 35 Galaxy Coins / Hour  | 20,000 Galaxy Coins  |
| **Level 3**             | 80,000                      | 130,000          | 90 Galaxy Coins / Hour  | 52,000 Galaxy Coins  |
| **Level 4**             | 170,000                     | 300,000          | 208 Galaxy Coins / Hour | 120,000 Galaxy Coins |
| **Level 5 (Max)**       | 350,000                     | 650,000          | 451 Galaxy Coins / Hour | 260,000 Galaxy Coins |

## 🎨 Customizing Your Estate

When you own a plot, you can customize its appearance and parameters:

* **Home Name:** Set a custom display name showing above your plot.
* **Laser Beam Color:** Adjust the color of the vertical beacon projecting from your roof into the sky.
* **Showcase Slot:** Select one of your unlocked ship skins to be mounted on a rotating pedestal outside your house to display your garage collection.
* **Neon Accents:** Customize the glow trims of your house structure and surrounding crystals.

## 🚀 Marketplace Roadmap

The housing system is expanding. Future updates will introduce the secondary housing market:

1. **Direct Player Sales:** List your developed property on the town board with a custom sale price, allowing other players to buy it directly from you.
2. **Property Auctions:** List your plot for auction. Other players will bid Galaxy Coins or tokens, with the property transferring to the highest bidder at the deadline.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.ni-ka.fun/monetary/housing.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.