Relocators: Difference between revisions

From Official Gamemode 4 Wiki
Jump to navigation Jump to search
(→‎Features: Made a small grammar fix. Moved the "can't pick up filled blocks" to the picking up section and mentioned that liquid tanks will lose liquids in the same section as it seems relevant to a non-technical audience.)
(bot removed too much)
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{ModuleInfobox|name=Relocators|creator=BluePsychoRanger|type=Reliant|versions=1.14|complementary=[[Custom Crafters]], [[Liquid Tanks]], [[Block Compressors]]|requires=[[Custom Crafters]]}}This module adds an item that can pick up Gamemode 4 machine blocks such as custom crafters, liquid tanks, and more!
{{ModuleInfobox|name=Relocators|creator=BluePsychoRanger|type=Reliant|versions=1.14+|complementary=[[Block Compressors]], [[Book Binders]], [[Disassemblers]], [[Enchantment Extractors]], [[Ender Hoppers]], [[Liquid Tanks]], [[Master Crafting]], [[Smelteries]], [[Tinkering Compressors]]|requires=[[Custom Crafters]]}}This module adds an item that can pick up Gamemode 4 machine blocks such as custom crafters, liquid tanks, and more!
==Features==
==Features==
By placing down a relocator, the player is able to pick up and move a custom machine block. Whenever a relocator is placed, it will immediately return to the player's inventory unless placed on a machine block.
By placing down a relocator, the player is able to pick up and move a custom machine block. Whenever a relocator is placed, it will immediately return to the player's inventory unless placed on a machine block.


====== Picking Up a Machine Block ======
The relocator will pick up the block it is placed on (this means a block cannot be picked up from the bottom because a skull cannot be placed on the bottom of a block).  Relocators will not pick up blocks with items in them. Relocating a liquid tank will empty it of its contents.
Once a machine is picked up, the relocator will drop as the block type it was placed on (e.g. dropper for custom crafter or hopper for liquid tank). This item will have an enchanted glint and be named according to the custom name of the block, and will have the first line of lore set to “Relocator” (yellow and italic).
====== Placing Down a Machine Block ======
To get the machine block back, simply place down the item created when picking up a machine block. The original relocator item will drop once the block is created.
===Crafting===
===Crafting===
{| class="wikitable"
{| class="wikitable"
Line 22: Line 15:
| Input = {{CraftingGrid
| Input = {{CraftingGrid
| Diamond | Popped Chorus Fruit | Diamond
| Diamond | Popped Chorus Fruit | Diamond
| Popped Chorus Fruit | Enchanted Book | Popped Chorus Fruit
| Popped Chorus Fruit | {{Stack|Enchanted Book|lore=&7Silk Touch}} | Popped Chorus Fruit
| Diamond | Popped Chorus Fruit | Diamond
}}
| Output = {{CraftingCell
| gm4:Relocator
}}
}}
|-
|Relocator (x1)
|4x Diamond, 4x Popped Chorus Fruit, 1x Silk Touch Page
|{{Crafting
| Input = {{CraftingGrid
| Diamond | Popped Chorus Fruit | Diamond
| Popped Chorus Fruit | {{Stack|gm4:Enchanted Page|lore=&7Silk Touch}} | Popped Chorus Fruit
| Diamond | Popped Chorus Fruit | Diamond
| Diamond | Popped Chorus Fruit | Diamond
}}
}}
| Output = {{CraftingCell
| Output = {{CraftingCell
| Head
| gm4:Relocator
}}
}}
}}
}}
|}
|}


=== Technical Summary ===
=== Picking Up a Machine Block ===
Scores of the armor stands are not stored, so liquid tanks will not retain their liquid type or fill amount.
The relocator will pick up the block it is placed on (this means a block cannot be picked up from the bottom because a skull cannot be placed on the bottom of a block).  Relocators will not pick up blocks with items in them.  


Sometimes the raytracing doesn't work properly and the items used to initially create the machine block will be spawned about five block in front of the player. This only happens if the raycasting does not find the correct block, due to the player moving too fast or a unique hitbox, such as the hopper.  
Once a machine is picked up, the relocator will drop as a custom block. It will have a lore indicating that it is a Relocator.


The following data is stored for a machine block armor stand: Small, CustomName, ArmorItems, DisabledSlots, Invulnerable, Pose, Tags, Y-Position relative to the block
=== Placing Down a Machine Block ===
To get the machine block back, simply place down the custom block created when initially picking up a machine block. The original relocator item will drop once the block is created.


The following data is stored for a machine block: CustomName, Lock
===Compatibility===
The relocator is capable of picking up compatible GM4 Machine Blocks. Any module can support relocation; custom pick up and place down functions are available so each module is able to be correctly compatible with relocators.
 
The following modules have relocation support:
 
*[[Block Compressors]]
*[[Custom Crafters]]
*[[Disassemblers]]
*[[Enchantment Extractors]]
*[[Ender Hoppers]]
*[[Liquid Tanks]]
*[[Master Crafting]]
*[[Smelteries]]
*[[Tinkering Compressors]]


