有爱设计

应用数
117
安装量
1.3万

应用圈

最后在线：: 2026-10-07
客服时间：: 工作日 9时~21时

其他应用

热门应用

庙会套圈一圈一喜V1.2

收藏分享投诉

¥199.00

统　　计:共 0 次下载
更新日期:2026-09-12
适配编码:UTF8SC
兼容版本:X3.3 X3.4 X3.5 X5.0 X5.1
PHP版本:7.0 ~ 7.4 8.0 ~ 8.5
标签分类:其他功能
移动属性:该版本安装后自带手机版（触屏版）
开发方式:作者申明该应用大量使用 AI 辅助开发，请谨慎考虑

购买应用 免责声明

# 庙会套圈 · 一圈一喜（hl_taoquan）插件介绍

&gt; 一款面向 Discuz! 论坛的传统庙会主题互动页面插件。登录会员可以在论坛页面完成五圈套圈，保存已完成成绩与套中奖品；管理员可以在后台设置游戏开关、开局积分、每日局数、榜单人数和 9 个奖品的奖励积分。

## 一、插件简介

`hl_taoquan` 将 Three.js 场景、Rapier 物理圆环和套圈操作接入 Discuz! 页面。游戏使用固定视角的三维场景，保留目标柱、圆环飞行、碰撞判断、命中提示和粒子表现，用户不需要切换或旋转场景视角。

插件通过 `plugin.php?id=hl_taoquan` 进入，使用 Discuz! 会员账号保存回合、投掷、成绩和奖品数据。游客可以按后台设置查看页面，但开始套圈和保存成绩需要登录。

当后台设置了开局积分时，页面会在开局前提示本局所需积分，用户确认后才提交开局请求。积分类型、扣除金额和当前配置由服务器再次核对。

## 二、玩法说明

- 每局包含 5 圈，完成 5 次投掷后结束本局。
- 场景奖品固定为 9 个，按前排 4 个、后排 5 个的方式放置。
- 投掷前可以调整方向和力度，松开圆环后由物理场景完成飞行与碰撞表现。
- 服务器根据方向、力度、奖品布局和连中状态重新计算命中、成绩、Perfect 与连中数据，不读取浏览器提交的分数结果。
- 命中奖品后，奖品会加入会员的奖品图鉴；完成一局后，按照本局套中的奖品奖励值合计并发放到指定扩展积分。
- 未完成的回合、过期回合和手动关闭的回合不会计入会员成绩、会员榜单或奖品图鉴统计。

### 默认奖品分值

奖品分值和奖励积分在后台分别按插件规则处理：游戏成绩会结合 Perfect 与连中规则计算，积分奖励按照后台配置的奖品奖励值合计。

## 三、操作方式

- **鼠标**：按住场景中的圆环，向下拖动蓄力，左右移动调整方向，松开后投掷。
- **触屏**：使用单指拖动圆环完成蓄力和方向调整，松手投掷。
- **键盘**：聚焦圆环后，使用左右方向键调整方向，上下方向键调整力度，空格或回车投掷。
- **辅助操作**：可以重置瞄准方向和力度，也可以切换页面音效。

## 四、功能说明

1. **固定视角游戏场景**：场景采用三维渲染与固定镜头，目标柱和奖品贴图分层显示，圆环飞行由 Rapier 物理系统处理。
2. **命中与成绩记录**：服务端保存每次投掷的方向、力度、命中结果、奖品、成绩、Perfect 和连中信息。
3. **奖品图鉴**：会员完成有效回合并套中奖品后，可以在页面查看已收集的奖品。
4. **会员成绩榜**：榜单只使用完成 5 圈的成绩，每位会员取一条成绩展示。
5. **积分开局**：开局积分设置为 0 时为免费模式；设置为大于 0 时，用户确认后扣除指定扩展积分。
6. **奖励积分发放**：一局完成后，系统按照本局命中的奖品和后台奖励值计算奖励，并通过 Discuz! 积分接口发放。
7. **后台数据管理**：后台提供套圈总览、成绩记录和开局积分记录。开局积分记录只保存实际扣除积分的付费开局，免费开局不会生成开局积分流水。
8. **PC 与 Touch 页面**：插件提供 PC 和 Touch 模板，页面包含返回论坛入口及底部版权信息区域。

## 五、后台配置

- **功能开关**：控制套圈页面是否开放。
- **允许游客访问页面**：开启后，游客可以查看页面；开始套圈、提交投掷和保存成绩仍需要登录。
- **页面标题**：设置页面标题区域和浏览器标题使用的名称。
- **页面副标题**：设置页面标题下方显示的说明文字。
- **每局消耗积分**：开局时扣除指定扩展积分；填写 `0` 表示免费模式。付费模式需要用户确认后才会提交开局。
- **开局积分类型**：选择 Discuz! 使用的扩展积分类型。
- **每日挑战局数上限**：按会员账号限制每天开局次数；填写 `0` 表示不限制。
- **排行榜人数**：设置页面加载的会员榜单数量，插件实际限制为 10 至 100 人。
- **9 个奖品奖励积分**：每行填写一条 `id=积分` 配置。
  奖励值填写为 `0` 时，该奖品不发放奖励积分；未填写或无法识别的 ID 使用插件默认值。奖品奖励积分在一局完成后按本局命中的奖品合计发放。

## 六、数据与账务说明

- 开局积分扣除、订单与回合创建使用同一事务；其中一项失败时，本次开局不会完成。
- 奖励积分发放会先记录待处理状态，积分余额发生预期变化后再标记为已发放；处理失败时保留可重试状态。
- 成绩和奖励积分以服务器计算结果及后台配置为准，页面端只提交方向、力度和回合请求信息。