Skip to main content

​
Create a world

A world links several maps together with world coordinates. Use this when you want map-to-map transitions, overworld navigation, or a large connected game world.

​
Declare world maps in a module

You can register a world directly with provideServerModules: 
import { provideServerModules } from "@rpgjs/server";

provideServerModules([
  {
    worldMaps: [
      {
        id: "main-world",
        maps: [
          { id: "town", worldX: 0, worldY: 0, width: 800, height: 600 },
          { id: "forest", worldX: 800, worldY: 0, width: 800, height: 600 }
        ]
      }
    ]
  }
]);

​
Create or update a world dynamically

You can also do it from the server map API: 
const manager = map.createDynamicWorldMaps({
  id: "main-world",
  maps: [
    { id: "town", worldX: 0, worldY: 0, width: 800, height: 600 },
    { id: "forest", worldX: 800, worldY: 0, width: 800, height: 600 }
  ]
});
Or update it later: 
await map.updateWorldMaps("main-world", [
  { id: "town", worldX: 0, worldY: 0, width: 800, height: 600 },
  { id: "forest", worldX: 800, worldY: 0, width: 800, height: 600 }
]);

​
Keep this page focused on creation

This page covers the creation workflow only. For the full runtime API, see Map API / World Maps.

​
Next step

Continue with Create an event.