Skip to content

b3nNn/bottle-royale

Repository files navigation

🚧🚧 (DRAFT) Bottle Royale - A Battle Royale Arena for JS Programming Challenges 🚧🚧

Implement your strategy for surviving with javascript and challenge opponents in a battle royale environnement.

Features

  • Up to 100 bots per game scripted with javascript.
  • Event Driven and Module Driven API.
  • Scenario Driven for debugging.
  • Game view with three.js (live, replay).
  • Code Obfuscation using OpenPGP to secure privacy of executed source code.
  • Persistence and Realtime with RethinkDB.
  • Docker for production deployment.

Guides

Create a bot

Provide your scripts which use the JS API inside a bundle directory. See examples/my_bot.bundle and examples/foo_bar.bundle.

  • bot.js; entry point
  • discord.js*; discord communication

*: optionnal

Start a match

Start a match by running the start command:

npm run watch:app -- --bot examples/my_bot.bundle --bot examples/foo_bar.bundle

or with a game configuration file:

npm run watch:app -- --bot examples/my_bot.bundle --bot examples/foo_bar.bundle --config game.config.js

Display logs using --debug and/or --debug-persistence parameters.

Game Configuration

After beeing initialized, a game starts after game_launch_delay milliseconds delay. All players have an amount of life equal to player_health and the storm will move for the first time after storm_stay_delay milliseconds delay. Then, it moves for storm_move_delay milliseconds and level up at the end. Everytime the storms level up, it will stay again for storm_stay_delay then moves for storm_move_delay until the end of the game.

export  default {
	game_launch_delay: 0, // ms duration before the game star
	player_health: 100.0, // amount of health for players
	storm_stay_delay: 60000, // ms duration before the storm move
	storm_move_delay: 30000, // ms duration before the storm stay
	storm_damage: 1.0, // damage per second while player is in the storm
	storm_damage_factor: 2.0  // damage factory per level
	storm_size: 1000  // storm size
	storm_size_factor: 0.3  // size factory per level
};

JS API

Minimalist bot

const client = new br.Client();
const player = new br.Player();

client.connect("SNK citizendotexe");
client.on('game_found', matchmaking => {
    matchmaking.accept(client);
    matchmaking.on('start', () => {
        const strategy = player.behavior.createStrategy('empty-strategy');
        
        player.behavior.while(['alive'], strategy, () => {
            client.log('WTF i\'m dead too');
        });
    });
});

Location

const client = new br.Client();
const location = new br.PlayerLocation();

client.connect("SNK citizendotexe");
client.on('game_found', matchmaking => {
    matchmaking.on('start', () => {
        client.log('my current location is', location);
    });
});

Storm phases detection

const client = new br.Client();
const storm = new br.StormEvents();

client.connect("SNK citizendotexe");
client.on('game_found', matchmaking => {
    matchmaking.on('start', () => {
        storm.on('prepare', storm => {
            client.log('the storm is preparing');
        });
        storm.on('stay', storm => {
            client.log('the storm is staying');
        });
        storm.on('move', storm => {
            client.log('the storm is moving');
        });
    });
});

Gameplay events

const client = new br.Client();
const game = new br.GameEvents();

client.connect("SNK citizendotexe");
client.on('game_found', matchmaking => {
    matchmaking.accept(client);
    matchmaking.on('start', () => {
        game.on('landed', () => {
            client.log('landed confirmed');
        });
        game.on('death', () => {
            client.log('death confirmed');
        });
    });
});

More coming next...