Revision Difference
CopyPaste#563619
<cat>Dev.Cinematic</cat>
<title>CopyPaste</title>
CopyPaste is an admin tool that saves a list of entities and can spawn them back into the world.
# Copy
You can copy entities in a box, radius or building to your clipboard.
⤶
`copybuilding` will target everything connected to the building you are currently looking at.
You can copy entities in a box, radius or building to your client.
⤶
`copybuilding {name}` will target everything connected to the building you are currently looking at.
[Copy building](https://files.facepunch.com/jakerich/4F9ncclz29fQ/r2CCqILIo0KbwYOR.mp4)
## Bounding Box
Use `pos1` and `pos2` to set the corners of the bounding box. `copybox` will copy everything inside that box to your clipboard.
Use `pos1` and `pos2` to set the corners of the bounding box. `copybox {name}` will copy everything inside that box to your clipboard.
[Copy from bounding box](https://files.facepunch.com/jakerich/9j1hXbiuwKAd/XdqZRNYDmqVb21Gj.mp4)
# Paste
Once you have something in your clipboard (after copying from world or loading from disk) you can paste it into the world.
Use `paste` to place a copy of the clipboard centered on your player. By default this will try to place on the terrain, you can toggle `paste_snap_terrain` to control this.
Use `paste {name}` to place a copy of your paste centered on your player. By default this will try to place on the terrain, you can toggle `paste_snap_terrain` to control this.
[Terrain Snapping](https://files.facepunch.com/jakerich/2kW04DFmE0dq/9RiqjAA6Bn2RQAvT.mp4)
⤶
If you want to paste something directly from disk without loading it first, you can use `paste NAME`. **Note:** this won't replace your current clipboard.⤶
[Paste from disk](https://files.facepunch.com/jakerich/JpmTsdk7kpyu/ttdQeJMyDX5vpmjb.mp4)
## Undo
If you are unhappy with the way it was placed, you can use the `undopaste` command to delete the last thing you pasted in.
[Undo example](https://files.facepunch.com/jakerich/7KGaUlMSpJ75/rUDZ3LbTezL6SKJ4.mp4)
⤶
# Save⤶
⤶
If you want to persist a clipboard of entities across server restarts, you can give it a name and save it to disk via the command `savepaste <name>`. It will be saved in the directory `server/{Identity}/copypaste`.⤶
⤶
[Save to disk](https://files.facepunch.com/jakerich/a1py6Knadzbh/wUV4CdlJACmsQrTj.mp4)
⤶
# Load⤶
⤶
To load a paste from disk to your clipboard use `loadpaste <name>`. Keep in mind this will replace your current clipboard.⤶
⤶
[Load from disk](https://files.facepunch.com/jakerich/yrPJo5f0JxAa/jJDlr3jf1Y8tTgrX.mp4)⤶
⤶
## Download⤶
⤶
You can download pastes from a url with `downloadpaste <url> <name>`. If no name is provided it will use the filename of the URL.⤶
⤶
⤶
## Legacy Pastes⤶
⤶
When CopyPaste was first released it saved pastes on the server under `server/{Identity}/copypaste`. Now we store them on the client under `Rust/copypaste`.
⤶
If you want to download pastes from the server you can check what is on the server with `list_pastes_sv` and download pastes from the server with `download_paste {name}`.⤶
# Filters
You can configure what will be pasted by modifying the filters which are client convars that start with `paste_{filter} `. Each one is named pretty self explanatory, use `find paste_` to list them all.
<upload src="28cbc/8dcfea9d00af6dd.png" size="100821" name="image.png" />
**Note:** Player models pasted in will have different steam ids to prevent issues with duplicate players on the server. They will still have the same inventory and name.
[Video Example](https://files.facepunch.com/jakerich/EIupZiR4ZjwH/NZCf7yXc2zj7DWqO.mp4)