World Edit Commands

Adds new client side commands for advanced world editing.

Check any modding guide for installation instructions.

Install also Server Devcommands.

Commands

This mods add 4 new commands. Most parameters are given as named parameters that have a "key=value" format (or just "key" if no value is needed). All of them are optional and can be put in any order. All keys and some values are case insensitive too.

Some parameters accept ranges with "key=min-max" format. This causes each affected object to randomly get a value within the range which allows creating some random variation.

Use the alias command to create new simpler commands. This should significantly reduce the amount of typing.

Remember to bind undo and redo commands for easier undoing. Recommended also to read the manual of Server Devcommands mod.

Object

The object [...args] alters the hovered object or objects within a given radius. The undo/redo system is supported by saving snapshots of the object.

Following parameters are available:

• baby: Prevents offspring from growing up.
• center: Sets rotate center point at player position.
• center=x,z,y: Overrides the player position and sets rotate center point.
• durability=number or health=number: Sets the current durability for items, the current health for structures and the maximum health for creatures. Very high values like 1E30 turn the target invulnerable (including gravity for structures).
• fuel=number: Sets the fuel amount. Without number, prints the fuel amount.
• from=x,z,y: Same as the center.
• guide: Visualizes the affected area instead of doing anything. Turn off by not giving the radius.
• id: Filters objects by id. Supports starts with, ends with or contains by using "*". Default is * that allows all objects which don't start with "_".
• info: Prints information of objects.
• level=integer: Sets levels for creatures (level = stars + 1).
• mirror: Mirrors the position and rotation based on the player position. Always mirrors the x-axis.
• move=forward,right,up: Moves objects (meters). Static objects only update their position for other players when they leave the area.
• origin=player|object|world: Base direction for move and rotate. Default value player uses the player's rotation, object uses the objects rotation and world uses the global coordinate system (x=north/south,y=up/down,z=west/east).
• prefab=id: Replaces the object with the given id.
• radius=number: Radius for included objects. Capped at 100 meters. If not given, the hovered object is only affected.
• remove: Removes objects. Must use the id parameter (id=* is ok). Can't be used with other operations.
• respawn: Resets loot chests, pickables and spawn points.
• rotate=yaw,roll,pitch: Rotates objects (degrees). Static objects only update their rotation for other players when they leave the area.
• rotate=reset: Resets object rotation. Static objects only update their rotation for other players when they leave the area.
• scale=x,z,y: Scales objects (which support it). A single value sets all of the scales.
• sleep: Makes creatures fall asleep (that support it).
• stars=integer: Sets stars for creatures (stars = level - 1).
• wild: Untames creatures.

Additional style parameters:

• chest=item id,variant: Sets creatures to have this item as their chest (if supported).
• helmet=item id,variant: Sets creatures to have this item as their helmet (if supported).
• left_hand=item id,variant: Sets creatures to have this item on their left hand (if supported).
• legs=item id,variant: Sets creatures to have this item as their legs (if supported).
• right_hand=item id,variant: Sets creatures to have this item on their right hand (if supported).
• shoulders=item id,variant: Sets creatures to have this item as their shoulders (if supported).
• utility=item id,variant: Sets creatures to have this item as their utility (if supported).
• visual=item id,variant: Sets item stands to have this item (including enemy weapons). Not all items work without Item Stand All Items mod.

Note: Creatures reset their style when attacking.

Examples

• object radius=50 move=-5-5,-5,5: Randomly moves all objects within 50 meters.
• object move=5: Moves the targeted object 5 meters away from you.
• object move=0,5 origin=world: Moves the targeted object 5 meters towards east.
• object prefab=Wolf: Changes the targeted object to a wolf.
• object rotate=90 center radius=10: Rotates nearby objects around the player.
• alias remove object remove id=$: Adds a command remove [object id] that removes the targeted object if it matches the given object id.
• alias remove object remove id=*: Adds a command remove that removes the targeted object without having to specify the id.
• alias remove50 object remove radius=50 id=$: Adds a command remove50 [object id] that removes the given objects within 50 meters.
• alias essential object tame health=1E30 radius=$ id=$: Adds a command essential [radius] [object id] that tames and turns objects invulnerable within a given radius and with a given id. If radius and id is not given, then affects the hovered object.

Spawn object

The spawn_object [object id] [...args] spawns objects to the world. The undo/redo system is supported by saving snapshots of the created objects.

Following parameters are available:

