TooAngel NPC / bot / source code for screeps

This project is a codebase for Screeps, a strategy sandbox MMO game. The codebase is a fully automated player that covers all important features provided by the game.

The TooAngel bot laid the groundwork for bots on private servers and pioneered the full automation concept. It was the first fully automated open source codebase and introduced the concept of community-driven merge processes as well as fully automated bot deployment.

Pull Requests are automatically merged (World Driven) and deployed to the Screeps TooAngel account.

Use cases

There are different occasions where you get into contact with the TooAngel NPC / bot / source code.

• As NPC on the public server
• Deployed as bot on a private server
• Using it as code base

Contributing

This project welcomes all kinds of contributions! Whether you're reporting issues, suggesting features, or submitting pull requests, your input helps improve the bot.

Please see CONTRIBUTING.md for details about the automated merge process and how to get involved.

The codebase includes many innovative ideas and solutions developed through practical gameplay experience. While some code was written quickly during active gameplay situations, the project continues to evolve and improve with community contributions.

Features

Core Automation

• Automatic base building - Smart room layout and construction
• Remote harvesting - Automated resource collection from external rooms
• Room extension and expansion management
• Reviving attacked rooms automatically

Resource Management

• Mineral handling, harvesting, market, reactions and boosting
• Power and commodity harvesting
• Automated market trading

AI Systems

• Trapped scenario detection - Detects when bot is imprisoned by hostile players
• Diplomatic module for retaliations - Reputation-based player interactions
• Quest system - Interactive challenges for other players

Development Tools

• Layout visualization - Visual debugging tools
• Manual commands - Administrative controls
• Testing framework - Automated testing system

Design

More details of the AI design

Links

• Game Docs
• API Docs