PlanarAlly releases

This is a small patch to fix an issue with the new note filters not showing details as advertised.

This is a small patch to fix an issue with templates dropping not applying their dimensions properly.

For more details on what's new checkout https://www.planarally.io/blog/release-2026.1/

planarally-bin provides a prebuilt client, with a python server that you'll need to run yourself.
planarally-windows provides a compiled executable that can simply be run by double clicking the exe in the planarally-windows-2026.1 folder.

Check the documentation over at https://www.planarally.io for more info

The changelog for this release:

Added

• Custom shape data
  • A new tab in the Shape settings UI
  • Can be used to freely add custom data and create a rudimentary character sheet
  • Currently supported data types are text, number, toggle and dice expressions
  • Dice expressions can reference other data entries and open the dice tool with the evaluated expression
  • Dice tool has a quick access sidebar to selected shapes with dice expressions
  • Dice tool shows auto completion on expression references
• Shape order inconsistency check
  • Runs when moving a shape to the back
  • Fixes the order of all shapes on the layer and requests a page refresh
• Asset manager icon when a shape has template info
• Notes:
  • Campaigns tab (see more general note changes below)
  • Create can be confirmed with the enter key
  • Tag add now shows a pre-populated list with known tags
• Logging:
  • Enabling configuration of the logger via a new logging section
  • Allows for multiple logging file streams at different levels

Changed

• Initiative
  • UI rework
    • Asset images appear in initiative list
    • Prevent large initiative list growing excessively tall
    • Allow resizing of initiative list view
    • Replace popup modal with less intrusive verification check
    • New UI to add effects to entries
    • Add group badges for shapes with badges enabled
    • [DM] Add button to clear initiative list
    • [DM] Add previous/next round buttons
  • Add effects with infinite timespan
  • Fix names in initiative list not being reactive
• Templates
  • Are now stored as proper shapes in the DB
  • Will migrate along with other shapes on DB upgrades (old templates could become broken)
  • Can be linked with other systems (e.g. custom-data, notes, ...)
• Notes
  • No longer hard-linked to 1 particular location
    • Can be linked to multiple locations or no location (global/local concept is removed)
  • List filters have been redesigned to be mure useful
    • Many preferences have been removed as a result
  • Pagination is now in the bottom left and clearly notes the amount of pages
  • Tags in the note edit panel now have a "search" and "remove" action instead of always removing on click
  • [tech] Searching/Filtering/Pagination is now done on the server
  • [tech] tags are now stored in their own tables instead of being a json array on notes
• Campaign creator can no longer change their own role or kick themselves
• [tech] refactor of intermediate shape handling on client side (see transformations.ts)
• [tech] upgraded pydantic from 1.x to 2.x
• Square grids now have distinct x and y size values
• Keyboard movement now also snaps to the closest grid cell when snapping is relevant
• Variants
  • Players may now add variants to shapes they have edit access to
  • Players may now swap between variants of shapes they have edit access to
  • [tech] Variants' access permissions are now based on the permissions of the parent shape only

Fixed

• Images in the Token Direction indicator were overflowing
• Prevent shortcut handling when targetting an html select element
• Ampersand in campaign name preventing game load
• Duplicating (copy/paste) or undoing a removal of shapes would lose some info (e.g. notes)
• Undoing a shape removal related to a character did not work
• Undoing a shape removal causing the related group to be removed (i.e. last shape of the group)
• Cutting a rotated polygon would be wrong on refresh
• Resizing a rotated polygon did not correctly recalculate center, causing sudden shifts on move
• Note creation not going straight to edit mode in some cases
• Account settings text overlapping on smaller viewport widths
• Moving special hide/reveal shapes from the fow layer could lead to a niche bug
• Rotation slider not showing current value in text input on component load
• Shapes snapping to square grid sometimes offset from grid
• Shapes attempting to snap to a grid square now collide with walls
• DDraft files no longer being uploadable to the asset manager
• Moving shapes with keyboard keys while ruler was enabled on select tool would move shapes twice as far
• Hovering on an initiative entry that is part of a group but not marked as a group entry would highlight all group members
• Error log about viewports on the server
• Toggling initiative off vision lock interactions
• Initiative cog wheel not opening initiative tab in the client settings
• Initiative entries would remain blurred if the focused entry was removed by another player.
• Group system not properly cleaning up on location changes
• Group badges were not sorted numerically in a shape's group settings when set to the numbers character set.
• Tracker input resets to last value if left empty

For more details on what's new checkout https://www.planarally.io/blog/release-2025.3/