• amount=integer: Amount of spawned objects within a random radius. Items are autostacked.
• crafter=value or name=value: Name of the crafter for items or name for tamed creatures (that support naming). Character _ is replaced with a space bar.
• durability=number or health=number: Overrides the current durability for items, the current health for structures and the maximum health for creatures. Very high values like 1E30 turn the target invulnerable (including gravity for structures).
• from=x,z,y: Allows overriding the player's position for the command. Used by redo and can be useful for some advanced usage.
• hunt: Spawned creatures are in the hunt mode.
• level=integer: Spawned creatures have this amount of level (level = stars + 1).
• pos=forward,right,up: Relative position (meters) from the player. If not given, the objects are spawned 2 meters front of the player. If y coordinate is not given, the objects snaps to the ground.
• radius=number: Maximum spawn distance when spawning multiple objects. Default is 0.5 meters.
• refPlayer=name: Allows overriding the player's position with another player's position.
• refRot=yaw,roll,pick: Allows overriding the player's rotation for the command. Used by redo and can be useful for some advanced usage.
• rot=yaw,roll,pick: Relative rotation (degrees) from the player's rotation.
• scale=x,z,y: Scale for the spawned objects (which support it). A single value sets all of the scales.
• stars=integer: Spawned creatures have this amount of stars (stars = level - 1).
• tame: Spawned creatures are tamed.
• to=x,z,y: Distributes the objects between the player and target position.
• variant=integer: Style/variant for some spawned items.

Additional style parameters:

• chest=item id,variant: Spawned creatures have this item as their chest (if supported).
• helmet=item id,variant: Spawned creatures have this item as their helmet (if supported).
• left_hand=item id,variant: Spawned creatures have this item on their left hand (if supported).
• legs=item id,variant: Spawned creatures have this item as their legs (if supported).
• right_hand=item id,variant: Spawned creatures have this item on their right hand (if supported).
• shoulders=item id,variant: Spawned creatures have this item as their shoulders (if supported).
• utility=item id,variant: Spawned creatures have this item as their utility (if supported).

Note: Creatures reset their style when attacking.

Examples

• spawn_object StatueCorqi rot=0-360 amount=10 radius=10: Spawns 10 corqi status within 10 meters that have a random rotation. Undo/redo can be used to reroll the positions and rotations.
• spawn_object Rock_4 scale=0.5-5 rot=0-360 amount=200 radius=100: Spawns 200 rocks with a random rotation and a random scale.
• spawn_object Wolf star=0-2 amount=5 radius=20: Spawns 5 wolves with random stars from 0 to 2.
• spawn_object PickaxeIron refPlayer=Jay: Spawns an iron pickaxe at the position of a player called Jay.
• alias spawn spawn_object $ amount=$ level=$: Upgrades the default spawn command with undo/redo.

Spawn location

The spawn_location [location id] [...args] spawns Point of Interests to the world. The main difference to the location command is that the game saving doesn't get disabled and all parameters can be set. The undo/redo system is supported by saving snapshots of the created objects.

Following parameters are available:

• seed=number: Sets the result of randomized locations. If not given, the result is random.
• dungeonSeed=number: Sets the result of next dungeon generation. If not given, the result is random. If the location is not a dungeon, this will carry over to the next dungeon generation. Forcing dungeon seed randomize the dungeon room seeds (instead of being based on the room position).
• from=x,z,y: Allows overriding the player's position for the command. Used by redo and can be useful for some advanced usage.
• pos=forward,right,up: Relative position (meters) from the player. If not given, the location will be placed at the player. If y coordinate is not given, the location snaps to the ground.
• rot=degrees: Relative rotation (degrees) from the player's rotation.
• refRot=degrees: Allows overriding the player's rotation for the command. Used by redo and can be useful for some advanced usage.

Examples

• spawn_location DevHouse1: Spawns a location at your position (snaps to the ground).
• spawn_location DevHouse1 pos=10 seed=1: Spawns a location 10 meters in front of you with a specific random outcome.
• alias location spawn_location: Upgrades the default command with undo/redo, no save breaking and support for extra parameters.

Terrain

The terrain [...args] command can create different shapes on top of the usual flattening and resetting. The undo/redo system is supported by saving snapshots of the terrain.

Note: If you have trouble understanding the affected area, try the guide parameter.

Note: The granularity of the terrain system is 0.5 meters.

Note: Terrain is only affected in loaded areas. You can use Render Limits mod to increase this area.

