Ludoya 可以连接你已经在用的工具和平台。把你的收藏和对局与其他网站同步，关联 Telegram 或 Discord 接收群组通知，导出你的数据，并在 Ludoya 之外分享你的桌游生活。
BoardGameGeek（BGG）
把你的收藏和对局历史与全球最大的桌游数据库 BoardGameGeek 同步。
如何连接： 前往 设置 → BoardGameGeek 集成，输入你的 BGG 用户名。导入只需要用户名：只有当你还想让 Ludoya 把收藏或对局发送到 BGG 时，才会要求输入 BGG 密码。
同步的内容：
- 导入收藏 — 把你的 BGG 收藏 导入 Ludoya
- 导入对局 — 把你的 BGG 对局历史 导入 Ludoya 的 统计
- 导出收藏 — 把你的 Ludoya 收藏发送到 BGG
- 导出对局 — 把你的 Ludoya 对局发送到 BGG
同步起始日期筛选： 导入对局时选择一个起始日期。只会导入该日期及之后记录的对局。方便从上次停下的地方继续。
同步状态： 实时查看进度。你会看到：
- 等待中 — 等待开始
- 等待 BGG — 请求已发送，等待回应
- 导入中 — 正在从 BGG 下载
- 导出中 — 正在上传到 BGG
- 已完成 — 已结束，附带数量（例如“已导入 45 款游戏、120 局对局”）
- 错误 — 出了问题；请检查用户名和密码
如果提示 BGG 暂时阻止自动登录： 这不是你的问题，你的登录信息也没有错。BoardGameGeek 会不时限制自动登录，在此期间 Ludoya 无法代你登录。稍等一会儿再运行一次 立即同步 —— 不会丢失任何内容，而导入（不需要密码）通常不受影响。
自动或手动同步： BGG 同步由服务器定期管理，但你也可以随时点 立即同步 马上刷新。
Board Game Arena (BGA)
将你在 Board Game Arena 的对局历史导入 Ludoya（不支持收藏导入）。
如何连接： 前往 设置 → Board Game Arena 集成。输入你的 BGA 用户名和密码。
同步内容：
- 导入对局 — 将你的 BGA 对局历史导入 Ludoya
开始导入时间： 选择一个开始日期。仅导入该日期之后的对局。
自动或手动同步： 与 BGG 一样，BGA 按照服务器管理的计划进行同步。使用 立即同步 即可立即导入。
Telegram 机器人
@ludoyabot 把你的俱乐部带进成员们本来就待着的聊天里。把一个 Telegram 群绑定到你的组织，它就会发布你们的活动、回答关于活动的问题、在谁都拿不定主意时从你们的书架里挑游戏，还能让人不用打开应用就占个位子。
个人关联：若要让 Ludoya 直接给你发消息，请从 Telegram 而不是从 Ludoya 开始——与机器人对话，点击开始，它会给你一个链接，一键连接这两个账户。
连接你的群组
关联需要群组或俱乐部拥有 Club 计划或更高等级——无论它是否有自己的登录账号。它的任何管理员都可以为它购买该计划。
- 打开你组织的控制台，进入 集成，然后进入 Telegram
- 生成一个链接代码
- 在 Telegram 中，将 @ludoyabot 添加到你的聊天
- 在聊天中输入
/link <code> - 机器人确认连接
若需稍后断开，请在同一聊天中输入 /unlink。公告会立即停止，且不会删除 Ludoya 上的任何内容——你可以随时再次链接。
向机器人提问
提及 @ludoyabot 并用普通问题发言，它会在聊天中用你的语言作答：
- "有什么活动？" — 你即将到来的活动
- "给我看看周五的活动" — 日期、地点以及谁会来
- "谁会来？" — 参加者名单
- "我们要玩什么？" — 人们发布的预定的游戏局
- "给我看看 Scythe" — 该桌游的详情
- "六个人玩的、轻松又好笑的" — 从你们俱乐部自己的收藏里挑出的一小份清单
- "像 Dune Imperium 那样的" — 你们俱乐部有、而喜欢那款的人也有的游戏
清单会附上在桌边真正起决定作用的信息：人数、时长、适合的最小年龄、用颜色标出的复杂度（绿色轻、红色重），以及当你们俱乐部记下过时，那条告诉所有人这本实体放在哪里的书架编号。
无需记忆任何命令。它只会回答与该聊天所关联的群组有关的内容。
无需离开 Telegram 就能占个座位
当机器人发布一条预定的游戏局时，会带有一个加入按钮。点一下就能入座——该消息会在聊天中自动更新，大家都能看到名单逐渐填满。还提供在 Ludoya 查看按钮，想看完整页面时就点它。
尚未关联其 Telegram 账户的用户会在聊天中直接得到如何操作的说明。
会发布哪些内容
在Telegram 设置中的两个选项决定哪些内容会发送到聊天：
- 哪些活动 — 仅公开活动、公开和仅限成员的活动，或全部
- 范围 — 仅主要活动（默认），或包括子活动和预定的游戏局在内的所有活动
活动在创建时和更改时都会发布公告，这样无需任何人转发，聊天就能保持最新。通过编辑而移入你的组织的活动会作为新活动发布，你的成员会像收到在那里创建的活动一样收到通知；它离开的组织的聊天会将其消息标记为已移走。重复活动一次只发布一个日期：下一个在上一个结束后发出，或者在你发布以草稿形式创建的日期时立即发出。
除了聊天之外，已关联账户但没有可接收通知的应用的成员，会通过机器人的私信得知自己的活动消息（所关注组织的新活动、变更、提醒）。安装应用后，这些消息会改为发送到手机。
Discord 机器人
Ludoya 机器人在 Discord 上做的，就是 @ludoyabot 在 Telegram 上做的事。把你服务器的一个频道绑定到你的组织，它就会在那里发布你们的活动并让每条公告保持最新，在服务器的任何频道回答关于活动的问题，还能让成员通过公告上的 加入 按钮占个位子。
连接你的服务器
和 Telegram 一样，关联需要群组或俱乐部拥有 Club 计划或更高等级。
- 打开你组织的控制台，进入 集成，然后进入 Discord
- 点击 添加到 Discord 并选择你的服务器
- 在应接收活动的频道里，用设置中的代码运行
/link <code> - 机器人确认连接
控制台的 集成 部分可以向每个已关联的聊天和频道发送一条测试消息，检查机器人是否仍能送达。只有能管理服务器的成员才能关联或解除关联频道。在该频道中运行 /unlink 即可停止公告——Ludoya 上不会删除任何内容。与 Telegram 相同的 哪些活动 和 范围 设置决定发布什么。
绑定你的账号
在服务器里或与机器人的私信中运行 /start。只有你能看到回复：一个 绑定账号 按钮，一键连接你的 Discord 和 Ludoya 账号。从此你只要点一下 加入 就能占位，你的名字也会出现在公告的参加者名单上。
问问机器人
用平常的问题提及机器人——和它在 Telegram 上回答的一样，从接下来有什么、谁会来，到从你们书架里挑出的一小份清单——或者回复它的某条回答来继续对话。它的快捷指令（/event_list、/planned_play_list…）会在你输入 / 时出现。
WordPress 插件
俱乐部已经有网站了？把 Ludoya 装上去。Ludoya for WordPress 插件把你的活动、游戏藏品、对局统计和位置放到自己的页面上，套着自己主题的样子，还让团队在 WordPress 后台就能办活动。
在页面上，放六个区块之一，或者它对应的短代码：
- 活动：近期活动列表
- 活动：单场活动，连着排期和报名表单。一个页面能装下整场活动连同它的子活动，所以整个展会都能放在自己站上
- 报名表单：只有表单，给你自己写满文字的页面用
- 藏品、统计、位置：你有什么游戏、玩了多少、在哪玩
活动页面带着搜索引擎用来做丰富结果的结构化数据。
在 wp-admin 里，工作人员不打开 Ludoya 也能创建、编辑、发布、取消、删除活动，并给人报名。
该插件免费且开源，使用开放 API，因此需要 Club 计划或更高等级。从它在 GitHub 上的最新版本下载，在 插件 → 安装插件 → 上传插件 下安装，然后粘贴控制台 集成 → 密钥与应用 中的 API 密钥。
使用 Google 登录
使用你的 Google 账号而非电子邮件和密码登录 Ludoya。
操作方式： 在登录页面，点击 使用 Google 登录。如果你还没有 Ludoya 账号，将会自动创建一个。若你已经有账号，你的 Google 账号将与其关联。
注意： 你必须拥有一个有效的 Google 账号。支持 Google 账号的两步验证。
使用 Ludoya 登录
它也可以反过来用：你的 Ludoya 账户可以登录到其他网站。俱乐部、商店和社区可以在自己的网站或论坛上放置一个使用 Ludoya 登录按钮，你可以用已有的账户直接进入。
当你批准时，你也会在 Ludoya 上与该组织建立关联——根据其加入政策，直接加入或申请加入。因此，登录某个俱乐部的论坛，可能会同时让你在这里成为该俱乐部的成员。
查看你的连接：前往设置 → 已连接的应用，查看所有你曾使用 Ludoya 登录过的网站、你连接它的时间以及其上次使用时间。点按断开连接即可立即收回该网站的访问权限——你仍会保留该群组成员身份，如需可另行退出。
你在运营社区？ 在你自己的网站上添加“使用 Ludoya 登录”属于 Club 计划及以上等级中开放 API 功能的一部分。
日历导出
将你的 Ludoya 活动导出到 Apple Calendar、Outlook、Google Calendar、Thunderbird，或任何支持 iCalendar 格式的应用。
可用格式：
- iCalendar (.ics) — 下载一个文件以导入到 Apple Calendar、Outlook 或 Thunderbird
- Google Calendar 直接链接 — 直接从 Google Calendar 订阅
包含内容： 活动标题、日期、时间、地点，以及返回到 Ludoya 上该活动的链接，便于你随时查看参与者名单、讨论和详情。
如何导出： 前往该活动页面并点击 添加到日历。请注意，这会将该活动的快照添加到你的日历中，而不是实时订阅 — 如果组织者更改了活动时间，请重新添加以获取新的时间。
可嵌入式小部件
使用 HTML iframe 代码片段将 Ludoya 的内容嵌入到你自己的网站或社区论坛中。小部件的样式可无缝适配，并包含一个 "由 Ludoya 驱动" 徽标。
可用的嵌入：
- 收藏 — 账号拥有的桌游，遵循你已应用的任意筛选或列表
- 对局 — 来自某个账号或群组的最近对局
- 活动 — 即将到来的活动
简便方法： 打开你想分享的收藏，并在其菜单中选择 创建网页嵌入。Ludoya 会提供一个现成的 HTML 代码片段，并保留你当前的筛选条件——因此你可以只嵌入愿望单、仅一个自定义列表，或某个群组的共享书架。
对局和活动： 这些暂时还没有片段生成器，所以请自行将 iframe 指向相应地址——在应用域名下使用你的账号或群组的用户名，指向 /embed/YOUR-USERNAME/plays 或 /embed/YOUR-USERNAME/events。
嵌入模式： 在嵌入视图中，Ludoya 顶部导航和页脚将被隐藏，只显示你想要展示的内容。
将任何页面变成图片
多数值得展示的页面都可以导出为图片——用于 Discord、社交媒体，或打印后在俱乐部张贴。对所有人、在所有方案中均免费。
可以转换为图片的内容：
- 收藏 — 由你的封面组成的网格，并遵循你当前查看的筛选或列表
- 对局历史 — 你在一段时间内的对局，包括月度和年度汇总
- Replays — 你的桌游年度回顾，以及小组和活动的 Replays
- 单场对局 — 桌游、玩家和最终得分
- 活动 — 标题、日期、地点以及谁将参加
找到分享，然后选择图片——如果你只想要文件，则选择下载。
让它更符合你的风格
在分享面板点按自定义，当你更改设置时，实时预览会随之更新：
- 标题 — 你的自定义文本。留空以使用该时段，或在更长的标题中插入
%PERIOD%，把它精确放在你想要的位置 - 背景 — 默认、你选择的纯色，或你自己的图片 URL
- 每个桌游显示什么 — 可切换显示对局次数、对局时长和桌游名称
- 排序依据 — 选项取决于你要分享的内容；收藏可按名称、添加日期、评分、BGG 评分或年份排序，而对局历史可按对局时长、对局次数或名称排序
- 项目上限 — 限制出现的桌游数量，最多 1000；当你的对局很多时，这样能得到更干净的图片
- 格式 — 正方形（1:1）用于信息流，故事（9:16）用于故事，纵向（4:5），或选择自定义并使用你自己的宽度和高度（各至少 512px）
- 质量 — 普通、大或超大，取决于发布去向
应用会锁定你的更改；重置会将一切恢复为默认值。
你的链接到处都好看
将 Ludoya 链接粘贴到 WhatsApp、Discord、Telegram、Bluesky 或任何其他地方，它会以富链接预览的形式呈现，而不是裸露的 URL——标题、描述和图片直接取自页面本身。
这适用于那些值得分享的页面：个人资料、收藏集、对局历史、Replays、评价、活动 和 桌游。带有强视觉效果的页面会显示大尺寸卡片，而不是缩略图，因此分享的 Replay 或收藏集会显示为更醒目的卡片。
你无需做任何操作来启用它。从浏览器复制地址，或在看到的任意位置使用分享，预览会在对方那端自动生成。
直接分享到 Ludoya
在 Ludoya 内部，方式不同，而且更好。当你将对局、评价、活动、商品刊登、战役、商店优惠或游戏套件分享至你的动态时，该项目会以卡片的形式附加到你的帖子中——而不是作为会自动展开预览的链接。卡片保持实时更新：活动卡片会持续显示其当前日期和参与人数，商品刊登卡片会持续显示其状态。
在你正在查看的内容上使用分享操作并选择你的动态。在其上方添加你自己的文字，大家可以对帖子点赞和评论，同时仍可点进查看原始内容。