Pirate Borg Wind Manager

Pirate Borg Wind Manager gives your table one shared source of truth for wind during naval travel and combat.

Roll or set wind direction and Changing Winds conditions from a dedicated GM control, show the current wind in a draggable scene overlay, post wind results to chat, and apply wind effects directly to selected or targeted ship actors. 

When Tile Scroll is installed, Wind Manager can detect likely water, wave, sea, and current tiles, then synchronize their scroll direction and speed with the active wind. 

Features

• GM wind controls for random rolls or manual direction/condition selection
• Draggable scene wind overlay with quick-roll support
• Pirate Borg chat cards for wind results
• Apply Wind Effect button for ship actors
• Automatic Tile Scroll synchronization for accepted water tiles
• Public API for other Pirate Borg modules to read, set, roll, and subscribe to wind changes

Public API for Pirate Borg Wind

Pirate Borg Wind Manager exposes a small public API for macros and companion modules at game.modules.get('pb-wind-manager').api. Use it to read the current wind, set or roll new wind, subscribe to wind changes, apply wind effects to ship actors, and synchronize accepted Tile Scroll water tiles.

const windApi = game.modules.get('pb-wind-manager')?.api;
const currentWind = windApi.getWind({ scene: canvas.scene });

await windApi.changeWind({
  scope: 'scene',
  scene: canvas.scene,
  postChat: true
});

The API returns normalized wind objects with direction, condition, labels, degrees, rules text, ship speed modifier, Tile Scroll speed, source, and rolled time. Other modules can also subscribe to pb-wind-manager.windChanged through windApi.subscribe(callback) and receive an unsubscribe function.

• getWind and setWind read or persist canonical wind state.
• rollWind and changeWind use the bundled Pirate Borg wind tables.
• applyWindEffect replaces Wind Manager effects on Pirate Borg ship actors.
• detectTileScrollTiles, rescanTileScrollTiles, and syncTileScrollTiles support Tile Scroll automation.
• listWindDirections and listChangingWinds expose the built-in table data for integrations.

Requires: Pirate Borg system.
Recommended: Tile Scroll for animated water tile integration.