The basic setup is very easy. You just need a programmable block with the script and that's it! Below you have a step by step description of what to do:

• subscribe to my script in the workshop (see link in the title)
  
• build a programmable block
  
• open it in the terminal
  
• press 'Edit'
  
• in the new window, press 'Browse Workshop'
  
• select my script 'Isy's Block Renaming Script' and press 'Ok'
  
• the code now appears in the window
  
• press 'Check Code' and 'Ok' in the popup window
  
• press 'Remember & Exit' and you're done

The script is now ready to run one of the commands found in this guide.

Note: Game has to be in experimental mode and ingame scripts have to enabled in world options!
How to do that, I explained here:

The basic idea of the script, is to make your life easier when it comes to renaming your terminal blocks. The script can rename blocks, replace certain strings in blocknames or give them nice and tidy numbers.

To get started, you need to write the command, you want to use, in the argument field of the programmable block and press run to execute it. Different paramaters of the commands are always separated with a comma ',' . If you see parameters in brackets, like [,FILTER] it means, that this parameter is optional and not needed for the command to work.

In this example, we want to replace all blocknames containing "Spotlight" to just "Light".


In this case, there were only two blocks, that matched the criteria, but you can bulk rename up to several thousand blocks at once. The result of our command is this:


As you see on the right, the script will output, which blocks it found and how it renamed these.

Another example would be numbers. Space Engineers will give a new number to every block you build but this number will always be one higher than the number of the last block, you built of that type. Grinding down and rebuilding blocks will end up with numbers, that don't make much sense, but we can use the sort command for this:


As you see, our two Lights have ridiculously high numbers. Let's see what the script does with that:


The script was once again a time-saver. Just imagine doing this with 300 blocks by hand... Hilarious!

The next chapters will show and explain every command, you can use.

Blocks are renamed to NEWNAME if the blockname contains OLDNAME. The number of the block is preserved but every other part of the old name (even if not specified in OLDNAME) will be replaced by NEWNAME.

• FILTER is optional and filters the possible blocks! All connected blocks that match OLDNAME are renamed if it's missing!
  Learn more about filters in the guide topic Filters
  
  
• GRID is optional and filters the grid, blocks can be found! Partial gridnames are enabled, e.g.: 'Isy' will find 'Isy's welder ship'. All connected grids are searched if it's missing!
  
  
• Hint: To skip parameters, use asterisk *

Replace a string with another one.

• FILTER is optional and filters the possible blocks! All connected blocks that match OLDSTRING are renamed if it's missing!
  Learn more about filters in the guide topic Filters
  
  
• GRID is optional and filters the grid, blocks can be found! Partial gridnames are enabled, e.g.: 'Isy' will find 'Isy's welder ship'. All connected grids are searched if it's missing!
  
  
• Hint: To skip parameters, use asterisk *

Remove a string from your blocknames.

• FILTER is optional and filters the possible blocks! All connected blocks that match STRING are renamed if it's missing!
  Learn more about filters in the guide topic Filters
  
  
• GRID is optional and filters the grid, blocks can be found! Partial gridnames are enabled, e.g.: 'Isy' will find 'Isy's welder ship'. All connected grids are searched if it's missing!
  
  
• Hint: To skip parameters, use asterisk *

Remove numbers from your blocknames.

• FILTER is optional and filters the possible blocks! All connected blocks are renamed if it's missing!
  Learn more about filters in the guide topic Filters
  
  
• GRID is optional and filters the grid, blocks can be found! Partial gridnames are enabled, e.g.: 'Isy' will find 'Isy's welder ship'. All connected grids are searched if it's missing!
  
  
• Hint: To skip parameters, use asterisk *

Sets blocknames to the default, localized name. For numbers, use autosort afterwards:

• FILTER is optional and filters the possible blocks! All connected blocks are renamed if it's missing!
  Learn more about filters in the guide topic Filters
  
  
• GRID is optional and filters the grid, blocks can be found! Partial gridnames are enabled, e.g.: 'Isy' will find 'Isy's welder ship'. All connected grids are searched if it's missing!
  
  
• Hint: To skip parameters, use asterisk *

Create new continuous numbers for a list of blocks defined by FILTER:

• FILTER is mandatory and filters the possible blocks!
  Learn more about filters in the guide topic Filters
  
  
• GRID is optional and filters the grid, blocks can be found! Partial gridnames are enabled, e.g.: 'Isy' will find 'Isy's welder ship'. All connected grids are searched if it's missing!

Same as above but gives gives continuous numbers based one the grid. So if several blocks with the same name on different grids are found, 'sortbygrid' will give new numbers for each grid separately instead of continuous numbers for all (see pictures):

• FILTER is mandatory and filters the possible blocks!
  Learn more about filters in the guide topic Filters

Sort will give continuous numbers across the grids.

Sortbygrid will give each grid its own continuous numbers.

When given this parameter, the script will automatically sort every block on its own grid with continuous numbers while adding the correct amount of leading zeros based on the total number of blocks for each type of block. All the names stay intact.


