sm.world
Associated object type: World
The world api handles the creation and destruction of worlds.
A world contains the terrain and simulates the physics environment in which other game objects can exist.
Constants:
Functions:
sm.world.ids
Predefined special world ids
| anyWorld |
| noWorld |
sm.world.createWorld(filename, classname, terrainParams=nil, seed=0)
Server only
Creates a new world object. Can only be called from inside the Game script environment.
Parameters:
| Type | Name | Description |
|---|---|---|
| string | filename | The world script filename. |
| string | classname | The world script class name. |
| any | terrainParams=nil | The world's terrain parameters. (Optional) |
| integer | seed=0 | The world's seed. Defaults to 0 (Optional) |
Returns:
| Type | Description |
|---|---|
| World | The created world object. |
sm.world.getCurrentWorld()
Get the world that the scripted object is in.
Returns:
| Type | Description |
|---|---|
| World | The world |
sm.world.getDirtySpheres(position=nil, radius=nil)
Returns an array of tables representing spheres where something has changed in the world.
The optional position and radius parameters will construct a sphere, and use it as a filter to only show results that intersect that sphere.
Parameters:
| Type | Name | Description |
|---|---|---|
| Vec3 | position=nil | The world position of the sphere. (Optional) |
| number | radius=nil | The radius of the sphere. (Optional) |
Returns:
| Type | Description |
|---|---|
| table | The table of tables. { {center=Vec3, radius=number}, ..} |
sm.world.getLegacyCreativeWorld()
Server only
Gets a previously saved creative world
Returns:
| Type | Description |
|---|---|
| World | The world (id 0) if it exists in the database or nil |
sm.world.loadWorld(world)
Server only
Loads a previously created world. Can only be called from inside the Game script environment.
Parameters:
| Type | Name | Description |
|---|---|---|
| World | world | The world that should be loaded. |
Returns:
| Type | Description |
|---|---|
| boolean | Return true if the world was loaded. |