🚀 Welcome to Timmeh the Wizard
A powerful Discord bot for scheduling automated messages. Perfect for reminders, announcements, and automation!
✨ Key Features
📅 Recurring Messages
Schedule messages hourly, daily, weekly - fully customizable intervals
🎨 Rich Embeds
Beautiful embedded messages with colors and images
🗑️ Auto-Delete
Messages automatically delete after specified time
📢 @everyone Mentions
Notify all server members for important announcements
✏️ Edit Schedules
Modify existing schedules without recreating them
💾 Persistent
All schedules survive bot restarts
/schedule - Recurring Messages
See the original documentation for full /schedule command details...
📋 Discord Bot Changelog
- ✨ NEW: Advanced timing controls in /edit-schedule
- ✨ NEW: Adjust schedule timing with adjust-time parameter
- ✨ NEW: Set exact next run time
- ✨ NEW: Change target channel for existing schedules
- 🔧 Improved: Better error handling and user feedback
- ✨ NEW: Schedules now survive bot restarts
- ✨ NEW: Auto-restore all schedules on startup
- 🔧 Fixed: Memory leaks in long-running schedules
- ✨ NEW: /edit-schedule command
- ✨ NEW: Modify message content, interval, and delete-after settings
- 🔧 Improved: Schedule management interface
- ✨ NEW: Messages can auto-delete after specified time
- ✨ NEW: Works with both embeds and regular messages
- 🔧 Fixed: Timing accuracy improvements
🗺️ Game Map Scanner
Automatically scan and map your game world with advanced OCR and screenshot stitching technology. Perfect for strategy games requiring territorial awareness!
✨ Key Features
🔍 Dual Scanning Modes
Detailed OCR: Reads all in-game data (buildings, players, resources) ✅ Working
Fast Screenshot: Quickly captures and stitches map images ⚠️ Currently Broken - Fix Coming Soon
🎨 Interactive Visualizer
Beautiful color-coded map visualization with toggleable layers and filters
🤖 Intelligent Scanning
Auto-detects multi-tile objects, skips already-scanned areas for efficiency
⚙️ Easy Configuration
Setup wizard walks you through screen position capture - no technical knowledge required
💾 Data Export
Export maps as JSON, PNG images, or view in the interactive visualizer
🎯 Precise Mapping
Handles coordinate systems, terrain types, player cities, wildlife, and resources
📊 What Can You Scan?
🏰 Player Cities
Friendly and enemy cities with power levels
🏗️ Buildings
HQ, Arsenal, Harvest Altar, Scholar's Tower, and more
🎖️ Alliance Structures
Banners, alliance resources, and buff locations
🌲 Resources
Idle mines, lumber yards, mills, and quarries
🐻 Wildlife
Bears, elephants, lions, wolves, and more
🗺️ Terrain
Plains, badlands, ruins, fertile land, forbidden areas
📥 Download Game Map Scanner
Latest Version: v1.0.0
Full-featured game map scanner with OCR and visualization
⚠️ Note: Fast Screenshot mode is currently broken. Use Detailed OCR Scanner mode. Fix coming in v1.1.0!
🪟 Windows (x64) - Standalone 🐍 Python Source CodeWindows executable includes all dependencies • No installation required • Just download and run!
📋 System Requirements
- Operating System: Windows 10/11 (64-bit)
- RAM: 4GB minimum, 8GB recommended
- Disk Space: 500MB free space
- Display: 1920x1080 or higher recommended
- Additional: Tesseract OCR (included in standalone version)
🐍 Running from Python Source
Requirements:
- Python 3.8 or higher
- Required packages:
pip install -r requirements.txt - Tesseract OCR: Download here
🚀 Quick Start Guide
Get scanning in 5 minutes! Follow these simple steps:
-
Launch Your Game
Open your game and navigate to the world map view. Make sure the game is in windowed mode or borderless windowed for best results. -
Run the Game Map Scanner
Standalone: LaunchGameMapScanner.exe
Python Source: Runpython ConfigWizard.py
On first run, the configuration wizard will appear automatically to guide you through setup. -
Capture Screen Positions
Follow the prompts to capture:- Coordinate input button location
- X and Y input field positions
- Confirm button location
- Popup info region
- Close popup button
-
Save Configuration
The wizard will save your settings toscanner_config.json. This file is reusable, so you only need to configure once! -
Start Scanning!
The main scanner GUI will open automatically. Enter your scan area coordinates and click "Start Scan".
- Use "Detailed OCR Scanner" mode only - Fast Screenshot mode is currently broken
- Don't move or minimize the game window during scanning
- Disable screen savers and sleep mode
- For OCR mode: Install Tesseract OCR first (see Configuration tab)
- Press ESC to stop scanning at any time
📖 Complete User Guide
🎯 Scanner Modes Explained
🔍 Detailed OCR Scanner ✅ WORKING
Best for: Complete data collection, building information, player details
Speed: Slower (reads each tile individually)
Data Quality: Highest - captures names, levels, power, alliances
Requirements: Tesseract OCR installed
⚡ Fast Screenshot Scanner ⚠️ CURRENTLY BROKEN
Status: Under development - do not use until fixed
Best for: Quick territory visualization, large area mapping (when working)
Speed: Very fast (captures zoomed-out screenshots)
Data Quality: Visual only - no text/data extraction
Requirements: None (OCR not needed)
⚙️ Scanner Settings
Coordinate Range
- Start X/Y: Top-left corner of scan area
- End X/Y: Bottom-right corner of scan area
- Step: Tile increment (1 = scan every tile, 2 = every other tile)
Performance Tips
- Large Areas: Use Fast Scanner or increase step size
- Detailed Data: Use OCR scanner with step=1
- Testing: Always test with a small area first (10x10 tiles)
- Efficiency: Scanner auto-skips multi-tile objects in OCR mode
💾 Working with Scan Data
- Toggle layers on/off to focus on specific elements
- Adjust tile size for better visibility (1-20 pixels)
- Enable banner radius to see alliance coverage areas
- Use grid overlay for coordinate reference
- Export high-resolution images for sharing with alliance
🗺️ Map Visualizer Guide
The Map Visualizer transforms your scan data into beautiful, interactive maps with full control over what you see.
🎨 Layer Controls
🌍 Terrain
Plains (green), Badlands (brown), Ruins (gray), Fertile Land, Forbidden Areas
👥 Players
Friendly cities (green), Enemy cities (red) with power levels
🐻 Wildlife
Small wildlife (gold), Large wildlife (orange) - Bears, Lions, Wolves, etc.
⛏️ Resources
Idle resources (blue) - Mines, Lumber, Mills, Quarries
🏛️ Alliance Buildings
Banners (purple), Alliance resources, Buff locations
🏗️ Player Buildings
HQ, Arsenal, Harvest Altar, Towers, Camps, Groves
🎛️ Visualization Options
Tile Size
Adjust from 1-20 pixels per tile. Larger values give more detail but require more screen space.
- 1-3 pixels: Extreme overview, entire kingdom visible
- 5-8 pixels: Balanced view, recommended for most uses
- 10-20 pixels: Detailed view, labels clearly readable
Banner Range
Visualize alliance banner coverage areas. Adjust from 1-20 tiles radius.
- Shows square area around each alliance banner
- Default: 5 tiles (typical game mechanic)
- Toggle on/off with "Banner Area of Effect" checkbox
Grid Overlay
Display grid lines every 10 tiles for coordinate reference and measurement.
Labels
Show names for important structures like alliance banners, special buildings, and castles.
📤 Exporting Maps
- Alliance Planning: Map enemy territories and plan attacks
- Resource Farming: Find idle resources near your city
- Wildlife Hunting: Locate bears and other high-value targets
- Territory Analysis: Visualize alliance coverage and gaps
- Expansion Planning: Identify valuable terrain for city placement
⚙️ Advanced Configuration
📝 Configuration File Format
The scanner stores settings in scanner_config.json. All positions are stored as percentages of screen size for portability across different resolutions.
🔧 Reconfiguring
If your game resolution changes or scanner stops working:
-
From the Scanner GUI:
Settings → Reconfigure Scanner
Your old config will be backed up automatically -
Manual Reconfiguration:
Standalone: Deletescanner_config.jsonand runGameMapScanner.exeagain
Python Source: Runpython ConfigWizard.py
The configuration wizard will appear automatically on first run -
Edit Config Directly:
Settings → Edit Config File
Advanced users can manually adjust percentages
🎯 Tesseract OCR Setup
Required for Detailed OCR Scanner Mode
The fast screenshot scanner works without Tesseract, but detailed scanning requires OCR capability.
-
Download Tesseract
Visit: Tesseract OCR Downloads
Recommended:tesseract-ocr-w64-setup-5.3.3.20231005.exe -
Install to Default Location
C:\Program Files\Tesseract-OCR\
The scanner auto-detects this location -
Verify Installation
Try running Detailed OCR Scanner mode
You'll see an error if Tesseract isn't found
Custom Tesseract Path
If you installed Tesseract to a custom location, the scanner will search these paths:
- Same directory as scanner executable
C:\Program Files\Tesseract-OCR\C:\Program Files (x86)\Tesseract-OCR\%LOCALAPPDATA%\Programs\Tesseract-OCR\
📋 Game Map Scanner Changelog
- ✅ Detailed OCR scanning mode - fully functional
- ⚠️ Fast Screenshot mode - currently broken, needs fixing
- ✨ Interactive map visualizer with layer controls
- ✨ Configuration wizard for easy setup
- ✨ Auto-detection of multi-tile objects (cities, buildings, wildlife)
- ✨ Smart coordinate skipping to avoid duplicate scans
- ✨ Support for all terrain types, buildings, and resources
- ✨ JSON export for data portability
- ✨ PNG image export from visualizer
- ✨ Alliance banner area of effect visualization
- ✨ Adjustable tile sizes and zoom levels
- ✨ Grid overlay for coordinate reference
- ✨ Comprehensive building and wildlife recognition
- ✨ Player city detection with power levels
- ✨ Alliance structure identification
- 🔧 ESC key emergency stop during scanning
- 🔧 Progress tracking with percentage and tile counts
- 🔧 Automatic Tesseract OCR detection
⚠️ Known Issues
- Fast Screenshot Scanner: Mode is currently non-functional due to zoom/navigation issues. Use Detailed OCR Scanner instead.
- Screenshot Stitching: Temporarily unavailable until Fast Scanner is fixed
🔮 Planned Features (Future Versions)
- 🔧 v1.1.0: Fix Fast Screenshot Scanner mode
- 🔧 v1.1.0: Repair screenshot stitching functionality
- 📊 Statistical analysis and reports
- 🔍 Search and filter functions in visualizer
- 📍 Coordinate bookmarking system
- 🎯 Target priority recommendations
- 📈 Historical tracking and comparison
- 🤝 Multi-alliance territory mapping
- 🌐 Web-based visualizer for sharing
- 📱 Mobile companion app
- ⚡ GPU-accelerated OCR for faster scanning
- 🔄 Auto-update system
❓ Frequently Asked Questions
⚠️ Why is Fast Screenshot Scanner mode broken?
A: The Fast Screenshot Scanner is experiencing issues with zoom control and map navigation that prevent it from functioning correctly. We're working on a fix for the next update (v1.1.0). In the meantime, please use the Detailed OCR Scanner mode, which is fully functional and provides complete data extraction.
Q: Which scanner mode should I use?
A: Currently, you should use Detailed OCR Scanner as it's the only working mode. When the Fast Screenshot mode is fixed in v1.1.0, you'll be able to choose based on your needs:
- Detailed OCR (Available Now): Complete data extraction including player names, power levels, building types
- Fast Screenshot (Coming in v1.1.0): Quick territorial overviews for very large areas (100+ tiles)
Q: How long does scanning take?
A:
- Detailed OCR: ~2-3 seconds per tile (100 tiles ≈ 5-10 minutes)
- Fast Screenshot: ~1-2 seconds per screenshot (500 tiles ≈ 2-3 minutes)
- Exact time depends on your computer speed and game responsiveness
Q: The scanner is clicking the wrong positions, what do I do?
A: Run the configuration wizard again (Settings → Reconfigure Scanner). Make sure to:
- Keep the game window in the same position during configuration
- Don't change game resolution after configuring
- Use windowed or borderless windowed mode (not fullscreen)
Q: Can I scan while doing other things?
A: No, the scanner needs full control of mouse and keyboard during scanning. However, you can:
- Run scans overnight or during breaks
- Press ESC to pause/stop scanning at any time
- Resume from where you stopped by adjusting start coordinates
Q: What's the maximum area I can scan?
A: Technically unlimited! However:
- Practical limit: 1000x1000 tiles (1 million tiles)
- Recommended: Scan in chunks (100x100) for better manageability
- Memory usage: Large scans (500x500+) may require 8GB+ RAM
- Visualization: Maps over 500x500 tiles may be slow to render
Q: Does this violate game terms of service?
A: This tool does NOT:
- Modify game files or memory
- Inject code or automate gameplay actions
- Provide unfair advantages beyond information gathering
- Using for alliance strategy and planning
- Not publicly sharing scan capabilities to avoid mass usage
- Being respectful of game balance
Q: Can I scan on Mac or Linux?
A: Currently Windows-only for the standalone executable. However, the Python source code can run on Mac/Linux with:
- Python 3.8+ installed
- All required packages (see requirements.txt)
- Tesseract OCR for your OS
- Some code modifications may be needed for platform-specific features
Q: The OCR is misreading text, how can I improve accuracy?
A: Try these tips:
- Increase in-game text size/UI scale if available
- Use a higher game resolution (1920x1080 or higher)
- Ensure popup windows are fully visible and not cut off
- Recapture the popup region in configuration to include more area
- Check Tesseract installation is complete and up-to-date
Q: Can I share my scan data with alliance members?
A: Yes! Multiple ways:
- JSON File: Share the .json file - others can load it in Map Visualizer
- PNG Export: Export map image and share - viewable without the scanner
- Screenshots: Take screenshots of the visualizer for quick sharing
⚠️ Scanner Stopped Working After Game Update?
Game UI updates may change button positions or popup layouts. Solutions:
- Re-run configuration wizard to capture new positions
- Check if popup format changed (may need code updates)
- Join our community for update announcements