planarally-bin provides a prebuilt client, with a python server that you'll need to run yourself.
planarally-windows provides a compiled executable that can simply be run by double clicking the exe in the planarally-windows-2022.3 folder. (~~note an issue with the windows build occurred, which I'll rectify with a separate v2025.2.1 release later~~ this has been resolved)

Check the documentation over at https://www.planarally.io for more info

The changelog for this release:

Added

• Admin panel that can be accessed from the dashboard
  • Currently limited to the main admin_user as configured in the server's config
  • Shows roughly same content as the original separate admin client
  • Also shows total number of users/campaigns and a quick user create button
  • Last login day for users
• Toggle to search through shared assets
  • This is heavier for the server and niche so not enabled by default

Changed

• Smoothed out the scroll zoom behaviour when zoomed in furthest
• [server] Config values that are not known will now error and stop the server from starting
• [tech] Add debounce to asset search

Removed

• [server] Legacy server configs
• [server] Admin server - this is replaced with a new in-client admin dashboard

Fixed

• Ensure stat export is chunked to prevent rejection from stat server
• Rapid (dis)connect sequences flooding the stats
• Don't re-open shape properties after a re-select
• Last grid-line in X or Y axis sometimes not rendering
• Deleting first initiative entry would enter invalid state
• Going to previous initiative would decrement effect timers
• Going to previous initiative could enter negative rounds
• Render bug in vision mode "behind" showing the entire shape under certain circumstances
• Asset search server query had a missing () causing assets from other users to show up
• Floor renaming the wrong entry

This is a small release that fixes three bugs reported on the latest release:

• Initiative effect rename losing focus after pressing 1 character
• Locked shapes not being selectable directly
• DM only auras where no longer rendered due to a bug in the new access logic

This contains some small fixes/additions to the new mail setup.

Added

• SSL email configuration
  • Choose between START TLS / TLS / SSL / LMTP for smtp connection

Fixed

• Mail not working in envs where username env is missing (e.g. docker)
  • This is a problem in the mail lib used, but circumvented in the Dockerfile
• Mail error showing a 500 error in the client
• Email setup reset when the config changes to make sure new email values are used

For more details on what's new checkout https://www.planarally.io/blog/release-2025.2/

planarally-bin provides a prebuilt client, with a python server that you'll need to run yourself.
planarally-windows provides a compiled executable that can simply be run by double clicking the exe in the planarally-windows-2022.3 folder. (~~note an issue with the windows build occurred, which I'll rectify with a separate v2025.2.1 release later~~ this has been resolved)

Check the documentation over at https://www.planarally.io for more info

The changelog for this release:

Server owners: The server config has changed location and format. Ensure you check the release notes for the necessary info.
The old config files are not yet removed from git to prevent losing modifications you made to these files.
They will be removed in a future release though.
The server is now also managed using uv, if you manually manage the server using python/pip directly instead of using docker, you need to install this as well. See the server's readme for details.

Added

• New quick toggle to disable LoS rendering for the DM only
• Forgot password flow if Mail is configured on the server
  • This only works if the user account actually has an email-address
• Success notification when changing email in the settings
• Mod improvements
  • Can now register shape context menu entries
  • Upload/Remove mods for a specific campaign
• Asset create folder/upload file/remove buttons to the in-game asset browser
• [server] Email configuration setup
• [server] Anonymous stat collection
  • Sends usage stats about number of campaigns and users to stats.planarally.io
  • Identifiers are anonymized, no personal info is included
  • Can be disabled

Changed

• Access levels are no longer additive
  • e.g. edit access used to automatically include movement & vision access, this is no longer the case
• Selection draw box now appears on top of the fog
• Selection rotate UI now appears on top fo the fog
• Moved zoom bar and selection info behind main modals when overlapping
  • the selection info can pop-over when hovered with the mouse
• [server] Server config setup has changed
  • The server config is now by default stored in the data directory and in toml format
  • It's no longer tracked in git, as the default values are now coded in python itself
  • An env variable can be used to change the location
  • Changes to the config are now checked and loaded by the server during runtime
• [tech] Server shutdown sequence has been modified
• [tech] Mod improvements
  • DataBlock API changes
    • Made most functions sync
    • Save method renamed to sync
    • API added to handle reactivity inside the datablock
    • Now listens to saved events from other clients to update local data
    • No longer runs the (de)serializer per key, but instead just on the entirety, alloweing root arrays
    • Added utility useDataBlock hook to reduce a lot of boilerplate in mod components
    • Serialize and Deserialize generic order are swapped
  • Now expects a root level events object with event functions instead of them being exported
  • Remove registerTrackerSettings event

Removed

• The isToken property has been removed from all shapes
  • This is now fully derived based on vision access of the shape

Fixed

• Draw tool polygon was not updating vision until shape completion
• Reduced some render overhead when token shapes that the player did not own were moved
• Shape context menu not closing when selecting an option
• Select tool build UI not appearing when mode toggling
• Datablocks for room and user categories had a bug in the server preventing creating them
• Asset context-menu remove not working
• Asset context-menu background colour being wrong in-game sometimes
• Asset upload bar missing in the dashboard asset manager
• Asset picker out of game now uses the newer UI
• Dropping assets you have shared-view permission for on the map was not working
• Movement only door toggle not immediately rerendering screen
• Select tool UI would sometimes stick around when there is no shape selected anymore