Following parameters are available:

• angle=degrees: Determines the direction. Cardinal directions like n, ne, e, se, s, sw, w and nw work as a value too. Uses the player's direction if not given (45 degrees precision).
• blockcheck: Excludes terrain that is under structures or other objects. This can be used to create specific shapes.
• blockcheck=on/off/inverse:
  • on: Excludes terrain that is under structures or other objects.
  • off: All terrain is affected (default).
  • inverse: Only includes terrain that is under structures or other objects.
• circle=number: Determines the radius of the affected terrain.
• delta=meters: Sets the difference from the original elevation. Without the parameter, resets terrain altitude changes.
• from=x,z,y: Overwrites the player's position. Allows fixing the current position for more precise editing. The y coordinate can be used to override the current ground altitude.
• guide: Visualizes the affected area instead of doing anything. Turn off by not giving the circle or rect parameters.
• level=altitude: Sets terrain height to the given altitude. If not given, uses the ground altitude below the player.
• lower=meters: Lowers terrain by X meters. Same as raise when a negative value is used.
• max=altitude: Lowers terrain above the given altitude to the altitude.
• min=altitude: Raises terrain below the given altitude to the altitude.
• offset=forward,right,up: Moves the targeted position while still using the altitude of the player's position.
• smooth=number: Determines how gradually the changes are applied (from 0.0 to 1.0).
  • 1.0: All of the terrain gets reduced changes (except the very center).
  • 0.5: Half of the terrain gets reduced changes.
  • 0.0: No reduction (default).
• paint=value: Sets the terrain material (dirt, paved, cultivated or grass to reset).
• raise=meters: Raises terrain by X meters. Same as lower when a negative value is used.
• rect=width,depth: Determines the size of the affected terrain.
• reset: Resets terrain height and paint changes. Ignores smooth parameter.
• slope=meters,angle: Creates a slope centered at current position with a given height.
• step=forward,right,up: Calculates offset based on the radius (and slope height if given).
• to=x,z,y: Moves the affected terrain between the current position and this position. Determines angle, slope and circle/rect size automatically.
• within=min-max: Only includes terrain that is within the given altitude range.

Examples

• terrain level circle=10: Sets terrain height within 10 meters (20 meters diameter) to the same level as below you.
• terrain level terrain raise=4 rect=4 smooth=1 paint=paved: Creates a pyramid.
• terrain level raise=4 rect=4;terrain lower=4 rect=4 smooth=1 paint=paved: Creates a pyramid shaped hole.
• terrain slope rect=5 from=10,10 to=10,20: Creates a slope between two positions (10 meters width).
• terrain slope=5 rect=5 from=10,10 to=10,20: Creates a 5 meter slope between two positions (10 meters width).
• terrain level from=300,40,-500 rect=5,10000: Creates a long leveled path. Walk along the path to load new areas and then use the command again to extend the path.
• terrain from=-23,23 angle=e rect=5 slope=4: Creates a slope rising towards east.
• terrain from=-23,23 angle=e rect=5 slope=4 step=1 level: Creates a level at the end of the slope.
• terrain from=-23,23 angle=e rect=5 slope=4,e step=1,1: Creates a slope at right side of the level rising towards south (east of east).
• terrain from=-23,23 angle=e rect=5 slope=4 step=1,2,1 level: Creates a level at the end of the slope. The last parameter of step is needed because the slope is not going to the original direction so it won't be raised automatically.
• alias level terrain level circle=$: New command level [value] for easier leveling.
• alias level terrain level rect=$: New command level_sq [value] for easier leveling.

Mechanics

Any changes made by the mod are compatible with unmodded clients which adds some significant restrictions to some commands.

Creature style

Creatures overwrite their style when they try to attack. So altering their style has mainly three uses:

