# ZeroAd Engine v2026.02.18.3 - Release Notes
## 🎉 What's New
### Major Features
- ✅ **CrazygamesAds API Support** - Full support for the new CrazyGames ad system (`window.CrazygamesAds`)
- ✅ **Instant Reward System** - Rewards granted in 200-400ms (realistic timing)
- ✅ **8 SDK Support** - CrazygamesAds, CrazyGames SDK, Poki, AdInPlay, GameDistribution, CPMStar, Google Ads, GameVui
- ✅ **Property Trap Technology** - Catches SDKs before they're even defined
- ✅ **Aggressive Polling** - 20 attempts over 10 seconds (500ms intervals)
- ✅ **Production Ready** - Debug mode disabled by default
---
## 🔧 Technical Improvements
### CrazygamesAds API (NEW)
```javascript
✓ CrazygamesAds.requestAds() - Primary ad request
✓ CrazygamesAds.render() - Alternative rendering
✓ CrazygamesAds.requestOnly() - Pre-load suppression
✓ CrazygamesAds.hasAdblock() - Detection bypass
✓ CrazygamesAds.initAds() - Initialization wrapper
```
### Enhanced Callbacks
- All SDK callbacks fire with proper timing
- `adStarted` → Immediate
- `adFinished` → 200-400ms delay (realistic)
- Fallback events dispatched for compatibility
### Improved Cleanup
- Video element neutralization (mute, pause, remove src)
- Iframe blocking (7 ad domains)
- Container removal (9 common selectors)
- Mutation observer for dynamic content
---
## 🎮 Supported Games & Platforms
### Confirmed Working
- ✅ CrazyGames (Harvest Kings, etc.)
- ✅ Poki games
- ✅ Taming.io
- ✅ GameVui.vn games
- ✅ .io games using standard SDKs
### SDK Coverage
| SDK | Status | Methods Hooked |
|-----|--------|----------------|
| CrazygamesAds | ✅ Full | requestAds, render, requestOnly, hasAdblock |
| CrazyGames SDK | ✅ Full | ad.requestAd |
| Poki | ✅ Full | commercialBreak, rewardedBreak |
| AdInPlay | ✅ Full | aipPlayer constructor, cmd queues |
| GameDistribution | ✅ Full | showAd |
| CPMStar | ✅ Full | RewardedVideoView, InterstitialView |
| Google Ads | ✅ Partial | googletag, adsbygoogle |
| GameVui | ✅ Full | GVAdBreak |
---
## 📊 Performance Metrics
- **Initialization**: <5ms
- **Memory Usage**: <500KB
- **Polling Duration**: 10 seconds max
- **Cleanup Interval**: 1.8 seconds
- **Reward Delay**: 200-400ms (realistic)
---
## 🔍 Debug Mode
Enable detailed logging by setting `DEBUG = true` on line 18:
```javascript
const DEBUG = true; // Set to true for console logging
```
### Expected Debug Output
```
[ZeroAd] ZeroAd Engine initializing...
[ZeroAd] CrazygamesAds property trap installed
[ZeroAd] 🎯 CrazygamesAds API detected!
[ZeroAd] ✓ CrazygamesAds.requestAds hooked
[ZeroAd] 🎉 CrazygamesAds API FULLY HOOKED
[ZeroAd] Polling started
[ZeroAd] MutationObserver started
[ZeroAd] ZeroAd Engine v2026.02.18.3 initialized
```
When ad is requested:
```
[ZeroAd] CrazygamesAds.requestAds("rewarded") intercepted
[ZeroAd] Fired callbacks.adStarted
[ZeroAd] Fired callbacks.adFinished - REWARD GRANTED
[ZeroAd] Dispatched event: rewardedComplete
```
---
## 🚀 Installation
### For Greasy Fork Users
1. Click **Install this script**
2. Confirm installation in Tampermonkey
3. Visit any supported game site
4. Rewards granted instantly (no ads play)
### For GitHub Users
1. Install [Tampermonkey](https://www.tampermonkey.net/)
2. Create new script
3. Paste contents of `ZeroAd-Engine-v2026.02.18.3-PRODUCTION.user.js`
4. Save and enable
### For Developers
```bash
# Clone repository
git clone https://github.com/YOUR_USERNAME/zeroad-engine.git
# Install in Tampermonkey
# File → Utilities → Import from file
```
---
## 🐛 Bug Fixes
### v2026.02.18.3
- ✅ Fixed CrazyGames detection (was missing `CrazygamesAds` API)
- ✅ Fixed race condition with SDK initialization
- ✅ Fixed callback timing (now realistic 200-400ms)
- ✅ Fixed taming.io iframe isolation issue
- ✅ Fixed AdInPlay temp callback cleanup
- ✅ Fixed CPMStar reward grant timing
### v2026.02.18.2
- ✅ Enhanced CrazyGames hook with property trap
- ✅ Increased polling frequency (2000ms → 500ms)
- ✅ Extended polling duration (10 → 20 attempts)
### v2026.02.18.1
- ✅ Added aggressive CrazyGames interception
- ✅ Improved logging system
### v2026.02.15.1
- ✅ Initial production release
- ✅ Multi-SDK support
- ✅ Bounded polling system
---
## ⚠️ Known Issues
### Won't Fix
- **Some games detect modified behavior** - Game-specific anti-cheat may flag instant rewards
- **Cross-origin iframes unreachable** - Browser security prevents access (by design)
### Investigating
- Rare cases where `adFinished` fires twice
- Some Unity WebGL games need additional hooks
### Report Issues
- Greasy Fork feedback page
- Include: Game URL, console logs (with DEBUG=true), browser version
---
## 🔒 Privacy & Security
### What We Do
- ✅ Hook ad SDKs locally in browser
- ✅ Grant rewards without playing ads
- ✅ Remove ad containers from DOM
- ✅ Block ad iframes
### What We DON'T Do
- ❌ Send data to external servers (NO network requests)
- ❌ Track user behavior (NO analytics)
- ❌ Collect personal information (NO data storage)
- ❌ Require elevated permissions (`@grant none`)
### Open Source Guarantee
- All code is visible and auditable
- No obfuscation or minification (in source)
- MIT License - Free to fork and modify
---
## 📝 Changelog
### v2026.02.18.3 (Current)
- Added CrazygamesAds API support
- Property trap for early SDK interception
- Enhanced callback system with realistic timing
- Improved debug logging
- Production-ready defaults (DEBUG=false)
### v2026.02.18.2
- CrazyGames property trap
- Aggressive polling (500ms intervals)
- Extended polling duration (20 attempts)
### v2026.02.18.1
- Enhanced CrazyGames hooks
- Detailed callback logging
### v2026.02.15.1
- Initial release
- Multi-SDK support
- Bounded polling
- Mutation observer
- Periodic cleanup
---
## 🤝 Contributing
### How to Help
1. **Test games** - Report what works/doesn't work
2. **Find new SDKs** - Share SDK signatures
3. **Improve code** - Submit pull requests
4. **Update docs** - Fix typos, add examples
### Development Setup
```javascript
// Enable debug mode
const DEBUG = true;
// Test on local file
// @match file:///*
// Monitor console for hook messages
// Look for: [ZeroAd] ... hooked
```
---
## ⚖️ Legal & Ethics
### Intended Use
- Educational purposes (learning web ad systems)
- Personal use on games you own/support
- Testing and development
### Please Support Developers
- Buy premium versions when available
- Donate to game creators
- Watch ads occasionally
- Disable script on games you love
### Disclaimer
This script modifies client-side behavior only. Use responsibly and in accordance with game terms of service. The authors are not responsible for any consequences of use.
---
## 📚 Technical Documentation
### Architecture
```
Document Load (document-start)
↓
Install Property Traps
↓
Hook Existing SDKs
↓
Start Polling (500ms × 20)
↓
Start MutationObserver (on DOMContentLoaded)
↓
Start Periodic Cleanup (1.8s intervals)
```
### Hook Priority
1. Property traps (before SDK exists)
2. Immediate hooks (document-start)
3. Polling hooks (0-10 seconds)
4. Mutation observer (dynamic content)
5. Periodic cleanup (ongoing)
### Callback Flow
```
Game calls: SDK.requestAd("rewarded", callbacks)
↓
Our hook intercepts
↓
Fire callbacks.adStarted() immediately
↓
Wait 200-400ms (realistic delay)
↓
Fire callbacks.adFinished()
↓
Dispatch window events (rewardedComplete, etc.)
↓
Game grants reward
```
---
## 🎯 Roadmap
### Planned Features
- [ ] Unity WebGL message hook
- [ ] More SDK support (Yandex, VK, etc.)
- [ ] Per-game configuration
- [ ] Whitelist system (support favorite games)
### Under Consideration
- [ ] Partial ad playback (watch 1 second, skip rest)
- [ ] Ad frequency limiting (every 5th ad plays)
- [ ] Developer donation reminder
---
## 📞 Support
### Get Help
- **Greasy Fork**: Feedback tab
- **GitHub Issues**: Bug reports
- **Email**: [email protected] (if applicable)
### Provide Logs
When reporting issues, include:
1. Game URL
2. Browser + version
3. Console logs (with DEBUG=true)
4. Steps to reproduce
---
## 🙏 Credits
### Contributors
- ZeroAd Team - Initial development
- Community testers - Bug reports and feedback
- SDK reverse engineers - Technical analysis
### Reverse-Engineered SDKs
- CrazygamesAds API
- AdInPlay SDK
- Poki SDK
- CrazyGames SDK
- GameDistribution API
- CPMStar integration
### Built With
- Vanilla JavaScript (ES6+)
- MutationObserver API
- Event System
- Promise API
---
## 📄 License
MIT License
Copyright (c) 2026 ZeroAd Team
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
---
**Version**: 2026.02.18.3
**Release Date**: February 18, 2026
**Status**: Production Ready ✅
