Lazy Tilesets

じ☆ve冰风

Lazy Tilesets 1.0
Shaz​

Introduction
We all love getting new tilesets for our games, and can't wait to get them installed and start using them. But there's the importing of images to be done, the allocation to correct slots, the setting of passage, counter, ladder, bush, damage and terrain data, and heaven help us get it right the first time!

NO MORE!!!

These two companion scripts allow a tileset creator to export all the settings from the Tilesets tab into one or more files to distribute with the resources, and for users to allocate a tileset, specify which settings file to use, and import all the settings in one quick, easy action.

Over time, resources packs on the store that include tileset resources for Ace will include these scripts and the .VXATileset files, so when you buy tilesets from the store, the settings file will come with it, and you will be able to load them quickly and easily. In the meantime, as the artists are able to provide the files, they'll be added to this thread.


Features
- Pulls tileset images into correct slots - no more wondering why your map isn't being drawn the right way when you've put the images into wrong slots.
- Sets all passage, counter, ladder, bush, damage and terrain data just the way the artist intended them to be.
- Mix and match resources from different tilesets, including moving a resource from one B-E slot to another.
- Set up multiple tilesets at a time
- Creates a backup of your Tilesets.rvdata2 file prior to making any changes - if things go terribly pear-shaped, you can just replace the file with the backup.

How to Use
Instructions are in the scripts, but ...

Lazy Tilesets - Exporter

• As an artist creating your tilesets, once you have all the database settings correct, import the Lazy Tilesets - Exporter script, and in the notebox of each tileset you want to export, add the following command:
                  Code:       
  1. <export tilesetname>

  复制代码
  
  
• tilesetname can be a mix of letters and numbers only - other characters will be removed. The name must be unique - if you have more than one tileset using the same name, the second one will overwrite the first one.
  
• Run your game. When the title screen appears, close the game.
  
• In your Graphics/Tilesets folder, there will be a new .VXATileset file for every tileset where you placed the <export ...> note.
  
• Package this file with the rest of your resources for distribution.
  

Lazy Tilesets - Importer

Beginner Mode

• As a developer downloading tilesets and importing them into your game, make sure the .VXATileset files provided with your resources are saved into the Graphics/Tilesets folder.
  
• Import the Lazy Tilesets - Importer script.
  
• DO NOT RENAME ANY FILES - EITHER THE .VXATileset FILES OR THE TILESET IMAGE FILES.
  
• Open the Tilesets tab and insert slots for your new tilesets.
  
• Name your tilesets, and in the notebox, add the following command:
                  Code:       
  1. <import tilesetname>

  复制代码
  
  
• tilesetname must be exactly the same as the .VXATileset file for the pack you want to import (without the extension).
  
• Run your game. When the title screen appears, close the game.
  
• Close the editor (do not save, if prompted) then open it again (you might be able to just reopen the same project - what we're looking for is for all the database files to be reloaded in the editor).
  
• Take a look at your tileset - all the images will have been placed into the correct slots, and the settings all updated.
  
• If all looks good, remove the import statements from the tileset note boxes, and remove the script - you do not want to distribute the script. You should also remove the .VXATileset files when you're done with them.
  

Intermediate Mode

• What if you want to create a tileset that is a combination of tiles from different sets, with settings in different .VXATileset files?
  
• That's pretty easy too. Just add the slot IDs after the tileset name, and it will only import those slots from that tileset.
                  Code:       
  1. <import tilesetname B C D E>

  复制代码
  
  the above will import only tabs B, C, D and E from the tileset file, leaving all the A tiles alone.
  

Advanced Mode

• So you want to get clever and shuffle things around a bit? You want slots A and B from tileset 1, and slots A and B from tileset 2 as well, but you want to put those into the D and E slots?
  
• Still pretty easy. Just add a series of slot combos, separated by a colon : and it will take the first slot from the tileset and place it into the second slot:
                  Code:       
  1. <import tileset1 A B><import tileset2 A:C B:D>

  复制代码
  
  the above will import slots A and B from tileset 1 and place them into the A and B slots, then will import slots A and B from tileset 2 but place them into the C and D slots.
  

Demo
Celianna's Tileset
SpoilerNot a demo to download, but an example using files kindly provided by Celianna, from her editor (grid-based) tileset:

Download Celianna's tiles from her topic and save them into your Graphics/Tilesets folder. You should have (these names must be exactly the same, including the case):
celianna_TileA1.png
celianna_TileA2.png
celianna_TileA3.png
celianna_TileA4.png
celianna_TileA5.png
celianna_TileB(1).png
celianna_TileB(2).png
celianna_TileC.png
celianna_TileD.png
celianna_TileE.png

Also save the following files into your Graphics/Tilesets folder:
CeliannasTilesetSummer.VXATileset
CeliannasTilesetWinter.VXATileset


In your project, create two new tilesets and name them.

Put the following into the first tileset's note box:

                Code:       

1. <import CeliannasTilesetSummer>

复制代码

Put the following into the second tileset's note box:
                Code:       

1. <import CeliannasTilesetWinter><import CeliannasTilesetSummer A3 A4 C D E>

复制代码

Run your game then close it, and close the editor.

When you are happy with the tilesets and don't want to do any more importing, remove the import statements in the note tab. Then remove the script.




Script
Lazy Tilesets - Exporter (for artists)
Lazy Tilesets - Importer (for those using the art)

FAQ

Q: My tileset settings aren't being imported
A: Make sure the filename used in the <import ...> statement is exactly the same as the .VXATileset file name, without the extension. Also make sure you haven't renamed any of the tileset image files or the .VXATileset files.


Post questions below if you need help running these scripts. A screenshot of your Tilesets tab and a screenshot of your Graphics/Tilesets folder might be helpful too.


Credit and Thanks
- Shaz
- Thanks to Celianna for her tilesets for the opening thread, and to other artists who will provide their exported VXATileset files to be added to the thread over time.


Author's Notes
These scripts are NOT intended to be distributed with your released game (or even for demos or beta testing). You WILL have issues if you compress your game while these scripts are active. Please remove them as soon as your tilesets are all set up correctly.

Free for commercial use.

You do NOT need to credit me in your game if you use these scripts. They are developer tools and I never ask for credit for scripts that are being pulled from your game before release.


本贴来自国际rpgmaker官方论坛作者:Shaz处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/lazy-tilesets.36354/