===Compatibility===
The relocator is capable of picking up almost any machine block by Gamemode 4. There is no hard-coded list, but if the machine block has an armor stand, it is likely that it can be picked up.
===Advancements===
===Advancements===
{| class="wikitable"
{| class="wikitable"
|+
|+
!Advancement
!Advancement
!Description
!Requirement
!Requirement
|-
|-
|It's moving day!
|{{Advancement|gm4:Relocator|It's Moving Day!|Pick up a machine with the relocator}}
|Pick up a machine with the relocator
|Place down a relocator that picks up a machine block
|Place down a relocator which picks up a machine block
|}
|}
==Learn More and Download==
==Learn More and Download==
{{Download|url=https://gm4.co/modules/relocators}}
{{Download|url=https://gm4.co/modules/relocators}}
==History==
==History==
{| class="wikitable"
{| class="wikitable"
Line 62: Line 80:
!Change
!Change
|-
|-
| rowspan="2" |1.14
|1.14
|01 Dec 2019
|01 Dec 2019
|Released Relocators
|Released Relocators
|-
| rowspan="3" |1.16
| rowspan="3" |29 Nov 2020
| Improved reliability of placing down a relocated machine
|-
| Relocated machines are now custom blocks instead of the block that makes up the machine block
|-
| Improved module compatibility; each machine block can run custom pick up and place down functions
|}
|}
==Previous Versions==
=== MC 1.14-1.15 Versions ===
Prior to 1.16, Relocators were less reliable and less expandable.
When picking up a block, the block that the machine block was made of (e.g. dropper/hopper) dropped as the relocated block, instead of a custom block item. Additionally, there was no hardcoded implementation for deciding whether a block should or shouldn't be picked up, leading to errors with some machine blocks (e.g. relocated smelteries were bugged until breaking and placing it down again).
In these versions, the following technical details were present:
* Sometimes the raytracing doesn't work properly and the items used to initially create the machine block will be spawned about five block in front of the player. This only happens if the raycasting does not find the correct block, due to the player moving too fast or a unique hitbox, such as the hopper.
* The following data is stored for a machine block armor stand: Small, CustomName, ArmorItems, DisabledSlots, Invulnerable, Pose, Tags, Y-Position relative to the block
* The following data is stored for a machine block: CustomName, Lock
{{Modules List/Custom Crafters}}
{{Modules List/Relocatable Machines}}
[[Category:Reliant Modules]]
[[Category:Reliant Modules]]
[[Category:All Modules]]
[[Category:All Modules]]

Revision as of 18:45, 12 July 2021

Relocators

Module TypeReliant
Created byBluePsychoRanger
Required ModulesCustom Crafters
Complementary ModulesBlock Compressors, Book Binders, Disassemblers, Enchantment Extractors, Ender Hoppers, Liquid Tanks, Master Crafting, Smelteries, Tinkering Compressors
Compatible MC Versions1.14+

This module adds an item that can pick up Gamemode 4 machine blocks such as custom crafters, liquid tanks, and more!

Features

By placing down a relocator, the player is able to pick up and move a custom machine block. Whenever a relocator is placed, it will immediately return to the player's inventory unless placed on a machine block.

Crafting

Item Ingredients Recipe (Custom Crafter)
Relocator (x1) 4x Diamond, 4x Popped Chorus Fruit, 1x Silk Touch Book
Relocator (x1) 4x Diamond, 4x Popped Chorus Fruit, 1x Silk Touch Page

Picking Up a Machine Block

The relocator will pick up the block it is placed on (this means a block cannot be picked up from the bottom because a skull cannot be placed on the bottom of a block). Relocators will not pick up blocks with items in them.

Once a machine is picked up, the relocator will drop as a custom block. It will have a lore indicating that it is a Relocator.

Placing Down a Machine Block

To get the machine block back, simply place down the custom block created when initially picking up a machine block. The original relocator item will drop once the block is created.

Compatibility

The relocator is capable of picking up compatible GM4 Machine Blocks. Any module can support relocation; custom pick up and place down functions are available so each module is able to be correctly compatible with relocators.

The following modules have relocation support:

Advancements

Advancement Requirement
It's Moving Day!
Pick up a machine with the relocator
Place down a relocator that picks up a machine block

Learn More and Download

Download

History

Version Date Change
1.14 01 Dec 2019 Released Relocators
1.16 29 Nov 2020 Improved reliability of placing down a relocated machine
Relocated machines are now custom blocks instead of the block that makes up the machine block
Improved module compatibility; each machine block can run custom pick up and place down functions

Previous Versions

MC 1.14-1.15 Versions

Prior to 1.16, Relocators were less reliable and less expandable. When picking up a block, the block that the machine block was made of (e.g. dropper/hopper) dropped as the relocated block, instead of a custom block item. Additionally, there was no hardcoded implementation for deciding whether a block should or shouldn't be picked up, leading to errors with some machine blocks (e.g. relocated smelteries were bugged until breaking and placing it down again).

In these versions, the following technical details were present:

  • Sometimes the raytracing doesn't work properly and the items used to initially create the machine block will be spawned about five block in front of the player. This only happens if the raycasting does not find the correct block, due to the player moving too fast or a unique hitbox, such as the hopper.
  • The following data is stored for a machine block armor stand: Small, CustomName, ArmorItems, DisabledSlots, Invulnerable, Pose, Tags, Y-Position relative to the block
  • The following data is stored for a machine block: CustomName, Lock