-
Notifications
You must be signed in to change notification settings - Fork 17
Autobingo Command
Bingo Reloaded adds a set of commands that can be used from the console or by a bingo.admin player in-game. The purpose of these commands, as the name suggests, is to remove the middle man and automate bingo games more for server owners that want this plugin to work on its own.
All commands are tab completable. See the list of commands below for a full list. All commands require the <world_name> argument. This argument specifies what world the command should apply to. For the default SINGULAR configuration this argument will be suggested when typing, but is the same name as the defaultWorldName option.
Just like the /bingo menu settings, these commands apply to any future games of bingo until the server restarts or the option is overwritten by a new command.
-
Creates a new world to play bingo on. This will create a world in the plugin folder. Worlds for nether and end dimensions are created as well. You cannot create 2 worlds with the same name.
A world must be created first to perform any other commands on it.Arguments: -
-
Destroys a created world. This will remove the world folder associated with this world, so make sure all players have left.
(The other way worlds get deleted is when the plugin reloads/ restarts.)Arguments: -
-
Teleports the given player to this world's spawn point.
Arguments: -
-
Teleports the given player to the target_world's spawn point if they are present in the given world.
Arguments: -
-
Teleports all players of world_name to the target_world's spawn point.
Arguments: -
-
Starts the bingo game. A single session/bingo world can only have 1 active game at a time.
Arguments: -
-
Ends the bingo game. alias for /bingo end.
Arguments: -
-
Set the gamemode to use in the bingo game
Arguments:
-
Required*
<gamemode>: can be any of:- 'regular'
- 'lockout'
- 'complete'
- 'countdown'
-
Required*
<cardsize>: can be any of:- '3'
- '5'
-
Required*
-
Select the kit to use in the bingo game.
Arguments:
-
Required*
<name>: can be any of:- 'hardcore'
- 'normal'
- 'overpowered'
- 'reloaded'
- 'custom_1' through 'custom_5' (if undefined defaults to hardcore)
-
Required*
-
Select the effects to use in the bingo game.
Arguments:
-
Required*
<effect_name | all | none>: can be any of:- 'all' (select all effects)
- 'none' (select no effects)
- 'water_breathing'
- 'night_vision'
- 'fire_resistance'
- 'no_fall' (no fall damage)
- 'card_speed'
-
Optional*
[true | false]: (doesn't apply to 'all' and 'none') can be any of:- 'false' turn off this effect in the bingo game.
- 'true' turn on this effect in the bingo game.
-
Required*
-
Select the card to use in the bingo game.
Arguments:
-
Required*
<card_name>: exact name of the card (i.e. 'default_card') -
Optional*
[card_seed]: select a card seed, with the same seed, and card_name, the same exact card tasks will also be generated.- Default value is 0, meaning no seed is used.
-
Required*
-
Select the maximum amount of players per team in the bingo game.
Note: This will remove all players from existing teams when the new value is smaller than the old value.
Arguments:
-
Required*
<teamsize>:
-
Required*
-
Used to determine the type of countdown to use, set the duration of the countdown using /autobingo duration.
Arguments:
-
Required*
<type>: can be any of:- 'disabled`: No countdown timer is used.
- 'duration': Countdown timer is used, removing score goals, the game can only end when the time runs out (only relevant for hot-swap).
- duration works the same as time_limit on all other gamemodes.
- 'time_limit': Countdown timer is used, but does not take precedence over score goals.
-
Required*
-
Select the duration of the timer in countdown mode. This command has no effect when countdown is set to false.
Arguments:
-
Required*
<minutes>: duration in minutes from 1 to 60.
-
Required*
-
Sets the required win score of hot-swap to
<win_goal>, when playing hot-swap the first team to complete this many tasks wins.Arguments:
-
Required*
<score>:- score in amount of tasks to complete.
-
Required*
-
When set to true, when playing hot-swap, tasks will expire automatically after some amount of time.
Arguments:
-
Required*
<true | false>:- True to expire tasks automatically (default), false to only expire tasks when they get completed.
-
Required*
-
Sets the required win score of complete-x to
<win_goal>, when playing complete-x the first team to complete this many tasks wins.Arguments:
-
Required*
<score>:- score in amount of tasks to complete.
-
Required*
-
Add the given player to the given team, using none will remove the player from any team they are on.
Arguments:
-
Required*
<player_name>: name of the player to select a team for. -
Required*
<team_name | none | auto>: the name / id of the team, found in/bingo teameditfor custom made teams- Use 'none' to remove the player from all teams
- Use 'auto' to allow the plugin to pick the best team for the player when the game starts.
-
Required*
-
Select a settings preset to use for the next game.
-
Required*
<load | save | remove>:- Specify whether to load, save, or remove a preset.
- Note: when loading a preset, all previously selected settings for this game will be overwritten by the selected preset.
-
Required*
<preset name>: The name of the preset.
-
Required*
-
Place a vote for a specific category in the autobingo game, posing as a player. This is mainly used if you need a custom voting system, which may involve ranks and different permissions etc..
Arguments:
-
Required*
<player_name>: The name of the player to cast a vote from. -
Required*
<vote_category>: can be any of:- 'kits'
- 'gamemodes'
- 'cards'
-
Required*
<vote_for>: The specific item within the vote category to vote for.
-
Required*
-
Command used to manage player data. The plugin will take care of this automatically. This command is useful if you want to deal with playerdata manually. Can be used even when config.savePlayerInformation is set to false, to completely ignore the existing saving strategy. Player Data is everything the player has in their inventory as well as their position, current health, hunger, etc...
Arguments:
-
Required*
<save | load | remove>:- specify whether to save new player data, load saved player data or remove existing player data.
-
Required*
<player_name>: The name of the player to manage.
-
Required*
-
Determine whether each team will get their own set of tasks or if every team gets the same tasks.
Arguments:
-
Required*
<true | false>:- When true each team will get their own tasks/card.
-
Required*
Example of how you can set up a game using only autobingo commands:
/autobingo world card my_epic_card
/autobingo world effects all
/autobingo world effects no_fall false
/autobingo world effects card_speed false
* the above 3 commands will turn on all effects except no_fall and card_speed *
/autobingo world kit overpowered
/autobingo world countdown true
/autobingo world duration 20
/autobingo world gamemode lockout 5
/autobingo world start
Contact me in my discord server here (discord) for any requests, bug reports or changes you would want to see as that's where I hang out more often compared to over here.
There is also a test server available where we occasionally test out experimental features.