kruptein/planarally

PlanarAlly

概述

PlanarAlly是一款面向桌面角色扮演游戏（如D&D）的Web工具，提供虚拟战斗地图及多种增强功能。它支持自托管和离线使用，帮助游戏团体提升沉浸感和游戏管理效率。该工具免费开源，适合希望掌控数据和使用环境的用户。

核心功能

• 自托管：可在任意环境部署，无需依赖外部服务
• 离线支持：完全离线环境下可用，适用于无网络的游戏场景
• 图层管理：通过图层组织场景，简化复杂场景的管理
• 无限画布：提供无限制的工作空间，满足大型或复杂场景需求
• 动态照明：支持光影效果，增强游戏视觉沉浸感
• 玩家视野限制：根据角色标记（token）位置限制视野，如不同房间的角色无法共享视野
• ** initiative追踪器**：简易的 initiative 顺序追踪功能

使用场景

• D&D及其他桌面角色扮演游戏的战斗场景可视化与管理
• 需要自托管解决方案以确保数据隐私的游戏团体
• 无网络环境下的线下游戏（如"黑暗地牢"等无网络场景）
• 构建复杂场景，需要图层分离和无限画布支持的游戏需求

下载与安装

下载说明

通常团体中仅需一人下载安装PlanarAlly。可选择：

• 自托管：从https://github.com/Kruptein/PlanarAlly/releases%E4%B8%8B%E8%BD%BD%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC
• 公共托管：使用官方公共托管版本，无需本地安装

安装与配置

详细的安装和使用指南请参考官方文档。文档仍在持续完善中，部分内容可能存在更新延迟。

文档与支持

• 用户文档：访问官方文档站点获取详细使用说明
• 社区支持：通过***服务器获取帮助和交流
• 文档贡献：文档源码托管于https://github.com/Kruptein/planarally-docs%EF%BC%8C%E6%AC%A2%E8%BF%8E%E8%B4%A1%E7%8C%AE

贡献方式

• 反馈与Bug报告：通过GitHub Issues提交（提交前请先检查是否已有相关issue）
• 代码贡献：参考项目CONTRIBUTING文档设置开发环境后提交PR
• 资金支持：通过Patreon进行***支持项目开发

示例截图

!https://github.com/Kruptein/PlanarAlly/blob/dev/extra/player_light_example.png?raw=true
背景地图由Gogots提供，来源

注意：项目仍在积极开发中，可能存在功能变更或bug，请关注最新发布版本。