# How to Configure World Generation on Your Eco Server (/docs/eco/world-generation)



import { Step, Steps } from 'fumadocs-ui/components/steps';

Eco's world is **dramatically** more RAM-hungry than most survival games — a single world voxel is server-authoritative, simulated, and persisted. The size you pick at world generation is a one-way decision: changing it later requires a full wipe. This page covers how to pick a size, the seed, biome count, and the in-game `/serverui` shortcut for editing live without touching files.

File Location [#file-location]

```
Eco/Eco_Data/Server/Configs/WorldGenerator.eco
```

Size & Player Count [#size--player-count]

| Size           | Volume     | Recommended Players | Recommended RAM |
| -------------- | ---------- | ------------------- | --------------- |
| **72×72×40**   | Default    | 5–15                | 4 GB            |
| **100×100×40** | Medium     | 15–30               | 6–8 GB          |
| **140×140×60** | Large      | 30–50               | 12+ GB          |
| **200×200×60** | Very Large | 50–100              | 16+ GB          |

**Hard limits:**

* All dimensions must be divisible by 4
* Total volume `(L*10) * (W*10) * H` cannot exceed `2,147,483,647` (Int32 max)
* The world is loaded into RAM at runtime — running too small a server for the world size is the #1 cause of Eco performance complaints

Configure World Generation [#configure-world-generation]

<Steps>
  <Step>
    Stop the server [#stop-the-server]

    In the [XGamingServer Panel](https://panel.xgamingserver.com), stop your Eco server from **Console**.
  </Step>

  <Step>
    Open WorldGenerator.eco [#open-worldgeneratoreco]

    In **Files**, navigate to `Eco/Eco_Data/Server/Configs/WorldGenerator.eco`.
  </Step>

  <Step>
    Set the size [#set-the-size]

    ```json
    {
      "WorldSize": {
        "x": 100,
        "y": 100
      },
      "Seed": 0,
      "BiomeCount": 6
    }
    ```

    | Key                           | Description                                                                                         |
    | ----------------------------- | --------------------------------------------------------------------------------------------------- |
    | `WorldSize.x` / `WorldSize.y` | World dimensions in chunks. **Must be divisible by 4.**                                             |
    | `Seed`                        | World generation seed. `0` = random per generation. Set a number to get the same world every regen. |
    | `BiomeCount`                  | Number of distinct biomes (lower = more uniform world, higher = more variety)                       |
  </Step>

  <Step>
    Wipe and regenerate [#wipe-and-regenerate]

    `WorldGenerator.eco` only takes effect on a **new world**. If you already have a save:

    1. Back up your `Storage/` folder first — see [Backup & Restore](/docs/eco/backup-restore)
    2. Stop the server
    3. Delete the contents of `Eco/Eco_Data/Server/Storage/`
    4. Start the server. A fresh world generates with your new settings.
  </Step>
</Steps>

Edit Live with /serverui [#edit-live-with-serverui]

Eco has an in-game admin panel called `/serverui` that exposes most config files for live editing — without touching files manually.

<Steps>
  <Step>
    Connect to your server in-game as an admin (see [Adding Admins](/docs/eco/adding-admins)).
  </Step>

  <Step>
    Open the chat with **Enter** and type:

    ```
    /serverui
    ```
  </Step>

  <Step>
    In the panel that opens, click **Sim → World Generator**.
  </Step>

  <Step>
    Edit the values you want and click **Apply**.
  </Step>
</Steps>

`/serverui` is the easiest way to tune most settings — but world size still requires a wipe regardless of how you change it.

Picking a Seed for Reproducibility [#picking-a-seed-for-reproducibility]

Setting `Seed` to a specific number lets you regenerate the same world repeatedly — useful for tournaments, events, or testing balance changes:

```json
{
  "Seed": 12345
}
```

A seed of `0` means "pick a random seed at generation time." Once a world is generated, the seed is recorded in the save and isn't re-rolled on restart.

Why World Size Matters for RAM [#why-world-size-matters-for-ram]

Every voxel in an Eco world is:

* A persistent block with type, hardness, ownership
* A node in the ecosystem simulation (plants, soil, water flow)
* A potential target for skills, laws, and contracts

A 100×100 world is **2x** the simulation cost of a 72×72 world, not just 2x the area. Don't oversize your world unless you have the RAM to back it up — Eco's performance degrades non-linearly when you exceed your RAM budget.

Related Guides [#related-guides]

* [Configure Your Server](/docs/eco/configure-your-server)
* [Meteor & Disasters](/docs/eco/meteor-disasters)
* [Backup & Restore](/docs/eco/backup-restore)
* [Admin Commands](/docs/eco/admin-commands)