To autosort a specific grid, use the GRID as the second parameter. Partial gridnames are also detected, e.g.: "Isy" will find "Isy's welder ship".


In order to autosort every block on every connected grid, you can use the following parameter (based on the size of your station, this could crash the script!):

This will add a specific string to your blocknames. Strings can either be added to the front or the back by using the respective command. The script won't add the string again if it's already there, so executing the same command again will only add your string to blocks, that don't already have it.

• FILTER is optional and filters the possible blocks! All connected blocks are renamed if it's missing!
  Learn more about filters in the guide topic Filters
  
  
• GRID is optional and filters the grid, blocks can be found! Partial gridnames are enabled, e.g.: 'Isy' will find 'Isy's welder ship'. All connected grids are searched if it's missing!
  
  
• Hint: To skip parameters, use asterisk *

This renames a grid. Although you can do this in the info tab, you sometimes have subgrids with no access. The script can do it for you by identifying the grid via a block that is on the grid.
The parameter BLOCKONGRID is optional and is only needed to identify a subgrid. The grid of the PB is renamed if it's missing:

You can copy the custom data from one block to all blocks matching FILTER. This is especially useful for 'Special' containers of my Inventory Manager. The syntax is:


To avoid confusion, BLOCKNAME is the source and should match as exactly as possible with the full blockname of the block you want to copy from, otherwise it might first find a similarly named block and copy from that one instead.

• FILTER is mandatory and filters the possible blocks you want to copy to!
  Learn more about filters in the guide topic Filters
  
  
• GRID is optional and filters the grid, blocks can be found! Partial gridnames are enabled, e.g.: 'Isy' will find 'Isy's welder ship'. All connected grids are searched if it's missing!

You can delete the custom data of all blocks matching FILTER. The syntax is:

• FILTER is mandatory and filters the possible blocks you want to delete the custom data!
  Learn more about filters in the guide topic Filters
  
  
• GRID is optional and filters the grid, blocks can be found! Partial gridnames are enabled, e.g.: 'Isy' will find 'Isy's welder ship'. All connected grids are searched if it's missing!

Mistakes are made, but no worries ;)
If you made a mistake and want to undo your last operation, run the program with the following argument:

Everwhere you see a FILTER in the syntax you can either use a blockname, a blockgroup or a blocktype as a filter.

Blocknames
Simply use the blockname, like "Assembler" or a partial blockname, like "Turret", which will find "Gatling Turret", "Missile Turret" and "Interior Turret".

Blockgroup
This will find any user made block groups by name. Use the group token "G:" and the groupname, e.g.: "G:Solar Rotors".

Blocktype
This will find any block type or partial block type. Use the type token "T:" and type and/or subtype name, e.g.: "T:Refinery/LargeRefinery" will find any large refineries or "T:Assembler" to find "Assembler/LargeAssembler" and "Assembler/BasicAssembler"

By adding modifiers as an additional parameter to your command, you can change the way, they are executed. Modifiers can added to every command as the last parameter!

Sort mode:
Sortmode can be applied to every operation. It sorts the current selection after renaming.
Add this parameter at the end of your argument, e.g.: 'replace,OLDSTRING,NEWSTRING,!sort':


Testmode:
If you want to see your planned names without actually renaming any block, you can use testmode. Just append this as another parameter to your argument line, e.g.: 'replace,OLDSTRING,NEWSTRING,!test':


Help:
Every command accepts '!help' as an additional parameter. Just append this as another parameter to your argument line to see the help for this command, e.g.: 'autosort,!help':

The following topic explains, how to use LCD panels (regular and block LCDs) of my script. Whenever you add one of the following keywords to a LCD name, the keyword gets transformed to the universal [IsyLCD] keyword. In the custom data, you can then set different options about the LCD as well as the screen, the information should be shown (on blocks like cockpits, programmable blocks and so on). The custom data will look like this:

@# !KEYWORD

@# stands for the screen, the information is shown, where # is the screen identifier number from 0 to the max number of screens - 1. A programmable block for example has two screens: The main screen and the keyboard. Both can be used to show the script informations (screen 0 and screen 1). To change the screen, you want to show your informations, just edit the screen identifier number in the custom data.

It is also possible to display informations of different scripts in one block by using this syntax (MMaster's Automatic LCDs 2 uses the same syntax and all of my other scripts).

Main LCD
You can display all the main script informations that are also shown in the console on the main LCD. Just add the following keyword to a LCD name:

[IBR-main]

This will rename all blocks that contain "Interior Light" to "Base Light" and create new continuous numbers with automatic leading zeros, e.g.: "Base Light 01", "Base Light 02", ..., "Base Light 10"

This will replace the word "Sliding Door" with "Door" on all blocks that contain it. All other parts of the name stay intact, e.g.: "Basement Sliding Door Right 1" will be renamed to "Basement Door Right 1"

This will attempt to autosort every block on your grid, but only shows you the new names without actually doing anything because testmode was given as a parameter.

This will add "[Isy]" in front of every blockname on every connected grid, that contains "Reactor".