View source for Tile Grafter System VisuStella MZ

{{MzPlugin
|preview = <youtube>https://youtu.be/3bbNd1Z_pX8</youtube>
<!-- |preview = [[File:VisuMZ.147.jpg|600px]] -->
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/2501192" width="552" height="167"><a href="https://visustellamz.itch.io/tile-grafter-system">Tile Grafter System plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wanderlust Vol 2}}

}}

<!-- Preview -->

[[File:TileGrafterSystem_Preview1.gif]]

[[File:TileGrafterSystem_Preview2.gif]]

[[File:TileGrafterSystem_Preview3.gif]]

[[File:TileGrafterSystem_Preview4.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]
* [[Events and Movement Core VisuStella MZ]]

<!--
{{ExtensionPluginsMZ}}
* [[Extension Plugin 1|Name1]]
* [[Extension Plugin 2|Name2]]
* [[Extension Plugin 3|Name3]]
-->

{{Visustella MZ}}

== Introduction ==

Ever wanted to insert tiles onto one map from another in-game? And have them
retain those changes? The Tile Grafter System allows for exactly that, so
that you can make HUB-like maps containing evolving architecture overtime
without the need to make lots of map variants. Take them exactly or by
certain tile layers only.

Features include all (but not limited to) the following:

* Tiles from one map can be inserted into another map via Plugin Commands in the form of tile grafting. 
* These tiles can be inserted exactly or layer by layer depending on how you configure the Plugin Commands. 
* Returning to maps with changed tiles will have their changes retained. 
* Don't want these changes to be permanent? You can revert them or clean them up even. 
* Grafting tiles can optionally work with autotiles as well. 
* Insert shadows and even alter region IDs as well. 
* If allowed, events from the source map can be grafted into the current map as preserved spawned events. Likewise, those spawned events can be removed when cleared or reverted. 



== Requirements ==

This plugin is made for RPG Maker MZ. This will not work in other iterations
of RPG Maker.

=== Required Plugin List ===

* [[Core Engine VisuStella MZ]]
* [[Events and Movement Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}



== Major Changes ==

This plugin adds some new hard-coded features to RPG Maker MZ's functions.
The following is a list of them.

---

=== Map Tileset Data ===

[[File:TileGrafterSystem_Preview1.gif]]

Tile Grafting will change up the tile data found present in the current map.
As a result, $dataMap.data will have its values changed and adjusted
appropriately to reflect the new changes made. This means that map collision
and the like will be changed, too.

When grafting, the tiles that will be imported from the source map will be
changed to whatever the current map's tileset is. This means that you CANNOT
use a different tilemap on a source map and expect it to remain the same
when inserting into the current map. Instead, it will convert whatever tiles
are being used into the current map's tileset instead.

Upon leaving and returning to the map, the tile data will remain changed
until reverted by a Plugin Command.

*NOTE* When grafting from a source map for the first time, the game will
need to load said map. This may cause the game to wait a few frames before
continuing. Therefore, it's best to preload these source maps if possible
using the Plugin Commands.

---

=== Autotiles ===

[[File:TileGrafterSystem_Preview2.gif]]

If you decide to graft using autotiles, autotiles will be applied slightly
differently than how they're done in the RPG Maker MZ editor in order to
preserve more of the game map. This is done INTENTIONALLY and is not a bug.

Autotiles will only affect their own tiles and not surrounding tiles that
aren't matching. In the editor, some road tiles will connect to one another
regardless if they're the same type. That does not happen here in order to
make more sense in the context of the game.

When grafting an autotile to a coordinate, it will affect matching autotile
types in the surrounding 8 tiles, too. This is to make sure that all of the
pieces will connect properly.

---

=== Grafted Events ===

[[File:TileGrafterSystem_Preview4.gif]]

If you allow grafting the event layer (L7: Events), you can spawn any
matching events from the source map as long as the locations coincide. These
events will be spawned into the map as preserved spawns.

When importing, if there are any normal events already existing on the
grafting target location, they will be preserved in order to prevent a map
desynchronization. Keep this in mind as you prepare for spawning. On the
flip side, if there are any spawned events already existing on the target
location, they will be despawned.

If you want to make sure there are no events in the grafting target area
before applying the grafting, use the

When using the Clear and Revert Plugin Commands, currently existing spawned
events (if the L7: Events layer is affected) will be removed from the target
location. Both Clear and Revert function the same for the L7: Events layer.

Clear and Revert will NOT remove any already existing normal events from the
target location in order to ensure the game map does not desync. However, it
will remove any spawned events that may have wandered into the area. Due to
this clearing process, the "Revert" function will NOT restore any spawned
events that may have been removed through grafting. Keep this in mind.

---



== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

=== [[Lighting Effects VisuStella MZ]] ===

The VisuStella MZ Lighting Effects plugin has "Anti-Light" and "Auto-Light"
functions tied to region IDs. If these regions match a grafted tile's region
then the map will fade out and fade back in to properly show the newly added
"Anti-Light" and "Auto-Light" effects.

---

=== [[Visual Fogs VisuStella MZ]] ===

The VisuStella MZ Visual Fogs plugin has fogs that can be applied to only
certain regions on the map. If these regions match a grafted tile's region,
then the map will fade out and fade back in to properly show the fog being
applied to that region.

---

=== [[Visual Parallaxes VisuStella MZ]] ===

The VisuStella MZ Visual Parallaxes plugin has water reflections that can be
applied to only certain regions on the map. If these regions match a grafted
tile's region, then the map will fade out and fade back in to properly show
the parallax reflection being applied to that region.

---

=== [[TileD VisuStella MZ]] ===

This plugin does not work with TileD.

---



{{Plugin Commands MZ}}

{{VisuMZ Tile Grafter System Plugin Commands}}



== Plugin Parameters ==

=== General Settings ===

[[File:TileGrafterSystem_Preview3.gif]]

There's a single Plugin Parameter that can be adjusted here.

---

[[File:TileGrafterSystem_Param1.png]]

Parameters

  Nonmatch Tileset Warning:
  - Turn on warnings when using nonmatching tileset IDs.
  - This is because when grafting, the tiles that will be imported from the
    source map will be changed to whatever the current map's tileset is.
  - This means that you CANNOT use a different tilemap on a source map and
    expect it to remain the same when inserting into the current map.
  - Instead, it will convert whatever tiles are being used into the current
    map's tileset instead.

---



{{VisuStella MZ Terms of Use}}



== Credits ==

If you are using this plugin, credit the following people in your game:

Team VisuStella
* [[Arisu]]
* [[Irina]]
* [[Olivia]]
* [[Yanfly]]



== Changelog ==

Version 1.02: August 29, 2024
* Compatibility Update!
** Added compatibility for Core Engine's version 1.84 new notetag: Taller by x: id.


Version 1.01: February 15, 2024
* Bug Fixes!
** Fixed a function clash with the Save Core. Fix made by Olivia.



Version 1.00 Official Release Date: February 23, 2024
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wanderlust Volume 2]]



