World Edit Commands

Adds new commands for advanced world editing.

Install on the admin client (modding guide).

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:

• angle=degrees: Direction of the rectangle when used with rect.
• 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.
• chance=number: Randomly filters included objects. For example 0.5 includes about half of the objects (50%).
• creator=player id: Sets the piece creator. Use 0 for no creator.
• circle=number or radius=number: Radius for included objects. If not given, the hovered object is only affected.
• connect: Includes entire structures.
• 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.
• height: Maximum height from the center point (default is 1000 meters).
• 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.
• rect=width,depth: Area for included objects. 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).
• type=creature/structure: Only selects creatures or structures.
• 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.

For Structure Tweaks mod:

• collision=true/false: Sets whether the object has collision. Without a value, toggles the collision.
• fall=off/solid/terrain: Overrides the fall behavior.
• growth=big/big_bad/small/small_bad: Overrides the plant visual wear (and prevents growth).
• interact=true/false: Sets whether the object can be interacted with. Without a value, toggles the interactability.
• restrict=true/false: Sets whether the portal restricts some items. Without a value, toggles the restriction.
• show=true/false: Sets whether the object is visible. Without a value, toggles the visibility.
• wear=broken/damaged/healthy: Overrides the object visual wear.

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 (cultivated, grass, grass_dark,dirt, patches, paved, paved_dark, paved_dirt or paved_moss).
• paint=dirt,cultivated,paved: Sets custom terrain material (values from 0.0 to 1.0).
• 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.8

  • Adds new parameters fall and restrict to the object command (for Structure Tweaks mod).
  • Adds a new parameter connect to the object command.

• v1.7

  • Adds a new parameter chance to the object command.
  • Adds new parameter collision, growth,interact, show and wear to the object command (for Structure Tweaks mod).
  • Adds a new paramater type to the object command to filter by object type.

• v1.6

  • Adds rectangle support to the object command.
  • Adds height support to the object command.
  • Adds a new parameter creator to the object command.
  • Adds new paints to the terrain command.
  • Adds support for custom paint color the terrain command.

• 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).

Thanks for Azumatt for creating the mod icon!

• v1.59

  • Fixes arithmetics not working for int and long values.

• v1.58

  • Fixes possible error when matching float, int or long values.
  • Fixes undo not reverting object move and object rotate commands.

• v1.57

  • Fixes data from profile folder not being loaded.
  • Fixes tweak_runestone compendium not working.
  • Fixed for the new game version.

• v1.56

  • Adds new default value groups containing all objects of a certain type.
  • Changes the ignore parameter to also prevent the connecting with the connect parameter.
  • Fixes value groups being case sensitive.
  • Fixes setting max health not updating the visual correctly.

• v1.55

  • Adds new paramater data copy_raw to make it easier to use the old system.
  • Fixes multiple data entries not working for spawn_object data.
  • Fixes multiple data entries not working for data data.
  • Fixes item generation not working from data.

• v1.54

  • Adds support for targeting players when id=Player is used.
  • Adds new command data for data related operations.
  • Adds support for the Expand World Data system (with much more features).
  • Adds keywords creature (Humanoid) and structure (WearNTear) back to the type parameter.
  • Adds new parameters match and unmatch to filter objects by data.
  • Fixes the type parameter being case sensitive.
  • Fixes the type parameter not working for the hovered object.
  • Fixes the field parameter not working with the Piece component.
  • Fixes the object command defaulting to scale 1 when no scale was provided.
  • Improves reliability of the undo feature.
  • Replaces object copy command, now it copies the object id.
  • Removes object data as obsolete.