From 37b93a063d4665ed97ec1e22385dc613ba9ad10a Mon Sep 17 00:00:00 2001 From: dgm3333 Date: Mon, 26 May 2014 22:44:50 +0100 Subject: [PATCH] Update Chat Commands.md added help for /loadalign, /loadalignoffset, /correctorigin --- Chat Commands.md | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/Chat Commands.md b/Chat Commands.md index c3d5250..210dd13 100644 --- a/Chat Commands.md +++ b/Chat Commands.md @@ -22,6 +22,10 @@ Many commands also have shorter names that can be typed faster. For example, if | `//hdo` | `//hollowdome` | | `//do` | `//dome` | | `//hcyl` | `//hollowcylinder` | +| `//co` | `//correctorigin` | +| `//oc` | `//correctorigin` | +| `//la` | `//loadalign` | +| `//lao` | `//loadalignoffset`| ### `//about` @@ -318,6 +322,44 @@ Load nodes from "(world folder)/schems/``.we" with position 1 of the curre //load some random filename //load huge_base +### `//correctorigin` + +Moves pos1 and pos2 so pos1 is at the origin of the region (ie pos1 located with minimum x,y,z, pos2 with maximum x,y,z) +This is ideally used before /save to decrease confusion with placement for /load and /loadalign +Shortcut of /co and /oc (to ease confusion) is set in worldedit_shortcommands/init.lua + + //correctorigin + +### `//loadalignoffset [x y z]` + +Set a global variable to enable an offset to the player location for /loadalign +-- This can be useful it a particular location is not easily accessible (eg if you want a file y-origin to be below ground level, or x- or z- inside a cliff) +-- the offset is cleared by using the command without params (=arguments) +-- Shortcut of /lao is set in worldedit_shortcommands/init.lua + + //load + //load x y z + +### `//loadalign ` + +Load nodes from "(world folder)/schems/``.we" with player location as the origin. The loaded schem will be in a region to the front, right and above the players location. +If the location is not easily accessible (eg if you want a file y-origin to be below ground level, or x- or z- inside a cliff), you can set an offset with /loadalignoffset +The player is moved backwards one space to moved them out of the load zone (or more if there is and offset). This may mean the player ends up inside a node (if it suddenly gets dark). You may be able to step out. If not you'll have to teleport to an unblocked location. +The /save command saves the file with the origin at the xmin,ymin,zmin, irrespective of where pos1 and pos2 are. To reduce confusion it is suggested that you use the /correctorigin command before saving + to move the markers to reflect this, but if you are copying a section one node wide, there are two possible orientations. + You need to be facing in the positive z direction to correctly orient yourself to the orientation when it is reloaded. + If you are using a schem regularly, and markers are not in your prefered orientation, it is best to do an initial /loadalign to get the correct orientation, then resave it +The loaded region is marked with pos1/pos2 with pos1 where the origin would have been when the schem was saved. +The function has only been tested with the current (version 4) schem files, so consider use with older schem files to be at your own risk. + The most likely bugs with untested versions are: either the entire region is incorrectly rotated or individual nodes are incorrectly oriented (so faces point in the incorrect direction) +The functions is a modifications of the original register //load to support alignment relative to player, so code from the screwdriver mod was used as a starter for node orientation. + The main functions are in the WorldEdit/worldedit/serialization.lua (worldedit.deserializeAligned which also uses worldedit.getNewRotation, and might need worldedit.screwdriver_handler + depending on compatibility with old files) +Shortcut of /la is set in worldedit_shortcommands/init.lua + + //loadalign some random filename + //loadalign huge_base + ### `//lua ` Executes `` as a Lua chunk in the global namespace.