Isometric Perspective

This module changes the map, tiles and token artwork/sprite for use with maps and tokens drawn using an isometric perspective.

Features

Here are some of the features the module offers.

• Dual Canvas Perspectives: You can use native isometric maps or top-down maps in isometric perspective. This way you can use any 2D map you want with the isometric perspective as well.
• Multiple Isometric Projections: You can choose between different types of isometric projections, with different aspect ratios, such as the default true isometric (√3:1), dimetric (2:1), overhead (√2:1) and others specific to well-known old games. You can even add your own custom perspective using my own tool you can find here.
• Token Sprite Adjustments: You can fine-tune the position of the token sprite, as well as its scale. You can adjust the token art sprite to be centered even if the token is assymetrical. Increasing the token size automatically increases the sprite size, but you can disable this to use tokens with unconventional sizes (such as a tank that has dimensions of 2x1).
• Tile Sprite Adjustments: You can also fine-tune the sprite position and scale, making easy to copy and paste multiple tiles. There's also a easy Flip Tile option.
• Token Height Visual Cues: If a token has any elevation, its sprite adjusts to reflect the height, with a round shadow and line sprites being created for clarity.
• Dynamic Tile: If you link a tile to a wall, the position of the token can make the tile invisible, and having a isometric game-like experience.
• Auto Sorting Token: Tokens are automatically ordered, with tokens that are further away appear behind tokens that are closer, based on canvas position.

Configuration Screens

Images

Token and map art provided by Epic Isometric and The Dungeon Sketcher.

Dynamic Tile previews. Elevation previews.

Compatibility

The basic functionality of this module is just apply a transformation on the canvas (rotate and skew) achieving an isometric perspective while undoing that transformation on the background, tokens, and tiles. This approach ensures compatibility with most Foundry core features and modules that don’t directly interact with these systems. Native functions like templates, drawing, and lighting should work as intended.

These are the modules I've tested and their status:

• Working
  Drag Upload
  Elevation Ruler
  FXMaster
  Levels
  Sequencer
  Tactical Grid
  Tile Sort
  Token Ease
  Token Movement 8bit Style
  Wall Height

• Partially Working
  DFred Droppables (tokens are dropped far from the point where the mouse is pointing. Just zoom out to find where they are)
  Drag Ruler (sometimes the values ​​do not appear, but this is a problem with the drag ruler and not this module)
  Token Magic FX (some area effects, like sphere effects, are deformed)
  Rideable (if both mount and rider tokens have the same size, isn't possible to select the mount token)

• Not working
  Image Hover (render the art, but it moves with the pan of the canvas. You can only see it if you use hotkeys, and will not show the entire art)
  LockerView (needs a 330° rotation to make a working isometric rotation)

Known Bugs

• Scene Grid Configuration: The canvas background configuration in Scene Settings > Grid > Ruler Tool ( ) does not work.

  • Workaround: The art scale function has been recreated in the Isometric tab, and you can set the offset in the Grid tab. For align the grid, you really should use the module Grid Scaler for that.

• TokenHud and TileHud Position: The position of the TileHud (menu on right-clicking a tile) is aligned with the left vertex, but sometimes will be far away from the token/tile.

  • Workaround: In most cases, running the macro canvas.draw() is enough to fix.

To-Do List

• [ ] Add new perspectives.
• [ ] Code to handle tiles and walls.
• [ ] Code to handle occlusion of tiles and tokens.
• [ ] Different token art for isometric and top-down views.
• [x] Code to handle non symmetrical token sizes.
• [x] Translation to other languages.
• [x] Check compatibility with other canvas related modules.
• [x] Bugfix: Change tokens properties (vision) change token position.
• [x] Using core foundry controls for token scale and anchor. (Scrapped idea).

Contribution

Contributions are welcome! If you want to improve this module, feel free to open an issue or submit a pull request.

License

This project is under the MIT license. See the LICENSE file for more details.