This script provides functionality for swapping tiles. In a single script call, you can change entire groups of tiles from one tile to another. The changes may be reverted as well using simple script calls.
Script: download here
There are some concepts and terminology that you would need to be familiar with before effectively using this script.
RMVX Ace’s tileset design takes a single tileset and splits it into 5 different pages (A, B, C, D, E). It then takes the A-page and breaks it down into 5 more parts (A1, A2, A3, A4, A5)
This script uses the custom concept of a “tile ID”, which is a special string that represents a particular tile on your tileset page.
The format of a tile ID is a letter, followed by a number.
- The letter is the tileset page.
- The number is the position of the tile on that page.
So for example, “A3” would be the the third tile in tileset A, whereas
“B12” would be the 12th tile of tileset B.
It is very easy to look up the position of a tile: just look at your tileset page and number the top-left tile as 1. Then, numbering left-to-right, top-to-bottom, you would get something like this
For page A, it is a little different. This is assuming you have all 5 parts.
If you are missing any parts, you will need to skip them appropriately.
To avoid all the unnecessary math, simply fill up the empty slots with dummy tilesets to make things easier.
The script supports three ways to swap tiles:
- Swap by tile ID
tile_swap(old_tileID, new_tileID, layer, map_id)
This is a very simple swap. It takes all of the old tiles and swaps them to the new tile. For maps where you simply want to swap out an unwanted tile, this is the easiest to use.
2. Swap by region ID
region_swap(regionID, tileID, layer, map_id)
This swaps all tiles within a region to the new tile.
- Swap by position
pos_swap(x, y, tileID, layer, map_id)
This swaps the tile on the specified position to the new tile.
You can undo any changes by using the following calls
tile_revert(tid, layer, map_id) pos_revert(x, y, layer, map_id) region_revert(rid, layer, map_id) revert_all(map_id)
Each method has its own uses in different situations depending on which tiles need to be swapped.
KilloZapit, for providing the code for auto-tile generation.
Hi Hime is there a way to delete shadows ?After swap ?
Well this will be problem with Tile swap 🙁 I wanted to made random generator level 🙁 thanks for answer!
Just another person hoping to see this for MV at some point. Love your plugins and videos! Keep hangin’, bro!
It is currently in development, though auto-tiles and auto-layers will not be supported at this point.
Awesome. This is another of my favorites I’d love to see for MV eventually. I originally used it for creating more elaborate spike traps. I’ve found uses for it everywhere though.
Is it possible to prevent a pos_swap if standing on certain tile IDs?
e.g. I want to turn the square I am standing on into tile ID X, but only if that tile has ID Y
Hmm there isn’t really a nice way to check what the current tile is…
Can you please explain me how you detect tiles, making a game and didn’t undestand that part.
What do you mean by “Detect tiles”?
Can this be used comercially?
Hi! First off I gotta say, I love your script! I used it quite a bit in VXAce ^^
But, to my question, do you have any plans on making it for MV?
Yes, I will port it over to MV at some point. Currently, the list of scripts to port over is pretty big and the rate I’m going at them is pretty slow since I’m making videos for each of them as I go
Okay, then I will be patiently waiting ^^
Any progress on getting this created for mv? I’m desperately needing a way to swap tiles and have found nothing useful so far. Zero scripting knowledge…
I haven’t started working on it yet.
Hey, Hime. I have a problem: “Script ‘Nameofmyscript’ line 634: SyntaxError occurred: unexpected ‘:’ alias :tsuki_tile_swap_setup_map: setup”. What should I do? Thanks.
Hmmm… Sorry, man. That’s not the problem anymore, I solved it. This is the problem: “Script ‘Game_Interpreter’ line 1411: TypeError occurred. can’t convert String into Integer”. I’ve put the script between Materials and Main, I’ve just Ctrl+C and Ctrl+V the script… I’m using this script: “region_swap(1, “A17”, “A46″, 0)” that’s triggered by an event in parallel process. Thanks. Sorry, my english sucks.
Man, I hope you have not wasting your time with my stupid questions. I just needed to read the instructions properly. Sorry.
Glad you found a solution to the problem.
Hello. I went to download Tile Swap but the link sends me to a text file. I would really like this Script 🙂
The text file is the script. You insert that into your project through the script editor.
Well now i feel like an idiot, Thank you. I will be trying your scripts!
hey sorry but im completely new too rpg maker and i just cant get this too work?? what am i doing wrong this is my script tile_swap( A98, A37, 1, 2)
The “tile codes” need to be surrounded by quotes.
tile_swap( “A98”, “A37”, 1, 2)
This script is truly marvelous, but I’m having some problems with it. Tiles will swap just fine in button press, collision, touch or even autorun events, but it won’t work for parallel processes. Is this intentional?
I have tested the script in a new project with a parallel process event and it seems to work for me. I only tested the “tile_swap” script call.
I created a new map, created a patch of water (“A1”) and then used a script call to change “A1” to “A8”. It then waits 60 frames, before changing “A8” to “A1”, and waits another 60 frames. This occurs as a parallel process.
The result is the patch of water toggling between lava and water in one second intervals.
thank you so much hime, this script is no less than amazing!
Hello! How to work with Mask?
I haven’t used the mask very much so not too sure, as I did not write that part of the script. Sorry about that!
I downloaded the script, but I keep getting the error Script ‘Game_Interpreter’ line 1411: NoMethodError occurred. undefined method ’tile_swap’.
Do I need to move the script to a specific location to make it work and if so where?
It should be placed below Materials and above Main.
Sorry if it was asked already, I looked through a bunch and searched but couldn’t find it.
Does the tile change persist through map transitions and save/load? Or do I need to do a script call when entering a map, if the tile change I want is different than the default map?
It should persist until you reset it via script calls.
Hey. Interesting script but : Why this gives me a bug
with words – " interpreter A ? " It shouldnt happen. It's against logic
pos_swap(26, 32, A, 17, 2)
I replaced A with a number and gives me another bug…
What must be written instead of numbers if i want use switches/variable as arguments (switches/variables – from games and switches/variables from ruby)
Check the usage instructions. The proper way to reference a tile is something like "A24" or "B12".
You can just use normal ruby for variables. $game_variables can be accessed if you want the game variables.
Sorry i have to report a Bug again. I hope that is OK.
If i use the pos revert command within a paralell event, the game crashes.
even if the code is just running once and than with switch to the seccond event page,
it crashes also.
If i select the Action Button Trigger on the Event, it works fine.
That is strange.
Besides that one Question:
Is is possible to use a autotile from for example A1 on layer 2?
it works, but without autotile functionality. Is it possible that it works like a autotile on layer 2? (Just a question, no emergent need for it at the moment)
(Iam still learning English, so i hope you can understand what i tryed to explain and ask)
When I fixed the crashing error, I found another bug where the map tiles are constantly being reloaded. Will need to figure out something for that.
I've updated it so you can draw auto-tiles on layer 2.
The Autotiles on Layer2, it seems to work fine.
You are right, everytime a pos revert command took action, the
original map gets loaded for a seccond, and after that all swapped tiles reapear on the map. Did you ment that?
Yes, the way the "revert" is not very clean right now.
I didnt found a Solution for the Buggy
Can you Safe my Day? 🙂
I haven't found a way to address the problem. Consider asking the question on rpgmakerweb forums and see if someone might have an idea.
pos_revert command isnt working as supposed.
If i swap around all tiles between x 0to10 and y 0t10 it works perfectly.
But when i want to revert only one specific tile, he will not let me do that,
insteed he keeps deleting on tile on the y axis on every call, until it reaches the chosen coordinate.
(My English isnt the best, hope u can understand) I realy could need that revert command).
Edit: Your explanation above is wrong:
pos_revert(x, y, tid, layer, map_id)
pos_revert(x, y, layer, map_id)
and i used:
pos_revert(4, 3, 2, map_id)
The problem should be fixed now. See if it works. I have also updated the documentation to show correct usage.
Thank you so much Hime. It seem to work perfect fine now.
Thank you thank you thank you for answering this so quick.
If iam able to create a (workaround) Fog of War with this,
i will share it.
Is it possibe to use this script with variables? as in, "pos_swap($Game_Variables, $Game_Variables, "A27", 1)"?
It doesn't seem to work for me, though it could be something else in my project…
It's $game_variables, no upper case.
I get an error 629 – Unidentified method 'setup' in class 'Game_Map'. This is my first time using a script in rpg maker so im not sure where it should have been added. How can I resolve this?
Add it below Materials and above Main.
For general interest, I want to state that this and Sheolshade’s Minimap
You can’t use $game_map.refresh to reset the minimap but you can teleport to a base map then teleport back to the same spot and the minimap will be updated.
I think the mini-map needs to be completely re-drawn from scratch, since there are new tiles. I don’t know how that would be done. Does that minimap work with fomar’s script? Cause both scripts change tiles; it would be strange if one updated the minimap and the other didn’t.
They are both compatible and update if you teleport. You can just go to a black map or set the screen black for a second, almost as if blinking then seeing a change of scenery.
That’s because the map is only redrawn when you change the map. If you want the map to change if any tiles on the map changes, first update the Tile Swap script, then in the minimap script go to line 344 and change the condition to
Didn’t you have something where you have a house in an area and you swap it to a new location?
I can’t find all your stuff since it’s in different places
You might be thinking of this one http://forums.rpgmakerweb.com/index.php?/topic/1833-region-map-loader/
I never looked at what it does beyond what people have suggested though.
As I suspected, your script doesn’t work completely with his ‘installed. Not that that was very helpful of me. I don’t quite know how to explain how it doesn’t work. Perhaps I comment to him.
I think yours would be more important, though.
But if I wanted to make it so you can build a cabin in the forest and made a new map which is the same as the forest, only, with a cabin, then every call I made referring to the map id would have to be conditioned and switched.
One reason I was using your tile swap script is to go from
And fomar to from
You should consider using Placeholder Maps: http://himeworks.wordpress.com/2014/01/13/placeholder-maps/
It allows you to set a condition on the map that will have the engine figure out which map to load depending on the conditions you have set. The purpose of the script is exactly to allow you to NOT have to do all of those conditional checks in events when you want to transfer from one map to another.
Hey Hime! I keep getting an error,
“Script ‘Game_Interpreter’ Line1441: NameError Occured.
Uninitialized constant Game_INterpreter::A11
that error pops out for every tileID I input.
Wrap it with quotes. “A11”
Well that was stupid of me, thanks Hime! 🙂
I thank you for your help, I will just start a new project since this was only a tutorial map for me.
Okay, it works on a new project, but not my existing one…. not sure what is going on.
You’ll have to debug the issue on your own as I don’t know what might conflict with the tile swap (or overlay maps). Disabling scripts one at a time to find the problem, etc.
maybe there is something wrong with my program.
Possibly. Try it in a new project. Shouldn’t take more than 2 minutes to set up.
Can you post a screenshot of your event page so I can see exactly what you put in please?
So for simplicity, if I wanted to do a region swap on the overlay map, region_swap(10, B1, 0, 7) should work?
region_swap(10, “B1”, 0, 7) doesn’t work O_o
Any other event settings that I should turn off/on like priority or Options?
No, you should be able to just insert the scripts and make the script call. I tried it on a new project with the new updates (oct 23 versions) and the tiles on the overlay map were swapped as expected.
Invalid Octal Digit.
pos_swap(009, 003, “B1”, 0, 007)
Don’t have extra 0’s in your numbers. 009 is not the same as 9.
Have seen this discussed, but not spelled out. I am trying to make tiles on an overlay map vanish when I trigger an event. I have tried pos and region both to no effect.
region_swap(10, A31, all layers tried, tried 007 & 7)
pos_swap(9, 3, A31, all layers, tried 007 & 7)
Please help or let me know what I need to do exactly? I am trying for your disappearing fog but with overlay map and tile swap.
Sorry, it looks like there was a bug in the scripts that prevented overlay maps from updating properly. I’ve updated both the overlay maps script as well as the tile swap script to address the issues. Please download the scripts and see if it works.
I am using your overlay maps & tile swap to create hidden paths. I am using VX Ace if that makes any difference. I can get everything to work until I try region or pos swapping on overlay layer. Region swap doesn’t detect and position swap gives ruby errors.
Is it possible to swap “overlay” tiles with this? It doesn’t seem to detect the overlay map correctly?
If this can be properly utilized, novices need not touch photoshop at all.
What is your script call?
Are you still giving support for this script? Or not anymore? Because I’m getting an error as I’m starting my game, which say’s: “Script ‘TileSwap’ line 727: SyntaxError occurred. Invalid Text”
Any idea what this is about?
I have reverted the script to a previous version so that it works. Will see what is causing the problem.
Where is the updated script? 🙁 I’m having the same problem.
Seems like the dropbox version was never updated. It’s the same link to the script. I’ve checked that it has been correctly updated now.
It’s possible to change a single tile to anoher tile, from a diferente tileset?
an exemple, change the normal window to a light window (the last in a different tileset)
You should be able to pick tiles from different pages.
Is it normal for the shadows to remain after swap?Its not a big problem because it looks good anyway,its like it shows that something is there.
Shadows are not touched during the swap process.
Tiles from A5 doesn’t swap, this is one of the script call i used
tile_swap(“A217”, “A222”, 2, 3)
other tiles are swapping fine only tiles from A5 doesn’t swap, Help please? Thanks.
Thanks for the report. I have fixed the issue. It should work now. Note that A5 tiles are on Layer 2 because they are “normal” tiles
Thanks it’s working now, but they doesn’t swap when in layer 1 and 2, only on layer 0.It wouldn’t cause a problem right?
It might, but I think A5 tiles are only in layer 0.
Here is a video showing it in work 🙂
Looks good. Maybe I can add some functions to make it easier to modify overlay map properties such as changing the opacity or the position.
Thank you now because of your tutorial and tile layer teaching i can reach the effect i wanted!If you want to know the main problem was that,i used a different tilesset to make the wall and a different tileset had the transparent tiles,so when it applied the transparent effect it went to a different layer covering nothing.So the wall remained.Anyway….i still have to learn about tiles layers and photoshop,but without your help i may never reached to this,thank you.
Sorry i wrote this into the bad category this is the tile swap category…..im just using the overlay map too,and because of this combination its a bit hard to tell what im doing wrong xD
Im not sure,because opacity too seems to be out of order.But i think yes because aside form the current map im on with the player,there is only one map with the same size that serves as the wall layer…..or am i misundnerstood the meaning of layer?
There are three tile layers: 0, 1, and 2. Auto-tiles are drawn on layers 0 and 1, while the other tiles are drawn on layer 2. I am unable to automatically determine which layer your tile is on, so you’ll have to explicitly say which tile you are modifying.
I use now layer 1…but becuase i assume i cant effect tiles that are shown by overlay map i have to use a call event script so i can call an event from other maps that change the overlay map tiles….So i did this but either nothing happens….or im too noob to understand whats going on….i still re-reading your tile swap tutorial every 5min to find out what im doing wrong with tiles and layers….and thanks for the note,yes i understand now that there are 3layer,but i added my transparent tileset first in D-sheet which used layer….2…..now i added the set into A3(BUILDINGS)(that was the only empty space)which should treat it like layer 0?Ok first of all thanks for trying to help me(a noob)…..and answering this fast :'(
I have updated the script so that it supports overlay maps. If you look at the documentation for the functions, you will see that the last argument is “map_id”. By default, this is the current map if you don’t specify one, but you can pass in the ID of the overlay map instead and it will update THAT map instead of the current map. This was always in the script; the only change I made was to update the overlay maps as well.
Big thanks for this cool script!
Can i ask a little help about this script?I switch a region of tiles into transparent tiles,but after the swap,the tiles are still visible.Is that normal?If yes,how can i reach that kind of effect that a wall is there blocking view and when i got there it disappears leaving the floor tiles to be seen.
Thanks for help!
Are you swapping the correct layer?
Fixed bug where specifying a tile on pages C to E was not handled properly and the script chose a tile from page B.