文档
游戏社区签到
# 游戏社区签到 在编辑器中选中项目,进入「作者管理 → 签到系统」创建或编辑签到规则。原生游戏也可从插件设置的「礼包与邮件 → 签到系统」进入,外部网页游戏也可从文件管理页进入。用日常、周年等不同系统分别统计进度,同一玩家可以在同一 UTC 日各签一次。多个系统共享每天首次签到的 10 游戏经验。 玩家从游
# 游戏社区签到
在编辑器中选中项目,进入「作者管理 → 签到系统」创建或编辑签到规则。原生游戏也可从插件设置的「礼包与邮件 → 签到系统」进入,外部网页游戏也可从文件管理页进入。用日常、周年等不同系统分别统计进度,同一玩家可以在同一 UTC 日各签一次。多个系统共享每天首次签到的 10 游戏经验。
玩家从游戏详情页或社区中心打开「活动 → 签到」,选择要参加的签到活动。详情直接展示当天奖励、周期日历和已配置的里程碑。点「签到」确认,到游戏邮件领取已发送的礼包。
# 配置和发奖
例如,要让玩家平时领取补给、第 7 天领取宝箱:
- 新建签到系统,在「基本设置」填写活动名称。准备好让玩家参加时,将发布状态设为「启用」。
- 在「每日奖励」保留七天周期,添加默认补给礼包。点选「第 7 天」,选择「自定义当天奖励」,将默认补给替换为宝箱。想让宝箱和补给一起发放,可以保留补给再添加宝箱。
- 需要额外周奖励时,在「里程碑 → 每周累计」添加目标,将天数设为 3 并选择礼包。
- 在「玩家预览」调整示例日期和签到次数,核对当天礼包与达标奖励,再点「保存并启用」。先存草稿可以选「暂停」并点「保存为暂停」。
七日模板可以改为 45 天或任意 1~2147483647 的整数。选择累计或连续计数、循环或单轮。默认礼包适用于没有覆盖的日期,显式空覆盖表示当天只计进度。单轮完成后仍可签到。连续模式漏签后从第一天重新计数。保存立即生效,已发奖励与累计进度保留。
每次签到最多触发五组奖励:周期日、终身累计、连续、自然周累计、自然月累计。周一及每月一日 00:00 UTC 刷新对应次数。每段连续可再次达标,终身首次受历史最长连续限制。已越过的门槛不补发,短月的 31 天奖励不可达。每个非空组发一封邮件,最多 10 个附件。玩家进入游戏后在「礼包 → 邮件」领取;禁用礼包会阻止旧附件领取。外部游戏仅支持计数、里程碑进度与游戏经验。
系统表保存当前规则,记录表保存每日签到事实和累积检查点。邮件及经验使用平台现有账本,回滚存档不改变签到记录。
# FangZhi
先用 tools.checkin.list() 展示系统列表,将玩家选择的字符串 ID 作为 systemId。只读脚本从 tools.checkin.getCachedStatus(systemId) 读取,首次可能返回 null。以下最后一行放在玩家点击的事件中。
const state = await tools.checkin.getStatus(systemId)
const window = await tools.checkin.getRewards(systemId, { start_day: state.cycle.next_day || 1, limit: 7 })
const history = await tools.checkin.getHistory({ system_id: systemId, week_start: state.weekly.period_key.slice(5) })
const receipt = await tools.checkin.checkIn(systemId)
# External HTML SDK
用普通 script 引入 SDK。读取本周或本月的次数、边界和奖励进度,使用 getHistory({system_id:id,month:"2026-11"}) 查看历史。缓存 60 秒后或跨日过期,仅订阅不会产生轮询。超时后让玩家重试同一个系统。
<script src="/client/sdk/lp-external-game-sdk.js"></script>
<select id="system"></select>
<button id="sign" type="button">Check in</button>
<output id="progress"></output>
<script>
(async () => {
const client = window.LPExternalGameSDK.createClient()
await client.init()
const select = document.querySelector('#system')
const sign = document.querySelector('#sign')
const output = document.querySelector('#progress')
const page = await client.checkin.list({ page: 1, page_size: 20 })
select.add(new Option('—', ''))
for (const s of page.items) select.add(new Option(s.system.name, s.system_id))
let stop = () => {}
sign.disabled = true
select.onchange = async () => {
stop()
const id = select.value
sign.disabled = true
if (!id) return
stop = client.checkin.onChange(id, state => {
if (state) output.textContent = state.weekly.count + ' / ' + state.monthly.count
})
const state = await client.checkin.getStatus(id)
if (select.value === id) sign.disabled = !state.availability.can_checkin
}
sign.onclick = async () => {
const id = select.value
sign.disabled = true
try {
const { record } = await client.checkin.checkIn(id)
if (select.value === id) output.textContent = record.checkin_date + ' · XP +' + record.reward_game_xp
} catch (error) {
if (select.value === id) { output.textContent = error.message; sign.disabled = false }
}
}
window.addEventListener('pagehide', () => { stop(); client.dispose() }, { once: true })
})()
</script>