> For the complete documentation index, see [llms.txt](https://chunkedworld.gitbook.io/chunkedworld/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chunkedworld.gitbook.io/chunkedworld/your-island/expanding-and-managing.md).

# Expanding and Managing Your Island

Buying chunks, protecting your island, and managing friends and visitors

## Buying chunks - `/cw upgrade`

`/cw upgrade` purchases your next chunk. Expansion follows a fixed spiral pattern around your starting chunk, up to the maximum of 25 chunks (a 5x5 island). Your current rank caps how many chunks you can own - see [Ranks](/chunkedworld/progression/ranks.md).

**Pricing:** the first expansion costs $300, and each one after that costs $300 more than the last. The final, 25th chunk costs $7,200.

Each purchased chunk rises dramatically out of the void, layer by layer, over about 2 minutes. Once the animation finishes, its loot chests, spawners, and passive mobs activate - including villagers, if the chunk contains village beds or workstations. Sand and gravel start obeying physics once the animation completes.

## Protection and settings

Your island is protected by default - outsiders can't break or place blocks, open chests, or hurt you there. Open `/cw settings` to toggle:

* PvP on your island (off by default)
* Public Island - whether visitors may enter at all
* Chest access for visitors
* Use/interact permissions for visitors (doors, buttons, and so on)

Use `/cw friend <player>` (alias `/cw trust`) to grant a friend full build access to your island, and `/cw unfriend` to remove it. Friends appear as heads in the settings menu.

## Visiting and teleporting

* `/cw home` teleports you home, with a 3-second warmup shown by particles - moving or taking damage cancels it. `/cw sethome` moves your home point anywhere on your island.
* `/cw visit <player>` teleports you to another player's island if it's public. If that island has PvP enabled, you'll be warned and need to run the command again to confirm before teleporting.
* `/cw top` teleports you to the highest block at your current position.

## Villager cap

Each island supports up to 50 villagers total across all its chunks. If breeding pushes past the cap, the youngest villagers are removed during a periodic check, roughly every 10 minutes.

## Command summary

`/cw create`, `/cw home`, `/cw sethome`, `/cw reset`, `/cw recover`, `/cw upgrade`, `/cw gen` (alias `/cw generator`), `/cw visit`, `/cw top`, `/cw settings`, `/cw friend` (`/cw trust`), `/cw unfriend` (`/cw untrust`), `/cw movechonky`, `/cw help`.

For what happens if you reset, go inactive, or die, see [Island Lifecycle](/chunkedworld/your-island/island-lifecycle.md).


---

# 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://chunkedworld.gitbook.io/chunkedworld/your-island/expanding-and-managing.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.