• Decorating the training dummy since it never attacks.
• Decorating tamed creatures while ensuring they are safe.
• Initially decorating aggresive creatures (as long as it's ok that their style resets during the fight).

Creature health

Creatures reset their maximum health if their current health equals the maximum health. To prevent this, the mod sets creature health slightly higer than the max health.

However this means that if the creature is damaged and let to heal back to full, its health may reset when the area is loaded.

• When creating combat scenarios, manually set enemy health if the scenario is not finished.
• When creating stronger tamed creatures, manually set their health after the combat is over (recommended to bind a key for this).

Creature / structure invulnerability

Setting a very high health like 1E30 will make objects invulnerable. This is because the float variable type has a limited precision so small amounts of damage is rounded down to nothing. This may cause following:

• Lack of support doesn't break structures so build limits can be ignored (since lack of support only causes damage equal to the default max health).
• killall command doesn't kill some creatures (since it only deals very high damage to them).

Dig limit

This mod doesn't unlock the terrain dig limit so all changes will still be capped by the limit (default is +- 8 meters). However the terrain command should be compatible with any mods affecting the dig limit.

The command however supports going over the limit which can lead to unexpected results. For example if you lower terrain by 20 meters and then raise by 10 meters, the second command probably won't do anything because the result is still below the dig limit.

Moving objects

Static objects only synchronize their position and rotation when loaded. This means that object move and object rotate commands won't instantly show for other clients. Instead they have to leave the area.

This shouldn't cause any issues unless objects are moved long distances (which might cause issues anyways).

Changelog

• v1.5

  • Fixes painting using wrong circle or rectangle size.

• v1.4

  • Adds a new parameter to to the spawn_object command to even distribute multiple object.
  • Adds a new parameter guide to the object command to visualize the affected area.
  • Adds a new parameter mirror to the object command to mirror the position and rotation of objects.
  • Adds a new parameter from to the object command with same behavior as the center parameter.
  • Changes the circle and rect parameters of the terrain command to have half of the size (matches radius of other commands).
  • Renames the parameter refPos to the from (like in the terrain command).

• v1.3

  • Adds a new parameter guide to the terrain command to visualize the area.
  • Adds a new parameter within to the terrain command to include only terrain within a given altitude range.
  • Adds new parameters max and min to the terrain command which allow capping the terrain altitude.
  • Adds a new parameter delta to the terrain command which allow directly setting the height difference.
  • Adds a new parameter center to the object command which allow setting the rotation center point and overriding the player's position.
  • Adds a new parameter respawn to the object command which allow reseting loot chests, pickables and spawn points.
  • Adds support for replacing the character _ with a space bar in crafter names.
  • Adds min-max support to the pos parameter of the spawn_object command.
  • Changes the parameter reset of the terrain command to ignore smooth parameter and also reset the terrain paint.

• v1.2

  • Adds a new parameter to to the terrain command which automatically calculates angle, distance and slope.
  • Changes the parameter refPos of terrain command to from (renamed).
  • Changes the terrain command to automatically use the player's rotation as the angle (45 degrees precision).
  • Fixes the object health not working.
  • Fixes the terrain command not working outside the world edge.

• v1.1

  • Adds an basic undo to the object command.
  • Adds a new parameter prefab to the object command to allow replacing objects.
  • Adds a new parameter refPos to the terrain command to allow overriding the player's position.
  • Adds a new parameter slope to the terrain command to allow creating slopes.
  • Adds a new parameter offset to the terrain command to allow moving the targeted position.
  • Adds a new parameter step to the terrain command to automatically calculate the offset based on radius.
  • Adds a new parameter angle to the terrain command to select the slope and step direction.
  • Adds a new parameter fuel to the object command to set or print the fuel amount.
  • Changes offset parameter description from x,z,y to forward,right,up.
  • Changes rotation parameter description from y,x,z to yaw,roll,pitch.
  • Changes parameters radius and squareof the terrain command to circle and rect.
  • Improves output of some commands.
  • Removes the size restriction from circle and rect parameters.

• v1.0

  • Initial release.

Thanks for Azumatt for creating the mod icon!

• v1.66

  • Improves the undo system (again).

• v1.65

  • Improves the undo system.

• v1.64

  • Fixed for the new game version.
  • Fixes the command object refresh.

• v1.63

  • Adds a new command data dump to save data with default fields.
  • Adds some missing zdo keys.
  • Changes object f=DungeonGenerator,room0_pos to use relative coordinates (converted automatically to absolute).
  • Fixes the data keep command not working. Thanks ddein!
  • Fixes autocomplete missing for normal ZDO data keys.
  • Reworks the undo system.

• v1.62

  • Adds some missing zdo keys.
  • Adds normal ZDO data keys to fields.
  • Adds support for setting CLLC infusion with the command tweak_creature infusion=.
  • Fixes the command data print taking object ownership.
  • Fixes the command data set not showing "long" on the autocomplete.
  • Removes the id requirement when using the object remove command.

• v1.61

  • No real changes, just compatibility for Expand World Prefabs data changes.