screeps-server-mockup
Based on https://github.com/screepers/screeps-server-test
Private server package for unit tests
This is a project that runs the screeps private server one tick at a time, allowing to easily check data in between ticks and opens the possibilities for automatic testings in a reproductible environment.
Requirements
These are necessary to build the internal Screeps server.
- Node.js 10 LTS or higher
- Python (for node-gyp)
- Build tools (
apt install build-essentialfor Ubuntu, Visual Studio for Windows, etc)
Usage
- Install via npm or yarn
- Write a test script (see
examplesandtestsfolders for details) - Run the test script
Script example (simple)
const _ = require('lodash');
const { ScreepsServer, TerrainMatrix } = require('screeps-server-mockup');
// Initialize server
const server = new ScreepsServer();
await server.world.reset(); // reset world but add invaders and source keepers users
await server.world.stubWorld(); // create a stub world composed of 9 rooms with sources and controller
// Add a bot in W0N1
const modules = {
main: `module.exports.loop = function() {
console.log('Tick!',Game.time);
const directions = [TOP, TOP_RIGHT, RIGHT, BOTTOM_RIGHT, BOTTOM, BOTTOM_LEFT, LEFT, TOP_LEFT];
_.sample(Game.spawns).createCreep([MOVE]);
_.each(Game.creeps, c => c.move(_.sample(directions)));
};`
};
const bot = await server.world.addBot({ username: 'bot', room: 'W0N1', x: 15, y: 15, modules });
// Start server and run a tick
await server.start();
await server.tick();Script example (complete)
const _ = require('lodash');
const { ScreepsServer, TerrainMatrix } = require('screeps-server-mockup');
// Initialize server
const server = new ScreepsServer();
await server.world.reset(); // reset world but add invaders and source keepers users
// Prepare the terrain for a new room
const terrain = new TerrainMatrix();
const walls = [[10, 10], [10, 40], [40, 10], [40, 40]];
_.each(walls, ([x, y]) => terrain.set(x, y, 'wall'));
// Create a new room with terrain and basic objects
await server.world.addRoom('W0N1');
await server.world.setTerrain('W0N1', terrain);
await server.world.addRoomObject('W0N1', 'controller', 10, 10, { level: 0 });
await server.world.addRoomObject('W0N1', 'source', 10, 40, { energy: 1000, energyCapacity: 1000, ticksToRegeneration: 300 });
await server.world.addRoomObject('W0N1', 'mineral', 40, 40, { mineralType: 'H', density: 3, mineralAmount: 3000 });
// Add a bot in W0N1
const modules = {
main: `module.exports.loop = function() {
console.log('Tick!',Game.time);
const directions = [TOP, TOP_RIGHT, RIGHT, BOTTOM_RIGHT, BOTTOM, BOTTOM_LEFT, LEFT, TOP_LEFT];
_.sample(Game.spawns).createCreep([MOVE]);
_.each(Game.creeps, c => c.move(_.sample(directions)));
};`
};
const bot = await server.world.addBot({ username: 'bot', room: 'W0N1', x: 25, y: 25, modules });
// Print console logs every tick
bot.on('console', (logs, results, userid, username) => {
_.each(logs, line => console.log(`[console|${username}]`, line));
});
// Start server and run several ticks
await server.start();
for (let i = 0; i < 10; i++) {
console.log('[tick]', await server.world.gameTime);
await server.tick();
_.each(await bot.newNotifications, ({ message }) => console.log('[notification]', message));
console.log('[memory]', await bot.memory, '\n');
}
// Stop server and disconnect storage
server.stop();
process.exit(); // required as there is no way to properly shutdown storage :(Each tick should output something like:
[tick] 1
[console|bot] Tick! 1
[memory] {"creeps":{"Arianna":{}}}
Tests
yarn lint // or npm run lint
yarn test // or npm run test