AuraEconomy README

项目的 README,来自 github.com/AhmadHassan-BTed/AuraEconomy。合并为一个 markdown 文件:README.md。

AuraEconomy: Advanced Streamer.bot Gamification System

An Open Source Project by Ahmad Hassan (B-Ted)

Status Platform Database

AuraEconomy is a high-performance, engagement-focused economy system for Twitch streamers. It combines a robust C# backend with a stunning Vanilla JS overlay to create a mini-RPG experience for your viewers.


Key Features


Project Structure

/
├── docs/
│   └── ImplementationGuide.md    # Simple step-by-step setup for non-technical users
├── src/
│   ├── bot/
│   │   └── EconomySystem.cs      # Core C# logic for Streamer.bot
│   ├── database/
│   │   └── schema.sql            # SQLite database structure & views
│   └── overlay/
│       ├── Overlay.html          # Vanilla JS Chat & Notification Overlay
│       └── icons/                # Rank icons (SVG)
└── README.md                     # Project overview

Quick Start

  1. Database: Run schema.sql in a SQLite tool to create your database file.
  2. Configuration: Open EconomySystem.cs and set your DB_PATH.
  3. Streamer.bot: Create actions and paste the corresponding code regions from EconomySystem.cs. Ensure "Watch Time" uses the 'Present Viewers' trigger.
  4. OBS: Add Overlay.html as a Browser Source (1920x1080).

For detailed instructions, see the Implementation Guide.


Tech Stack


Rank Thresholds

Rank Points Bet Cap Aura Color
Wood 0 25 #8B6914
Bronze 500 50 #CD7F32
Silver 1,500 100 #A8A9AD
... ... ... ...
Eternal Top 3 10,000 #FFE566

Developed with by Ahmad Hassan (B-Ted) for the streaming community.

AuraEconomy (AhmadHassan-BTed/AuraEconomy)

正在搜索数据库…

这是什么?AuraEconomy 是一个用于 Twitch 直播的游戏化系统,运行在 Streamer.bot 内,把观众的观看时长转化为积分、等级和投注,并通过 OBS 叠加层实时显示结果。
这是独立程序,还是需要接入其他软件?它不是独立程序,而是一个粘贴到 Streamer.bot 中的 C# 'Inline' 脚本,加上一个 Vanilla JS/HTML 叠加层文件,因此只能配合 Streamer.bot 和 OBS 使用。
我要怎么才能在直播间里运行它?用 SQLite 工具运行 schema.sql 创建数据库,在 EconomySystem.cs 中设置 DBPATH,把代码区块粘贴到 Streamer.bot 的动作中,然后将 Overlay.html 添加为分辨率 1920x1080 的 OBS 浏览器源。
这个功能需要 Streamer.bot 和 OBS 才能运行吗?需要。经济系统逻辑以 C# Inline 代码的形式运行在 Streamer.bot 中,叠加层则是 OBS 的浏览器源;观看时长统计还依赖 Streamer.bot 原生的 'Present Viewers' 触发器。
设置时有哪些需要注意的坑吗?只有连接到 Streamer.bot 的 'Present Viewers' 触发器,观看时长才能正确累计;叠加层是为固定 1920x1080 的浏览器源设计的,其他分辨率可能需要手动调整。
观众能达到哪些等级?共有 10 个等级,从 'Wood' 到尊贵的 'Eternal',每个等级都有各自的积分门槛、投注上限和 Aura 光晕颜色,范围从 Wood(0 积分,上限 25)到 Eternal(前 3 名,上限 10,000)。
每月重置时积分会怎样?赛季积分每月重置,但累计数据和观众历史最高等级会以永久的 'Legacy Aura' 彩色徽章保留下来。
投注功能是怎么运作的?AuraEconomy 采用基于托管的胜负投注系统,观众可下的最大注额取决于其当前等级。
为什么要使用 WAL 模式的 SQLite?WAL 模式让 Streamer.bot 和外部工具(例如 Minecraft 插件)可以同时读写同一个数据库文件,不会出现锁定问题。
大小
0.1 MB
星标
2.8K
更新
提交Jun 30
时长
6个月
提交 · 90 天