== End of Helpfile ==

|}

<!-- This is a comment, remove the arrows surrounding this for the categories you want to show -->
<!-- [[Category: RPG Maker MZ Core Plugins]] -->
<!-- [[Category: RPG Maker MZ Battle Plugins]] -->
<!-- [[Category: RPG Maker MZ Item Plugins]] -->
<!-- [[Category: RPG Maker MZ Skill Plugins]] -->
<!-- [[Category: RPG Maker MZ Equip Plugins]] -->
<!-- [[Category: RPG Maker MZ Status Menu Plugins]] -->
[[Category: RPG Maker MZ Gameplay Plugins]]
<!-- [[Category: RPG Maker MZ Movement Plugins]] -->
<!-- [[Category: RPG Maker MZ Quest Plugins]] -->
<!-- [[Category: RPG Maker MZ Options Plugins]] -->
[[Category: RPG Maker MZ Eventing Plugins]]
[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]
<!-- [[Category: RPG Maker MZ Menu Plugins]] -->
<!-- [[Category: RPG Maker MZ Message Plugins]] -->
[[Category: RPG Maker MZ Quality of Life Plugins]]
<!-- [[Category: Action Sequences (MZ)]] -->
<!-- [[Category: Comment Tags (MZ)]] -->
<!-- [[Category: Main Menu Manager Integration (MZ)]] -->
<!-- [[Category: Notetags (MZ)]] -->
<!-- [[Category: Options Core Integration (MZ)]] -->
<!-- [[Category: Plugin Commands (MZ)]] -->
<!-- [[Category: Script Calls (MZ)]] -->
<!-- [[Category: Text Codes (MZ)]] -->