Copy Paste4.2.5

Chat Commands

Copy

/copy NAME options values - Copy a building
Example: /copy home radius 3 method building
Short example: /copy home r 3 m building

Syntax - Options

• each true/false - default: true - Check radius from each entity
• method building/proximity - default: proximity - Choose the type of mechanics to use to copy a building:
  Building: Only copy the current building.
  Proximity: Copy all blocks close to the building. (Some deployables can be missing with Building also use proximity in these cases)
• radius XX - default: 3 - Sets the radius to search for entities around each building parts & deployables
• share true/false - default: true - Set to copy data CodeLocks, BuildingPrivileges, SleepingBag
• tree true/false - default: false - Set to copy trees and resources

Paste

/paste NAME options values - Paste a building
Example: /paste home auth true stability false
Short example: /paste home a true s false

Syntax - Options

• auth true/false - default: true - Authorize player in all cupboards
• blockcollision XX - default: 0 - Checks in XX radius if there is something that could collide with the new building, if so, blocks the build. 0 is to deactivate the detection.
• deployables true/false - default: true - Set to paste the deployables
• **height XX **- *default: 0 *- Adjust height to paste
• autoheight true/false - default: true - Wether or not to try to find best height for building
• inventories true/false - default: true - Set to paste the inventories
• stability true/false - default: true - Set false to ignore stability system
• vending true/false - default: true - Set to paste sellings, name and broadcasting for Vending Machine
• entityowner true/false - default: true - Copy entity ownership of building.
• position x,y,z - Override a position for spawning
• rotation x - default: 0 - Change rotation correction

Pasteback

/pasteback NAME options values - Paste on old place a building where it was when it was saved
Example: /pasteback home auth true stability false
Short example: /pasteback home a true s false

Syntax - Options

• auth true/false - default: false - Authorize player in all cupboards
• deployables true/false - default: true - Set to paste the deployables
• **inventories true/false **- default: true - Set to paste the inventories
• height XX - default: 0 - Adjust height to pasteback
• stability true/false - default: true - Set false to ignore stability system
• vending true/false - default: false - Set to paste sellings, name and broadcasting for Vending Machine
• position x,y,z - Override a position for spawning
• rotation x - default: 0 - Change rotation correction

Other

/undo - Removes what you've last pasted/copylist - List of stuctures (from folder oxide/data/copypaste)

Permissions

This plugin uses the permission system. To assign a permission, use oxide.grant user or group name or steam id permission. To remove a permission, use oxide.revoke user or group name or steam id permission.

• copypaste.copy
• copypaste.list
• copypaste.paste
• copypaste.pasteback
• copypaste.undo

Configuration

The settings and options can be configured in the CopyPaste file under the config directory. The use of an editor and validator is recommended to avoid formatting issues and syntax errors.

{
  "Amount of entities to paste per batch. Use to tweak performance impact of pasting": 15,
  "Amount of entities to copy per batch. Use to tweak performance impact of copying": 100,
  "Amount of entities to undo per batch. Use to tweak performance impact of undoing": 15,
  "Enable data saving feature": true,
  "Copy Options": {
    "Check radius from each entity (true/false)": true,
    "Share (true/false)": true,
    "Tree (true/false)": false
  },
  "Paste Options": {
    "Auth (true/false)": true,
    "Deployables (true/false)": true,
    "Inventories (true/false)": true,
    "Vending Machines (true/false)": true,
    "Stability (true/false)": true
  }
}

Developer API

object TryCopyFromSteamId(ulong userID, string filename, string[] args)
object TryPasteFromSteamId(ulong userID, string filename, string[] args)
object TryPasteFromVector3(Vector3 pos, float rotationCorrection, string filename, string[] args)

Returns string on failure and true on success

When Copy is done calls OnCopyFinished(Listobject rawData, string filename, IPlayer player, Vector3 startPos)

When Pasting is done calls OnPasteFinished(ListBaseEntity pastedEntities, string filename, IPlayer player, Vector3 startPos)

Example:

bool BuyBuilding(BasePlayer player, string buildingName)
{
    var options = new Liststring{ "blockcollision", "true" };

    var success = CopyPaste.Call("TryPasteFromSteamId", player.userID, buildingName, options.ToArray());

    if(success is string)
    {
        SendReply(player, "Can't place the building here");

        return false;
    }

    SendReply(player, "You've successfully bought this building");

    return true;
}