stv-AdHelper 0.0.2

Auto send Ad to your game's chat room.

🎮 自动公屏广告助手

一款专为游戏玩家设计的自动化工具，帮助您在游戏公屏中定时发送广告信息（如公会招人、物品交易等）

🌟 功能特点

• 精准坐标控制：通过可视化界面设置游戏内文本框和发送按钮的精确坐标
• 内容自定义：自由编辑要发送的广告内容（支持中英文及特殊符号）
• 智能定时：自定义发送间隔（0.1秒至1小时）和发送次数（支持无限循环）
• 操作反馈：提供操作提示音和实时日志记录
• 深色主题：现代化深色界面设计，减少长时间使用眼睛疲劳
• 配置保存：自动保存所有设置，下次启动无需重新配置
• 安全可靠：纯Python开发，不修改游戏内存，仅模拟鼠标键盘操作

📦 项目结构

.
├── pyproject.toml
├── readme.md
├── requirements.txt
└── src
    └── stv_AdHelper
        ├── core
        │   ├── window.py
        │   └── worker.py
        ├── main-ui.py
        ├── main.py
        └── utils
            └── utils.py

⚙️ 使用说明

1. 设置坐标

1. 点击"获取坐标"按钮
2. 5秒倒计时内将鼠标移动到游戏内：
   • A点：聊天输入框位置
   • B点：发送按钮位置
3. 程序自动捕获并保存坐标

2. 编辑内容

在"内容设置"区域输入要在公屏发送的广告文本

3. 配置参数

• 操作间隔：设置发送广告的时间间隔（秒）
• 重复次数：0=无限循环，n=执行n次后停止
• 提示音：开启/关闭操作提示音

4. 开始执行

点击"开始执行"按钮，程序将按设定自动发送广告

🛠 运行环境

• 操作系统：Windows 10/11, macOS, Linux

• Python版本：3.10+

• 依赖库：

  PyQt5
  pyautogui
  pyperclip
  

🚀 安装与运行

1. 克隆仓库：

   git clone https://github.com/yourusername/stv_AdHelper.git
   cd stv_AdHelper
   

2. 安装程序：

   pip install .
   

3. 运行程序：

   sadui 是本工具的gui模式，如果您更喜欢cli模式，也可以运行 sad. sad 即为 send Ad.

   sadui
   

⚠️ 注意事项

1. 使用前请确保游戏窗口位置固定
2. 操作过程中请勿移动鼠标或切换窗口
3. 遵守游戏规则，避免发送过于频繁导致封号
4. 建议设置合理间隔（通常15-30秒为宜）
5. 本工具仅用于合法用途，禁止用于任何违规操作

📜 开源协议

本项目采用 GPL v3 License 开源协议