ALE PCU Transferrer

LordTylus

Introduction

For administrators its a tedious job to paste grids in once CLANG demanded a new sacrifice to be given.

But to do that you have to paste the grid from workshop, or maybe even from a previous server iteration which results in OwnerID Changes. Also the "Keep Original Authorship" option in Space master is broken.

When you still want to enforce your own PCU and Block limits you need to make sure PCUs are properly set. However PCUs can only be transferred if you are the owner of them and you need to transfer all connected and subgrids.

This is what this plugin does

Commands

Space Master Commands

  • !freebuild
    • Increases all limits for the user to be able to paste limit exceeding grids. Run again to disable
  • !transfer <PlayerName>
    • Transfers all PCU and block ownership of the grid you are looking at over to the player.
  • !transfer <PlayerName> <GridName>
    • Transfers all PCU and block ownership of the named grid to the player.
  • !transferpcu <PlayerName>
    • Transfers only PCU of the grid you are looking at over to the player.
  • !transferpcu <PlayerName> <GridName>
    • Transfers only PCU of the named grid to the player.
  • !transferowner <PlayerName>
    • Transfers only block ownership of the grid you are looking at over to the player.
  • !transferowner <PlayerName> <GridName>
    • Transfers only block ownership of the named grid to the player.
  • !forcetransfer <PlayerName>
    • Transfers all PCU and block ownership of the grid you are looking at over to the player ignoring ownership.
  • !forcetransfer <PlayerName> <GridName>
    • Transfers all PCU and block ownership of the named grid to the player ignoring limits.
  • !forcetransferpcu <PlayerName>
    • Transfers only PCU of the grid you are looking at over to the player ignoring limits.
  • !forcetransferpcu <PlayerName> <GridName>
    • Transfers only PCU of the named grid to the player ignoring limits.

When pasting some grids it may be possible they get some deformations or damage. To get rid of them easily there is also

  • !repair
    • Repairs all damaged and deformed blocks of the grid you are looking at.
  • !repair <GridName>
    • Repairs all damaged and deformed blocks of the given grid.

Unfinished blocks will not be fixed unless they are deformed or damaged. So blocks that are left on grid stage on purpose will not be changed.

Finally we have commands for world analysis

!listblocks <all|limited> [-pcu] [-player=<playerName>] [-faction=<factionTag>]

  • !listblocks all
    • Lists all blocks the world has.
  • !listblocks all -pcu
    • Lists all blocks and also outputs the total pcu.
  • !listblocks limited
    • similar to "!listblocks all" but shows only blocks that have block limits.
  • !listblocks limited -pcu
    • similar to "!listblocks all -pcu" but shows only blocks that have block limits.

You can filter the results by addind -faction=XYZ or -player=Playername. If the player name contains spaces you need to set the whole expression in "". Example: !listblocks all -pcu "-player=My Player"

Moderator Commands

  • !checkowner
    • Lists the owners and amount of blocks they own in descending order of the grid you are looking at.
  • !checkowner <Gridname>
    • Lists the owners and amount of blocks they own in descending order of the grid with the given name.
  • !checkauthor
    • Lists the authors and amount of PCU they own in descending order of the grid you are looking at.
  • !checkauthor <Gridname>
    • Lists the authors and amount of PCU they own in descending order of the grid with the given name.
  • !listgridsowner <PlayerName>
    • Lists all grids the player has block ownership on
  • !listgridsowner <PlayerName> -gps
    • Lists all grids the player has block ownership on and adds gps to executing player
  • !listgridsowner <PlayerName> -position
    • Lists all grids the player has block ownership also shows GPS in the window can be combined with -gps
  • !listgridsauthor <PlayerName>
    • Lists all grids the player has PCU ownership on
  • !listgridsauthor <PlayerName> -gps
    • Lists all grids the player has PCU ownership on and adds gps to executing player
  • !listgridsauthor <PlayerName> -position
    • Lists all grids the player has PCU ownership also shows GPS in the window can be combined with -gps

Things to be aware of

  • Similar to the game itself when transferring ownership to an other player connectors will unlock. So you need to ensure beforehand that nothing can get damaged in the process.

  • Also when the grid you are transferring has no PCU owner it wont immediately be updated the player will see it in its info tab and block limits, but when looking with the welder at the block grid you just transferred it may be that it is not shown at the moment. Sadly there is some game features missing to do it right away. Transferring from Player to Player works without issue

  • You can also transfer to players that are currently online.

  • The plugin will respect PCU and block limits as well as block-type limits. The plugin will tell you what will be exceeded for the player if you perform the transfer and will not allow it.

    • With the exception of the force commands. These will ignore the any limits.

Executing via Console

An online character is needed in order to run the commands that require looking at a grid.

All commands that want you to pass a grid name can be run by console also.

Github

See Here

Beta? Version Note Date Download DL Count
v1.1.2.1 !checklimits command now shows "build / total (remaining)" for PCU and Blocks to be less confusing. 6/2/19 6:50:42 PM Download 97
v1.1.2.0 UI Added and Freebuild command can now be disabled again 5/23/19 6:10:30 PM Download 55
v1.1.1.0 filters for faction and player added to listBlocks command 5/19/19 2:45:41 PM Download 47
v1.1.0.1 checklimits command is now also available for moderators 5/18/19 8:36:39 PM Download 45
v1.1.0.0 Gridtransfer to offline players is now possible. Also there are a few new Analysis commands for Blocks, Grids and Players 5/18/19 8:34:30 PM Download 25
v1.0.3.0 New Command !freebuild that increases blocklimits of the user to be able to paste otherwise limit exceeding grids 5/5/19 9:07:25 PM Download 51
v1.0.2.0 New Commands listGridsOwner and listGridsAuthor to find all grids based on owner/authorship of an player 5/2/19 8:55:50 PM Download 37
v1.0.1.0 check commands for owner and authorchip and force option for transfer to ignore limits 5/1/19 7:33:31 PM Download 33
v1.0.0.2 Some small refactoring no new features 4/30/19 10:10:09 PM Download 36
v1.0.0.1 performance fixes & better logging 4/30/19 9:39:50 PM Download 26
v1.0.0.0 First Plugin Version 4/28/19 2:56:57 PM Download 34